Activer et désactiver l'attribut (.NET)

Le champ attributes.enabled remplace tous les autres paramètres. Lorsque false, aucun attribut ne sera signalé à New Relic.

Exemple de configuration :

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

Exemple de sortie :

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

Les indicateurs {destination}.attributes.enabled ont priorité sur les clés d'inclusion et d'exclusion.

Exemple de configuration :

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

Exemple de sortie :

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

Si une destination est activée, tous les attributs utilisateur sont envoyés à cette destination par défaut.

Tous les attributs utilisateur sont par défaut true. Cependant, par défaut, l'attribut de demande et le paramètre de message sont désactivés pour toutes les destinations.

Exemple de configuration :

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

Exemple de sortie :

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

Si la même clé est répertoriée dans les listes d'inclusion et d'exclusion, l'attribut avec la clé spécifiée sera exclu.

Exemple de configuration :

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

Exemple de sortie :

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

Les clés sont sensibles à la casse.

Exemple de configuration :

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

Exemple de sortie :

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

Vous pouvez utiliser un astérisque * à la fin d'une clé comme caractère générique. Cela correspondra à tous les attributs avec le même préfixe.

Exemple de configuration :

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

Exemple de sortie :

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 plusieurs attributs d'inclusion ou d'exclusion affectent la même clé, le paramètre le plus spécifique aura la priorité.

Exemple de configuration :

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

Exemple de sortie :

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

Si l'attribut include ou exclude est spécifié sur une destination, il n'impacte que cette destination.

Exemple de configuration :

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

Exemple de sortie :

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

L'élément analyticsEvents dans newrelic.config est obsolète. Activer l'élément transactionEvents dans newrelic.config:

<transactionEvents enabled="true"/>

Par défaut, les paramètres de requête ne sont pas envoyés à New Relic. Ajoutez request.parameters.* à la liste attributes.include pour activer la collecte des paramètres de demande.

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

La valeur parameterGroups et ses paramètres enabled et ignore sont obsolètes. Par défaut, customParameters et responseHeaderParameters sont instrumentés, tandis que serviceRequestParameters ne le sont pas. Pour personnaliser ces paramètres :

• Utilisez l’indicateur enabled pour activer l’instrumentation.

• Utilisez include et exclude pour basculer instrumentation pour un attribut spécifique.

  Par exemple:

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

  Copier

  Pour plus d'informations sur la configuration des attributs, consultez les exemples d'attributs.

L'attribut de capture sur browserMonitoring, transactionTracer, transactionEvents et errorCollector est obsolète. Utilisez plutôt le sous-élément attributes pour configurer les paramètres d’attribut pour chacune de ces destinations.

<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>>