• /
  • EnglishEspañolFrançais日本語한국어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

Suporte para funções NRQL em regras de gateway

|View as Markdown (English)

Este documento descreve as funções NRQL suportadas nas regras de gateway do Controle de Pipeline. Use essas funções para criar regras mais poderosas e precisas para filtrar e gerenciar seus dados.

Função

Descrição

Exemplo de consulta NRQL

aparse()

Extrai um valor de uma string com base em um padrão especificado.

DELETE FROM Log WHERE aparse(message, 'Error: %') = 'timeout'

dimensions()

Filtra dados com base em facetas ou dimensões associadas à sua métrica/evento.

DELETE FROM Log WHERE dimensions() LIKE '%collectd%'

floor()

Retorna o maior inteiro menor ou igual ao número especificado.

DELETE FROM Metric WHERE floor(duration) > 5

getField()

Extrai um campo específico de uma estrutura de dados complexa (por exemplo, objeto JSON).

DELETE FROM Metric WHERE getField(cpu_usage, percent) > 90

hourOf()

Extrai o componente de hora de um timestamp.

DELETE FROM Log WHERE hourOf(timestamp) IN (2, 3, 4)

mod()

Retorna o resto de uma operação de divisão.

DELETE FROM Log WHERE mod(timestamp/1000,20) != 1

numeric()

Converte um valor de string em um tipo numérico.

DELETE FROM Log WHERE numeric(responseTime) > 1000

round()

Arredonda um número para o inteiro mais próximo ou para um número especificado de decimais.

DELETE FROM Metric WHERE round(latency, 2) > 0.5

string()

Converte um valor numérico ou outro em um tipo de sequência de caracteres.

DELETE FROM Log WHERE string(statusCode) = '404'

substring()

Extrai uma parte especificada de uma string.

DELETE FROM Log WHERE substring(transactionId, 1, 3) = 'tmp'

weekdayOf()

Extrai o dia da semana de um timestamp (por exemplo, 'segunda-feira', 'domingo').

DELETE FROM Metric WHERE weekdayOf(timestamp) IN ('Saturday', 'Sunday')

Exemplos de múltiplas funções NRQL em regras de gateway

Esses exemplos demonstram como você pode combinar várias funções e usá-las em cenários mais complexos para obter filtragem e exclusão de dados precisas.

  • Esta regra exclui dados de contêineres que saíram, mas preserva registros de contêineres que saíram nos últimos 10 minutos:
DELETE FROM ContainerSample WHERE state = 'exited' AND status LIKE '%Exited%' AND NOT (status LIKE '%second%' AND numeric(aparse(status,'%Exited (%) * seconds ago%')) < 10) AND NOT (status LIKE '%About a minute ago%' OR status LIKE '%minute%' AND numeric(aparse(status,'%Exited (%) * minutes ago%')) < 10)
  • Esta regra exclui logs que estão associados a um padrão de log específico (collectd) e não são do tipo evento personalizado:
DELETE FROM Log, LogExtendedRecord WHERE dimensions() LIKE '%collectd%' AND newrelic.logs.customEventType IS NULL
  • Esta regra exclui um tipo específico de log de erros, mas os amostra mantendo apenas registros em que o timestamp é múltiplo de 101:
DELETE FROM Log WHERE message LIKE '%lib/ladon/middleware/caching.rb:49 run> terminated with exception%' AND floor(timestamp/101) = (timestamp/101) AND newrelic.logs.customEventType IS NULL

Essas novas funções expandem significativamente os recursos da sua consulta NRQL ao trabalhar com o gateway Controle de Pipeline, permitindo análise e gerenciamento de dados mais precisos.

Copyright © 2026 New Relic Inc.

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