Controle seus dados com NRQL

Após concluir o primeiro tutorial de NRQL, você usou count(), average(), sum(), max() e min() para transformar seus dados de maneiras significativas. Mas e se você quiser encontrar e contar valores exclusivos? Para encontrar o número de valores exclusivos registrados para um atributo em um intervalo de tempo especificado, você pode usar a função uniqueCount(). Você só precisa fornecer o atributo que queremos inspecionar como um argumento. Por exemplo, aqui está uma consulta para exibir todas as chamadas de API públicas exclusivas:

SELECT uniqueCount(http.url) 
FROM Public_APICall 
SINCE 1 day ago

Copiar

Para otimizar o desempenho da consulta, a função acima retorna resultados aproximados para consultas que fiscalizam mais de 256 valores exclusivos. Para retornar a lista real de valores exclusivos de um atributo em um intervalo de tempo especificado, podemos usar a função uniques() .

SELECT uniques(http.url) 
FROM Public_APICall 
SINCE 1 day ago

Para especificar um valor limite diferente do padrão de 1.000, use uniques(attribute[,limit]), que aceita um máximo de 10.000.

Para recuperar o valor mais recente de um atributo em um intervalo de tempo especificado, use a função latest() . Neste exemplo de consulta, você pode localizar o tempo de resposta mais recente para uma chamada de API no último dia. Isso pode ajudá-lo a localizar o valor mais recente para uma transação ou serviço de relatório intermitente.

SELECT latest(duration) 
FROM Public_APICall 
WHERE awsAPI = 'sqs' 
SINCE 1 day ago

Copiar

Do outro lado do espectro, você poderia usar a função earliest() para conseguir o oposto. Ele retornará o valor mais antigo de um atributo registrado no intervalo de tempo especificado. Neste exemplo de consulta, você pode recuperar o primeiro tempo de resposta para uma chamada de API no último dia. Se os dados forem relatados de forma consistente, isso reportará o ponto de dados do primeiro evento nas últimas 24 horas.

SELECT earliest(duration) 
FROM Public_APICall 
WHERE awsAPI = 'sqs' 
SINCE 1 day ago

Copiar

Pode ser necessário usar porcentagens em vez de contagens, somas ou médias. O uso da função percentage() permite calcular a porcentagem de um valor no conjunto de dados que corresponde a uma condição especificada. Essa função aceita dois argumentos: o primeiro é uma função de agregador para o atributo desejado, como count(). O segundo é uma condição WHERE para especificar o subconjunto de dados a ser consultado.

Neste exemplo de consulta, você pode encontrar a porcentagem de chamadas de API no último dia que tiveram uma duração (ou tempo de resposta) superior a 100 milissegundos.

SELECT percentage(count(*), WHERE duration > 0.1) 
FROM Public_APICall 
SINCE 1 day ago

Copiar

É muito comum visualizar dados de desempenho do aplicativo ou de experiência dos clientes usando percentis em vez de médias. Você pode usar a função percentile() para entender a experiência do enésimo percentil.

Por exemplo, digamos que você queira saber qual foi a pior experiência (maior duração) de 98% dos seus clientes no último dia. Você pode solicitar ao NRDB percentile(duration, 98) das últimas 24 horas.

SELECT percentile(duration,98) 
FROM Public_APICall 
SINCE 1 day ago

Copiar

O NRQL oferece suporte a operadores matemáticos básicos. Você pode realizar adição (+), subtração (-), multiplicação (*) e divisão (/) tanto em valores de atributo numéricos quanto em resultados de funções de agregador.

Por exemplo, capturamos tanto o tempo de resposta total (como duration) quanto o tempo de resposta do banco de dados (como databaseDuration) quando registramos um evento de transação. Mas e se você quiser encontrar o tempo médio gasto fora do processamento do banco de dados? Você pode começar calculando esse valor para cada evento em seu conjunto de dados usando uma consulta como esta.

SELECT GigabytesIngestedBillable - GigabytesIngestedFree, metric  
FROM NrMTDConsumption 
WHERE productLine IS NOT NULL

Ótimo! Você acabou de realizar algumas operações matemáticas básicas. Isso é útil para ajudar você a listar eventos individuais. Mas e se você quiser saber a duração média das transações sem o tempo do banco de dados? Você também pode fazer a aritmética dentro da função:

SELECT average(GigabytesIngestedBillable - GigabytesIngestedFree) 
FROM NrMTDConsumption 
WHERE GigabytesIngestedBillable IS NOT NULL

Agora, e se você quisesse complicar ainda mais subtraindo, dividindo e multiplicando na mesma consulta para descobrir a duração sem o tempo do banco de dados, como uma porcentagem do tempo total? Bem, você pode adicionar a matemática:

SELECT average(GigabytesIngestedBillable - GigabytesIngestedFree) / unitPrice * 100 
FROM NrMTDConsumption 
WHERE GigabytesIngestedBillable IS NOT NULL

À medida que você começa a executar funções NRQL mais complexas, pode se perguntar se é possível tornar os nomes exibidos para os atributos de consulta mais úteis, especialmente para outras pessoas que não conhecem o NRQL. Vamos considerar um exemplo usando o que você aprendeu no tutorial anterior.

SELECT average(duration-externalDuration) 
FROM Transaction

Você pode usar a cláusula AS após uma função ou atributo para dar ao resultado um nome mais legível e significativo. Isso ajuda você e sua equipe a entender exatamente o que um gráfico representa.

SELECT average(duration-externalDuration) 
AS 'Non-External Response Time' 
FROM Transaction

Agora você já pratica o uso de intervalos de tempo com cláusulas SINCE e UNTIL . Mas e se você quiser comparar valores de diferentes intervalos de tempo? Você pode conseguir isso com a cláusula COMPARE WITH .

NRQL usa SINCE e UNTIL para definir um período de interesse. Em seguida, você pode indicar o período de tempo com o qual deseja comparar usando uma cláusula COMPARE WITH [time period] AGO contendo um valor de deslocamento relativo.

Por exemplo, no exemplo de consulta abaixo, você pode comparar os dados do último dia com os dados da semana anterior usando um deslocamento relativo de 1 semana atrás.

SELECT average(duration) 
FROM Public_APICall 
SINCE 1 day ago 
COMPARE WITH 1 week ago

Copiar

Para mapear a comparação de valores ao longo do tempo, adicione TIMESERIES. Isso cria um gráfico de linhas de comparação, permitindo visualizar como esse período se compara aos dados recentes e acompanhá-lo ao longo do tempo.

SELECT average(duration) 
FROM Public_APICall 
SINCE 1 day ago 
COMPARE WITH 1 week ago 
TIMESERIES

Você também pode especificar vários períodos de tempo relativos diferentes no mesmo formato, semelhante a UNTIL. Para instância, você pode especificar 4 WEEKS AGO ou 6 HOURS AGO.

SELECT average(duration) 
FROM Public_APICall 
SINCE 1 hour ago 
COMPARE WITH 6 hours ago 
TIMESERIES

Agora você sabe usar uma cláusula WHERE para filtrar os resultados em nossa consulta. Além de usar operadores de comparação padrão, você também pode usar LIKE e NOT LIKE se quiser descobrir se um atributo contém ou não uma substring especificada. Para conseguir isso, você pode usar o símbolo de porcentagem (%) como curinga em qualquer lugar da string.

Em nossa consulta de amostra, você pode obter o número de transações com o termo "amazonaws" em qualquer lugar (início, meio ou fim) do nome.

SELECT count(*) 
FROM Public_APICall 
WHERE http.url 
LIKE '%amazonaws%' 
FACET http.url 
SINCE 1 day ago

Copiar

Se você alterar sua consulta para usar NOT LIKE , obterá o número de transações que não contêm a palavra escolhida (como "google", conforme abaixo) em seu nome.

SELECT count(*) 
FROM Public_APICall 
WHERE http.url NOT 
LIKE '%google%' 
FACET http.url 
SINCE 1 day ago

Copiar

Você pode usar % como um curinga no início e no fim, o que significa que a New Relic verifica se o valor do atributo que você escolheu contém o termo, como “Web” em qualquer lugar do texto. Da mesma forma, você pode usar %Web OU Web% para corresponder a algo que termina com “Web” ou começa com “Web”, respectivamente.

Você também pode adicionar o curinga entre as strings para uma pesquisa mais refinada. Esta consulta verifica um nome de transação que contém a palavra "amazon" seguida de qualquer texto, mas também contém o termo ".com" seguido por qualquer número de caracteres. Assim, os resultados só serão negociados com “amazon” e “.com” no nome.

SELECT count(*) 
FROM Public_APICall 
WHERE http.url NOT 
LIKE '%amazon%.com' 
FACET http.url 
SINCE 1 day ago

Copiar

E se você precisar de extrema especificidade e os nomes não tiverem uma string comum que possa corresponder usando curingas? Os operadores IN e NOT IN permitem especificar um conjunto de valores que você gostaria de verificar em um atributo. Em vez de especificar diversas cláusulas WHERE com operadores AND ou OR , você pode simplificar uma condição listando os valores entre parênteses separados por vírgulas.

Neste exemplo de consulta, você pode contar o número de transações cujo subtipo é "graph.microsoft.com" ou "s3.amazonaws.com". Se você alterar a consulta para usar NOT IN , obterá o número de transações cujo subtipo não é "graph.microsoft.com" nem "s3.amazonaws.com".

SELECT count(*) 
FROM Public_APICall 
WHERE http.url IN ('graph.microsoft.com', 's3.amazonaws.com') 
SINCE 1 day ago

Copiar

As cláusulas SINCE e UNTIL fazem mais do que fornecer informações sobre intervalos de tempo relativos: você também pode fornecer a elas uma data ou hora específica. Na seguinte consulta de exemplo, você pode usar uma data SINCE no formato YYYY-MM-DD.

SELECT average(duration) 
FROM Public_APICall SINCE '2023-10-28' 
TIMESERIES MAX

Você pode usar isso para criar relatórios de SLA para um período de tempo especificado. Você pode até incluir uma hora específica com o formato YYYY-MM-DD HH:MM. Nesta consulta, você pode ver que os dados estão definidos para as 18h.

SELECT average(duration) 
FROM Public_APICall SINCE '2023-10-28 18:00' 
TIMESERIES MAX

Às vezes, você pode receber um tempo de evento no tempo epoch (unix). Você também pode usar timestamps epoch com as cláusulas SINCE e UNTIL para não precisar traduzir manualmente esses valores para outro formato de data.

SELECT average(duration) 
FROM Public_APICall SINCE 1698525489519 UNTIL 1698698289519 
TIMESERIES MAX

Quando o NRDB mostra dados durante um período de tempo, ele pressupõe que você deseja ver os dados da perspectiva do seu fuso horário. Mas com equipes internacionais dispersas, o seu hoje pode ser o de um companheiro de equipe amanhã ou ontem, dependendo da localização. Você pode usar a cláusula WITH TIMEZONE para definir um fuso horário do qual exibir dados. Isso afeta a interpretação dos valores nas cláusulas SINCE e UNTIL .

Considere os dois gráficos de exemplo abaixo. Cada consulta tem um fuso horário especificado usando WITH TIMEZONE. Os dois estão separados por 8 horas. Observe que o padrão de dados é o mesmo, mas com deslocamento de 8 horas para alinhar com cada fuso horário respectivo:

SELECT count(*) 
FROM Public_APICall 
SINCE yesterday 
UNTIL today WITH TIMEZONE 'America/Los_Angeles' 
TIMESERIES

SELECT count(*) 
FROM Public_APICall 
SINCE yesterday 
UNTIL today WITH TIMEZONE 'Europe/London' 
TIMESERIES

Embora possa parecer complexo, a coorte baseada no tempo significa apenas uma maneira de organizar os dados em grupos baseados no tempo, como minuteOf, hourOf, weekOf e muito mais.

Quando você usa a cláusula SINCE para durações, você recupera toda a extensão de tempo da consulta. Mas esses dados podem nem sempre contar toda a história! E se você precisar analisar o desempenho dentro de um período de tempo mais de perto? Com coortes baseadas no tempo, você pode classificar ainda mais os dados em agrupamentos lógicos baseados no tempo.

Usando uma combinação de FACET e uma das muitas funções baseadas em tempo (como hourOf(timestamp)), você pode obter dados de uma semana e entender o desempenho com base na hora específica em que ocorreu. Isso revela tendências e identifica os momentos mais críticos para o seu aplicativo:

SELECT average(duration) 
FROM Public_APICall 
FACET hourOf(timestamp) 
SINCE 1 week ago

Depois de executar a consulta acima, você pode ver o tempo de resposta mais lento com base na hora do dia. A New Relic oferece muitas opções diferentes para facetar com base no tempo. O exemplo anterior agrupa por hora, mas você também pode agrupar por dia da semana para determinar quais dias têm o melhor e o pior tempo de resposta.

SELECT average(duration) 
FROM Public_APICall 
FACET weekdayOf(timestamp) 
SINCE 1 week ago

Agora você pode ver os períodos mais lentos do seu aplicativo em qualquer dia específico. Você pode usar isso para responder a perguntas críticas de negócios, como "Quando vendemos mais produtos?", ou "Quando temos mais inscrições ou logins?".

Você também pode agrupar os resultados por uma data específica. Isso ajuda ao considerar relatórios de SLA ou analisar mudanças de desempenho durante um determinado período.

SELECT average(duration) 
FROM Public_APICall 
FACET dateOf(timestamp) 
SINCE 1 week ago