• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Comece com NRQL: a linguagem dos dados

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 SELECT e a cláusula FROM são obrigatórias. Todas as outras cláusulas são opcionais. Você pode iniciar sua consulta com SELECT ou FROM.

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 nomes dos atributos diferenciam maiúsculas de minúsculas.
  • Cláusulas e funções NRQL não diferenciam maiúsculas de minúsculas.

Sintaxe para strings

NRQL usa aspas simples para designar strings. Por exemplo:

... where traceId = '030a573f0df02c57'

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 (:) e sublinhados (_). nomes de atributo podem ter esses caracteres e pontos (.). Os nomes relatados por padrão começam com uma letra. Nomes personalizados que não seguem essas diretrizes devem ser colocados entre crases na consulta NRQL. Por exemplo:

... FACET `Logged-in user`

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:

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.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.