Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

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:

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.

Importante

Não é possível consultar métricas de timelice em conjunto com métricas dimensionais ou dados de eventos. Qualquer consulta envolvendo métrica newrelic.timeslice.value ou apm.* só pode retornar métricas de APM.

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.

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.

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].

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.