Criando uma Consulta

Defina uma consulta para recuperar dados do serviço Monitoring.

Para obter um exemplo de consulta, veja Exemplo de Consulta e Gráfico de Métricas.

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

  • Estas etapas mostram como criar uma consulta na página Explorador de Métricas, no modo Básico. Para criar uma consulta no modo Avançado (MQL), consulte Editando a Expressão MQL para uma Consulta.

    1. Abra o menu de navegação e clique em Observabilidade & Gerenciamento. Em Monitoramento, clique em Metrics Explorer.
      A página Explorador de Métricas exibe um gráfico vazio com campos para criar uma consulta.
    2. No cabeçalho da Console, selecione a região que contém os dados de métrica desejados.
      Para obter mais informações sobre regiões, consulte Noções Básicas e Trabalhando entre Regiões.
    3. Na consulta sob o gráfico, selecione o compartimento que contém a métrica desejada.
    4. Selecione o namespace de métrica que contém a métrica desejada.
      Observação

      A lista Namespace de métricas mostra namespaces de métricas para o compartimento selecionado. Por exemplo, se o compartimento atual contiver balanceadores de carga, a lista incluirá oci_lbaas.
    5. Selecione o nome da métrica.
    6. Atualize o intervalo ou a estatística conforme necessário.
    7. (Opcional) Para selecionar dimensões, forneça valores para os seguintes campos:
      • 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.
      • 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.
    8. (Opcional) Para agregar fluxos de métricas, selecione Agregar fluxos de métricas.
    9. Clique em Atualizar Gráfico.
      O gráfico mostra pontos de dados para a métrica personalizada, em uma view de gráfico. Exemplo:Streams e valores de métrica em um gráfico.
    10. (Opcional) Para alternar para uma view de tabela, clique em Mostrar Tabela de Dados.
      O gráfico mostra pontos de dados para a métrica personalizada, em uma exibição de tabela.

    Para obter informações sobre edição direta de expressões MQL ou alteração de consultas usando a CLI ou a API, consulte Editando a Expressão MQL para uma Consulta.

  • Use o comando oci monitoring metric-data summarize-metrics-data e os parâmetros obrigatórios para consultar dados de métrica:

    oci monitoring metric-data summarize-metrics-data [OPTIONS]

    Ao especificar um valor de dimensão na consulta (--query-text), coloque-o entre aspas duplas e escape cada aspas duplas com um caractere de barra invertida (\). Exemplo:

    oci monitoring metric-data summarize-metrics-data --compartment-id <compartment_OCID> --namespace oci_computeagent --query-text "CpuUtilization[1m]{resourceId = \"<instance_OCID>\"}.max()"

    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.