Use funções NRQL avançadas

O Desvio padrão mede a quantidade de variação ou dispersão dentro de um conjunto de valores. Ela usa uma escala de baixo (valores próximos da média) a alto (valores distantes da média). A função stddev()permite que você olhe entre as linhas das médias e entenda os valores relatados em um nível mais profundo. Neste exemplo, você compara o Desvio padrão de transação tempo de resposta ("duração") do último dia com o dia anterior.

SELECT stddev(duration) 
FROM Transaction 
SINCE 24 hours ago 
COMPARE WITH 24 hours ago 
TIMESERIES

A função stdvar() funciona de maneira semelhante a stddev() , mas retorna a variação padrão para atributo numérico.

Em uma lição anterior, você aprendeu como agrupar dados em uma configuração específica de buckets usando FACET cases(). Você também pode agrupar dados por um atributo específico automaticamente usando FACET buckets(). Esta função simplifica o agrupamento de dados para qualquer função de agregação e leva três argumentos:

buckets(attribute, ceiling, number-of-buckets).

• O atributo pelo qual você deseja agrupar.

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

• O número total de buckets que você precisa.

  Na consulta de exemplo, você usa NRQL para encontrar a duração média de uma transação inteira. Porém, você agrupa esse desempenho em transações que realizam volumes específicos de chamadas de banco de dados. Portanto, você especifica o atributo do bucket como databaseCallCount, define o limite máximo em 400 chamadas e agrupa-o em 10 buckets. Isso resulta no desempenho de transações de 0 a 40, 40 a 80, 80 a 120, 120 a 160, 160 a 200, 200 a 240, 240 a 280, 280 a 320, 320 a 360 e >360 chamadas de banco de dados. 10 baldes transparentes divididos uniformemente até o teto.

  SELECT average(duration) 
  FROM Transaction 
  SINCE 12 hours ago 
  FACET buckets(databaseCallCount, 400, 10)

  Copiar
  

NRQL possui muitas funções matemáticas que manipulam valores de alguma forma. Neste exemplo, você verá alguns demonstrados simultaneamente.

A função abs(n) retorna o valor absoluto para n: para valores n não negativos ela retorna "n" e para valores n negativos ela retorna o número positivo "n". Por exemplo, abs(2) = 2 e abs(-4) = 4.

Você também pode arredondar números decimais para inteiros usando floor(), ceil() e round(). floor() retorna o número inteiro completo mais próximo, arredondado para baixo, e ceil() faz o oposto, arredondando para cima. round() é bidirecional e arredonda para cima ou para baixo para o número inteiro completo mais próximo.

SELECT abs(duration), round(duration), ceil(duration), floor(duration) 
FROM Transaction 
SINCE 1 day ago

Você pode usar a fixação em um atributo para impor um limite superior ou inferior ao seu valor. Isso é útil para coisas como garantir que valores discrepantes extremos não distorçam a escala de um gráfico de série temporal. clamp_max(duration, 10) retorna a duração, a menos que exceda 10; nesse caso, retorna 10. Muito simplesmente, qualquer coisa maior que 10 ainda retorna igual a 10. clamp_min(duration,1) faz o inverso; se alguma duração for inferior a 1, será reportado como igual a 1.

SELECT clamp_max(average(duration), 10), clamp_min(average(duration), 1) 
FROM Transaction 
SINCE 1 day ago 
TIMESERIES

Agora você pode passar para a matemática avançada que muitos consideram difícil de usar. Como antes, podemos mostrar todas essas funções em um único exemplo de consulta.

A função pow() eleva o primeiro argumento à potência do segundo argumento. Neste exemplo, você eleva a duração à potência de 2. Se precisar da raiz quadrada de um valor, a função sqrt() pode fornecer isso rapidamente. E a função exp() calcula a função exponencial natural do seu argumento.

Finalmente, NRQL também oferece logaritmos que atendem a uma série de funções semelhantes:

• ln(n) calcule o logaritmo natural: o logaritmo base e.

• log2(n) calcule o logaritmo na base 2.

• log10(n) calcule o logaritmo na base 10.

• log(n, b) permite calcular logaritmos com uma base arbitrária b.

  SELECT pow(duration, 2), sqrt(duration), exp(duration), ln(duration), log2(duration) 
  FROM Transaction 
  SINCE 1 day ago

  Copiar
  

Digamos que você queira uma lista de todos os tipos de eventos atualmente reportados à sua conta New Relic. A sintaxe SHOW EVENT TYPES retorna uma lista de todos os tipos de eventos relatados em um determinado período. É uma das raras exceções em que uma consulta NRQL não precisa de SELECT e FROM. Você pode usar essa funcionalidade para coisas como confirmar a existência de dados de eventos personalizados.

SHOW EVENT TYPES 
SINCE 1 week ago

Talvez você precise saber qual atributo você tem disponível para um determinado tipo de evento. A função keyset() fornece uma lista de todos os atributos de um tipo de evento, agrupados por tipo de atributo. Você receberá apenas atributos que contenham valores dentro da janela de tempo fornecida, que você pode usar para explorar seus dados. Você também pode usá-lo em automação, para coisas como garantir relatórios de dados de clientes corretamente.

SELECT keyset() 
FROM Transaction 
SINCE 1 week ago

Ocasionalmente, você pode querer filtrar dados com correspondência de padrões mais complexa do que LIKE pode fornecer. Com a cláusula RLIKE , você pode filtrar com expressões regulares para uma correspondência mais complicada.

Em qualquer cenário que você possa usar LIKE, você tem a opção de usar RLIKE para fornecer uma regex correspondente entre aspas. Neste exemplo, há uma lista de todos os nomes de host que terminam em números pares ou consoantes.

SELECT uniques(host) 
FROM Transaction 
WHERE host 
RLIKE '^.*[02468bcdfghjklmnpqrstvwxyz]'

Copiar

Você também pode fazer combinações simples. Por exemplo, se você quiser corresponder um valor que começa com uma determinada letra ou palavra.

SELECT count(*) 
FROM Transaction 
WHERE name 
RLIKE 'W.*|O.*' 
FACET name

O mecanismo de expressão regular usa a sintaxe RE2. Se você precisar excluir caracteres, talvez seja necessário usar sequências de escape com barras invertidas duplas. (por exemplo \\).

Lembre-se de que RLIKE tem inerentemente mais complexidade e menos desempenho que LIKE. Use-o apenas quando LIKE e outras funcionalidades de filtragem não atenderem às suas necessidades.

Exemplo 1: Máximo de chamadas de API na última hora

Primeiro, você pode contar o número de chamadas API por minuto na última hora. Isso retorna 60 pontos de dados em um gráfico:

SELECT count(*) AS apicalls
FROM Transaction 
TIMESERIES 1 MINUTE

Agora, para encontrar o valor máximo relatado nesse período, coloque a consulta entre parênteses e use SELECT ... FROM assim: SELECT z FROM (SELECT x AS z FROM y)

SELECT max(apicalls) 
FROM ( SELECT count(*) AS apicalls FROM Public_APICall TIMESERIES 1 minute )

Exemplo 2: servidores com alta carga de CPU

Este exemplo usa dados da New Relic Infrastructure. Às vezes, você deseja ver apenas hosts cuja CPU excedeu, em média, uma determinada porcentagem. Se você solicitar o average(cpuPercent) ao NRQL, obterá uma lista de hosts com a porcentagem média de CPU mais alta. Porém, você não pode simplesmente adicionar um WHERE cpuPercent > 90 para limitar isso apenas a hosts rodando a 90% ou mais, porque isso removeria os dados antes de calcular a média.

Mas você pode resolver isso com agregação aninhada! Ao solicitar average(cpuPercent) na subconsulta, você obtém a lista de hosts e sua CPU média. Agora, na consulta externa, você pode filtrar apenas os resultados que foram > x%! (Dica: pode ser necessário ajustar o limite desta consulta para funcionar com a CPU dos seus hosts. Nós definimos para 20% aqui.)

SELECT hostname, cpu 
FROM (SELECT average(cpuPercent) AS cpu FROM SystemSample FACET hostname) 
WHERE cpu > 20

Exemplo 3 – Rejeições de Sessão

Muitas vezes as pessoas se perguntam como calcular a taxa de rejeição no monitoramento de front-end. Isso se refere a sessões que visualizam uma única página e “saltam” antes de visitar mais páginas. Com a agregação aninhada, você pode conseguir isso facilmente. Nossa consulta interna conta os PageViews, agrupando-os por sessão. O conjunto de resultados passado para a consulta externa lista todas as sessões e quantas páginas cada uma visualizou. A consulta externa calcula então a porcentagem de sessões com uma contagem de 1 (isso indica uma "sessão devolvida", porque visualizaram apenas uma única página).

SELECT percentage(count(*), WHERE sessionLength = 1) 
FROM (SELECT count(*) AS sessionLength FROM PageView FACET session)

Nesta lição, você aprendeu como usar uma consulta como FROM de outra consulta para responder perguntas mais complicadas. Só há uma última coisa a aprender: como usar subconsultas!

Condições Numéricas

Você pode usar qualquer consulta que retorne um único valor numérico em condições numéricas. Este exemplo usa uma subconsulta na cláusula WHERE que retorna o valor do 97º percentil da duração da chamada de API e, em seguida, retorna o nome e a duração das chamadas maiores que esse valor.

SELECT http.url, duration 
FROM Public_APICall 
WHERE duration > (SELECT percentile(duration,97) FROM Public_APICall)

IN Condições

Quando você tiver vários valores retornando de uma subconsulta, use uma condição IN para a consulta pai comparar com cada valor. No exemplo, o atributo entity.guid fornece dados para cada entidade única que tem um erro de transação, e isso corresponde ao valor entity.guid das transações para determinar a duração média das entidades com erro.

SELECT average(duration) 
FROM Transaction 
WHERE entity.guid 
IN (SELECT uniques(entity.guid) FROM TransactionError) 
FACET appName 
TIMESERIES

Subconsultas na instrução SELECT

Você pode usar os resultados da subconsulta em cálculos com uma instrução SELECT e pode especificar um intervalo de tempo diferente da consulta externa. Este exemplo calcula o delta entre a duração média atual e a dos últimos 7 dias.

SELECT average(duration) - (SELECT average(duration) FROM Public_APICall SINCE 7 days ago) 
FROM Public_APICall 
TIMESERIES

As subconsultas são uma ferramenta poderosa para exploração de dados, permitindo consultas mais sofisticadas em diferentes fontes de dados e intervalos de tempo.