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étricas 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étricas Padrão para um Único Recurso e Criando um Alarme a partir de um Gráfico de Métricas Padrão.

Para solucionar problemas de alarme, consulte Diagnosticando e Solucionando Problemas de Alarmes.

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

    1. Abra o menu de navegação e clique em Observabilidade & Gerenciamento. Em Monitoring, clique em Definições do alarme.
    2. Clique no nome do alarme que deseja atualizar.
    3. Na página de detalhes do alarme, clique em Ações e selecione Editar alarme.
    4. 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.
    5. Para selecionar dimensões usando o modo Básico (padrão), vá para a área Dimensões de métricas e forneça os seguintes valores:

      Campos de dimensão adicionais ou outros aparecem 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 que seja 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ê selecionou 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.
    6. Para selecionar um recurso atualizando a expressão MQL, siga estas etapas:
      1. Na parte superior da página Editar alarme, clique em Alternar para o Modo Avançado.
      2. Na área Descrição da métrica, dimensões e regra de acionamento, edite o texto na caixa Editor de código de consulta.
        Para referência, consulte Consultando Dados de Métrica e Referência do Monitoring Query Language (MQL).
    7. Atualize outros valores para o alarme, conforme necessário.
      Para obter mais informações sobre os campos, consulte Criando um Alarme Básico.
    8. Clique em 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).