Documentação do Oracle Cloud Infrastructure

Selecionando um Recurso para uma Consulta de Alarme

Limite os dados de métrica retornados a um recurso selecionando uma dimensão específica do recurso ao consultar dados de métrica para um alarme no serviço Monitoring.

As dimensões disponíveis variam de acordo com a métrica.

Esta página descreve como consultar métricas de um recurso por meio de dimensões específicas do recurso. Você também pode acessar gráficos de métrica específicos do recurso acessando a página de detalhes do recurso na Console e criando um alarme com base em uma consulta de serviço predefinida. Consulte Exibindo Gráficos de Métrica Padrão para um Único Recurso e Criando um Alarme com base em um Gráfico de Métricas Padrão.

Para solucionar problemas de alarme, consulte Diagnosticando e Solucionando Problemas de Alarmes. Consulte também Criando um Alarme Básico.

  • Para obter informações sobre como selecionar um recurso na página Explorador de Métricas, consulte Selecionando um Recurso para uma Consulta.

    1. Na página da 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 para os quais você deseja especificar dimensões estão selecionados.
    4. Para selecionar dimensões usando o modo Básico (padrão), vá para a área Dimensões de métrica e forneça os seguintes valores:

      Campos de dimensão adicionais ou outros são exibidos para alguns namespaces de métrica. Por exemplo, um campo de tipo de implantação aparece para o namespace de métricas oci_autonomous_database. Consulte a documentação específica do serviço para obter detalhes.

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

        Para selecionar um recurso específico no compartimento selecionado, filtre os resultados por uma dimensão específica do recurso, como o resourceDisplayName.

        Observação

        As listas longas de dimensões são reduzidas.

        • Para exibir dimensões por nome, digite um ou mais caracteres na caixa. Uma lista atualizada (reduzida) mostra os nomes das dimensões correspondentes.
        • Para recuperar todas as dimensões de uma métrica, consulte Listando Definições de Métrica.
      • 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.
    5. Para selecionar um recurso atualizando a expressão MQL, siga estas etapas:
      1. Na parte superior da página Editar alarme, selecione Alternar para Modo Avançado.
      2. Na área Descrição da métrica, dimensões e regra de acionamento, edite o texto na caixa Query code editor.
        Para referência, veja Consultando Dados de Métrica e Referência de MQL (Monitoring Query Language).
    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 um alarme. Use o parâmetro --query-text para selecionar dimensões específicas do recurso (parte da expressão MQL).

    oci monitoring alarm update --query-text <mql_expression> [...]

    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. Use o atributo query para selecionar dimensões específicas do recurso (parte da expressão MQL).