Alterar limites e desativar verificações
Cada verificação parte da linha de base da entrada dela no catálogo. Você a altera onde fizer sentido: em uma entidade, para que todos os recursos abaixo dela a sigam, ou em um único recurso que seja a exceção. Este guia mostra as duas formas, como voltar aos valores herdados e como desativar uma verificação ou um dos níveis dela.
Antes de começar
- Para alterar uma verificação em um recurso, você precisa da função Editor ou superior na entidade do recurso.
- Para definir um padrão de entidade, você precisa da função Entity admin (Administrador de entidade) nessa entidade.
- Saiba de onde vêm os valores: a linha de base, depois cada entidade da raiz para baixo e depois o recurso. O valor mais específico prevalece. Consulte Limites e linhas de base.
Defina os valores o mais alto possível na árvore e crie substituições apenas para as exceções. Um padrão definido uma única vez em Veredas Ltda. › Production cobre todos os servidores adicionados ali depois.
Como um nível é escrito
Cada verificação tem um nível Warning e um nível Critical. Cada nível tem:
| Parte | Valores |
|---|---|
| Operator | >, >=, <, <=, ==, !=, in, not_in, matches |
| Value | Um número na unidade da verificação, exibida ao lado do campo, ou uma lista para in e not_in |
| For | Opcional. Por quanto tempo a condição deve se manter antes que o alerta seja aberto, como 30s, 15m, 1h ou 1d. Absorve picos curtos; a recuperação é imediata |
Algumas verificações comparam estados em vez de um valor com limites, por exemplo a integridade de uma réplica de um grupo de disponibilidade. As regras delas vêm do catálogo, e o editor informa isso em vez de mostrar níveis.
Alterar um limite em um recurso
- Abra o recurso e selecione a guia Checks. Use Search checks ou Only problems para localizar a verificação.
- Selecione o ícone de lápis, Edit, na linha da verificação. A caixa de diálogo mostra o id da verificação, a linha de base dela e os níveis atuais.
- Para cada nível que quiser alterar, mantenha This level raises alerts selecionado e digite o Operator, o Value e, se necessário, For. Por exemplo, para Page life expectancy (
sqlserver.ple_seconds) emsql-ventas-01, defina Warning level como<900por10m. - Selecione Save.
A linha agora mostra os novos níveis marcados com (this resource). Os níveis que você não alterou mantêm os valores herdados.
Para voltar aos valores herdados, abra a caixa de diálogo novamente e selecione Back to inherited thresholds. O botão só aparece quando o recurso tem valores próprios.
Definir um padrão para uma entidade
- Abra Settings › Entities.
- Abra o menu de ações da entidade, por exemplo Production, e selecione Threshold defaults. O painel lista as verificações que a própria entidade define; ela herda todas as outras.
- Em Set a default for a check, escolha a verificação, por exemplo CPU utilization (SQL process) (
sqlserver.cpu_percent), e selecione Add. - Para cada nível, escolha:
- Inherit: mantém o que vem de cima.
- Set here: digite o Operator, o Value e o For, por exemplo
>75por15m. - Turn off here: este nível não gera alertas nesta entidade e abaixo dela.
- Selecione Save.
Todos os recursos abaixo da entidade passam a usar o padrão, a menos que uma entidade inferior ou o próprio recurso o altere. Na guia Checks de cada recurso, o nível mostra a entidade de onde ele vem.
Para remover um padrão, selecione o ícone de lixeira ao lado dele, Remove the default of essa verificação. Os recursos abaixo voltam a herdar de níveis mais acima.
Desativar uma verificação
Em um recurso, abra a guia Checks e desative a verificação na coluna On, ou desmarque Check runs na caixa de diálogo da verificação. A verificação deixa de ser executada nesse recurso e aparece como Off, para que ninguém se esqueça de que ela existe. Ative-a novamente da mesma forma.
Para impedir que uma verificação gere alertas em uma entidade inteira, abra os Threshold defaults dela, adicione a verificação e defina Warning level e Critical level como Turn off here. A verificação continua sendo executada e registrando valores em todos os recursos abaixo, mas não gera alertas ali. Use isso para verificações que não fazem sentido em um ramo, como as verificações de servidor de relatórios onde não há servidor de relatórios.
Alterar a frequência de execução de uma verificação
Na caixa de diálogo da verificação, digite um Interval de 10s a 7d, por exemplo 30s, 5m ou 1h. Deixe-o vazio para usar o intervalo do catálogo, que o campo mostra. A linha marca um intervalo alterado como changed.
Fazer isso com a API
Toda alteração feita por meio da API segue as mesmas funções e é registrada no log de auditoria. $BASE é https://<your server>/api/v1 e H contém o seu token; consulte Início rápido: adicionar uma instância do SQL Server com a API.
| Tarefa | Solicitação |
|---|---|
| Ver os níveis efetivos e de onde cada um vem | GET /resources/{id}/checks |
| Definir níveis em um recurso | PATCH /resources/{id}/checks/{check_id} com thresholds |
| Voltar aos níveis herdados | O mesmo PATCH com "thresholds": null |
| Desativar ou ativar uma verificação | O mesmo PATCH com "enabled": false ou true |
| Alterar o intervalo | O mesmo PATCH com "interval_seconds", de 10 a 604800 |
| Ver os padrões próprios de uma entidade | GET /entities/{id}/thresholds |
| Definir um padrão de entidade | PUT /entities/{id}/thresholds/{check_id} |
| Remover um padrão de entidade | DELETE /entities/{id}/thresholds/{check_id} |
As chaves que uma substituição de nível pode conter são warn, crit, expect, window e sigma. Uma chave definida como null desativa essa parte nesse nível.
# one resource: warn when page life expectancy stays under 900 s for 10 minutes
curl -s "${H[@]}" -X PATCH "$BASE/resources/$SQL01/checks/sqlserver.ple_seconds" \
-d '{"thresholds": {"warn": {"op": "<", "value": 900, "for": "10m"}}}' | jq .thresholds
# the Production entity: CPU warning above 75% for 15 minutes, no critical level
curl -s "${H[@]}" -X PUT "$BASE/entities/$PROD/thresholds/sqlserver.cpu_percent" \
-d '{"warn": {"op": ">", "value": 75, "for": "15m"}, "crit": null}'