Installation manuelle de l'agent d'infrastructure pour Linux à partir de Tarball

Notre processus d'installation Linux personnalisé pour monitoring de l'infrastructure vous permet de personnaliser tous les aspects du processus d'installation et de placer des fichiers et des dossiers sur votre système de fichiers. Vous avez le contrôle total de l'installation.

Installer l'agent

Avant l'installation, vérifiez la compatibilité et les exigences.

Pour installer l’agent :

1. Téléchargez le fichier de l'agent du package ou utilisez la commande suivante qui récupère automatiquement une version spécifique de l'agent, sa somme de contrôle et la vérifie après le téléchargement. Remplacez ARCH=amd64 par l'architecture souhaitée (amd64, 386, arm64, arm) et V=1.27.4 par la version la plus récente ou spécifique.

   bash

   Copier

   $
   V=1.27.4 ARCH=amd64; echo "https://download.newrelic.com/infrastructure_agent/binaries/linux/${ARCH}/newrelic-infra_linux_${V}_${ARCH}.tar.gz" | { read    url; wget "${url}"{,.sum}; shasum -a 256 --check ${url##*/}.sum; }

   À partir de la version 1.27.4 , nous fournissons la signature GPG du package tar.gz . Vous pouvez consulter la procédure de signature et les instructions de vérification dans le référentiel infra-agent sur GitHub.

2. Décompressez le fichier.

3. Assurez-vous que le fichier se décompresse avec la structure suivante :

   newrelic-infra
   |-- config_defaults.sh
   |-- etc
   |   |-- init_scripts
   |   |   |-- systemd
   |   |   |   `-- newrelic-infra.service
   |   |   |-- sysv
   |   |   |   `-- newrelic-infra
   |   |   `-- upstart
   |   |       `-- newrelic-infra
   |   `-- newrelic-infra
   |       `-- integrations.d
   |-- installer.sh
   |-- usr
   |   `-- bin
   |       |-- newrelic-infra
   |       |-- newrelic-infra-ctl
   |       `-- newrelic-infra-service
   `-- var
       |-- db
       |   `-- newrelic-infra
       |       |-- custom-integrations
       |       |-- integrations.d
       |       |-- LICENSE.txt
       |       `-- newrelic-integrations
       |-- log
       |   `-- newrelic-infra
       `-- run
           `-- newrelic-infra

   Copier

4. Installez le script de service.

5. Facultatif : étapes d'installation supplémentaires.

Installation : étapes facultatives

Vous pouvez également effectuer ces étapes supplémentaires :

• Modifiez l'emplacement du fichier de configuration.
• Modifiez l'emplacement du fichier PID.
• Changer l'utilisateur et le mode d'exécution.
• Configurer le répertoire du plugin.
• Configurer le répertoire de l'agent.
• Configurez le fichier de log.
• Modifiez l'emplacement du binaire de l'agent.

Installer le script de service

Avant de procéder à l'installation du script de service, vous devez déterminer quel gestionnaire de services votre système utilise :

• Si vous utilisez l'un des gestionnaires de services pris en charge (SystemD, SysV et Upstart), utilisez le script de service fourni dans l' tarball.
• Si vous utilisez un gestionnaire de services que nous ne prenons pas en charge, vous devez écrire votre propre script de service.

Si vous utilisez l’un des gestionnaires de services pris en charge, installez le script de service pour votre hôte :

Votre script de service est configuré. Configurez le reste des options et démarrez le service manuellement.

Modifier l'emplacement du fichier de configuration

L'agent d'infrastructure inclut un fichier de configuration, généralement nommé newrelic-infra.yml, pour affiner le comportement de l'agent. Pour plus d'informations, consultez un modèle de fichier de configuration et comment configurer l'agent.

Par défaut, l'agent recherche le fichier de configuration dans l'un de ces emplacements :

• newrelic-infra.yml (dossier racine du répertoire de travail)
• /etc/newrelic-infra.yml
• /etc/newrelic-infra/newrelic-infra.yml

Pour spécifier un emplacement différent, utilisez la ligne de commande de l'indicateur -config . Par exemple:

$
usr/bin/newrelic-infra -config /whatever/path/custom_config_name.yml

Pour rendre cette modification permanente, modifiez le script de service :

Changer l'emplacement du fichier PID

L'agent d'infrastructure utilise un pid-file pour conserver le numéro d'identification du processus (pid), qui est utilisé pour identifier une instance en cours d'exécution de l'agent. La manière de modifier l’emplacement du pid-file dépend de la configuration de l’agent.

Pour modifier l'emplacement du pid-file:

Changer le mode utilisateur et d'exécution

L'agent Linux s'exécute par défaut sous root , mais il prend également en charge l'exécution avec un utilisateur avec moins de privilèges : PRIVILEGED et UNPRIVILEGED. Pour plus d'informations, consultez notre documentation sur les modes d'exécution des agents.

Pour changer le mode de fonctionnement :

1. Modifier le script de service :

   Systèmed

   1. Ouvrez le script de service ./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.service.
   2. Recherchez la ligne [Service].
   3. Ajoutez la ligne User=user_name et remplacez user_name par l'utilisateur pour lequel vous souhaitez exécuter l'agent (PRIVILEGED ou UNPRIVILEGED).
   4. Sauvegarder le fichier.

   SysV

   1. Ouvrez le script de service ./newrelic-infra/etc/init_scripts/sysv/newrelic-infra.
   2. Recherchez la ligne USER=root.
   3. Remplacez root par l’utilisateur pour lequel vous souhaitez exécuter l’agent (PRIVILEGED ou UNPRIVILEGED).
   4. Sauvegarder le fichier.

   Parvenu

   1. Ouvrez le script de service ./newrelic-infra/etc/init_scripts/upstart/newrelic-infra.
   2. Recherchez la ligne exec /usr/bin/newrelic-infra.
   3. Remplacez-le par exec su -s /bin/sh -c ‘exec “$0” “$@“’ user_name-- /usr/bin/newrelic-infra.
   4. Remplacez user_name par l’utilisateur pour lequel vous souhaitez exécuter l’agent (PRIVILEGED ou UNPRIVILEGED).
   5. Sauvegarder le fichier.

2. Si vous exécutez l'agent en tant que PRIVILEGED, vous devez lui donner deux fonctionnalités Linux supplémentaires:

   1. Assurez-vous que la bibliothèque libcap est installée sur votre hôte. (Vous avez besoin des commandes setcap et getcap qui l'accompagnent.)

   2. Extrayez le contenu de l' tarball et exécutez la commande suivante avec l'autorisation root :

      bash

      Copier

      $
      setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infra

   3. Le mode d’exécution sera sélectionné en fonction de l’utilisateur actuel et des capacités du noyau qui lui sont attribuées.

Configurer le répertoire des plugins

L'agent infrastructure vous permet d'installer une intégration qui monitore et rapporte les données de services populaires tels que Kubernetes, AWS, MySQL, Redis, Kafka, etc. Chaque intégration possède son propre fichier de configuration, nommé par défaut integration-name-config.yml, placé à l'emplacement prédéfini /etc/newrelic-infra/integrations.d/. Lors de l'initialisation, l'agent charge le fichier de configuration.

Pour écraser l’emplacement prédéfini du fichier de configuration d’intégration, utilisez l’une des méthodes suivantes :

• Définissez l'emplacement dans la variable d'environnement NRIA_PLUGIN_DIR .
• Définissez le chemin personnalisé dans le fichier de configuration newrelic-infra.yml à l'aide du champ plugin_dir .
• Transmettez-le comme argument de ligne de commande en utilisant -plugin_dir lorsque vous exécutez le binaire newrelic-infra .

Configurer le répertoire des agents

L'agent nécessite son propre répertoire défini pour exécuter l' intégration installée, la mise en cache des données (inventaire), etc. L'emplacement par défaut est /var/db/newrelic-infra/.

Le répertoire des agents a la structure et le contenu suivants :

• LICENSE:Fichier texte contenant la licence de l'agent New Relic Infrastructure.
• custom-integrations: Répertoire qui stocke l' intégration personnalisée installée.
• newrelic-integrations: Répertoire qui stocke l' intégration officielle de New Relic.
• data:Répertoire dans lequel l'agent stocke les données du cache (inventaire).

Pour écraser l’emplacement prédéfini du répertoire de l’agent, utilisez l’une des méthodes suivantes :

• Définissez l'emplacement dans la variable d'environnement NRIA_AGENT_DIR .
• Définissez le chemin personnalisé dans le fichier de configuration newrelic-infra.yml à l'aide du champ agent_dir .
• Transmettez-le comme argument de ligne de commande en utilisant -agent_dir lorsque vous exécutez le binaire newrelic-infra .

Configurer le fichier de log

Par défaut l'agent stocke le fichier de log dans /var/db/newrelic-infra/newrelic-infra.log.

Pour écraser l'emplacement prédéfini du fichier de log, utilisez l'une des méthodes suivantes :

• Définissez l'emplacement dans la variable d'environnement NRIA_LOG_FILE .
• Définissez le chemin personnalisé dans le fichier de configuration newrelic-infra.yml à l'aide du champ log_file .
• Transmettez-le comme argument de ligne de commande en utilisant -log_file lorsque vous exécutez le binaire newrelic-infra .

Modifier l'emplacement du binaire de l'agent

Pour modifier l’emplacement de l’exécutable, modifiez le script de service :

Quelle est la prochaine étape ?

Vous pourriez également vouloir :

• Ajoutez un attribut personnalisé pour annoter vos données infrastructure .
• Connectez votre compte AWS si vos serveurs sont hébergés sur Amazon EC2.
• Activer le transfert de log.
• Activez notre intégration Flex en ajoutant manuellement l'exécutable Flex.
• Ajoutez d’autres intégrationsinfrastructure pour collecter des données à partir de services externes.
• Démarrez, arrêtez, redémarrez ou vérifiez manuellement l'état de l'agent.