Consulta métrica APM de dados de fração de tempo com NRQL

O APM reporta dados métricos na forma de dados métricos de frações de tempo, e você pode usar o NRQL para consultar e alertar sobre esse tipo de dados. Para explorar seus dados da fração de tempo, consulte Explorar sua métrica.

Por que consultar dados métricos de fração de tempo?

A New Relic reporta métricas de diversas maneiras. Uma variedade de dados métricos que chamamos de metric timeslice data; este é o tipo de dados usado para gerar muitos dos gráficos em APM, monitoramento de mobilee browser (para mais detalhes, veja métrica de fração de tempo data).

APMmétrica são automaticamente convertidas de dados métricos de fração de tempo para dados métricos dimensionais mais detalhados, o que os abre para consulta via NRQL e por meio de nossa API NerdGraph. Esse recurso permite criar visualizações personalizadas poderosas e detalhadas dessas importantes métricas de APM. E isto inclui poder consultar a sua métrica personalizada.

Onde consultar?

Recomendamos consultar dados de métrica de fração de tempo do APM usando nosso criador de consulta. Essa experiência oferece funcionalidade NRQL completa e também fornece sugestões úteis de preenchimento automático e feedback sobre erros de consulta.

Você também pode:

• Faça consulta NRQL usando nossa API NerdGraph (GraphQL)
• Alerta sobre consulta de NRQL usando NRQL condição do alerta

Como construir uma consulta

No APM, alguns gráficos têm a opção de visualizar a consulta NRQL que gerou aquele gráfico. Este é um bom ponto de partida para entender como consultar métricas. A consulta NRQL abaixo foi ligeiramente modificada em relação ao gráfico de taxa de erros na página de resumo APM.

FROM Metric
  SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE (entity.guid = 'AN_ENTITY_GUID')
  AND (transactionType = 'Web')
  SINCE 1 day ago TIMESERIES

Aqui está um detalhamento de como as partes desta consulta funcionam:

Para obter informações gerais sobre a sintaxe NRQL, incluindo FROM, FACET e TIMESERIES, consulte Introdução ao NRQL.

Para mais dúvidas, veja exemplos de consulta.

Como os dados de métrica de fração de tempo são convertidos

A conversão da métrica de fatia de tempo APMoriginal em métrica dimensional que está disponível para consulta é um processo contínuo e não está completo. Se você não encontrar a métrica que procura nesta seção, consulte Consulta genérica.

Veja como as métricas de intervalo de tempo APM originais são convertidas em métricas dimensionais:

Algumas das métricas APM disponibilizadas como métrica dimensional:

Saiba como ver todas as métricas disponíveis para você. Para obter a unidade métrica para um determinado nome de métrica, você pode usar uma consulta como:

FROM Metric
  SELECT unit
  WHERE appName = 'YOUR_APP_NAME'
  AND metricName = 'METRIC_NAME'

Para entender mais sobre a estrutura geral dos dados de métrica de frações de tempo, incluindo alguns exemplos comuns, consulte dados de métrica de frações de tempo.

Atributo

Esses atributos estão disponíveis além dos atributos específicos da métrica listados na tabela de métricas APMacima.

Visão geral métrica

As métricas de visão geral permitem que você obtenha um detalhamento de onde o tempo é gasto durante a execução. Essas métricas são únicas em alguns aspectos:

• Eles são uma combinação de muitas fatias de tempo.
• Eles foram projetados para funcionar somente com a função agregadora average .
• O código executado simultaneamente mostrará o tempo de execução combinado.

Por exemplo, se o seu serviço chamar um banco de dados MySQL em 3 threads simultâneos com um tempo médio de resposta de 0,1 segundos para cada thread, o segmento MySQL aparecerá como 0,3.

Várias métricas de visão geral são fornecidas para diferentes propósitos:

Consulta genérica com o newrelic.timeslice.value

Para métricas que não foram convertidas para métrica dimensional, ou para sua própria métrica personalizada, temos uma métrica dimensional denominada newrelic.timeslice.value.

Quando usar newrelic.timeslice.value

Dado o nome de uma métrica de frações de tempo, você pode consultá-la para ver se ela possui uma métrica dimensional convertida equivalente com esta sintaxe:

FROM Metric
SELECT uniques(metricName)
WHERE metricTimesliceName = 'Datastore/statement/MySQL/test/select'

Se o único nome da métrica retornado for newrelic.timeslice.value, você precisará consultar seus dados usando esta abordagem geral.

Obtenha métricas disponíveis

Para obter uma lista de métricas disponíveis para uma aplicação, você pode usar uma consulta como:

SELECT uniques(metricTimesliceName) 
FROM Metric WHERE appName='YOUR_APP_NAME' 
AND newrelic.timeslice.value IS NOT NULL

Faceta em um segmento de nome de métrica curinga

Alguns nomes de métrica de fração de tempo incluem valores de atributo como segmentos do nome da métrica. Por exemplo, nossa métrica de relatório de agente APMrastreia a duração das chamadas externas usando este formato:

External/{externalHost}/all

Aqui, {externalHost} representa o nome do host da chamada de rede de saída.

Aqui está um exemplo de uma consulta newrelic.timeslice.value genérica de uma métrica personalizada que delimita um segmento de métrica curinga:

FROM Metric SELECT count(newrelic.timeslice.value) 
  WHERE appName = 'MY APP' 
  WITH METRIC_FORMAT 'Custom/Labels/{action}' 
  TIMESERIES FACET action

Nesta consulta, {action} cria um atributo temporário, action, que é então usado por FACET action. Você pode usar qualquer nome que desejar, porque é apenas um atributo que existe durante a consulta. Você deve escolher um nome que não entre em conflito com um nome de atributo existente.

Funções agregadoras recomendadas

As funções recomendadas do agregador NRQL incluem:

• apdex
• average
• sum
• count
• rate
• uniques

Exemplos de consulta

Alguns exemplos de consulta de dados de métrica de fração de tempo:

FROM Metric
  SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'Web throughput' 
  WHERE appName IN ('MY_APPLICATION', 'MY_OTHER_APPLICATION')
  AND (transactionType = 'Web')
  FACET appName
  TIMESERIES

FROM Metric 
  SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'HttpDispatcher requests_per_minute' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web')
  TIMESERIES SINCE 3 days ago

FROM Metric 
  SELECT count(apm.service.transaction.duration) as 'HttpDispatcher requests_per_minute' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web')
  TIMESERIES SINCE 3 hours ago 
  FACET host 
  LIMIT 20

FROM Metric
  SELECT average(apm.service.transaction.duration) as 'HttpDispatcher average duration' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web') 
  TIMESERIES SINCE 3 days ago

FROM Metric 
  SELECT average(newrelic.timeslice.value, exclusiveTime: true) as 'duration, seconds' 
  WHERE appName = 'MY_APPLICATION' 
  AND scope = 'Controller/users/show'
  LIMIT 20 
  FACET metricTimesliceName
  TIMESERIES SINCE 3 days ago