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 de 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 detalhes do recurso na Console. Consulte Exibindo Gráficos de Métrica Padrão para um Único Recurso.

Para solucionar problemas de consulta, consulte Diagnosticando e Solucionando Problemas de Consultas.

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étricas selecionando uma dimensão específica do recurso. Para edições de consulta de alarme, consulte Criando um Alarme Básico.

    1. Crie uma consulta básica na página Explorador de Métricas.
    2. Se a consulta não estiver aberta, abra-a clicando em 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 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: 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. Clique em Modo Avançado.
      2. Edite o texto na caixa Query code editor.
    5. Clique em 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 da CLI, consulte a Referência de Linha de Comando para o Serviço Monitoring.

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