A New Relic Query Language (NRQL) é uma linguagem semelhante ao SQL para consultar seus dados do New Relic. A mesma linguagem de consulta que alimenta os gráficos e dashboards integrados do New Relic está disponível para você, para que possa criar as visualizações e os alertas de que sua equipe precisa.
Aqui está um vídeo para ajudar a introduzir o uso do NRQL, mostrando como encontrar uma consulta em um dashboard e modificá-la no criador de consulta. Para obter informações mais detalhadas sobre consultas, incluindo uma lista de cláusulas, funções e exemplos de consultas, consulte nossa referência do NRQL.
O que você pode fazer com a NRQL
Use a NRQL para:
- Crie gráficos que mostrem as taxas de transferência de transações, a taxa de erros ou a latência ao longo do tempo
- Responder a uma pergunta específica para efeitos de resolução de problemas ou análise de negócios
- Investigue um problema de desempenho consultando os eventos e atributos específicos envolvidos
- Configure alertas baseados em NRQL que são acionados quando uma métrica ultrapassa um limite
- Faça consultas de API para seus dados do New Relic, por exemplo, usando nossa API NerdGraph.
A NRQL funciona tanto para consultas básicas (buscando linhas brutas de dados de evento) quanto para resultados calculados, como funis baseados em como os usuários interagem com seu site ou aplicativo.
Dica
O New Relic usa o NRQL internamente para alimentar os gráficos e dashboards na plataforma New Relic. Essa mesma linguagem de consulta está disponível para você.
Tipos de dados consultáveis
NRQL permite consultar quase todos os tipos de nossos dados de telemetria, incluindo:
Dados de eventos de todos os produtos New Relic. Exemplos incluem:
- Evento APM, como
Transaction - Monitoramento de evento do Browser, como
PageView - Monitoramento de evento Mobile, como
Mobile - Evento de infraestrutura, como
ProcessSample - Evento sintético, like
SyntheticCheck - Evento personalizado, como aqueles reportados pela API de eventos
- Evento APM, como
O tipo de dados
Metric(métrica relatada pela API métrica e fontes de dados que usam essa API)O tipo de dados
Span(dados distributed tracing )O tipo de dados
Log(dados de nossos recursos de gerenciamento de logs)
Dica
Alguns dados, como relacionamentos entre entidades monitoradas, não estão disponíveis via NRQL, mas estão disponíveis usando nossa API NerdGraph.
Onde usar NRQL
A NRQL está disponível em toda a plataforma:
Acesse o criador de consulta por meio da gaveta Query your data na parte inferior de qualquer página New Relic para executar consultas e criar gráficos personalizados.
Você pode executar uma consulta NRQL no criador de consulta na plataforma. Esta consulta NRQL mostra uma contagem de spans de distributed tracing facetados por seus nomes de entidade.
Alertas baseados em NRQL são o principal tipo de alerta no New Relic. Para criar um, acesse one.newrelic.com > All capabilities > Alerts > Alert conditions (Policies) > (select a policy) > Add a condition, clique em NRQL e depois em Next, define thresholds.
Você também pode usar o NRQL com a nossa API NerdGraph. Isso permite que você execute consultas entre contas e consultas assíncronas que não estão disponíveis na interface.
Estrutura de consulta NRQL
O NRQL segue uma sintaxe estruturada baseada em cláusulas. Aqui está uma consulta NRQL que conta todas as transações na última hora:
SELECT count(*) FROM Transaction SINCE 1 hour agoAqui está um detalhamento de todas as cláusulas disponíveis:
SELECT function(attribute) [AS 'label'][, ...]
FROM data type
[WHERE attribute [comparison] [AND|OR ...]][AS 'label'][, ...]
[FACET attribute | function(attribute)]
[LIMIT number]
[SINCE time]
[UNTIL time]
[WITH TIMEZONE timezone]
[COMPARE WITH time]
[TIMESERIES time]Aqui estão as regras que o NRQL segue:
NRQL rule | Detalhes |
|---|---|
Valores obrigatórios | A cláusula |
Tamanho da string de consulta | A string de consulta deve ter menos de 4 KB. |
Sensibilidade a maiúsculas e minúsculas | Os nomes dos tipos de dados e os nomes dos atributos diferenciam maiúsculas de minúsculas. As cláusulas e funções da NRQL não diferenciam maiúsculas de minúsculas. |
Sintaxe para strings | O NRQL usa aspas simples para designar strings. O exemplo a seguir mostra a sintaxe: |
Nomes de eventos personalizados e atributos fora do padrão | Os eventos que reportamos por padrão têm nomes que contêm caracteres alfanuméricos, dois pontos ( |
Coerção de tipo de dados | Não oferecemos suporte ao tipo de dados "coerção". Para obter mais informações, consulte Conversão de tipo de dados. |
Para obter mais informações, consulte nossa referência NRQL para ajudar a criar suas consultas.
Próximos passos
- Como o NRQL funciona (execução de consulta, atualização de dados e limites)
- Gráficos e dashboards com NRQL (visualize os resultados da sua consulta)
- Tutorial guiado da NRQL (passo a passo prático para novos usuários)
- Referência do NRQL (sintaxe completa, cláusulas e funções)