Adicionando Regras de Trigger a um Alarme

Defina uma ou mais regras de acionamento, ou predicados, para um alarme. Uma regra de acionamento é uma condição (definida pela consulta) que deve ser atendida para que o alarme esteja no estado de acionamento e também inclui severidade, atraso do acionamento (pendingDuration) e o corpo do alarme a ser incluído nas notificações. Uma condição em uma regra de trigger pode especificar um limite, como 90% para utilização da CPU, ou uma ausência.

Adicione até duas regras de acionamento, ou predicados, a um alarme. Por exemplo, adicione uma regra de acionador crítico para 95% e uma regra de acionador de aviso para 90%.

Observação

Para entender como as notificações são enviadas quando um alarme tem várias regras de acionamento, consulte Agrupando Notificações para um Alarme e Dividindo Notificações para um Alarme.
Exemplo de regras de acionamento em um alarme
{
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

Para operadores de predicado válidos em expressões MQL, consulte Operadores de Predicado.

Para diagnóstico e solução de problemas de alarme, consulte Diagnosticando e Solucionando Problemas de Alarmes. Consulte também Criando um Alarme Básico.

    1. Na página de lista Definições de Alarme, selecione o alarme com o qual deseja trabalhar. Se precisar de ajuda para localizar a página da lista ou o alarme, consulte Listando Alarmes.
    2. Vá para Ações e selecione Editar alarme.
    3. Na área Descrição da métrica, verifique se o namespace da métrica e o nome da métrica desejados estão selecionados.
    4. Para definir uma regra de acionamento (predicar) usando o modo Básico (padrão), vá para a área Regra de acionamento e forneça os seguintes valores:
      • Para Operador, selecione o operador a ser usado no limite da condição. Consulte Operadores de Previsão.
      • Para Valor, informe o valor a ser usado para o limite da condição. Para os operadores entre e fora, informe os dois valores para o intervalo.
      • Em Minutos para atraso do acionador, informe o número de minutos nos quais a condição deve ser mantida antes de o alarme estar no estado de acionamento.
      • Para Severidade do alarme, selecione o tipo percebido de resposta necessário quando o alarme estiver no estado acionador desta condição (regra do acionador).
      • Para Corpo do alarme, informe o conteúdo legível da notificação para essa condição (regra de acionamento).

        Recomendamos fornecer orientação aos operadores para resolver a condição do alarme. Considere adicionar links às práticas padrão do manual. Exemplo: "Alerta de alto uso da CPU. Siga as instruções do manual para obter a resolução." Opcionalmente, insira variáveis dinâmicas para renderizar o valor dos parâmetros de mensagem de alarme associados em mensagens de alarme. Por exemplo, insira {{query}} para renderizar o valor de query.

      • Para adicionar outra regra de trigger (condição), selecione Regra de trigger adicional.
    5. Para definir uma regra do acionador (predicar) atualizando a expressão MQL, execute as seguintes etapas:
      1. Na parte superior da página Editar alarme, selecione Alternar para o Modo Avançado.
      2. Forneça os seguintes valores:
        • Em Minutos para atraso do acionador, informe o número de minutos nos quais a condição deve ser mantida antes de o alarme estar no estado de acionamento.
        • Para Severidade do alarme, selecione o tipo percebido de resposta necessário quando o alarme estiver no estado acionador desta condição (regra do acionador).
        • Para Editor de código de consulta, edite a consulta MQL para especificar a regra de acionamento desejada.

          A regra de acionamento é o fragmento de operador e valor na consulta MQL. Por exemplo, o fragmento > 90 representa o operador de maior que e um valor 90. Exemplo de consulta MQL:

          CpuUtilization[5m].Mean() > 90

          Para referência, veja Consultando Dados de Métrica e Referência de MQL (Monitoring Query Language).

        • Para Corpo do alarme, informe o conteúdo legível da notificação para essa condição (regra de acionamento).
        • Para adicionar outra regra de trigger (condição), selecione Regra de trigger adicional.
    6. Atualize quaisquer outros valores para o alarme, conforme necessário.
      Para obter mais informações sobre os campos, consulte Criando um alarme básico.
    7. Selecione Salvar alarme.
  • Use o comando oci monitoring alarm update e os parâmetros obrigatórios para atualizar as regras do trigger em um alarme. Uma regra de acionamento faz parte da expressão MQL ou consulta.

    Para um alarme com uma regra, use o parâmetro --query-text. Exemplo de atualização da regra de acionamento para mais de 90% (>90):

    oci monitoring alarm update --query-text "CPUUtilization[1m].mean()>90" [...]

    Para um alarme com várias regras, use o parâmetro --overrides. Exemplo:

    oci monitoring alarm update --overrides <json_file_path> [...]
    Exemplo de arquivo JSON para solicitação (alarme com várias regras de trigger)
    {
      "body": "95% CPU utilization",
      "pendingDuration": "PT5M"
      "query": "CPUUtilization[1m].mean()>95",
      "ruleName": "95",
      "severity": "CRITICAL",
    },
    {
      "body": "90% CPU utilization",
      "pendingDuration": "PT5M"
      "query": "CPUUtilization[1m].mean()>90",
      "ruleName": "90",
      "severity": "WARNING",
    }

    Para obter uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Linha de Comandos para Monitoramento.

  • Execute a operação UpdateAlarm para atualizar um alarme. Uma regra de trigger faz parte da expressão MQL em um atributo query.

    Forneça as regras de trigger usando UpdateAlarmDetails. Para um alarme com uma regra (sem valor overrides), use o atributo query. Para um alarme com várias regras, use o atributo overrides.