Além dos filtros aleatórios e de duração, os observadores trace usam um filtro trace de atributo span para encontrar rastreamento útil. Você pode personalizar as regras de filtro para manter ou descartar rastreamentos que possuam spans com atributo específico.
Visão geral
As regras de filtro são pares de valores principais específicos para observadores trace individuais. Você usa o aplicativo de configurações Infinite Tracing para defini-los e visualizá-los.
O filtro de trace de atributo span permite um total de três regras e, por padrão, duas regras são fornecidas para capturar erros. Embora você possa remover as duas regras de erro padrão, recomendamos que você mantenha as duas regras de erro padrão e adicione uma regra adicional, se precisar de uma.
Adicione uma regra personalizada
Aqui está um exemplo de como adicionar uma regra para manter todos os traces que possuem spans com atributo contendo o usuário sally@some_company.com:
Vá para one.newrelic.com > All capabilities > Apps > Your apps > Infinite Tracing settings.
Para o observador trace que você deseja modificar, clique no ícone de engrenagem para abrir os filtros.
Em Create new rule, insira
userabaixo de Span key e, no dropdown Key operator, selecione o valor Equals:
Em Span value, insira
sally@some_company.come, no dropdown Value operator, selecione Equals.
No dropdown Observer action, selecione Keep.
Dica
Se você tiver algum rastreamento que corresponda a esta regra, você os verá listados abaixo da regra.
Clique em Add rule para salvar sua regra personalizada.
Quando você adiciona uma regra personalizada, ela entra em vigor imediatamente para esse observador trace .
Prioridade de regras
Cada regra é avaliada de forma independente. Se alguma regra corresponder, sua ação de observador, Keep ou Discard, será executada. Quando um trace tem intervalos com atributos que correspondem às regras de filtro Keep e Discard, o trace é descartado.
Por exemplo, suponha que você não queira salvar algum erro esperado que contenha uma determinada frase na mensagem de erro. Você pode criar uma regra de filtro Discard que destine a mensagem de erro e ainda retenha todos os outros rastreamentos com erro.