Documentação do Oracle Cloud Infrastructure

Selecionando um Recurso para uma Consulta

Limite os dados de métrica retornados a um recurso selecionando uma dimensão específica do recurso ao consultar dados da métrica 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 dados do recurso na Console. Consulte Exibindo Gráficos de Métrica Padrão para um Único Recurso.

Para diagnosticar e solucionar problemas de consulta, consulte Solucionando Problemas de Pesquisas.

Exemplos

Exemplo 1: Selecionando um Recurso por Nome
DiskIopsWritten[1m]{resourceDisplayName = "wordpress"}.rate()
Exemplo 2: Selecionando um Recurso por OCID
DiskIopsWritten[1m]{resourceId = "ocid1.instance.oc1.phx.exampleuniqueID"}.rate()

  • Esta seção descreve como selecionar um recurso na página Explorador de Métrica, selecionando uma dimensão específica do recurso. Para edições de consulta do alarme, consulte Criando uma Alarme Básico.

    1. Crie uma consulta básica na página Explorador de Métrica.
    2. Se a consulta não estiver aberta, abra-a selecionando Editar consultas.
    3. Para selecionar um recurso usando o modo Básico (padrão), forneça as informações a seguir.

      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: 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 de dimensão: O valor que você deseja usar para a dimensão especificada, por exemplo, o identificador de recurso de uma instância.
      • Dimensão adicional: Adiciona outro par de nome/valor para uma dimensão.
    4. Para selecionar um recurso, atualizando a expressão MQL, siga estas etapas:
      1. Selecione Modo avançado.
      2. Edite o texto na caixa Editor do código de pesquisa.
    5. Selecione Atualizar Gráfico.

  • Use o comando oci monitoring metric-data summarize-metrics-data e os parâmetros obrigatórios para consultar dados de métrica. Use o parâmetro --query-text para selecionar dimensões específicas do recurso (parte da expressão MQL).

    oci monitoring metric-data summarize-metrics-data --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 SummarizeMetricsData para consultar dados de métrica. Use o atributo query para selecionar dimensões específicas do recurso (parte da expressão MQL). Para obter um exemplo, consulte SummarizeMetricsDataDetails.