Criando uma Consulta

Defina uma consulta para recuperar dados do Monitoring.

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

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

  • Observação

    Para começar com uma consulta de serviço predefinida, veja Explorando um Gráfico de Métricas Padrão.

    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 selecione Observabilidade e Gerenciamento. Em Monitoramento, selecione Explorador de Métricas.
      A página Explorador de Métricas exibe um gráfico vazio com campos para criar uma consulta.
    2. Na barra de navegação, selecione a região que contém os dados de métrica desejados.
      Para obter mais informações sobre regiões, consulte Entender as Regiões e Como Trabalhar entre Regiões.
    3. Na consulta no gráfico, selecione o compartimento que contém a métrica que você deseja.
    4. Selecione o namespace de métricas que contém a métrica que você deseja.
      Observação

      A lista Namespace de métricas mostra namespaces de métrica 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 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.
    8. (Opcional) Para agregar streams de métrica, selecione Agregar streams de métrica.
    9. Selecione 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, selecione Mostrar Tabela de Dados.
      O gráfico mostra pontos de dados para a métrica personalizada, em uma view de tabela.

    Para obter informações sobre como editar diretamente expressões MQL ou alterar consultas usando a CLI ou 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 aspa dupla 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 CLI, consulte a Referência de Linha de Comandos para Monitoramento.

  • Execute a operação SummarizeMetricsData para consultar dados de métrica.