• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

configurationde l'agent Go

Vous pouvez modifier les paramètres configuration de l'agent Go pour contrôler certains aspects de la manière dont New Relic monitore votre application. Par exemple:

  • Activez le mode haute sécurité.
  • Ajoutez une balise personnalisée pour le filtrage et le tri dans l'UI.
  • Désactivez la collecte des erreurs, la transaction événement, la trace de transaction et l'événement personnalisé.

Méthodes de configuration et priorité

La principale façon de configurer l'agent Go consiste à modifier la structure newrelic.Config dans le cadre de l'appel de newrelic.NewApplication(), qui fait partie du processusinstallation standard. Avec les versions agent Go 2.7.0 ou supérieures, vous pouvez également définir un nombre limité d'options configuration à l'aide configuration côté serveur dans l'UI.

L'agent Go suit cet ordre de priorité pour configuration. Si cette option est activée, la configuration côté serveur remplace all valeurs correspondantes dans la structure newrelic.Config, même si les valeurs côté serveur sont laissées vides.

New Relic Go agent: config order of precedence

Si configuration côté serveur est activée avec l'agent Go, elle remplace all valeurs correspondantes dans la structure newrelic.Config, même si les valeurs côté serveur sont laissées vides.

Voici des descriptions détaillées de chaque méthode de configuration :

Modifier les paramètres de configuration

Pour apporter des modifications configuration de l'agent Go, définissez les valeurs dans la structure newrelic.Config à partir d'un newrelic.ConfigOption personnalisé. Par exemple, pour désactiver New Relic monitoring temporairement à des fins de test, remplacez la Enabled valeur par false:

app, err := newrelic.NewApplication(
newrelic.ConfigAppName("Your Application Name"),
newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
func(config *newrelic.Config) {
config.Enabled = false
},
)

Dans cet exemple et les suivants, config représente votre structure de configuration New Relic, même si vous lui avez peut-être donné un nom de variable différent lorsque vous avez installé l'agent Go et lancé la configuration dans votre application.

Paramètres de configuration générale

Si vous utilisez New Relic CodeStream pour monitorer les performances de votre IDE, vous souhaiterez peut-être également associer un référentiel à vos services et associer des SHA de build ou une balise de sortie à des erreurs.

Configuration à partir de l'environnement

Pour une plus grande flexibilité, vous pouvez définir de nombreuses options de configuration en définissant des variables d'environnement au lieu de les coder en dur dans le code source de votre application. Pour les utiliser, ajoutez un appel à ConfigFromEnvironment() parmi vos autres options de configuration :

app, err := newrelic.NewApplication(
newrelic.ConfigAppName("Your Application Name"),
newrelic.ConfigLicense(os.Getenv("NEW_RELIC_LICENSE_KEY")),
newrelic.ConfigFromEnvironment(),
)

Notez que les variables d'environnement seront lues et leurs entrées correspondantes dans la structure newrelic.Config seront mises à jour, au point de la liste d'options où newrelic.ConfigFromEnvironment() apparaît. S'il existe des options de configuration supplémentaires répertoriées après ConfigFromEnvironment, elles peuvent remplacer les valeurs définies par ConfigFromEnvironment.

Par exemple, si les variables d’environnement suivantes sont définies :

NEW_RELIC_LICENSE_KEY="your_license_key_here"
NEW_RELIC_APP_NAME="Your Application Name"
NEW_RELIC_CODE_LEVEL_METRICS_ENABLED="true"
NEW_RELIC_CODE_LEVEL_METRICS_PATH_PREFIX="myproject/src"
NEW_RELIC_LABELS="Env:Dev;Label2:label2;Label3:label3;Label4:label4"

puis le code suivant :

app, err := newrelic.NewApplication(
newrelic.ConfigFromEnvironment(),
)

obtiendra le même résultat que l'équivalent codé en dur :

app, err := newrelic.NewApplication(
newrelic.ConfigAppName("Your Application Name"),
newrelic.ConfigLicense("your_license_key_here"),
newrelic.ConfigCodeLevelMetricsEnabled(true),
newrelic.ConfigCodeLevelMetricsPathPrefix("myproject/src"),
func(config *newrelic.Config) {
config.Labels = map[string]string{
"Env": "Dev",
"Label2": "label2",
"Label3": "label3",
"Label4": "label4",
}
},
)

Toutes les options de configuration possibles ne peuvent pas être définies via des variables d'environnement. Le tableau des variables d'environnement et des fonctions dans le réplicateur ci-dessous répertorie toutes les fonctions de configuration disponibles et leurs variables d'environnement correspondantes. Bien que toute option de configuration nommée puisse être définie en attribuant directement une valeur au champ correspondant dans la structure Config, nous recommandons d'utiliser des fonctions de configuration et/ou des variables d'environnement chaque fois que possible.

Définir tagde version

Le paramètre NEW_RELIC_METADATA_SERVICE_VERSION créera une tag, tag.service.version sur les données de l'événement. Dans ce contexte, la version du service est la version de votre code qui est déployée, dans de nombreux cas une version sémantique telle que 1.2.3 mais pas toujours. L'envoi de ces informations vous permet de facetter votre télémétrie par la version du logiciel déployé afin de pouvoir identifier rapidement quelles versions de votre logiciel produisent les erreurs.

Monitoring de l'IA

Cette section comprend la configuration de l'agent Go pour la mise en place de monitoring de l'IA.

Important

Si le traçage distribué est désactivé ou si le mode haute sécurité est activé, monitoring de l'IA ne collectera pas de données AI.

Important

Lorsque cette option est activée, monitoring de l'IA enregistre une copie en continu des entrées et des sorties envoyées vers et depuis les modèles que vous choisissez de monitorer, y compris toutes les informations personnelles qu'ils contiennent. Vous êtes responsable d'obtenir le consentement de l'utilisateur de votre modèle pour que son interaction puisse être enregistrée par un tiers (New Relic) dans le but d'assurer la monitoring de la fonctionnalité IA.

configurationd'événement personnalisé

Vous pouvez créer des événements personnalisés et les rendre disponibles pour l'interrogation et l'analyse.

configurationdes événements de transaction

Les événements de transaction sont utilisés pour collecter les événements correspondant aux requests Web et aux tâches d'arrière-plan. Les données d'événement permettent à l'UI de New Relic d'afficher des informations supplémentaires telles que l'histogramme et le centile.

configurationdu collecteur d'erreurs

Les paramètres suivants sont utilisés pour configurer le collecteur d’erreurs :

Conseil

Pour un aperçu de la configuration des erreurs dans New Relic, voir Gérer les erreurs dans APM.

configurationdu traceur de transactions

Voici les paramètres permettant de modifier la configuration du traceur de transaction. Pour plus d'informations sur la trace de transaction, voir trace de transaction.

configurationdu traceur de banque de données

Voici les paramètres datastore, y compris l'activation et les paramètres des requêtes lentes .

du traçage inter-application configuration

Voici les paramètres permettant de modifier la fonctionnalité de traçage inter-applications .

Important

le traçage inter-applicationa été abandonné au profit du traçage distribué et sera supprimé dans une future version agent .

configurationdu traçage distribué

Important

L'activation du traçage distribué nécessite la version 2.1.0 de l'agent Go ou supérieur, et il désactive le traçage inter-applications. Cela a également des effets sur d’autres fonctionnalités. Avant l'activation, lisez le guide de transition.

Le traçage distribué vous permet de voir le chemin emprunté par une requête lorsqu'elle traverse un système distribué.

Lorsque le traçage distribué est activé, vous pouvez collecter span événement.

configurationde l'événement

Span événement sont signalés pour traçage distribué. le traçage distribué doit être activé pour signaler l'événement span. Ces paramètres contrôlent la collecte de l'événement span :

configurationde traçage infini

Pour activer le traçage infini, activez le traçage distribué (définissez config.DistributedTracer.Enabled = true sur la structure newrelic.Config ) et ajoutez les paramètres supplémentaires ci-dessous. Pour un exemple, voir Agent de langage : Configurer le traçage distribué.

Paramètres de logging des applications

Les paramètres suivants sont disponibles pour configuration du logging application dans l'agent. Pour obtenir des conseils sur l'utilisation des journaux en contexte d'agent Go, consultez Go logs en contexte.

Important

Nécessite la version 3.17.0 ou supérieure d'agent Go

Paramètres des métriques de dépendance des modules

Les modules dépendance métriques peuvent être configurés de différentes manières dans l'agent Go. Les métriques de dépendance de module indiquent la liste des modules importés utilisés par votre application Go pour faciliter la gestion des dépendances de code. Il inclut également les informations de version des modules de votre application.

Important

Nécessite la version 3.20.0 d'agent Go ou supérieur

New Relic IAST

New Relic Interactive sécurité des applications Testing (IAST) teste votre application pour détecter d'éventuelles vulnérabilités exploitables en rejouant la requête HTTP générée avec une charge vulnérable. Vous pouvez activer New Relic IAST en mettant à jour le code de votre application Go avec la configuration transmise à la fonction INIT. Vous pouvez également effectuer ces configurations via un fichier YAML ou avec des variables d'environnement.

Les options définies à l'aide des fonctions INIT ont priorité sur l'environnement ou la configuration YAML. Cela dit, nous vous recommandons d'activer IAST à l'aide d'un fichier YAML car ces configurations seront transmises à d'autres agents de votre environnement.

Instructions d'installation

Importez l'intégration en ajoutant la dépendance directe suivante à votre fichier go.mod .

import "github.com/newrelic/go-agent/v3/integrations/nrsecurityagent"

Ensuite, initialisez et activez l’agent de sécurité.

Activer IAST

Configurer IAST

L'agent de sécurité peut être configuré avec les options suivantes.

les parties sensibles de votre applicationen matière de sécurité des instruments

L'intégration nrgin, nrgrpc, nrmicro, fasthttp ou nrmongo contient désormais du code pour prendre en charge l'analyse de sécurité des données qu'elles traitent.

De plus, l'agent Go effectuera un examen des vulnérabilités sur le code instrumenté contenant des segments datastore, des opérations SQL, des transactions et des appels HTTP encapsulés et des points de terminaison.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.