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 de recursos acessando a página de dados do recurso na Console e criando um alarme com base numa 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 diagnóstico e solução de 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 Metrics Explorer, consulte Selecting a Resource for a Query.

    1. Na página de 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 o qual você deseja especificar as 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é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 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 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 você 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 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, 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 CLI, consulte a Referência de Linha de Comandos para Monitoramento.

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