A New Relic consulta Language (NRQL) é uma ferramenta poderosa que você pode usar para consultar e compreender praticamente qualquer tipo de dados, mas pode parecer complicado à primeira vista. Não se preocupe! Aqui estão algumas informações para lhe dar uma compreensão básica do NRQL, incluindo o que é, como usá-lo e algumas dicas e truques que o ajudarão a aproveitar ao máximo sua consulta. Depois de aprender sobre NRQL, você poderá capturar e interpretar seus dados, permitindo dividir o quadro geral em partes facilmente compreensíveis e ajudando a identificar problemas à medida que eles ocorrem.
Aqui está um vídeo rápido para ajudar a apresentar 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 consulta, consulte nossa referência NRQL.
O que é NRQL?
NRQL é um acrônimo de linguagem de consulta New Relic. É uma linguagem de consulta semelhante ao ANSI SQL (consulte a sintaxe) e você pode usá-la para recuperar dados detalhados do New Relic para obter insights sobre seu aplicativo, hosts e atividades importantes para os negócios. NRQL pode ajudá-lo:
- Crie um novo gráfico
- Responder a uma pergunta específica para efeitos de resolução de problemas ou análise de negócios
- Configure alertas baseados em NRQL (nosso tipo de alerta principal e mais poderoso)
- Faça consulta API de dados New Relic (por exemplo, usando nossa API NerdGraph )
Você pode usar NRQL para criar consultas simples, como buscar linhas de dados em um formato tabular bruto que fornece informações sobre eventos individuais. Você também pode usar o NRQL para executar cálculos poderosos nos dados antes que eles sejam apresentados a você, como criar funis com base em como o usuário final interage com seu site ou aplicativo.
Usamos NRQL nos bastidores para gerar muitos dos gráficos e painéis em nossas experiências de interface selecionadas:
Construímos muitos dos gráficos e visualizações no New Relic usando NRQL. Você pode visualizar a consulta de um gráfico e editá-la para criar seu próprio gráfico personalizado como uma maneira rápida de começar a usar o NRQL.
Onde você pode usar o NRQL?
Você pode usar NRQL em toda a plataforma para acessar seus dados. Esses lugares incluem:
Dica
NRQL é uma das várias maneiras de consultar dados da New Relic. Para saber mais sobre todas as opções de consulta, consulte Consultar seus dados.
Como o NRQL é estruturado?
Se você já está familiarizado com a redação de consultas SQL, ficará feliz em saber que o NRQL tem muitas semelhanças. Aqui está uma análise rápida da estrutura de uma consulta NRQL:
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 | |
Sintaxe para strings | NRQL usa aspas simples para designar strings. Por exemplo: |
Nomes de eventos personalizados e atributos fora do padrão | Todos 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. |
Se precisar de mais informações, você pode conferir nossa referência NRQL para ajudá-lo a construir sua consulta.
Que dados você pode consultar com o NRQL?
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
Dados métricos de fração de tempo (relatados pela APM)
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.
Pronto para aprender mais? Temos informações sobre como usar NRQL e como usar gráficos e dashboard com NRQL. Se você quiser começar a usar NRQL, vá direto para nosso tutorial guiado de NRQL.