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, batAs 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, fourSe 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: myAttKeySe 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, myCustomAttAs 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, PaSsWoRdVocê 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.barSe 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.barSe 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: fooPropriedades 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
enabledpara ativar a instrumentação.Use
includeeexcludepara 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 |
|---|---|
| |
| |
| |
|