Consulte o tipo de dados métricos

Quando métricas são reportadas ao New Relic por meio da API métrica (inclusive de integração que usa essa API), os dados são reportados como o tipo de dadosMetric e ficam disponíveis para consulta.

Este documento explica:

• Como visualizar e consultar sua métrica
• Exemplo de consulta métrica
• Como consultar múltiplas métricas com curingas
• Como explorar dados métricos

Consulta APM métrica de fração de tempo data

O APM reporta um tipo específico de dados que chamamos de dados métricos de fração de tempo. Para saber como consultar isso, consulte consulta métrica de dados de fração de tempo.

Para obter informações sobre outros tipos de métricas, consulte tipos de dados métricos.

Visualize e consulte sua métrica

Você pode utilizar o NRQL para consultar seus dados métricos no criador de consulta ou utilizando nossa API NerdGraph.

Para consultar uma métrica, você pode usar o seguinte formato de consulta:

FROM Metric SELECT function(metric_name) WHERE attribute=value FACET attribute TIMESERIES

Para obter informações sobre quais funções são suportadas para quais tipos de dados métricos, consulte estrutura de dados métricos.

Adicione os nomes da métrica que você deseja representar no gráfico com a função de valor apropriada na cláusula SELECT . As cláusulas WHERE e FACET podem ser usadas com valores de atributo. Lembre-se de incluir a palavra-chave TIMESERIES se quiser mapear os dados.

Este exemplo demonstra como você pode representar graficamente o uso da CPU em segundos para o cluster foo . Esta consulta divide o uso da CPU por contêiner, dada uma métrica count chamada container_cpu_usage_seconds_total com o atributo containerName e clusterName:

FROM Metric select sum(container_cpu_usage_seconds_total) 
  WHERE clusterName = 'foo' 
  FACET containerName 
  TIMESERIES

Se você quiser o uso da CPU por minuto (a taxa de alteração), poderá adicionar a função de taxa à consulta acima.

FROM Metric select rate(sum(container_cpu_usage_seconds_total), 1 minute) 
  WHERE clusterName = 'foo' 
  FACET containerName 
  TIMESERIES

Veja exemplo de consulta métrica

Os exemplos anteriores demonstram formas básicas de consulta métrica, mas o NRQL também pode ser usado para mapear, explorar e analisar dados métricos.

FROM Metric 
  SELECT latest(container_memory_usage_bytes), latest(container_spec_memory_limit_bytes) 
  WHERE containerName = 'inventory' 
  TIMESERIES

FROM Metric 
  SELECT (latest(container_spec_memory_limit_bytes) - latest(container_memory_usage_bytes)) 
    / latest(container_spec_memory_limit_bytes) 
    * 100 
    AS '% Memory Available' 
  WHERE containerName = 'inventory' 
  TIMESERIES

FROM Metric 
  SELECT filter(
    latest(
      container_memory_usage_bytes), 
    WHERE containerName = 'discovery') 
  + filter(
    latest(
      container_memory_usage_bytes), 
    WHERE containerName = 'my-proxy') 
  AS 'Total (k8s)' 
  WHERE clusterName = 'my-cluster' AND podName LIKE 'my-pilot-%' 
  TIMESERIES

FROM Metric SELECT * WHERE metricName = 'container_fs_usage_bytes' LIMIT 20 RAW

Consulta múltipla métrica com curingas

Os curingas são representados em NRQL pelo caractere % . Se você quiser consultar múltiplas métricas que usam uma convenção de nomenclatura padrão, você pode usar o recurso curinga para retornar resultados para todas elas sem precisar especificar o nome de cada métrica individualmente.

Os curingas podem ajudá-lo:

• Métrica agregada e traçar os resultados
• FACET resultados por nome de métrica em um gráfico
• Encontre e crie um gráfico de todas as métricas que correspondam a uma determinada convenção de nomenclatura

Os curingas são particularmente úteis se você adicionar posteriormente novas métricas que correspondam a uma convenção de nomenclatura existente. Ao usar % em vez de escrever o nome de cada métrica em sua consulta, você não precisará reescrever a consulta ao adicionar novas métricas.

Digamos que você tenha vários algoritmos que executam uma tarefa semelhante. Você pode definir as seguintes métricas, que mostram a duração dos diferentes algoritmos:

• myNeatProcess.algorithm1.duration
• myNeatProcess.algorithm2.duration
• myNeatProcess.algorithm3.duration

Se usado em uma consulta, myNeatProcess.%.duration retornará resultados para todos os três algoritmos acima. Se posteriormente você criar novos algoritmos chamados algorithm4, algorithm5 e algorithm6, a mesma consulta retornará resultados para todos os seis algoritmos.

FROM Metric 
    SELECT average(myNeatProcess.%.duration) 
    FACET metricName TIMESERIES

FROM Metric 
    SELECT average(myNeatProcess.%.duration) TIMESERIES

FROM Metric 
    SELECT myNeatProcess.algorithm1.duration / sum(myNeatProcess.%.duration) TIMESERIES

Retorne resultados para campos individuais usando getField()

Existem vários tipos de dados Metric (por exemplo, gauge e count) e cada tipo tem vários fields associados. Para obter detalhes sobre os tipos de campos disponíveis, consulte getField().

Você pode usar getField() para extrair esses campos. Por exemplo, se quiser usar um único valor em uma métrica para fazer uma comparação em uma cláusula WHERE , você pode usar getField(metricName, field) ou a sintaxe abreviada metricName[field].

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND getField(apm.service.transaction.duration, total) / getField(apm.service.transaction.duration, count) > 2

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND apm.service.transaction.duration[total] / apm.service.transaction.duration[count] > 2

FROM Metric 
SELECT uniques(metricName) 
WHERE getField(%, type) = 'gauge'

FROM Metric 
SELECT uniques(metricName) 
WHERE %[type] = 'gauge'

Explore dados métricos

As funções NRQL keyset e uniques podem ser utilizadas em conjunto com o atributo metricName (disponível em todas as métricas) para realizar tarefas como listar todas as métricas disponíveis em sua conta ou descobrir os atributos disponíveis em uma determinada métrica.

FROM Metric SELECT uniques(metricName)

FROM Metric SELECT uniques(metricName) WHERE hostname = 'host1.mycompany.com'

FROM Metric SELECT keyset() WHERE metricName = METRIC_NAME