Criando um Alarme Básico
Crie um alarme básico no serviço Monitoring para notificá-lo quando as métricas atenderem aos acionadores especificados.
Para diagnóstico e solução de problemas de alarme, consulte Diagnosticando e Solucionando Problemas de Alarmes.
-
Na página de lista Definições de Alarme, selecione Criar Alarme. Se precisar de ajuda para localizar a página da lista, consulte Listando Alarmes.
A página Criar Alarme é aberta no modo Básico (a exibição padrão). As etapas a seguir descrevem como criar um alarme no modo Básico.
-
Informe um nome amigável para o alarme. Evite digitar informações confidenciais.
Esse nome é enviado como o título para notificações relacionadas a esse alarme, a menos que você especifique um título de notificação (Assunto de notificação na Console).
O tipo de assinatura determina a renderização do nome do alarme ou do título da notificação.
- Para notificações por e-mail, o nome ou o título da notificação faz parte da linha de assunto.
- Para notificações HTTPS, o nome ou o título da notificação é o campo de título da mensagem publicada.
- Para notificações PagerDuty, o nome ou o título da notificação é usado no campo de título da mensagem publicada.
- Para mensagens do Slack, o nome ou o título da notificação faz parte do título.
- Para mensagens SMS, o nome ou o título da notificação faz parte da mensagem.
- (Opcional) Para Resumo de alarmes, informe um resumo de alarme personalizado, usando variáveis dinâmicas, se desejar.
O campo Resumo do alarme corresponde ao parâmetro de mensagem de alarme
alarmSummary
. Para obter informações sobre a aparência padrão do parâmetro em mensagens formatadas, consulte Formato de Mensagem de Alarme.Exemplo com variáveis dinâmicas:
{{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}
Para procurar variáveis dinâmicas de um parâmetro, consulte Variáveis Dinâmicas.
Você pode desativar o escape 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 HTML desativado, informe a variável dinâmica{{{query}}}
. -
Na área Descrição da métrica, informe valores para especificar a métrica a ser avaliada para o alarme.
- Compartimento: Selecione o compartimento que contém os recursos que emitem as métricas avaliadas pelo alarme. O compartimento selecionado é também o local de armazenamento do alarme. Por padrão, o primeiro compartimento acessível é selecionado.
- Namespace da métrica: Selecione o serviço ou aplicativo que emite as métricas para os recursos que você deseja monitorar. A lista Namespace de métricas mostra namespaces de métricas para o compartimento selecionado. Por exemplo, se o compartimento atual contiver balanceadores de carga, a lista incluirá oci_lbaas.
- Grupo do recurso: Selecione o grupo ao qual a métrica pertence. Um grupo de recursos é uma string personalizada fornecida com uma métrica personalizada e não é aplicável às métricas de serviço.
- Nome da métrica: Selecione o nome da métrica que você deseja avaliar para o alarme. Você poderá selecionar qualquer métrica ou métrica personalizada do OCI se os dados existirem no compartimento e no namespace de métricas selecionados.
- Intervalo: Selecione a janela de agregação ou a frequência com que pontos de dados são agregados. Você pode criar um intervalo personalizado, se necessário. Consulte também Intervalo.
- Estatística: Selecione a função a ser usada para agregar os pontos de dados.
- mean - O valor de sum dividido por count durante o período especificado.
- rate - A taxa média de alteração por intervalo.
- sum - Todos os valores somados.
- max - O valor mais alto observado durante o período especificado.
- min - O valor mais baixo observado durante o período especificado.
- count - O número de observações recebidas no período especificado.
- P50 - O valor do 50º percentil.
- P90 - O valor do 90º percentil.
- P95 - O valor do 95º percentil.
- P99 - O valor do 99º percentil.
-
Na área Dimensões de métricas, especifique filtros opcionais para restringir os dados de métricas avaliados.
- Nome da dimensão: Selecione um qualificador especificado na definição da métrica. Por exemplo, a dimensão
resourceId
é especificada na definição da métrica paraCpuUtilization
. - Valor da dimensão: Selecione o valor a ser usado para a dimensão especificada. Por exemplo, se você tiver selecionado
resourceId
como a dimensão, selecione o identificador de recurso da instância que você está monitorando. - Dimensão adicional: Adicione outro par de nome/valor para uma dimensão, conforme necessário.
- Agregar fluxos de métricas: Marque esta caixa de seleção para retornar o valor combinado de todos os fluxos de métricas para a estatística selecionada.
- Nome da dimensão: Selecione um qualificador especificado na definição da métrica. Por exemplo, a dimensão
-
Na área Regra do acionador, especifique uma ou mais condições que devem ser atendidas para que o alarme esteja no estado de acionamento. Uma condição pode especificar um limite, como 90% para utilização da CPU, ou uma ausência.
- 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 dequery
. - Para adicionar outra regra de trigger (condição), selecione Regra de trigger adicional.
Observação
O gráfico na seção Regra de trigger exibe dinamicamente as últimas seis horas de métricas emitidas, de acordo com campos selecionados para a consulta. Valores muito pequenos ou grandes são indicados pelo Sistema Internacional de Unidades (unidades SI), como M para mega (10 à sexta potência). Para alternar exibições de dados no gráfico, consulte Alternando Exibições de Tabela e Gráfico para um Gráfico de Métricas de Alarme. -
Na área Destino em Definir notificações do alarme, selecione o provedor do destino a ser usado para notificações do alarme.
- Serviço de destino: Selecione um dos seguintes valores:
- Notificações: Envie notificações de alarme para um tópico. Cada assinatura no tópico recebe uma mensagem de alarme.
- Streaming: Envie mensagens de alarme para um stream.
Observação
Se você esperar mais de 60 mensagens por minuto, selecione Streaming. Para obter mais informações, consulte Limites de Mensagens de Alarme. - Compartimento: Selecione o compartimento que contém os recursos que emitem as métricas avaliadas pelo alarme. O compartimento selecionado é também o local de armazenamento do alarme. Por padrão, o primeiro compartimento acessível é selecionado.
- Stream (apenas para o serviço Streaming): O stream a ser usado para notificações de alarme.
- Tópico (para Notificações somente): O tópico a ser usado para notificações. Cada tópico é compatível com um ou mais protocolos de assinatura, como PagerDuty.
- (Opcional) Assunto de notificação (somente para Notificações): Título de notificação personalizado, usando variáveis dinâmicas, se desejar.
Exemplo com variáveis dinâmicas:
{{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}
Para procurar variáveis dinâmicas de um parâmetro, consulte Variáveis Dinâmicas.
Você pode desativar o escape 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 HTML desativado, informe a variável dinâmica{{{query}}}
.O tipo de assinatura determina a renderização do título da notificação (ou nome do alarme, se o título da notificação não for especificado).
- Para notificações por e-mail, o nome ou o título da notificação faz parte da linha de assunto.
- Para notificações HTTPS, o nome ou o título da notificação é o campo de título da mensagem publicada.
- Para notificações PagerDuty, o nome ou o título da notificação é usado no campo de título da mensagem publicada.
- Para mensagens do Slack, o nome ou o título da notificação faz parte do título.
- Para mensagens SMS, o nome ou o título da notificação faz parte da mensagem.
- Para criar um novo tópico (e uma nova assinatura) no compartimento selecionado, selecione Criar um tópico e insira os seguintes valores:
- Nome do tópico: Um nome amigável para o tópico. Por exemplo, informe: "Equipe de Operações" para um tópico usado para notificar a equipe de operações de alarmes de acionamento. Evite digitar informações confidenciais.
- Descrição de tópico: Descrição do novo tópico.
- Protocolo de assinatura: Médio de comunicação a ser usado para o novo tópico. Selecione o tipo de assinatura que deseja criar e, em seguida, informe valores nos campos associados. Para obter detalhes sobre cada tipo de assinatura, selecione os links.
- E-mail: Informe um endereço de e-mail.
- Função: Selecione o compartimento e o aplicativo que contêm a função desejada e, em seguida, selecione a função.
- HTTPS (URL Personalizado): Informe o URL que você deseja usar como ponto final.
- PagerDuty: Informe a parte da chave de integração do URL da assinatura PagerDuty. (As outras partes do URL são codificadas permanentemente.)
- Slack: Informe o ponto final do Slack, incluindo o token do webhook.
- SMS: Selecione o país para o número de telefone e digite o número de telefone, usando formato E.164. Exemplo: +14255550100
- Serviço de destino: Selecione um dos seguintes valores:
-
Para Agrupamento de mensagens, selecione uma das seguintes opções.
- Agrupar notificações entre streams de métrica: Rastreie coletivamente o status da métrica entre todos os streams de métrica. Envie uma mensagem quando o status da métrica for alterado em todos os streams de métricas.
- Dividir notificações por stream de métrica: Rastreie individualmente status de métrica por stream de métrica. Envie uma mensagem quando o status da métrica de cada stream de métrica for alterado. Para obter um exemplo, consulte Cenário: Dividir Mensagens por Stream de Métrica.
-
Para Formato da Mensagem, selecione uma opção para a aparência das mensagens que você recebe desse alarme (somente para Notificações).
- Enviar mensagens formatadas: Layout simplificado e amigável. Para exibir protocolos e tipos de mensagens de assinatura suportados para mensagens formatadas (opções que não sejam Brutas), consulte Formatação Amigável.
- Enviar mensagens Pretty JSON (texto sem formatação com quebras de linha): JSON com novas linhas e recuos.
- Enviar mensagens brutas: Blob JSON bruto.
- (Opcional) Para receber notificações em intervalos regulares quando o alarme estiver sendo acionado, selecione Repetir notificação? e, em seguida, especifique o período de espera antes de reenviar a notificação. Consulte Melhores Práticas para Seus Alarmes.
- (Opcional) Para suprimir avaliações e notificações por um período especificado, selecione Suprimir notificações. Esta opção é útil para evitar notificações por alarme durante os períodos de manutenção no sistema. Especifique uma hora inicial, uma hora final e uma descrição opcional. Consulte Melhores Práticas para Seus Alarmes e Suprimindo uma Única Alarme.
- (Opcional) Para salvar o alarme sem começar a avaliar dados de métrica, desmarque a caixa de seleção Ativar este alarme?.
- (Opcional) Adicione uma ou mais tags ao alarme: Selecione Mostrar opções avançadas para mostrar a seção Adicionar Tags.
Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
- Selecione Criar alarme.
A página Definições de Alarma lista o novo alarme. Se o alarme estiver ativado, o serviço Monitoring começará a avaliar a métrica configurada, enviando mensagens de alarme quando dados de métrica satisfizerem uma regra do trigger.
-
Na página de lista Definições de Alarme, selecione Criar Alarme. Se precisar de ajuda para localizar a página da lista, consulte Listando Alarmes.
Use o comando oci monitoring alarm create e os parâmetros obrigatórios para criar um alarme:
oci monitoring alarm create --compartment-id <compartment_OCID> --destinations <file_or_text> --display-name <name> --is-enabled <true_or_false> --metric-compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression> --severity <level>
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 CreateAlarm para criar um alarme.