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 solucionar problemas de consulta, veja Diagnosticando e Solucionando Problemas de Consultas.

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étricas.
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 Entender as Regiões e Como Trabalhar entre Regiões.
3. Na consulta abaixo do 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 desejada.
  Exemplo: mymetricsnamespace
5. (Opcional) Selecione o grupo de recursos desejado.
  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ódigos de consultas. 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. Por 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 da CLI, consulte a Referência de Linha de Comando para o Serviço Monitoring.

Exemplo de arquivo JSON para solicitação

Compare esse arquivo com o exemplo de dados de métrica postados 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 de métrica postados 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