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.

    1. 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.
    2. 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.
    3. (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.

    4. 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.
    5. 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 para CpuUtilization.
      • 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.
    6. 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 de query.

      • 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.
    7. 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:
        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
    8. 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.
    9. 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.
    10. (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.
    11. (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.
    12. (Opcional) Para salvar o alarme sem começar a avaliar dados de métrica, desmarque a caixa de seleção Ativar este alarme?.
    13. (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.
    14. 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.

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