Como consultar com NRQL: a mecânica da consulta

Antes de usar qualquer ferramenta, é melhor saber como usá-la. Existe um processo de criação, estruturação e redação de consultas com NRQL. Compreender as regras de consulta com NRQL permite que você aproveite ao máximo seus dados. Mesmo que você nunca tenha consultado nada antes, apenas um entendimento básico das regras permite acessar (quase) todos os dados que você precisa e visualizá-los em gráficos e dashboards.

Exploração de dados

Uma das melhores maneiras de aprender a usar o NRQL é acessar uma ferramenta de consulta da New Relic e utilizá-la para consultar seus dados. Aqui está um exemplo de exploração de seus dados usando o criador de consulta e as entradas sugeridas da interface.

A consulta começa com FROM seguido de um espaço. A interface sugere os tipos de dados disponíveis e você seleciona Transaction nessa lista.

Em seguida, escolha um atributo usando SELECT e a consulta terá a seguinte aparência:

FROM Transaction SELECT

Pressionar espaço novamente faz com que a interface sugira atributos disponíveis. No exemplo abaixo, você escolhe appId.

Isso resulta em uma consulta NRQL muito básica usando a cláusula e a instrução obrigatórias (FROM e SELECT) e fornece uma lista de APMtransações e os appId associados para cada uma, conforme mostrado abaixo.

Outra ótima maneira de explorar seus dados é acessar qualquer painel existente, clicar em View query e executar seu gráfico no criador de consulta.

Exemplos de consulta NRQL

Aqui está um exemplo de uma consulta NRQL um pouco mais aprofundada de dados Transaction relatados pelo APM. Para esta consulta:

• Você escolhe Transaction como o tipo de dados.
• Você usa Select para determinar a duração média.
• Você agrupa os resultados por appName usando Facet.
• Você usa Timeseries para exibir os dados em um intervalo de tempo automatizado.

FROM Transaction 
SELECT average(duration) 
  FACET appName 
  TIMESERIES auto

Isso gera um gráfico semelhante a:

Aqui estão mais alguns exemplos de consulta:

SELECT uniqueCount(user) FROM PageView 
  WHERE userAgentOS = 'Mac' 
  FACET countryCode
  SINCE 1 day ago 
  LIMIT 20

SELECT count(*)
 FROM Transaction
 FACET `Logged-in user`

SELECT count(*) FROM Transaction, PageView SINCE 3 days ago

SELECT function(attribute), function(attribute) ...
  FROM ...

SELECT min(duration), max(duration), average(duration)
  FROM PageView SINCE 1 week ago

Pronto para aprender mais? Não deixe de conferir nossa introdução ao NRQL, caso ainda não o tenha feito, ou aprenda como usar gráficos e painel com NRQL. Se você quiser começar a usar NRQL imediatamente, vá direto para nosso tutorial guiado de NRQL.