Attribut de l'agent Go

Les attributs sont des paires valeur clé contenant des informations sur l'événement de transaction, l'événement d'erreur et les erreurs de trace. Vous pouvez ajuster les destinations des attributs par défaut et créer des attributs personnalisés pour les attributs collectés par l'agent Go de New Relic, notamment :

Trace d'erreur
Événement de transaction
Pages vues

Pour un niveau de détail monitoring supplémentaire, créez un attribut personnalisé.

L'agent Go reçoit l'attribut par défaut suivant de votre application. Vous pouvez ajuster ces paramètres par défaut et activer ou désactiver l'attribut pour certaines destinations.

Le nom de l'hôte du serveur sous lequel le script actuel s'exécute, appelé avec newrelic.AttributeHostDisplayName.

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé
Événement de transaction : Désactivé
Exemple d'exclusion de cet attribut :
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeHostDisplayName)
```

Le code d'état de réponse pour une requête Web, appelé avec newrelic.AttributeResponseCodeDeprecated

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé
Événement de transaction : Activé
Exemple d'exclusion de cet attribut :
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCodeDeprecated)
```
Important
À partir de l'agent Go v3.0.0, cet attribut a été marqué comme obsolète et renommé en http.statusCode. L'agent v3.x continuera à produire cet attribut, mais il sera supprimé dans la v4.0.0.

Le type tel que lu à partir de l'en-tête Accept de la requête HTTP, appelé avec newrelic.AttributeRequestAccept

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestAccept)

La taille de la requête entrante en octets telle que lue à partir de l'en-tête de requête Content-Length, appelée avec newrelic.AttributeRequestContentLength.

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestContentLength)

Le type de contenu de la requête entrante tel que lu à partir de l'en-tête de requête Content-Type, appelé avec newrelic.AttributeRequestContentType.

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestContentType)

Le nom de l'en-tête de la requête de l'hôte HTTP, appelé avec newrelic.AttributeRequestHost.

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestHost)

Le référent de la requête entrante tel que lu à partir de l'en-tête de requête Referer, appelé avec newrelic.AttributeRequestReferer.

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Désactivé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestReferer)

Le contenu de l'en-tête HTTP User-Agent, appelé avec newrelic.AttributeRequestUserAgentDeprecated

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé
Événement de transaction : Désactivé
Exemple d'exclusion de cet attribut :
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestUserAgentDeprecated)
```
Important
À partir de l'agent Go v3.0.0, cet attribut a été marqué comme obsolète et renommé en request.headers.userAgent. L'agent v3.x continuera à produire cet attribut, mais il sera supprimé dans la v4.0.0.

Le contenu de l'en-tête HTTP User-Agent, appelé avec newrelic.AttributeRequestUserAgent

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé
Événement de transaction : Désactivé
Exemple d'exclusion de cet attribut :
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestUserAgent)
```
Important
Cet attribut a été ajouté dans la version 3.0.0 de l'agent et le request.headers.User-Agent d'origine sera éventuellement supprimé. Par conséquent, l'agent v3.x produira deux attributs représentant le contenu de l'en-tête HTTP utilisateur-agent. Pour exclure complètement l'attribut lors de l'utilisation de l'agent v3.x, vous devez inclure l'ancien et le nouvel attribut. Par exemple:
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestUserAgent, newrelic.AttributeRequestUserAgentDeprecated, )

La méthode HTTP de la requête entrante, appelée avec newrelic.AttributeRequestMethod

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeRequestMethod)

La taille de la réponse sortante en octets telle que lue à partir de l'en-tête de réponse Content-Length, appelée avec newrelic.AttributeResponseContentLength.

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseContentLength)

Le type de contenu de la réponse sortante tel que lu à partir de l'en-tête de réponse Content-Type, appelé avec newrelic.AttributeResponseContentType.

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé

Événement de transaction : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseContentType)

Le code d'état de réponse pour une requête Web, appelé avec newrelic.AttributeResponseCode

Paramètres par défaut :

trace de transaction : Activé
Collecteur d'erreurs (trace des erreurs) : Activé
Événement de transaction : Activé
Exemple d'exclusion de cet attribut :
```
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCode)
```
Important
Cet attribut a été ajouté dans la version 3.0.0 de l'agent et le httpResponseCode d'origine sera éventuellement supprimé. Par conséquent, l'agent v3.x produira deux attributs représentant le code d'état de réponse pour une requête Web. Pour exclure complètement l'attribut lors de l'utilisation de l'agent v3.x, vous devez inclure l'ancien et le nouvel attribut. Par exemple:
config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCode, newrelic.AttributeResponseCodeDeprecated, )

Attribut Span et segment

Si vous disposez d'agent Go v2.6.0 ou supérieur, vous pouvez configurer des attributs sur des étendues et des segments. L'agent Go reçoit l'attribut par défaut suivant de votre application. Ces attributs ne se trouvent que sur les segments span événement et trace de transaction. Vous pouvez ajuster ces paramètres par défaut et activer ou désactiver l'attribut pour certaines destinations.

Pour les segments de datastore, il s'agit de la collection utilisée et représente la table ou le groupe, appelé avec newrelic.SpanAttributeDBCollection.

Paramètres par défaut :

Segments de trace de transaction : activés

Événement de portée : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeDBCollection)

Pour les segments de datastore, il s'agit du nom de la base de données et représente le nom de la base de données dans laquelle la requête est exécutée, appelée avec newrelic.SpanAttributeDBInstance.

Paramètres par défaut :

Segments de trace de transaction : activés

Événement de portée : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeDBInstance)

Pour les segments de banque de données, il s'agit de la requête paramétrée en cours d'exécution et représente la requête en cours d'exécution, appelée avec newrelic.SpanAttributeDBStatement.

Paramètres par défaut :

Segments de trace de transaction : activés

Événement de portée : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeDBStatement)

Pour les segments externes, il s'agit de la méthode http de la requête sortante, appelée avec newrelic.SpanAttributeHTTPMethod.

Paramètres par défaut :

Segments de trace de transaction : activés

Événement de portée : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeHTTPMethod)

Pour les segments externes, il s'agit de l'URL de la requête sortante, appelée avec newrelic.SpanAttributeHTTPURL.

Paramètres par défaut :

Segments de trace de transaction : activés

Événement de portée : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributeHTTPURL)

Pour les segmentsdatastore il s'agit du nom d'hôte plus le port de la base de données en cours de requête, appelé avec newrelic.SpanAttributePeerAddress.

Paramètres par défaut :

Segments de trace de transaction : activés

Événement de portée : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributePeerAddress)

Pour les segmentsdatastore il s'agit du nom d'hôte de la base de données interrogée, appelé avec newrelic.SpanAttributePeerHostname.

Paramètres par défaut :

Segments de trace de transaction : activés

Événement de portée : Activé

Exemple d'exclusion de cet attribut :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.SpanAttributePeerHostname)

Changer la destination de l'attribut

Utilisez ces options pour modifier les destinations des attributs :

Pour ouvrir ou fermer une destination entière à attribuer, définissez l'indicateur .Enabled sur true ou false.

Par exemple, pour désactiver la collecte d'erreurs : après la configuration, ajoutez :

config.ErrorCollector.Attributes.Enabled = false

Pour activer ou désactiver un attribut spécifique, utilisez les méthodes .Include ou .Exclude .

Par exemple, pour désactiver AttributeResponseCode: Après la configuration, ajoutez :

config.Attributes.Exclude = append(config.Attributes.Exclude, newrelic.AttributeResponseCode)

Créer un attribut personnalisé

Ajoutez un attribut personnalisé en utilisant cette méthode dans une transaction :

txn.AddAttribute("key", "value")

La variable txn est celle instrumentée pour la transaction Go. Par exemple:

txn.AddAttribute("product", "widget")
txn.AddAttribute("price", 19.99)
txn.AddAttribute("importantCustomer", true)

Paramètres par défaut pour l'attribut destinations personnalisées :

Collecteur d'erreurs (trace des erreurs) : Activé
Événement de transaction : Activé

Cette traduction automatique est fournie pour votre commodité.

Attribut de l'agent Go