Pular para o conteúdo principal
Versão: 0.4 · atual

Alterar limites e desativar verificações

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Editor, Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

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.
dica

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:

ParteValores
Operator>, >=, <, <=, ==, !=, in, not_in, matches
ValueUm número na unidade da verificação, exibida ao lado do campo, ou uma lista para in e not_in
ForOpcional. 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​

  1. Abra o recurso e selecione a guia Checks. Use Search checks ou Only problems para localizar a verificação.
  2. 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.
  3. 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) em sql-ventas-01, defina Warning level como < 900 por 10m.
  4. 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​

  1. Abra Settings › Entities.
  2. 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.
  3. Em Set a default for a check, escolha a verificação, por exemplo CPU utilization (SQL process) (sqlserver.cpu_percent), e selecione Add.
  4. 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 > 75 por 15m.
    • Turn off here: este nível não gera alertas nesta entidade e abaixo dela.
  5. 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.

TarefaSolicitação
Ver os níveis efetivos e de onde cada um vemGET /resources/{id}/checks
Definir níveis em um recursoPATCH /resources/{id}/checks/{check_id} com thresholds
Voltar aos níveis herdadosO mesmo PATCH com "thresholds": null
Desativar ou ativar uma verificaçãoO mesmo PATCH com "enabled": false ou true
Alterar o intervaloO mesmo PATCH com "interval_seconds", de 10 a 604800
Ver os padrões próprios de uma entidadeGET /entities/{id}/thresholds
Definir um padrão de entidadePUT /entities/{id}/thresholds/{check_id}
Remover um padrão de entidadeDELETE /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}'