Usando Variáveis Dinâmicas em Mensagens de Alarme

Como as Variáveis Dinâmicas São Renderizadas

O valor de um parâmetro de mensagem de alarme é renderizado em uma mensagem de alarme quando você insere a variável dinâmica associada nos campos suportados. Por exemplo, insira o seguinte como o corpo do alarme:

{{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}

Na imagem a seguir de uma mensagem de alarme, o corpo do alarme (Body) é renderizado como: Alarme CRITICAL acionado porque o limite foi violado em decorrência de [CpuUtilization[1m].mean():92] em 2023-08-15T19:51:00Z

As variáveis dinâmicas aparecem em notificações que contêm elementos do corpo.

• Se os dados estiverem disponíveis para uma variável dinâmica, a variável será resolvida e os dados serão exibidos em seu lugar. A mensagem de alarme de exemplo anterior mostra [CpuUtilization[1m].mean():92] no lugar da variável dinâmica {{metricValues}}.
• Se não houver dados disponíveis para uma variável dinâmica, a variável não será resolvida e aparecerá como codificada. Por exemplo, se nenhum valor de métrica estiver disponível para a variável dinâmica {{metricValues}}, como quando o alarme estiver no estado OK, a variável dinâmica {{metricValues}} aparecerá na mensagem de alarme.
• As mensagens SMS não têm elementos do corpo, portanto, as variáveis dinâmicas não são resolvidas.

• Console
• CLI
• API

• 1. Abra o menu de navegação e clique em Observabilidade & Gerenciamento. No serviço Monitoring, clique em Definições de Alarme.
  2. Clique no nome do alarme desejado.
  3. Na página de detalhes do alarme, clique em Ações e selecione Editar alarme.
  4. Na página Editar alarme, localize o campo ao qual você deseja adicionar variáveis dinâmicas.
     • Corpo do alarme (parâmetro da mensagem de alarme body): Renderizado como um campo dentro do corpo da mensagem de alarme.
     • Resumo do alarme (parâmetro da mensagem de alarme alarmSummary): Renderizado como um campo dentro do corpo da mensagem de alarme.
     • Assunto de notificação (parâmetro de mensagem de alarme title): A renderização depende do tipo de mensagem. Para uma mensagem de e-mail formatada, é renderizada como a linha de assunto. Para uma mensagem do Slack, é renderizada como o título. Para uma mensagem SMS, é renderizada como parte da mensagem.

     Para obter informações sobre a aparência padrão desses parâmetros de mensagem de alarme em mensagens formatadas, consulte Formato de Mensagem de Alarme.

  5. Insira variáveis dinâmicas para os parâmetros de mensagem de alarme desejados.

     Exemplo com variáveis dinâmicas:

     {{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}

     Para procurar variáveis dinâmicas para um parâmetro, consulte Variáveis Dinâmicas.

     Você pode desativar o escape de HTML usando a variável dinâmica mais longa para um parâmetro de alarme. Por exemplo, para renderizar o valor do parâmetro query na mensagem de alarme com escape de HTML desativado, informe a variável dinâmica {{{query}}}.

  6. Clique em Salvar alarme.

• Use o comando oci monitoring alarm update e os parâmetros obrigatórios para atualizar um alarme para usar variáveis dinâmicas no campo que você deseja:

  oci monitoring alarm update --alarm-summary <text-including-dynamic-variables> --body <text-including-dynamic-variables> --notification-title <text-including-dynamic-variables> [...]

  Com quebras de linhas:

  oci monitoring alarm update 
  --alarm-summary <text-including-dynamic-variables> 
  --body <text-including-dynamic-variables> 
  --notification-title <text-including-dynamic-variables> [...]

  Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Linha de Comando para o Serviço Monitoring.

• Execute a operação UpdateAlarm para atualizar um alarme para usar a opção de formato de mensagem desejada.

  Ao definir detalhes para UpdateAlarmDetails, defina o campo desejado (alarmSummary, body ou notificationTitle) para o texto desejado, incluindo variáveis dinâmicas.