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.
L'agent d'infrastructure peut être configuré de différentes manières. La méthode par défaut consiste à modifier les variables de configuration dans le fichier newrelic-infra.yml .
Redémarrez toujours l'agent après avoir modifié les paramètres. Les mises à jour de configuration d'intégration ne nécessitent pas de redémarrage de l'agent (le rechargement à chaud est pris en charge).
Méthodes de configuration et priorité
La méthode par défaut pour configurer l'agent d'infrastructure est le fichier de configuration newrelic-infra.yml . Vous pouvez remplacer le fichier de configuration en définissant des variables d'environnement, ce qui est idéal pour les environnements conteneurisés.
Les variables d'environnement remplacent le fichier de configuration. Le fichier de configuration remplace les valeurs par défaut de l'agent.
Voici des descriptions détaillées de chaque méthode de configuration :
Pour configurer l'agent d'infrastructure, utilisez le fichier newrelic-infra.yml . Son emplacement par défaut est :
Pour définir une variable d'environnement, utilisez le nom de la variable du fichier de configuration en majuscules et préfixez-le par NRIA_; par exemple, NRIA_LICENSE_KEY. Dans les environnements conteneurisés, renseignez les propriétés configuration telles que la clé de licence et la balise via des variables d'environnement.
Vous pouvez également définir des variables d'environnement dans le fichier de configuration avec des accolades doubles {{MY_ENV_VAR}}. Par exemple:
license_key:{{MY_LICENSE_KEY}}
Important
Souvent, l'agent d'infrastructure s'exécute en tant que service système dans l'hôte, géré globalement (par exemple systemd pour Linux, les services Windows, launchd pour macOS, etc.). Pour appliquer des modifications de configuration avec des variables d’environnement dans cette configuration, ces variables d’environnement doivent être définies et rendues visibles dans le contexte isolé dans lequel le service d’agent d’infrastructure s’exécute. La manière de procéder dépend de la plateforme, consultez la documentation du gestionnaire de services de votre plateforme pour savoir comment ajouter des variables d'environnement aux services système.
Vous pouvez utiliser des variables d'environnement pour contrôler les paramètres de configuration pour l'intégration sur l'hôte, qui peuvent ensuite être transmis à l'agent infrastructure . Les variables pouvant être utilisées avec chaque intégration sur hôte sont répertoriées dans la documentation de chaque intégration et peuvent être définies via l'une des méthodes suivantes.
L'option passthrough_environment prend en charge les expressions régulières pour les noms de variables.
Depuis l'intérieur du fichier de configuration : ajoutez une entrée au fichier de configuration de l'infrastructure pour permettre à l'agent d'obtenir les variables d'environnement que vous avez définies.
passthrough_environment:
- HTTPS_PROXY
- HTTP_PROXY
- HTTP.*
- .*
Depuis la ligne de commande : utilisez une autre variable d’environnement pour transmettre ces paramètres.
Chaque intégration dispose d'un ensemble de variables qui peuvent être écrasées en définissant et en passant une variable d'environnement avec exactement le même nom que l'argument (par exemple, une variable d'environnement PORT pour remplacer l'argument de port redis ).
Vous pouvez également définir des variables d'environnement dans le fichier de configuration d'intégration avec la notation {{}} . Par exemple:
integration_name: com.newrelic.redis
instances:
-name: redis-metrics
command: metrics
arguments:
hostname: localhost
port:6379
password:{{MY_REDIS_PASSWORD}}
Conseil
Assurez-vous que le service newrelic-infra a une visibilité sur toute variable d’environnement personnalisée définie dans l’hôte. Les gestionnaires de services tels que systemd ne définiront pas toutes les variables d'environnement par défaut et peuvent nécessiter des étapes supplémentaires.
Explorez les options de configuration
Pour obtenir une liste de tous les paramètres que vous pouvez configurer, y compris les définitions, les valeurs par défaut et les variables d'environnement associées, consultez Paramètres de configuration de l'infrastructure.
Structure du fichier de configuration
Lors de la modification des fichiers de configuration YAML de l'agent ou de l'intégration :
Ne modifiez pas la casse des options de configuration : les clés YAML sont sensibles à la casse.
Respecter les niveaux d'indentation. Toutes les indentations sont par incréments similaires, généralement de deux caractères d'espacement. Les données d’une même section du fichier doivent utiliser le même niveau d’indentation. Indentez les sous-sections de deux espaces (voir les exemples dans attribut personnalisé et Filtres d'interface réseau).
Le format YAML fait la distinction entre les nombres et les chaînes. Utilisez des guillemets pour analyser les valeurs de configuration sous forme de chaîne.
Un modèle de newrelic-infra.yml est disponible dans le référentiel de l'agent d'infrastructure. Utilisez un validateur pour vous assurer que la syntaxe est exacte avant d’utiliser le fichier avec l’agent d’infrastructure.
Outils de gestion de la configuration
Pour installer et gérer l'agent d'infrastructure avec des outils de gestion de configuration, consultez les documents suivants :
