Criando um Alarme Básico
Crie um alarme básico no Monitoring para notificá-lo quando as métricas atenderem aos acionadores especificados.
Para solucionar problemas de alarme, consulte Diagnosticando e Solucionando Problemas de Alarmes.
-
Na página da 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 view 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 título para notificações relacionadas a esse alarme, a menos que você especifique um título de notificação (Assunto da 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 do alarme, digite 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 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}}}
. -
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 de métricas: Selecione o serviço ou o 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 de recursos: 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 do OCI ou métrica personalizada se os dados existirem no compartimento e no namespace de métrica selecionados.
- Intervalo: Selecione a janela de agregação ou a frequência com que os pontos de dados são agregados. Se necessário, você pode criar um intervalo personalizado. 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 está monitorando. - Dimensão adicional: Adicione outro par de nome/valor para uma dimensão, conforme necessário.
- Agregar streams de métrica: Marque esta caixa de seleção para retornar o valor combinado de todos os streams de métrica 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 Predicado.
- 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 de atraso do trigger, informe o número de minutos durante os quais a condição deve ser mantida antes de o alarme ser ativado.
- Para Gravidade do alarme, selecione o tipo percebido de resposta necessário quando o alarme estiver no estado de acionamento para essa condição (regra de acionamento).
- Para Corpo do alarme, informe o conteúdo legível da notificação para esta condição (regra do acionador).
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 acionamento exibe dinamicamente as últimas seis horas de métricas emitidas de acordo com os 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 de alarme, selecione o provedor do destino a ser usado para notificações de alarme.
- Destination service: Selecione um dos seguintes valores:
- Notifications: 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 (somente para o serviço Streaming): O stream a ser usado para notificações de alarme.
- Tópico (somente para o serviço Notifications): 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 da notificação (somente para Notificações): Título da 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 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}}}
.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 informe 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 do tópico: Descrição do novo tópico.
- Protocolo de assinatura: O meio de comunicação a ser usado para o novo tópico. Selecione o tipo de assinatura que você deseja criar e 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: Digite a parte da chave de integração do URL da assinatura PagerDuty. (As outras partes do URL são codificadas permanentemente.)
- Slack: Digite o ponto final do Slack, incluindo o token do webhook.
- SMS: Selecione o país do número de telefone e informe o número de telefone usando o formato E.164. Exemplo: +14255550100
- Destination service: Selecione um dos seguintes valores:
-
Para Agrupamento de mensagens, selecione uma das seguintes opções.
- Agrupar notificações em streams de métrica: Rastreie coletivamente o status da métrica em 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 o status da 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 recebidas desse alarme (somente para o serviço Notifications).
- Enviar mensagens formatadas: Layout simplificado e amigável. Para exibir protocolos de assinatura e tipos de mensagem suportados para mensagens formatadas (opções diferentes de Bruto), consulte Formatação amigável.
- Enviar mensagens Pretty JSON (texto bruto com quebras de linha): JSON com novas linhas e recuos.
- Enviar mensagens brutas: Blob de JSON bruto.
- (Opcional) Para receber notificações em intervalos regulares quando o alarme estiver sendo acionado, selecione Repetir notificação? e 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. Essa opção é útil para evitar notificações de alarme durante períodos de manutenção do sistema. Especifique um horário de início, um horário de término e uma descrição opcional. Consulte Melhores Práticas para Seus Alarmes e Suprimindo um Único 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) Para adicionar tags para o alarme, selecione Mostrar opções avançadas e informe uma ou mais 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 esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
- Selecione Criar alarme.
A página Definições de Alarme lista o novo alarme. Se o alarme estiver ativado, o Monitoring começará a avaliar a métrica configurada, enviando mensagens de alarme quando os dados da métrica atenderem a uma regra de trigger.
-
Na página da 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 da CLI, consulte a Referência de Linha de Comando para o Serviço Monitoring.
Execute a operação CreateAlarm para criar um alarme.