Activar y desactivar atributo (.NET)

El campo attributes.enabled anula todas las demás configuraciones. Cuando false, no se informará ningún atributo a New Relic.

Configuración de ejemplo:

<attributes enabled="false">
  <include>foo</include>
  <include>bar</include>
</attributes>
<transactionTracer enabled="true">
  <attributes enabled="true"/>
</transactionTracer>

Salida de ejemplo:

Keys passed in: foo, bar, bat
Keys included for all destinations:
Keys excluded for all destinations: foo, bar, bat

Las marcas {destination}.attributes.enabled tienen prioridad sobre las claves de inclusión y exclusión.

Configuración de ejemplo:

<attributes enabled="true">
  <include>one</include>
  <include>two</include>
</attributes>
<transactionTracer enabled="true">
  <attributes enabled="false">
    <include>three</include>
    <include>four</include>
  </attributes>
</transactionTracer>

Salida de ejemplo:

Keys passed in: one, two, three, four
Keys included for transaction traces:
Keys excluded for transaction traces: one, two, three, four

Si un destino está habilitado, todos los atributos del usuario se envían a ese destino de forma predeterminada.

Todos los atributos de usuario están predeterminados en true. Sin embargo, de forma predeterminada, el atributo de solicitud y el parámetro de mensaje están deshabilitados para todos los destinos.

Configuración de ejemplo:

<attributes enabled="true">
  <exclude>myAttKey</exclude>
</attributes>

Salida de ejemplo:

Keys passed in: foo, bar, myAttKey
Keys included: foo, bar
Keys excluded: myAttKey

Si la misma clave aparece en las listas de inclusión y exclusión, entonces se excluirá el atributo con la clave especificada.

Configuración de ejemplo:

<attributes enabled="true">
  <include>foo</include>
  <include>myCustomAtt</include>
  <exclude>password</exclude>
  <exclude>myCustomAtt</exclude>
</attributes>

Salida de ejemplo:

Keys passed in: foo, myCustomAtt, password
Keys included: foo
Keys excluded: password, myCustomAtt

Las claves distinguen entre mayúsculas y minúsculas.

Configuración de ejemplo:

<attributes enabled="true">
  <exclude>password</exclude>
  <exclude>PaSsWoRd</exclude>
</attributes>

Salida de ejemplo:

Keys passed in: password, Password, PASSWORD, PaSsWoRd, PassWORD
Keys included: Password, PASSWORD, PassWORD
Keys excluded: password, PaSsWoRd

Puede utilizar un asterisco * al final de una clave como comodín. Esto hará coincidir todos los atributos con el mismo prefijo.

Configuración de ejemplo:

<attributes enabled="true">
  <include>custom*</include>
  <exclude>request.parameters.*</exclude>
</attributes>

Salida de ejemplo:

Keys passed in: custom, custom.key1, custom.key2, request.parameters., request.parameters.foo, request.parameters.bar
Keys included: custom, custom.key1, custom.key2
Keys excluded: request.parameters., request.parameters.foo, request.parameters.bar

Si varios atributos de inclusión o exclusión afectan a la misma clave, la configuración más específica tendrá prioridad.

Configuración de ejemplo:

<attributes enabled="true">
  <include>request.parameters.foo</include>
  <exclude>request.parameters.*</exclude>
</attributes>

Salida de ejemplo:

Keys passed in: request.parameters., request.parameters.foo, request.parameters.bar
Keys included: request.parameters.foo
Keys excluded: request.parameters., request.parameters.bar

Si el atributo include o exclude se especifica en un destino, solo afecta a ese destino.

Configuración de ejemplo:

<attributes enabled="true">
  <include>foo</include>
</attributes>
<transactionEvents enabled="true">
  <attributes enabled="true">
    <exclude>foo</exclude>
  </attributes>
</transactionEvents>

Salida de ejemplo:

Keys passed in: foo
Keys included for transaction events:
Keys included for other destinations: foo
Keys excluded for transaction events: foo

El elemento analyticsEvents en newrelic.config está obsoleto. Habilite el elemento transactionEvents en newrelic.config:

<transactionEvents enabled="true"/>

De forma predeterminada, los parámetros de solicitud no se envían a New Relic. Agregue request.parameters.* a la lista attributes.include para habilitar la recopilación de parámetros de solicitud.

<attributes>
  <include>request.parameters.*</include>
</attributes>

El valor parameterGroups y sus configuraciones enabled y ignore están obsoletos. De forma predeterminada, customParameters y responseHeaderParameters están instrumentados, mientras que serviceRequestParameters no están instrumentados. Para personalizar estas configuraciones:

• Utilice la marca enabled para habilitar la instrumentación.

• Utilice include y exclude para alternar la instrumentación de un atributo específico.

  Por ejemplo:

  <attributes enabled="true">
    <include>service.request.*</include>
    <exclude>response.headers.*</exclude>
    <exclude>myCustomApiKey.*</exclude>
  </attributes>

  Copia

  Para obtener más información sobre la configuración de atributos, consulte los ejemplos de atributos.

El indicador de atributo de captura en browserMonitoring, transactionTracer, transactionEvents y errorCollector está obsoleto. En su lugar, utilice el subelemento attributes para configurar los ajustes de atributos para cada uno de estos destinos.

<browserMonitoring enabled="true">
  <attributes enabled="false">
    <include>myKey.*</include>
    <exclude>myKey.foo</exclude>
  </attributes>
</browserMonitoring>

<transactionTracer enabled="true">
  <attributes enabled="false">
    <include>myKey.*</include>
    <exclude>myKey.foo</exclude>
  </attributes>
</transactionTracer>

<transactionEvents enabled="true">
  <attributes enabled="false">
    <include>myKey.*</include>
    <exclude>myKey.foo</exclude>
  </attributes>
</transactionEvents>

<errorCollector enabled="true">
  <attributes enabled="false">
    <include>myKey.*</include>
    <exclude>myKey.foo</exclude>
  </attributes>
</errorCollector>>