Início rápido: adicionar um grupo de disponibilidade
Neste início rápido, você adiciona ao Excubius um grupo de disponibilidade com duas réplicas da Veredas Ltda. e o vê no painel Overview. O processo leva cerca de 15 minutos depois que o logon de monitoramento já existe.
Antes de começar
- O logon de monitoramento existe em todas as réplicas com o mesmo SID. Consulte Pré-requisitos.
- Você é Entity admin (administrador de entidade) na entidade que vai conter o grupo, por exemplo Veredas Ltda. › Produção.
- O servidor do Excubius alcança o ouvinte e as duas réplicas na porta do SQL.
Nos exemplos, as réplicas são sql-ventas-01.ciguapa.example e sql-ventas-02.ciguapa.example, e o grupo é ag-ventas.
1. Armazene o logon uma única vez
Uma credencial armazenada na Veredas Ltda. pode ser usada por todos os recursos abaixo dela.
- Console
- API
- Abra Settings › Credentials e escolha Veredas Ltda. no seletor de entidades.
- Selecione Add credential, tipo SQL login.
- Insira o nome
sql-monitoring, o usuáriousr_monitoringe a senha. - Selecione Save. A senha é criptografada e nunca mais é exibida.
CRED=$(curl -s "${H[@]}" -X POST "$BASE/credentials" -d "{
\"entity_id\": \"$CIGUAPA\", \"name\": \"sql-monitoring\", \"kind\": \"sql_login\",
\"username\": \"usr_monitoring\", \"secret\": \"<password>\"
}" | jq -r .id)
$BASE é https://<your server>/api/v1 e H contém o seu token de portador. Consulte a referência da API.
2. Adicione cada réplica como uma instância
- Console
- API
- Abra Resources › Add resource.
- Type: SQL Server instance.
- Place and name: Veredas Ltda. › Produção, nome
sql-ventas-01. - Connection: host
sql-ventas-01.ciguapa.example, porta1433. - Tags:
env:prod,role:sql,client:ciguapa; criticidade4. - Credential:
sql-monitoring. - Review e, em seguida, Create resource.
Repita para sql-ventas-02.
for n in 01 02; do
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"sqlserver_instance\", \"name\": \"sql-ventas-$n\",
\"attributes\": {\"host\": \"sql-ventas-$n.ciguapa.example\", \"port\": 1433},
\"tags\": {\"env\": \"prod\", \"role\": \"sql\", \"client\": \"ciguapa\"}, \"criticality\": 4,
\"credential_id\": \"$CRED\"
}" | jq '{id, name, checks_provisioned}'
done
As verificações padrão de uma instância do SQL Server são configuradas imediatamente. Os primeiros valores chegam em um ou dois minutos.
3. Teste a conexão
Na primeira réplica, selecione Test connection. Um teste bem-sucedido mostra o nome do servidor, a versão, a edição e a latência, e lista as permissões que estiverem faltando.
| Resultado | Significa | Correção |
|---|---|---|
auth | O logon falhou ou os logons SQL estão desabilitados | Verifique a senha e se a instância aceita logons SQL (modo misto) |
unreachable | Nome, firewall ou porta | Verifique o DNS e o firewall a partir do servidor do Excubius |
timeout | Sem resposta a tempo | Verifique o caminho de rede e a porta do SQL |
Aviso: o logon é sysadmin | Funciona, mas não segue o privilégio mínimo | Recrie o logon conforme os Pré-requisitos |
4. Descubra o grupo de disponibilidade
Em apenas uma réplica, selecione Discover. A descoberta lê o servidor, os grupos de disponibilidade com as réplicas, as funções e o ouvinte, os bancos de dados e os servidores vinculados, e os adiciona como recursos filhos com as próprias verificações. Execute-a novamente sempre que a topologia mudar. Os filhos que desaparecem são marcados como ausentes, nunca excluídos.
5. Veja o grupo no painel Overview
Abra o Overview da Veredas Ltda.. O cartão ag-ventas mostra o ouvinte, a primária, as duas réplicas com a integridade da sincronização e os bancos de dados. As duas réplicas devem exibir Íntegro.
Limpar
Para remover o que você adicionou, exclua as duas instâncias em Resources. Os filhos descobertos, as verificações, as métricas e os alertas delas são removidos junto. Exclua a credencial por último, quando nada mais a usar.