Isto descreve as regras que a New Relic usa para determinar qual atributo incluir ou excluir para um destino. Isso também inclui um resumo das propriedades do agente .NET que não estavam mais disponíveis com o lançamento do atributo do agente New Relic nas versões 9.0 ou superior.
Regras de atributo
A New Relic segue estas regras para determinar qual atributo incluir ou excluir:
O campo attributes.enabled
substitui todas as outras configurações. Quando false
, nenhum atributo será reportado à New Relic.
Exemplo de configuração:
<attributes enabled="false"> <include>foo</include> <include>bar</include></attributes><transactionTracer enabled="true"> <attributes enabled="true"/></transactionTracer>
Exemplo de saída:
Keys passed in: foo, bar, batKeys included for all destinations:Keys excluded for all destinations: foo, bar, bat
As sinalizações {destination}.attributes.enabled
têm precedência sobre as chaves de inclusão e exclusão.
Exemplo de configuração:
<attributes enabled="true"> <include>one</include> <include>two</include></attributes><transactionTracer enabled="true"> <attributes enabled="false"> <include>three</include> <include>four</include> </attributes></transactionTracer>
Exemplo de saída:
Keys passed in: one, two, three, fourKeys included for transaction traces:Keys excluded for transaction traces: one, two, three, four
Se um destino estiver habilitado, todos os atributos do usuário serão enviados para esse destino por padrão.
Todos os atributos do usuário são padronizados como true
. Porém, por padrão, request atributo e message parâmetro estão desabilitados para todos os destinos.
Exemplo de configuração:
<attributes enabled="true"> <exclude>myAttKey</exclude></attributes>
Exemplo de saída:
Keys passed in: foo, bar, myAttKeyKeys included: foo, barKeys excluded: myAttKey
Se a mesma chave estiver listada nas listas de inclusão e exclusão, então o atributo com a chave especificada será excluído.
Exemplo de configuração:
<attributes enabled="true"> <include>foo</include> <include>myCustomAtt</include> <exclude>password</exclude> <exclude>myCustomAtt</exclude></attributes>
Exemplo de saída:
Keys passed in: foo, myCustomAtt, passwordKeys included: fooKeys excluded: password, myCustomAtt
As chaves diferenciam maiúsculas de minúsculas.
Exemplo de configuração:
<attributes enabled="true"> <exclude>password</exclude> <exclude>PaSsWoRd</exclude></attributes>
Exemplo de saída:
Keys passed in: password, Password, PASSWORD, PaSsWoRd, PassWORDKeys included: Password, PASSWORD, PassWORDKeys excluded: password, PaSsWoRd
Você pode usar um asterisco *
no final de uma chave como curinga. Isso corresponderá a todos os atributos com o mesmo prefixo.
Exemplo de configuração:
<attributes enabled="true"> <include>custom*</include> <exclude>request.parameters.*</exclude></attributes>
Exemplo de saída:
Keys passed in: custom, custom.key1, custom.key2, request.parameters., request.parameters.foo, request.parameters.barKeys included: custom, custom.key1, custom.key2Keys excluded: request.parameters., request.parameters.foo, request.parameters.bar
Se vários atributos de inclusão ou exclusão afetarem a mesma chave, a configuração mais específica terá prioridade.
Exemplo de configuração:
<attributes enabled="true"> <include>request.parameters.foo</include> <exclude>request.parameters.*</exclude></attributes>
Exemplo de saída:
Keys passed in: request.parameters., request.parameters.foo, request.parameters.barKeys included: request.parameters.fooKeys excluded: request.parameters., request.parameters.bar
Se o atributo include
ou exclude
for especificado em um destino, ele afetará apenas esse destino.
Exemplo de configuração:
<attributes enabled="true"> <include>foo</include></attributes><transactionEvents enabled="true"> <attributes enabled="true"> <exclude>foo</exclude> </attributes></transactionEvents>
Exemplo de saída:
Keys passed in: fooKeys included for transaction events:Keys included for other destinations: fooKeys excluded for transaction events: foo
Propriedades obsoletas
As propriedades a seguir não estão disponíveis no agente .NET v9.0. Visite a página do guia de migração do agente .NET 8.x para 9.x para obter propriedades de substituição ao atualizar seu agente .NET.
O elemento analyticsEvents
em newrelic.config está obsoleto. Habilite o elemento transactionEvents
em newrelic.config:
<transactionEvents enabled="true"/>
Por padrão, os parâmetros de solicitação não são enviados para o New Relic. Adicione request.parameters.*
à lista attributes.include
para ativar a coleta de parâmetros de solicitação.
<attributes> <include>request.parameters.*</include></attributes>
O valor parameterGroups
e suas configurações enabled
e ignore
estão obsoletos. Por padrão, customParameters
e responseHeaderParameters
são instrumentados, enquanto serviceRequestParameters
não são instrumentados. Para personalizar essas configurações:
Use a sinalização
enabled
para ativar a instrumentação.Use
include
eexclude
para alternar a instrumentação para um atributo específico.Por exemplo:
<attributes enabled="true"><include>service.request.*</include><exclude>response.headers.*</exclude><exclude>myCustomApiKey.*</exclude></attributes>Para mais informações sobre como configurar o atributo, veja os exemplos de atributo.
O sinalizador capture atributo em browserMonitoring
, transactionTracer
, transactionEvents
e errorCollector
está obsoleto. Em vez disso, use o subelemento attributes
para definir as configurações de atributo para cada um desses destinos.
New property | Example |
---|---|
| |
| |
| |
|