Referência NRQL

Se você é novo no New Relic e deseja ver como pode ser fácil usar o NRQL, você pode começar a usar a plataforma gratuitamente e seguir o tutorial. Tudo o que tem a fazer é:

1. Se ainda não o fez, crie sua conta New Relic gratuita abaixo para começar a monitorar seus dados hoje mesmo.

2. Use nosso agente e integração para coletar automaticamente dados de estruturas e ferramentas comuns.

3. Visite o guia de lançamento rápido para obter um caminho recomendado sobre como configurar New Relic. Você pode começar a ingerir dados para consulta e estar pronto para usar este ou qualquer um de nossos tutoriais.

SELECT attribute ...

SELECT function(attribute) ...

O SELECT especifica qual parte de um tipo de dados você deseja consultar especificando um atributo ou uma função. É seguido por um ou mais argumentos separados por vírgulas. Em cada argumento você pode:

• Obtenha os valores de todos os atributos disponíveis usando * como curinga. Por exemplo: SELECT * from Transaction.
• Obtenha valores associados a um atributo especificado ou a vários atributos especificados em uma lista separada por vírgulas.
• Obtenha valores agregados de um atributo especificado selecionando uma função agregadora.
• Rotule os resultados retornados em cada argumento com a cláusula AS .

Você também pode usar SELECT com funções matemáticas básicas.

SELECT average(duration) FROM PageView SINCE 1 week ago

SELECT ...
  FROM data type
  ...

Use a cláusula FROM para especificar o tipo de dados que você deseja consultar. Você pode iniciar sua consulta com FROM ou com SELECT. Você pode mesclar valores para o mesmo atributo em vários tipos de dados em uma lista separada por vírgulas.

SELECT count(*) FROM Transaction SINCE 7 days ago

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

SELECT ...
  AS 'label'
  ...

Use a cláusula AS para rotular um atributo, agregador, etapa de um funis ou o resultado de uma função matemática com uma string delimitada por aspas simples. O rótulo é usado no gráfico resultante. Observe que os rótulos de cláusula AS em gráficos de série temporal não serão exibidos se uma cláusula FACET for usada.

SELECT count(*)/uniqueCount(session) AS 'Pageviews per Session'
  FROM PageView

SELECT funnel(SESSION,
    WHERE name='Controller/about/main' AS 'Step 1',
    WHERE name = 'Controller/about/careers' AS 'Step 2')
    FROM PageView SINCE 1 week ago

SELECT ... (SINCE or UNTIL) (integer units) AGO
  COMPARE WITH (integer units) AGO
  ...

Use a cláusula COMPARE WITH para comparar os valores de dois intervalos de tempo diferentes.

COMPARE WITH requer uma instrução SINCE ou UNTIL . O horário especificado por COMPARE WITH é relativo ao horário especificado por SINCE ou UNTIL. Por exemplo, SINCE 1 day ago COMPARE WITH 1 day ago compara ontem com o dia anterior.

O intervalo de tempo para o valorCOMPARE WITH é sempre o mesmo especificado por SINCE ou UNTIL. Por exemplo, SINCE 2 hours ago COMPARE WITH 4 hours ago pode comparar das 15h às 17h com as 11h às 13h.

COMPARE WITH pode ser formatado como um gráfico de linhas ou um outdoor:

• Com TIMESERIES, COMPARE WITH cria um gráfico de linhas com a comparação mapeada ao longo do tempo.
• Sem TIMESERIES, COMPARE WITH gera um outdoor com o valor atual e a variação percentual do valor COMPARE WITH .

Example: esta consulta retorna dados como um gráfico de linhas mostrando o percentil 95 da semana anterior em comparação com o mesmo intervalo da semana anterior. Primeiro como um valor único e depois como um gráfico de linhas.

SELECT percentile(duration, 95) FROM PageView
  SINCE 1 week ago COMPARE WITH 1 week AGO

SELECT percentile(duration, 95) FROM PageView
  SINCE 1 week ago COMPARE WITH 1 week AGO TIMESERIES AUTO

Você pode usar esta cláusula com estes tipos de dados:

• Transaction

• TransactionError

• Evento personalizado reportado via APMAPI do agente

  O objetivo de EXTRAPOLATE é compensar matematicamente os efeitos da amostragem do agente APM de dados de eventos para que os resultados da consulta representem mais de perto a atividade total em seu sistema.

  Esta cláusula será útil quando um agente APM relata tantos eventos que muitas vezes ultrapassa os limites de relatórios do ciclo de coleta . Quando isso ocorre, o agente começa a amostrar o evento.

  Quando EXTRAPOLATE é usado em uma consulta NRQL que suporta seu uso, a proporção entre reported events e total events é usada para extrapolar uma grande aproximação do total de dados sem amostragem. Quando é utilizado numa consulta NRQL que não suporta a sua utilização ou que não utilizou dados amostrados, não tem efeito.

  Importante

  Observe que EXTRAPOLATE é mais útil para dados homogêneos (como taxas de transferência ou taxas de erros). Não é eficaz ao tentar extrapolar uma contagem de coisas distintas (como uniqueCount() ou uniques()).

  Esta cláusula funciona apenas com consultas NRQL que utilizam uma das seguintes funções agregadoras:

• apdex

• average

• count

• histogram

• sum

• percentage (se a função for tomada como argumento suporta EXTRAPOLATE)

• rate (se a função for tomada como argumento suporta EXTRAPOLATE)

• stddev

  Exemplo de extrapolação de taxas de transferência

  Uma consulta que mostrará as taxas de transferência extrapoladas de um serviço denominado interestingApplication.

  SELECT count(*) FROM Transaction WHERE appName='interestingApplication' SINCE 60 minutes ago EXTRAPOLATE

  Copiar

  Exemplo de extrapolação de taxas de transferência como uma série temporal

  Uma consulta que mostrará as taxas de transferência extrapoladas de um serviço denominado interestingApplication por nome de transação, exibidas como uma série temporal.

  SELECT count(*) FROM Transaction WHERE appName='interestingApplication'
  SINCE 60 minutes ago FACET name TIMESERIES 1 minute EXTRAPOLATE

  Copiar

SELECT ...
  FACET attribute
  ...

Use FACET para separar e agrupar seus resultados por valores de atributo. Por exemplo, você poderia FACET seus PageView dados por deviceType para descobrir qual porcentagem do seu tráfego vem de dispositivos móveis, tablets e desktops.

Use a cláusula LIMIT para especificar quantas facetas aparecem (o padrão é 10). Para agrupamentos mais complexos, use FACET CASES. As cláusulas FACET suportam até cinco atributos, separados por vírgulas.

Os aspectos são classificados em ordem decrescente pelo primeiro campo fornecido na cláusula SELECT . Caso você esteja facetando um atributo com mais de 5.000 valores exclusivos, um subconjunto de valores de faceta é selecionado e ordenado de acordo com o tipo de consulta. Observe que se um gráfico de série temporal não retornar dados (NRQL não corresponde a dados correspondentes, NRQL inválido etc.), ele mostrará apenas uma linha plana com o rótulo correspondente à primeira tabela na cláusula FROM .

Ao selecionar min(), max(), percentile(), average() ou count(), FACET usa essas funções para determinar como as facetas são escolhidas e classificadas. Ao selecionar qualquer outra função, FACET usa a frequência do atributo que você está facetando para determinar como as facetas são selecionadas e classificadas.

SELECT count(*) FROM PageView FACET city

SELECT uniqueCount(pageUrl) FROM PageView FACET city

FROM Event SELECT average(attribute) FACET name

FROM Event SELECT attribute, name WHERE attribute IS NOT NULL

Use FACET ... AS para nomear facetas usando a palavra-chave AS na consulta. Esta cláusula é útil para adicionar nomes mais claros ou simplificados para facetas nos seus resultados. Também pode ser usado para renomear facetas em consultas de agregação aninhadas .

FACET ... AS consulta alterará os nomes das facetas nos resultados (quando aparecem como cabeçalhos nas tabelas, por exemplo), mas não os próprios nomes das facetas.

FROM Transaction SELECT count(*) FACET response.headers.contentType AS 'content type'

SELECT ...
  FACET CASES (
    WHERE attribute operator value, WHERE attribute operator value, ...
    )
  ...

Use FACET CASES para dividir seus dados por condições mais complexas do que é possível com FACET. Separe diversas condições com uma vírgula ,. Por exemplo, você pode consultar seus dados de PageView e FACET CASES em categorias como menos de 1 segundo, de 1 a 10 segundos e mais de 10 segundos. Você pode combinar vários atributos em seus casos e rotular os casos com o seletor AS . Os pontos de dados serão adicionados a no máximo um caso de faceta, o primeiro caso de faceta que eles corresponderem.

Você também pode usar uma função de tempo com seu atributo e usar o operador OR para facetar resultados que não correspondam a nenhum dos casos especificados.

SELECT count(*) FROM PageView FACET CASES (WHERE duration < 1, WHERE duration > 1 and duration < 10, WHERE duration > 10)

SELECT count(*) FROM Transaction FACET CASES (WHERE name LIKE '%login%', WHERE name LIKE '%feature%' AND customer_type='Paid')

SELECT count(*) FROM Transaction FACET CASES (WHERE name LIKE '%login%' AS 'Total Logins', WHERE name LIKE '%feature%' AND customer_type='Paid' AS 'Feature Visits from Paid Users')

SELECT count(*) FROM Transaction FACET CASES (WHERE name LIKE '%login%', WHERE name LIKE '%feature%' AND customer_type='Paid') OR name

No NRQL, o padrão é a primeira agregação na cláusula SELECT para orientar a seleção de aspectos em uma consulta. FACET ... ORDER BY permite substituir esse comportamento padrão adicionando uma função agregada com o modificador ORDER BY para especificar como as facetas são selecionadas. Especificamente, a cláusula substituirá a prioridade pela qual as facetas são escolhidas para estarem no resultado final antes de serem limitadas pela cláusula LIMIT . Esta cláusula pode ser usada em consultas, mas não para alertas ou streaming.

Este exemplo mostra como usar FACET ... ORDER BY para encontrar as durações médias de transação de aplicativos, mostrando as 10 durações mais altas (limite padrão) por aplicativos que têm o maior tamanho de resposta. Nesse caso, se FACET ... ORDER BY não for usado, os resultados da consulta mostrarão os 10 primeiros pelas durações mais altas, sendo o tamanho da resposta irrelevante para a seleção do aplicativo.

FROM Transaction SELECT average(duration) TIMESERIES FACET appName ORDER BY max(responseSize)

Tenha em mente que se você usar a cláusula FACET ... ORDER BY , não poderá alterar a ordem de classificação adicionando os modificadores ASC e DESC . Por padrão, esta cláusula usa DESC.

Use a cláusula JOIN para combinar dados de um tipo de evento com os resultados de uma subconsulta baseada em um atributo ou chave comum.

FROM Event [INNER|LEFT] JOIN (SELECT... FROM...) ON [key =] key SELECT ...

Existem algumas regras simples para junções de subconsulta:

• A cláusula JOIN deve sempre seguir imediatamente após a cláusula FROM .
• Prefixar um tipo de junção (INNER ou LEFT) é opcional. Quando omitido, o tipo de junção é padronizado como INNER.
• Parênteses contendo uma subconsulta devem seguir imediatamente JOIN.
• A cláusula ON deve seguir imediatamente a subconsulta.

Restrições e limitações a considerar:

• A subconsulta unida continuará a ter um LIMIT padrão de 10, com um máximo de LIMIT de 5.000. Observe que o LIMIT da consulta externa não afeta a consulta interna.
• O uso de TIMESERIES na subconsulta unida não é compatível. Se sua consulta externa usar TIMESERIES, lembre-se de que a subconsulta unida fornecerá um único resultado para todo o intervalo de tempo da consulta.
• Como todas as subconsultas, as subconsultas unidas não podem ser utilizadas na condição do alerta.
• Embora SELECT * seja compatível com a consulta pai, ele não é compatível com a subconsulta unida.
• A cardinalidade da junção é limitada a 1:100, o que significa que uma única chave de junção não pode mapear mais de cem linhas no resultado da subconsulta.

Para uma análise aprofundada da cláusula JOIN, consulte o tutorial de junções de subconsulta NRQL .

INNER JOIN com uma subconsulta facetada

Esta consulta encontra a contagem de eventos facetados por browserTransactionName do tipo de evento PageView e depois por currentUrl do tipo de evento PageAction . Isso une os dois tipos de eventos com base em valores de atributo session comuns.

FROM PageView
JOIN (FROM PageAction SELECT count(*) FACET session, currentUrl) ON session
SELECT count(*) FACET browserTransactionName, currentUrl

Copiar

LEFT JOIN com uma subconsulta facetada

Este exemplo consulta os mesmos dados do exemplo INNER JOIN facetado, mas como uma consulta LEFT JOIN , os resultados incluem itens na tabela PageView que não possuem valores session correspondentes nos resultados da subconsulta PageAction .

FROM PageView
LEFT JOIN (FROM PageAction SELECT count(*) FACET session, currentUrl) ON session
SELECT count(*) FACET browserTransactionName, currentUrl

Copiar

INNER JOIN com uma subconsulta não agregada

Aqui estamos realizando uma subconsulta não agregada em linhas, com a consulta externa encontrando a contagem de eventos facetados por currentUrl do tipo de evento PageAction e depois por browserTransactionNamed do tipo de evento PageView . Isso une os dois tipos de eventos com base em valores de atributo session comuns.

Observe que o valor session 34d5ce6acf4c60be possui dois valores browserTransactionName do tipo de evento PageView da subconsulta, adicionando linhas adicionais ao resultado.

FROM PageAction
left JOIN (FROM PageView SELECT session, browserTransactionName LIMIT MAX) ON session
SELECT count(*) FACET session, currentUrl, browserTransactionName LIMIT MAX

Copiar

SELECT ...
  LIMIT count
  ...

Use a cláusula LIMIT para controlar o número máximo de valores de faceta retornados por FACET consulta ou o número máximo de itens retornados por SELECT * consulta. Esta cláusula usa um único valor inteiro como argumento. Se a cláusula LIMIT não for especificada ou nenhum valor for fornecido, o limite será padronizado como 10 para FACET consulta e 100 no caso de SELECT * consulta.

O valor máximo permitido para a cláusula LIMIT é 5.000. consulta pode usar a cláusula LIMIT MAX em vez de um valor específico, cujo padrão é automaticamente o valor máximo atual. Você pode usar isso se quiser sempre postar o número máximo de resultados, mesmo que isso mude no futuro. Se quiser que o comportamento da sua consulta permaneça inalterado, especifique um valor explícito em vez de usar LIMIT MAX.

SELECT uniqueCount(session), percentile(duration, 95)
  FROM PageView WHERE userAgentOS = 'Windows'
  FACET countryCode LIMIT 20 SINCE YESTERDAY

SELECT ...
  LIMIT count OFFSET count
  ...

Use a cláusula OFFSET com LIMIT para controlar a parte das linhas retornadas por SELECT * ou SELECT column consulta. Assim como a cláusula LIMIT , OFFSET usa um único valor inteiro como argumento. OFFSET define o número de linhas a serem ignoradas antes que as linhas selecionadas da sua consulta sejam retornadas. Isso é limitado por LIMIT.

OFFSET as linhas são ignoradas a partir do registro mais recente.

Por exemplo, a consulta SELECT interestingValue FROM Minute_Report LIMIT 5 OFFSET 1 retorna os últimos 5 valores de Minute_Report exceto o mais recente.

A cláusula ORDER BY permite especificar como deseja ordenar os resultados da consulta em consultas que selecionam evento atributo por linha.

Esta consulta ordena dois atributos de transação específicos por duração.

FROM Transaction SELECT appName, duration ORDER BY duration

A ordem de classificação padrão é crescente, mas isso pode ser alterado adicionando os modificadores ASC ou DESC .

Esta consulta ordena todos os atributos de transação por duração em ordem decrescente.

FROM Transaction SELECT * ORDER BY duration DESC

SHOW EVENT TYPES...

SHOW EVENT TYPES retornará uma lista de todos os tipos de dados presentes em sua conta para um intervalo de tempo específico. É usado como a primeira cláusula em uma consulta em vez de SELECT.

SHOW EVENT TYPES SINCE 1 day ago

SELECT ...
  SINCE [numerical units AGO | phrase]
  ...

O valor default é 1 hour ago.

Use a cláusula SINCE para definir o início inclusivo de um intervalo de tempo para os dados retornados. Você pode especificar um fuso horário para a consulta, mas não para os resultados. Os resultados do NRQL são baseados na hora do sistema.

Ao usar NRQL, você pode definir um timestamp /hora UTC , uma hora relativa ou uma string DateTime. Consulte Especificando um horário.

Veja também:

• Definir o intervalo de tempo de uma consulta
• ATÉ

A cláusula SLIDE BY oferece suporte a um recurso conhecido como janelas deslizantes. Com janelas deslizantes,SLIDE BY os dados são reunidos em "janelas" de tempo que se sobrepõem entre si. Essas janelas podem ajudar a suavizar gráficos de linha com muita variação nos casos em que o agregado móvel (como uma média móvel) é mais importante do que agregados de janelas estreitas de tempo.

Para usar SLIDE BY, coloque-o em uma consulta após a cláusula TIMESERIES . Por exemplo, esta consulta extrai dados em janelas de 5 minutos com um intervalo SLIDE BY de 1 minuto, o que significa que cada janela dura 5 minutos, mas a janela 1 começa em 0 minutos, a janela 2 começa em 1 minuto, a janela 3 começa em 2 minutos e assim por diante.

SELECT average(duration) FROM Transaction TIMESERIES 5 minutes SLIDE BY 1 minute

Para saber mais sobre como e quando você pode usar SLIDE BY, consulte Criar gráficos mais suaves com janelas deslizantes. Ou assista a este pequeno vídeo (aprox. 3:20 minutos).

SELECT average(duration) FROM Transaction TIMESERIES 5 minutes SLIDE BY AUTO

SELECT average(duration) FROM Transaction TIMESERIES 5 minutes SLIDE BY MAX

SELECT ...
  TIMESERIES integer units
  ...

Use a cláusula TIMESERIES para retornar dados como uma série temporal dividida por um período especificado. Como TIMESERIES é usado para acionar determinados gráficos, não há valor padrão.

Para indicar o intervalo de tempo, use integer units. Por exemplo:

• TIMESERIES 1 minute
• TIMESERIES 30 minutes
• TIMESERIES 1 hour
• TIMESERIES 30 seconds

TIMESERIES pode ser combinado com argumentos como MAX, AUTO e SLIDE BY para personalizar ainda mais os resultados da consulta, conforme mostrado nos exemplos abaixo.

SELECT ... SINCE 1 day AGO TIMESERIES 30 minutes

SELECT average(duration), percentile(duration, 50, 90)
  FROM PageView SINCE 1 week AGO TIMESERIES AUTO

SELECT average(duration) FROM Transaction since 1 day ago TIMESERIES MAX

SELECT ...
  UNTIL integer units AGO
  ...

Utilize a cláusula UNTIL para definir o término do intervalo de tempo de consulta. O valor é exclusivo, o que significa que o intervalo de tempo irá para o instante especificado, mas não o incluirá.

O valor default é NOW. Use apenas UNTIL para especificar um ponto final diferente do padrão.

Veja também:

• Definir o intervalo de tempo de uma consulta
• DESDE

Use a cláusula WHERE para filtrar resultados. NRQL retorna os resultados que atendem às condições especificadas na cláusula.

SELECT function(attribute) ...
  WHERE attribute [operator 'value' | IN ('value' [, 'value']) | IS [NOT] NULL ]
  [AND|OR ...]
  ...

• Se você especificar mais de uma condição, separe as condições pelos operadores AND ou OR.

SELECT * FROM PageView WHERE countryCode NOT IN ('CA', 'WA')

SELECT histogram(duration, 50, 20) FROM PageView
WHERE countryCode IN ('CA', 'US') AND userAgentName='Safari' AND pageUrl LIKE '%checkout%'
SINCE 1 day ago

Para informações sobre consulta de dados métricos, consulte consulta métrica.

FROM ...
  WITH function(attribute) AS var
  SELECT var
  ...

Use a cláusula WITH ... AS para definir variáveis NRQL para armazenar valores como variáveis que podem ser referenciadas em qualquer lugar da consulta. Algumas regras e dicas:

• A cláusula WITH ... AS pode vir antes, no meio ou diretamente depois da cláusula FROM/SELECT
• Somente funções de linha (por exemplo, capture()) podem ser definidas como variáveis. funções agregadoras, como average(), não são suportadas.
• Apenas um WITH pode ser usado, mas você pode usar diversas variáveis NRQL, desde que sejam separadas por vírgula.
• Se uma variável NRQL definida usar o mesmo nome de um atributo existente, a variável terá precedência.
• Os nomes de variáveis não podem incluir o símbolo % .

Aqui estão alguns exemplos de consulta:

FROM Transaction
  WITH duration*1000 AS millisec
  SELECT millisec

FROM Log
  WITH aparse(message, '%itemId":"*","unitPrice":*}%') AS (itemId, unitPrice)
  SELECT itemId, unitPrice

FROM Log
  WITH aparse(message, '%itemId":"*","unitPrice":*}%') AS (itemId, unitPrice),
    numeric(unitPrice) AS unitPriceNum
  SELECT sum(unitPriceNum)
  FACET itemId
  WHERE unitPriceNum < 100

SELECT ... WITH TIMEZONE (selected zone)
  ...

Use a cláusula WITH TIMEZONE para selecionar um fuso horário para uma data ou hora na consulta que ainda não tenha um fuso horário especificado.

Se você incluir a cláusula WITH TIMEZONE sem especificar um fuso horário em uma data e hora, as cláusulas since e until permanecerão no fuso horário fornecido.

Se você não incluir a cláusula WITH TIMEZONE , mas incluir um fuso horário em uma sequência de data e hora, o fuso horário da sequência de data e hora será mantido.

Por exemplo, a cláusula de consulta SINCE Monday UNTIL Tuesday WITH TIMEZONE 'America/New_York' retorna dados registrados da meia-noite de segunda-feira, horário dos Estados Unidos/Nova York, até meia-noite de terça-feira, horário dos Estados Unidos/Nova York.

Aqui estão alguns exemplos de cláusulas de intervalo de tempo de consulta:

• Nenhum fuso horário na string de data e hora usando a cláusula WITH TIMEZONE :

  SINCE today UNTIL '2022-05-19T12:00' WITH TIMEZONE 'America/Los_Angeles'

  Copiar

  Isso é resolvido como "beginTime": "2022-05-19T07:00:00Z" e "endTime": "2022-05-19T19:00:00Z".

• Fuso horário na string de data e hora, sem usar a cláusula WITH TIMEZONE :

  SINCE today UNTIL '2022-05-19T12:00-0500'

  Copiar

  Isso é resolvido como "beginTime": "2022-05-19T00:00:00Z" e "endTime": "2022-05-19T17:00:00Z".

• Fuso horário na sequência de data e hora, usando a cláusula WITH TIMEZONE América/Los Angeles, que é -0700 durante o horário de verão:

  SINCE today UNTIL '2022-05-19T12:00-0500' WITH TIMEZONE 'America/Los_Angeles'

  Copiar

  Isso é resolvido como "beginTime": "2022-05-19T07:00:00Z" e "endTime": "2022-05-19T19:00:00Z".

Consulte a lista de IDs de zona disponíveis.

Consulte Definir intervalo de tempo no painel e nos gráficos para obter informações detalhadas e exemplos.

Use a função aggregationendtime() para retornar o horário da agregação relevante. Mais especificamente, para um determinado agregado, a função aggregationendtime() fornece o timestamp de data/hora do final do período dessa agregação. Por exemplo, em uma consulta de série temporal, para um ponto de dados que abrange dados de uma hora, a função retornaria o timestamp de data/hora do final desse período de hora.

Use a função apdex para retornar uma pontuação Apdex para uma única transação ou para todas as suas transações. A pontuação Apdex padrão é 0,5 segundos. O atributo pode ser qualquer atributo baseado no tempo de resposta, como duration ou backendDuration. O argumento t: define um limite de Apdex T na mesma unidade de tempo do atributo escolhido. Por exemplo, se o atributo for medido em segundos, t será um limite em segundos.

A pontuação Apdex retornada pela função apdex() é baseada apenas no tempo de execução. Não leva em conta erros de APM. Se uma transação incluir um erro, mas for concluída no Apdex T ou menos, essa transação será classificada como satisfatória pela função apdex () .

Obtenha Apdex para clientes específicos

Se você definiu atributo personalizado, você pode filtrar com base nesses atributo. Por exemplo, você pode monitor o Apdex para clientes particularmente importantes:

SELECT apdex(duration, t: 0.4) FROM Transaction
  WHERE customerName='ReallyImportantCustomer' SINCE 1 day ago

Copiar

Obtenha Apdex para transações específicas

Use o atributo name para retornar uma pontuação para uma transação específica ou retorne um Apdex geral omitindo name. Esta consulta retorna uma pontuação Apdex para a transação Controller/notes/index na última hora:

SELECT apdex(duration, t: 0.5) from Transaction
WHERE name='Controller/notes/index' SINCE 1 hour ago

Copiar

Obtenha Apdex geral para seu aplicativo

Este exemplo de consulta retorna um Apdex geral do aplicativo nas últimas três semanas:

SELECT apdex(duration, t: 0.08) FROM Transaction SINCE 3 week ago

Copiar

Use a função average() para retornar o valor médio médio de um atributo. Leva um único nome de atributo como argumento. Se um valor do atributo não for numérico, ele será ignorado na agregação. Se os dados que correspondem às condições da consulta não forem encontrados ou se não houver valores numéricos retornados pela consulta, ela retornará um valor nulo.

A função bucketPercentile() é o equivalente NRQL da função histogram_quantile no Prometheus. Destina-se a ser utilizado com dados métricos dimensionais. Em vez do quantil, o New Relic retorna o percentil, que é o quantil * 100.

Use a função bucketPercentile() para calcular o quantil a partir dos dados do histograma em formato Prometheus.

Ele usa o nome do intervalo como argumento e relata o percentual ao longo dos limites do intervalo:

SELECT bucketPercentile(duration_bucket) FROM Metric SINCE 1 day ago

Opcionalmente, você pode adicionar especificações percentuais como argumento:

SELECT bucketPercentile(duration_bucket, 50, 75, 90) FROM Metric SINCE 1 day ago

Como múltiplas métricas são usadas para compor os dados do histograma do Prometheus, você deve consultar a métrica específica do Prometheus em termos do <basename> associado.

Por exemplo, para calcular o percentil de um histograma do Prometheus, com <basename> prometheus_http_request_duration_seconds usando NRQL, use bucketPercentile(prometheus_http_request_duration_seconds_bucket, 50). Observe como _bucket é adicionado ao final de <basename> como sufixo.

Consulte a documentação do Prometheus.io para obter mais informações.

Utilize a função cardinality() para obter o número de combinações de todas as dimensões (atributo) em uma métrica.

São necessários três argumentos, todos opcionais:

• Nome da métrica: se presente, cardinality() calcula apenas a métrica especificada.
• Incluir: se presente, a lista de inclusão restringe o cálculo da cardinalidade a esses atributos.
• Excluir: se presente, a lista de exclusão faz com que esses atributos sejam ignorados no cálculo da cardinalidade.

cdfPercentage() é uma implementação da função de distribuição cumulativa, retornando porcentagens de attribute valores cujo valor é menor ou igual a um ou mais thresholds.

cdfPercentage() agrega em seu argumento attribute , que pode ser um atributo numérico ou um atributo de métrica de distribuição. Tipos mistos em uma consulta são aceitos. Outros tipos (como string) são ignorados. Até 10 limites podem ser especificados.

FROM PageView SELECT cdfPercentage(firstPaint, 0.5, 1.0)

Use a função count() para retornar uma contagem de registros disponíveis. É necessário um único argumento; seja *, um atributo ou um valor constante. Atualmente, ele segue o comportamento típico do SQL e conta todos os registros que possuem valores para seu argumento.

Como count(*) não nomeia um atributo específico, os resultados serão formatados no formato padrão "humanizar" .

derivative() encontra a taxa de mudança para um determinado conjunto de dados. A taxa de variação é calculada usando uma regressão linear de mínimos quadrados para aproximar a derivada. Como esse cálculo exige a comparação de mais de um ponto de dados, se apenas um ponto de dados for incluído no intervalo de avaliação, o cálculo será indeterminado e não funcionará, resultando em um valor null .

O time interval é o período para o qual a taxa de alteração é calculada. Por exemplo, derivative(attributeName, 1 minute) retornará a taxa de alteração por minuto.

Use a função earliest() para retornar o valor mais antigo de um atributo no intervalo de tempo especificado.

É preciso um único argumento.

Se usado em conjunto com FACET , ele retornará o valor mais recente de um atributo para cada um dos aspectos resultantes.

SELECT earliest(countryCode) FROM PageView FACET userAgentName

Use a função filter() para limitar os resultados de uma das funções agregadoras na instrução SELECT. Você pode usar filter() em conjunto com FACET ou TIMESERIES. O filtro só é útil ao selecionar várias agregações diferentes, como:

SELECT filter(sum(x), WHERE attribute='a') AS 'A', filter(sum(x), WHERE attribute='b') AS 'B' ...

Caso contrário, é melhor usar apenas a cláusula WHERE padrão.

Analise compras que usaram códigos de oferta

Você pode usar filter() para comparar os itens comprados em um conjunto de transações para aqueles que usam um código de oferta e aqueles que não o usam:

Use a função funnel() para gerar um gráfico Funis. Leva um atributo como seu primeiro argumento. Em seguida, você especifica as etapas como cláusulas WHERE (com cláusulas AS opcionais para rótulos) separadas por vírgulas.

Para obter detalhes e exemplos, consulte a documentação dos funis.

Use a função histogram() para gerar o histograma. São necessários três argumentos:

• Nome do atributo

• Valor máximo do intervalo de amostragem

• Número total de buckets (entre 1 e 500, inclusive)

  Histograma do tempo de resposta do evento PageView

  Esta consulta resulta em um histograma de tempo de resposta que varia de até 10 segundos em 20 baldes.

  SELECT histogram(duration, 10, 20) FROM PageView SINCE 1 week ago

  Copiar

  Intervalos de histograma do Prometheus

  histogram() aceita intervalos de histograma do Prometheus:

  SELECT histogram(duration_bucket, 10, 20) FROM Metric SINCE 1 week ago

  Copiar

  Métrica de distribuição New Relic

  histogram() aceita a métrica de distribuição como entrada:

  SELECT histogram(myDistributionMetric, 10, 20) FROM Metric SINCE 1 week ago

  Copiar

  Histograma com cláusula FACET

  Use histogram() com uma cláusula FACET para gerar um gráfico de mapa de calor:

  SELECT histogram(duration) FROM PageView FACET appName SINCE 1 week ago

  Copiar

Usar keyset() permitirá que você veja todos os atributos de um determinado tipo de dados em um determinado intervalo de tempo. Não são necessários argumentos. Ele retorna uma estrutura JSON contendo grupos de chaves digitadas em string, chaves digitadas numéricas, chaves digitadas booleanas e todas as chaves.

SELECT keyset() FROM PageView SINCE 1 day ago

Use a função latest() para retornar o valor mais recente de um atributo em um intervalo de tempo especificado.

É preciso um único argumento.

Se usado em conjunto com FACET , ele retornará o valor mais recente de um atributo para cada um dos aspectos resultantes.

SELECT latest(countryCode) FROM PageView FACET userAgentName

Use a função latestrate() para retornar a taxa de alteração de um valor com base nos dois últimos pontos de dados. Toma o atributo em questão como primeiro argumento e a unidade de tempo da taxa resultante como segundo argumento. A função retorna um resultado em unidades de change in attribute/time interval.

Esta função pode ser útil para fornecer a taxa de alteração mais recente de um atributo, a fim de ver as tendências mais recentes.

SELECT latestrate(duration, 1 SECOND) FROM PageView

Use a função max() para retornar o valor máximo registrado de um atributo numérico no intervalo de tempo especificado. Leva um único nome de atributo como argumento. Se um valor do atributo não for numérico, ele será ignorado na agregação. Se os dados que correspondem às condições da consulta não forem encontrados ou se não houver valores numéricos retornados pela consulta, ela retornará um valor nulo.

Use a função median() para retornar a mediana ou percentil 50 de um atributo. Para mais informações sobre consulta de percentil, veja percentile().

SELECT median(duration) FROM PageView TIMESERIES AUTO

Mediana em uma cláusula JOIN :

• Como a mediana é simplesmente um atalho para percentile(attribute, 50), um resultado median() de uma subconsulta unida é um tipo de dados composto, que mapeia o 50º percentil para seu valor calculado.

  Para fazer referência ao valor mediano real na consulta externa, você pode usar a função getField() . Observe que a chave mapeada é uma representação de string de um valor duplo, portanto, para median() é '50.0'.

  Aderiu à consulta mediana

  FROM PageView
  JOIN (FROM PageAction SELECT median(timeSinceLoad) FACET session, currentUrl) ON session
  SELECT latest(getField(median, '50.0')) as median
  FACET browserTransactionName, currentUrl

  Copiar

  

Use a função min() para retornar o valor mínimo registrado de um atributo numérico no intervalo de tempo especificado. Leva um único nome de atributo como argumento. Se um valor do atributo não for numérico, ele será ignorado na agregação. Se os dados que correspondem às condições da consulta não forem encontrados ou se não houver valores numéricos retornados pela consulta, ela retornará um valor nulo.

Use a função percentage() para retornar a porcentagem de um conjunto de dados de destino que corresponde a alguma condição.

O primeiro argumento requer uma função agregadora contra o atributo desejado. Use exatamente dois argumentos (os argumentos após os dois primeiros serão ignorados). Se o atributo não for numérico, esta função retornará um valor de 100%.

FROM Transaction SELECT percentage(count(*), WHERE error is true ) AS 'Error Percent' Where host LIKE '%west%' EXTRAPOLATE

Use a função percentile() para retornar o valor aproximado de um atributo em um determinado percentil. Requer um atributo e pode receber qualquer número de argumentos que representem pontos percentuais. A função percentile() possibilita a exibição do percentual com até três dígitos após a vírgula decimal, proporcionando maior precisão. O limite percentual pode ser especificado como valores decimais, mas esteja ciente de que, para a maioria dos conjuntos de dados, percentis mais próximos que 0,1 um do outro não serão resolvidos.

Use TIMESERIES para gerar um gráfico de linhas com percentil mapeado ao longo do tempo.

• Omita TIMESERIES para gerar um outdoor e uma folha de atributos mostrando valores agregados para o percentil.

  Se nenhum percentil estiver listado, o padrão será o 95º percentil. Para retornar apenas o valor do 50º percentil, a mediana, você também pode usar median().

  Consulta de percentil básico

  Esta consulta irá gerar um gráfico de linhas com linhas para o 5º, 50º e 95º percentil.

  SELECT percentile(duration, 5, 50, 95) FROM PageView TIMESERIES AUTO

  Copiar

  percentil em uma cláusula JOIN :

• Ao usar o percentil em uma subconsulta unida, observe que os resultados da subconsulta são um tipo de dados composto, que mapeia cada percentil para seu valor calculado.

  Para fazer referência a qualquer um dos valores percentuais individuais na consulta externa, você pode usar a função getField() . Observe que a chave mapeada é uma representação de string de um valor duplo, portanto, você precisa adicionar ".0" aos números inteiros. Por exemplo, a chave para o percentil 95 é '95.0'.

  Inscreveu-se na consulta de percentil

  FROM PageView
  JOIN (FROM PageAction SELECT percentile(timeSinceLoad, 95, 99.5) as pctl FACET session, currentUrl) ON session
  SELECT latest(getField(pctl, '95.0')) as `95th`, latest(getField(pctl, '99.5')) as `99.5th`
  FACET browserTransactionName, currentUrl

  Copiar

  

predictLinear() é uma extensão da função derivative() . Ele usa um método semelhante de regressão linear de mínimos quadrados para prever os valores futuros de um conjunto de dados.

• O time interval é o quão longe a consulta irá olhar no futuro. Por exemplo, predictLinear(attributeName, 1 hour) é uma previsão linear 1 hora no futuro da janela de tempo da consulta.
• Geralmente, predictLinear() é útil para valores de crescimento contínuo, como espaço em disco ou previsões sobre grandes tendências.
• Como predictLinear() é uma regressão linear, a familiaridade com o conjunto de dados consultado ajuda a garantir previsões precisas de longo prazo.
• Qualquer conjunto de dados que cresça exponencialmente, logaritmicamente ou por outros meios não lineares provavelmente só terá sucesso em previsões de muito curto prazo.
• New Relic não recomenda o uso de predictLinear em TIMESERIES consulta. Isso ocorre porque cada bucket fará uma previsão individual com base em seu período relativo dentro da consulta, o que significa que tal consulta não mostrará previsões do final da série temporal em diante.

Use a função rate() para visualizar a frequência ou taxa de uma determinada consulta por intervalo de tempo. Por exemplo, você pode querer saber o número de visualizações de página por minuto durante um período de uma hora ou a contagem de sessões únicas em seu site por hora durante um período de um dia.

• Use TIMESERIES para gerar um gráfico de linhas com taxas mapeadas ao longo do tempo.

• Omita TIMESERIES para gerar um outdoor mostrando uma média de valor de taxa única ao longo do tempo.

  Aqui está uma consulta básica que irá gerar um gráfico de linhas mostrando a taxa de taxas de transferência para transação APM por 10 minutos nas últimas 6 horas:

  SELECT rate(count(*), 10 minute) FROM Transaction SINCE 6 hours ago
  TIMESERIES

  Copiar

  Aqui está um pequeno vídeo (3:21 minutos) que explica como usar rate para comparar dados em diferentes janelas de tempo:

Use a função stdvar() para retornar a variação padrão de um atributo numérico no intervalo de tempo especificado.

É preciso um único argumento. Se o atributo não for numérico, ele retornará um valor zero.

Use a função sum() para retornar a soma dos valores registrados de um atributo numérico no intervalo de tempo especificado.

É preciso um único argumento. Se o atributo não for numérico, ele retornará um valor zero.

Utilize a função uniqueCount() para retornar o número de valor exclusivo registrado para um atributo no intervalo de tempo especificado.

Utilize a função uniques() para retornar uma lista de valores exclusivos registrados para um atributo no intervalo de tempo especificado. Quando usado junto com a cláusula facet , uma lista de valores de atributo exclusivos será retornada para cada valor de faceta.

O parâmetro limit é opcional. Quando não fornecido, aplica-se o limite padrão de 1.000 valores de atributo únicos por faceta. Você pode especificar um valor limit diferente, até um máximo de 10.000. A função uniques() retornará o primeiro conjunto de valores de atributo únicos descobertos, até que o limite seja atingido. Portanto, se você tiver 5.000 valores de atributo únicos em seu conjunto de dados, e o limite for definido como 1.000, a operadora retornará os primeiros 1.000 valores exclusivos que descobrir, independente de sua frequência.

O número máximo de valores que podem ser retornados em um resultado de consulta é o produto do limite uniques() vezes o limite facet . Na consulta a seguir, o número máximo teórico de valores que podem ser retornados é 5 milhões (5.000 x 1.000).

Dependendo do conjunto de dados que está sendo consultado e da complexidade da consulta, limites de proteção de memória podem impedir a execução de uma consulta muito grande.

From Transaction SELECT uniques(host,5000) FACET appName LIMIT 1000

FROM NodeStatus SELECT uniques(tuple(index, cellName), 5)

Use a função accountId() para retornar o ID da conta associado aos dados da consulta. Esta função não aceita argumentos. Aqui estão alguns exemplos de consulta:

SELECT accountId() FROM Transaction SINCE 1 day ago

SELECT count(*) FROM Transaction FACET accountId() SINCE 1 day ago

SELECT count(*) FROM Transaction WHERE accountId() IN (1,2,3) SINCE 1 day ago

Use a função de análise de âncora aparse() para extrair valores específicos de uma string. Esta é uma alternativa para capture().

aparse() leva dois argumentos:

• Um atributo de string

• Uma sequência de padrões com sequências de âncora e caracteres de extração. Por exemplo, você poderia usar www.*.com para extrair o domínio de um URL.

  Ao usar aparse(), a string padrão deve conter âncoras, como www. e .com acima, para identificar a localização da string extraída pretendida, anotada por *.

  aparse() usa os seguintes caracteres em strings de padrão:

• %: curinga sem captura, como você veria na cláusula LIKE

• *: captura de curinga, semelhante ao uso de captura regex

  Na prática, as strings âncora geralmente ocorrem no meio de um atributo de string, e não no início ou no final.

  Nesse caso, use o curinga % para ignorar valores indesejados: por exemplo, %www.*.com%.

  Assim como capture(), todos os resultados de aparse() são strings. Para usar esses resultados em funções matemáticas eles devem ser convertidos com a função numeric() .

  Observação: aparse() não diferencia maiúsculas de minúsculas.

  Uso básico

  FROM PageView
    SELECT aparse(browserTransactionName, 'website.com/*')

  Copiar

  aparse() valores específicos

  Para extrair um valor do meio de uma string, use o curinga sem captura, %, no início e no final da string padrão. Por exemplo:

  FROM Log
    SELECT count(*)
    FACET aparse(string, '%"itemId":"*"%')

  Copiar

  aparse() vários valores

  Ao extrair vários valores como variáveis, observe que a ordem é importante. Por exemplo:

  FROM Log
    WITH aparse(string, 'POST: * body: {"itemId":"*","unitPrice":*}\n') AS (url, itemId, unitPrice)
    SELECT url, itemId, unitPrice

  Copiar

  Para obter mais informações sobre variáveis, consulte Variáveis NRQL.

Use a função blob() em um atributo de tipo de blob para retornar uma string codificada em base 64 desse atributo.

Esta função tem as seguintes restrições:

• Consulta contendo chamadas para blob() tem um valor LIMIT máximo de 20

• blob() não pode ser chamado na cláusula WHERE de uma consulta

• blob() não pode ser usado em consulta facetada ou consulta de série temporal

  Para obter mais informações sobre como isso é usado no Logging, consulte Localizar dados em logs longos (blobs).

  Para decodificar um blob codificado em base 64, consulte a funçãodecode() .

  Usando blob() no registro estendido

  SELECT message, blob(`newrelic.ext.message`) FROM Log WHERE newrelic.ext.message IS NOT NULL

  Copiar

Use a função buckets() para agregar dados divididos por uma cláusula FACET em intervalos com base em intervalos. Você pode agrupar qualquer atributo armazenado como um valor numérico no banco de dados New Relic.

São necessários três argumentos:

• Nome do atributo

• Valor máximo do intervalo de amostra (qualquer valor discrepante aparecerá no intervalo final)

• Número total de intervalos

  Para obter mais informações e exemplos, consulte Dividir seus dados em buckets.

Use a função concat() para retornar a string resultante da concatenação de seus argumentos.

Podem ser fornecidos até 20 argumentos dos tipos numérico, booleano, tupla ou matriz. Argumentos nulos e argumentos de tipos não suportados são ignorados. Se nenhum argumento for fornecido, o resultado será uma string vazia.

O argumento opcional de precisão pode ser fornecido para limitar o número de casas decimais incluídas ao concatenar valores numéricos de ponto flutuante.

A string resultante pode ter um comprimento máximo de 4.096 caracteres.

FROM PageView SELECT concat('Backend Duration: ', backendDuration, ', Network Duration: ', networkDuration, precision: 2)

FROM PageView SELECT average(connectionSetupDuration) FACET concat(city, ', ', regionCode, ' ', countryCode) WHERE countryCode IN ('US', 'CA')

Use a função convert() para realizar a conversão de unidades entre as unidades fornecidas no valor de entrada fornecido.

Unidades e abreviações comuns para tempo, comprimento, peso, volume e dados são suportadas usando os padrões UCUM para alinhar com as especificações OpenTelemetry. Por conveniência, as abreviações padronizadas são aumentadas por algumas alternativas de linguagem natural como ft além de ft_us, kilobytes e µs.

As unidades diferenciam maiúsculas de minúsculas. Todas as unidades estão em minúsculas, a menos que sua especificação exija que estejam em maiúsculas. Por exemplo, as unidades de dados 'bits' são válidas para bits e 'By' devem ter B maiúsculo para bytes.

A maior unidade de tempo é o year juliano, que é sempre 365,25 dias.

FROM Transaction SELECT convert(duration, 'ms', 'min') AS durationMin

FROM Product SELECT convert(sum(itemWeight), 'grams', 'lbs')

FROM Metric SELECT average(convert(apm.mobile.external.duration, unit, 's')) WHERE appName = 'my-application'

Use capture() para extrair valores de um atributo usando uma expressão regular com sintaxe RE2.

São necessários dois argumentos:

• Nome do atributo

• Expressão regular com sintaxe de captura (expressões regex em NRQL usam sintaxe semelhante a Python, r'...')

  Ao capturar, use a sintaxe de captura nomeada RE2 ...(?P<name> pattern )... para capturar o padrão contido, dado o nome especificado.

  Vários valores podem ser capturados especificando grupos de captura adicionais em uma expressão regular. Por exemplo: ...(?P<name1> pattern1)...(?P<name2> pattern2)...

  Nota: Ao capturar vários valores, cada instrução de captura pode ter até 16 grupos de captura e cada consulta NRQL pode ter até 5 instruções de captura.

  Leia como usar a captura de regex para melhorar os resultados da sua consulta.

  Dica

  A expressão regular deve corresponder a toda a sua entrada. Se uma expressão de captura não estiver extraindo os resultados esperados, verifique se ela precisa .* no início ou no final, que é o padrão para uma regex de correspondência parcial. No entanto, a regex de correspondência parcial pode causar uma execução de consulta lenta.

  Aqui está um pequeno vídeo (3:05 minutos) que mostra como usar capture() para melhorar a legibilidade dashboard :

  Para mais informações, veja os exemplos abaixo:

  capture() dentro de uma condição de cláusula SELECT

  A seguir, você selecionará o nome de domínio do site, removendo https:// e quaisquer caminhos após o .com

  SELECT capture(pageUrl, r'https://(?P<baseUrl>.*.com)/.+') FROM PageView SINCE 1 day ago

  Copiar

  O seguinte irá capturar apenas a primeira palavra da mensagem de erro.

  SELECT capture(errorMessage, r'(?P<firstWord>\S+)\s.+') FROM Transaction SINCE 1 hour ago where errorMessage is not null

  Copiar

  capture() dentro de uma condição de cláusula FACET

  O seguinte será facetado pelo método HTTP capturado.

  SELECT count(*) FROM Log WHERE message like '%HTTP%' FACET capture(message, r'.* "(?P<httpMethod>[A-Z]+) .*')

  Copiar

  capture() dentro de uma condição de cláusula WHERE

  A seguir, filtraremos os resultados com base no evento de log com message atributo que corresponde à expressão regular onde o nome do trabalho capturado é ExampleJob.

  SELECT message FROM Log WHERE capture(message, r'.*Job Failed: (?P<jobName>[A-Za-z]+),.*') = 'ExampleJob' SINCE 10 minutes ago

  Copiar

  capture() com uma conversão numérica

  O seguinte irá capturar a soma do tempo de CPU das linhas de log. Você deve converter explicitamente para numérico para realizar operações matemáticas.

  SELECT sum(numeric(capture(message, r'.*CpuTime:\s(?P<cpuTime>\d+)'))) FROM Log WHERE message like '%CpuTime:%' SINCE 1 hour ago

  Copiar

  capture() vários valores com variáveis NRQL

  Neste exemplo Variáveis NRQL são usadas para armazenar múltiplos valores capturados de uma mensagem do log.

  FROM Log
    WITH capture(message, r'POST to carts: (?P<URL>.*) body: {"itemId":"(?P<UUID>.*)","unitPrice":(?P<unitPrice>.*)}.*')
      AS (URL, UUID, unitPrice)
    SELECT URL, UUID, unitPrice
    WHERE URL IS NOT NULL

  Copiar

  Veja mais sobre variáveis NRQL aqui.

Use decode() para realizar conversões de base 64 em strings e blobs. O valor de entrada (o primeiro argumento) será decodificado usando o padrão base 64 especificado pela codificação (o segundo argumento).

Os seguintes valores de string são parâmetros de codificação suportados:

• 'base64': Usa o padrão RFC4648 base-64

• 'base64mime': usa o padrão RFC2045 base-64 (MIME)

• 'base64url': Usa o padrão RFC4648 base-64 com URL e nome de arquivo em alfabeto seguro

  Como blob() não é permitido em cláusulas WHERE ou FACET , decode() com tipos de blob não é suportado na cláusula WHERE ou para consulta facetada.

  Para codificar strings, consulte a funçãoencode() .

  Usando decode() em um atributo de string

  FROM Span SELECT entity.guid, decode(entity.guid, 'base64') WHERE entity.guid IS NOT NULL

  Copiar

  Usando decode() em um FACET

  FROM Span SELECT count(*) WHERE entity.guid IS NOT NULL FACET entity.guid, decode(entity.guid, 'base64')

  Copiar

  Usando decode() em uma cláusula WHERE

  FROM Span SELECT count(*) WHERE entity.guid IS NOT NULL AND decode(entity.guid, 'base64') NOT LIKE '%APM%'

  Copiar

  Usando decode() com um atributo de tipo de blob

  FROM Log
  WITH blob(`newrelic.ext.message`) as encodedBlob,
  decode(encodedBlob, 'base64') as decodedBlob
  SELECT encodedBlob, decodedBlob
  WHERE newrelic.ext.message IS NOT NULL
  LIMIT 10

  Copiar

Use a função dimensions() para retornar todos os valores dimensionais em um tipo de dados.

Você pode incluir ou excluir explicitamente um atributo específico usando os argumentos opcionais:

• Incluir: se presente, a lista de inclusão limita dimensions() a esses atributos.

• Excluir: se presente, o cálculo dimensions() ignora esses atributos.

  FROM Metric SELECT count(node_filesystem_size) TIMESERIES FACET dimensions()

  Copiar

  Quando usado com uma cláusula FACET , dimensions() produz uma série temporal exclusiva para todos os aspectos disponíveis no tipo de evento, semelhante ao modo como o Prometheus se comporta com consultas não agregadas.

Use encode() para realizar conversões de base 64 em strings. O valor de entrada (o primeiro argumento) será codificado usando o padrão base 64 especificado pela codificação (o segundo argumento).

Os seguintes valores de string são parâmetros de codificação suportados:

• 'base64': Usa o padrão RFC4648 base-64

• 'base64mime': usa o padrão RFC2045 base-64 (MIME)

• 'base64url': Usa o padrão RFC4648 base-64 com URL e nome de arquivo em alfabeto seguro

  Para decodificar strings ou blobs, consulte a funçãodecode() . encode() não é compatível com blobs.

  Usando encode() em um atributo

  FROM PageView SELECT session, encode(session, 'base64')

  Copiar

Use a função cidrAddress() para obter o endereço de rede base de um endereço IP CIDR.

cidrAddress() recebe os seguintes argumentos:

• atributo - Um valor de string que contém um endereço IP próprio ou com um comprimento de prefixo em notação CIDR.

  • Pode ser um atributo de string ou um literal de string entre aspas.
  • O endereço IP deve ser um endereço IPv4.

• número - Um valor inteiro que representa o comprimento do prefixo.

  • Pode ser um atributo inteiro ou um valor inteiro.
  • Se o parâmetro de atributo estiver em notação CIDR, esse parâmetro será opcional e terá precedência sobre o comprimento do prefixo fornecido na String CIDR.

• cidrFormat - Um valor booleano opcional usado para determinar se a saída do endereço de rede deve ser formatada em notação CIDR. O padrão será verdadeiro.

  A função cidrAddress() retornará um valor desde que o parâmetro atributo e number contenha um endereço IP e comprimento de prefixo válidos. Se a entrada do parâmetro for inválida, cidrAddress() retornará null.

  Descubra quais sub-redes estão processando mais solicitações

  A consulta a seguir retorna as sub-redes que processam a maioria das solicitações do tipo de evento SyntheticRequest .

  FROM SyntheticRequest SELECT count(*) FACET cidrAddress(serverIPAddress, 24)

  Copiar

  Isso retornaria respostas em um formato como:

  Endereço Cidr do endereço IP do servidor	Contar
  10.0.0.0/24	6k
  10.10.1.0/24	4k
  10.0.14.0/24	1k

  Consulte todos os endereços IP que existem em um intervalo CIDR

  Esta consulta retorna todos os endereços IP no atributo serverIPAddress que existem no intervalo CIDR de 10.0.0.0 a 10.0.0.255.

  FROM SyntheticRequest SELECT uniques(serverIPAddress) WHERE cidrAddress(serverIPAddress, 24) = '10.0.0.0/24'

  Copiar

  Filtrar endereços IP que existem em um intervalo CIDR específico dos resultados da consulta

  Esta consulta retorna uma contagem de todos os registros, excluindo registros que contêm um valor serverIPAddress que se enquadra no intervalo CIDR de 10.0.0.0/24 ou 10.10.1.0/24.

  FROM SyntheticRequest SELECT count(*) WHERE cidrAddress(serverIPAddress, 24) NOT IN ('10.0.0.0/24', '10.10.1.0/24')

  Copiar

...WHERE eventType() = 'EventNameHere'...
...FACET eventType()...

Use a função eventType() em uma cláusula FACET para dividir os resultados pelo tipo de dados selecionado ou em uma cláusula WHERE para filtrar os resultados para um tipo de dados específico. Isso é particularmente útil para direcionar tipos de dados específicos com as funções filter() e percentage() .

SELECT 100 * filter(count(*), where eventType() = 'TransactionError') / filter(count(*), where eventType() = 'Transaction') FROM Transaction, TransactionError WHERE appName = 'App.Prod' TIMESERIES 2 Minutes SINCE 6 hours ago

SELECT count(*) FROM Transaction, TransactionError FACET eventType() TIMESERIES

Use a função getField() para extrair um campo de tipos de dados compostos, como dados métricos dimensionais.

Leva os seguintes argumentos:

Exemplos:

SELECT max(getField(mySummary, count)) from Metric

SELECT sum(mySummary) from Metric where getField(mySummary, count) > 10

getCdfCount() é uma implementação da função de distribuição cumulativa, retornando o número de valores em attribute igual ou inferior a threshold.

Apenas um limite é permitido. Attribute pode ser um atributo numérico ou um atributo de métrica de distribuição. Tipos mistos em uma consulta são aceitos.

Para um tipo numérico, retorna 1 se o atributo for menor ou igual ao limite, caso contrário, retorna 0. Para uma distribuição, retorna a contagem no conjunto de dados representado pela distribuição. Para todos os outros tipos, retorna 0.

FROM PageView SELECT sum(getCdfCount(firstPaint, 1.0))

Use if() para executar operações de fluxo de controle if-then-else em uma consulta.

if() leva 3 argumentos:

• condição - uma expressão que pode ser avaliada como verdadeira ou falsa

• trueValue - este valor é retornado se a expressão booleana for verdadeira

• falseValue - este valor opcional é retornado se a expressão booleana for falsa, ou se não for fornecido NULL, será retornado

  Uso básico

  FROM Log
    SELECT count(*)
    FACET if(level_name = 'ERROR', 'ERROR', 'NOT_ERROR')

  Copiar

  Use com AND e OR

  FROM Log
    SELECT count(*)
    FACET if(level_name = 'INFO' OR level_name = 'WARNING', 'NOT_ERROR', 'ERROR')

  Copiar

  Aninhado If()

  Use uma função if() aninhada para adicionar lógica condicional adicional.

  FROM Transaction SELECT count(*)
    FACET if(appName LIKE '%java%', 'Java',
    if(appName LIKE '%kafka%', 'Kafka', 'Other'))

  Copiar

Use a função de análise JSON, jparse(), para analisar um valor de string e produzir um mapa/lista de valores (ou estruturas aninhadas) que podem ser manipulados como qualquer outro tipo de valor de primeira classe em NRQL.

jparse() leva dois argumentos:

• atributo - Um valor de string JSON.

• path - Um valor de string opcional usado para fazer referência direta a uma parte específica do JSON no parâmetro attribute . Consulte a seção Referência de sintaxe do caminho de análise JSON abaixo.

  A função jparse() segue o formato RFC 8259 para analisar valores JSON. Quando a função jparse() for usada sem o parâmetro path , ela retornará o valor JSON desserializado.

  Você pode usar colchetes para extrair valores individuais de um resultado jparse() por meio de uma chave/índice e mapear chaves JSON diretamente para atributo usando a cláusula WITH .

  Referenciando uma chave/índice usando a sintaxe de colchetes

  Referencing a key

  A consulta a seguir faz referência à chave userNames no atributo jsonString e retornará ['abc', 'xyz'].

  WITH '{"userNames": ["abc", "xyz"]}' as jsonString SELECT jparse(jsonString)[userNames]

  Copiar

  Referencing an index

  A consulta a seguir faz referência ao índice 0 dentro do atributo jsonString e retornará 'abc'.

  WITH '["abc", "xyz"]' as jsonString SELECT jparse(jsonString)[0]

  Copiar

  Mapeamento de chaves JSON para atributo

  A consulta a seguir usa jparse() na cláusula WITH para mapear as chaves JSON userName e id em variáveis NRQL para que possam ser usadas no restante da consulta.

  WITH '{"userName": "test", "unused": null, "id": 100}' as jsonString, jparse(jsonString) AS (userName, id) SELECT userName, id

  Copiar

  Para analisar valores específicos da string JSON, você pode usar o parâmetro path .

  Referência de sintaxe do caminho de análise JSON

  É comum que os dados JSON sejam aninhados em várias camadas em formas não triviais. A sintaxe do caminho permite fazer referência direta a uma parte específica dos dados JSON.

  Dados de exemplo:

  {
    "valueA": "test",
  
    "valueB": {
  
      "nestedValue1": [1, 2, 3],
  
      "nestedValue2": 100
  
    },
  
    "valueC: [
  
      { "id": 1, "label": "A", "other": 7 },
  
      { "id": 2, "label": "B", "other": 9  },
  
      { "id": 3, "label": "C", "other": 13  }
  
    ]
  }

  Copiar

  Exemplos de sintaxe de caminho usando os dados acima:

  Path Syntax Example	Result Description	Result
  'valorA'	Retorna o valor na chave	"test"
  '["valueA"]'	Retorna o valor na chave	"test"
  '[valueA, valueC]'	Retorna lista de valor principal	["test", [...]]
  'valueB.nestedValue2'	Retorna o valor na chave	100
  'valueC[0]'	Retorna o valor da lista no índice 0	{"id": 1…}
  'valueC[0,2]'	Retorna os valores da lista nos índices 0 e 2	[{"id": 1…}, {"id": 3…}]
  'valueC[0:2]'	Retorna o intervalo de valores da lista do primeiro ao segundo índice, excluindo o valor do segundo índice. Neste caso, os valores da lista nos índices 0 e 1 são retornados.	[{"id": 1…}, {"id": 2…}]
  'valueC[:2]'	Retorna o intervalo de valores da lista desde o início até o segundo índice, excluindo o valor no segundo índice. Neste caso, os valores da lista nos índices 0 e 1 são retornados.	[{"id": 1…}, {"id": 2…}]
  'valueC[:-2]'	Retorna todos os valores da lista, exceto o último n, onde n é um número negativo após os dois pontos (ou seja, [:-n]). Neste caso, o valor da lista no índice 0 será retornado.	[{"id": 1…}]
  'valueC[1:]'	Retorna o intervalo de valores da lista desde o índice especificado até o final da lista. Neste caso, os valores da lista nos índices 1 e 2 são retornados.	[{"id": 2…}, {"id": 3…}]
  'valueC[-1:]'	Retorna os últimos n valores da lista, onde n é um número negativo antes dos dois pontos (ou seja, [-n:]). Neste caso, o valor da lista no índice 2 será retornado.	[{"id": 3…}]
  'valueC[*]'	Retorna todos os valores da lista	[{"id": 1…}, {"id": 2…},{"id": 3…}]
  'valueC[*].id'	Retorna o valor principal especificado de todos os membros da lista. Neste caso, o “id” valor principal.	[1, 2, 3]
  'valueC[*]["label", other]'	Retorna as chaves especificadas de todos os membros da lista. Neste caso, o valor principal “rótulo” e “outro”.	[["A", 7],…]

  Exemplos:

  Exemplo Básico

  A consulta a seguir analisa a string JSON no atributo jsonString .

  WITH '{"user": {"name": "John", "id": 5}}' as jsonString SELECT jparse(jsonString)

  Copiar

  Esta consulta retornará a string JSON desserializada:

  {"user":{"name":"John","id":5}}

  Copiar

  Analisar um valor específico de uma mensagem do log

  Um problema comum é ter dados ricos e estruturados escondidos em uma mensagem do log. Você pode aproveitar aparse() e jparse() para eliminar ruídos e encontrar valores específicos.

  A seguinte consulta:

  1. Chama aparse() para extrair dados JSON do atributo logMessage

  2. Analisa o campo user.name dos dados JSON extraídos usando jparse() e o parâmetro de caminho user.name .

     WITH '1693242121842: value=\'{"user": {"name": "John", "id": 5}}\', useless=stuff' as logMessage, aparse(logMessage, '%: value=\'*\'%') AS jsonString SELECT jparse(jsonString, 'user.name')

     Copiar

  Analisar vários valores aninhados de uma string JSON

  A consulta a seguir analisa cada campo id da lista de objetos no atributo jsonString e gera esses valores como uma matriz.

  WITH '{"users": [{"name": "A", "id": 5}, {"name": "B", "id": 10}]}' as jsonString, jparse(jsonString, 'users[*].id') as ids SELECT ids

  Copiar

  A consulta acima retornará [5, 10].

  Funções relacionadas: mapKeys(), mapValues()