Criando uma Consulta para uma Métrica Personalizada

Defina uma consulta para uma métrica personalizada no serviço Monitoring.

Para obter informações sobre métricas personalizadas, consulte Publicando Métricas Personalizadas Usando a API. Para diagnosticar e solucionar problemas de consulta, consulte Solucionando Problemas de Pesquisas.

Estas etapas mostram como criar uma consulta no modo Básico na página Explorador de Métricas. Para criar uma consulta no modo Avançado (MQL), consulte Editando a Expressão MQL para uma Consulta.
1. Crie uma consulta básica na página Explorador de Métrica.
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 personalizada desejada.
4. Selecione o namespace de métrica que contém a métrica personalizada que você deseja.
  Exemplo: mymetricsnamespace
5. (Opcional) Selecione o grupo de recurso que você deseja.
  Exemplo: divisionX
6. Selecione o nome da métrica personalizada.
  Exemplo: productOrder
7. (Opcional) Atualize o intervalo ou a estatística.
  Exemplo: Selecione 1 minuto para Intervalo e selecione Soma para Estatística.
8. Para exibir e atualizar a expressão MQL, selecione Modo Avançado.
  A expressão MQL está na caixa Editor de código da consulta. Exemplo:
  productOrder[1m].sum()
9. Selecione Atualizar Gráfico.
  O gráfico mostra pontos de dados para a métrica personalizada, em uma view de gráfico. Exemplo:
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.

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 --compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression>

O exemplo a seguir usa o parâmetro --from-json para recuperar informações de métrica personalizada com base em um arquivo JSON.

oci monitoring metric-data summarize-metrics-data --from-json file://./get-metrics.json [...]

Para obter uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Linha de Comandos para Monitoramento.

Exemplo de arquivo JSON para solicitação

Compare esse arquivo com o exemplo de dados da métrica publicada em Publicando Métricas Personalizadas Usando a API.

{
  "compartmentId": "$compartmentId",
  "endTime": "2023-01-08T20:00:00+00:00",
  "namespace": "mymetricsnamespace",
  "queryText": "productOrder[1m].sum()",
  "resolution": "5m",
  "resourceGroup": "divisionX",
  "startTime": "2023-01-07T23:00:00+00:00"
}

Exemplo de resposta

Esse exemplo de resposta inclui pontos de dados somente para a divisão de grupo de recursos X (produto ball, país NL). A agregação usa um intervalo de um minuto, resultando em três timestamps.

Compare essa resposta com o exemplo de dados da métrica publicada em Publicando Métricas Personalizadas Usando a API.

{
  "data": [
    {
      "aggregated-datapoints": [
        {
          "timestamp": "2023-01-08T09:20:00+00:00",
          "value": 100.0
        },
        {
          "timestamp": "2023-01-08T10:15:00+00:00",
          "value": 110.0
        },
        {
          "timestamp": "2023-01-08T10:25:00+00:00",
          "value": 30.0
        },
      "compartmentId": "$compartmentId",
      "dimensions": {
        "country": "NL",
        "product": "ball"
      },
      "metadata": {
        "category": "toys",
        "note": "national holiday"
      },
      "name": "productOrder",
      "namespace": "mymetricsnamespace",
      "resourceGroup": "divisionX"
    }
  ]
}

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

Documentação do Oracle Cloud Infrastructure

Criando uma Consulta para uma Métrica Personalizada