Configurer l'agent d'infrastructure avec Puppet

Découvrez comment installer et configurer notre agent infrastructure , l'intégration des logs et l'agent PHP APM à l'aide du module newrelic_installer. Pour une explication sur la façon d'utiliser Puppet, consultez la documentation de Puppet. Il s’agit d’un effort soutenu par la communauté .

Nous fournissons ici les informations de base nécessaires à l'utilisation de cet outil de gestion de configuration. La configuration supplémentaire dépendra des normes et de la mise en œuvre de votre organisation.

Exigences

Notre module Puppet a les exigences suivantes :

Entreprise Puppet 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
Puppet 6.21.0 ou supérieur, mais inférieur à 8.0.0
Systèmes d'exploitation Debian, CentOS, OpenSUSE, RedHat, SLES, Ubuntu, Windows, Amazon Linux

Description du module

newrelic-newrelic_installer est un module Puppet qui vous aidera à faire évoluer vos efforts d'observabilité New Relic. Pour y parvenir, il utilise la CLI New Relic et notre référentiel d'installation ouvert.

Notre module Puppet est disponible sur Puppet Forge.

Important

L'installation d'une version d'agent d'infrastructure spécifique n'est pas prise en charge. Cette méthode installera toujours la dernière version de l'agent.

Installer l'agent d'infrastructure avec le module

Forge Puppet

bash

$puppet module install newrelic-newrelic_installer

Voir plus d'options d'installation sur PuppetForge

Manuel

Installer le kit de développement Puppet : https://www.puppet.com/docs/pdk/2.x/pdk_install.html
Cloner le référentiel (repository) et construire une tarball du module en utilisant pdk build. Par exemple, pkg/newrelic-newrelic_installer-0.1.0.tar.gz
Copiez tarball du module sur votre nœud maître et installez-le manuellement :

bash

$sudo puppet module install ~/newrelic-newrelic_installer-0.1.0.tar.gz
Notice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...
Notice: Downloading from https://forgeapi.puppet.com ...
Notice: Installing -- do not interrupt ...
/etc/puppetlabs/code/environments/production/modules
└─┬ newrelic-newrelic_installer (v0.1.0)
  ├── lwf-remote_file (v1.1.3)
  └── puppetlabs-powershell (v5.2.0)

Courir `newrelic-newrelic_installer`

Pour exécuter le module newrelic-newrelic_installer par défaut, déclarez la classe principale ::install avec la cible d'instrumentation et les informations d'identification du compte New Relic.

# /etc/puppetlabs/code/environments/<YOUR_ENVIRONMENT>/manifests/site.pp
class { 'newrelic_installer::install':
          targets               => ["infrastructure", "logs"],
          environment_variables => {
            "NEW_RELIC_API_KEY"          => "<YOUR-NR-API-KEY>",
            "NEW_RELIC_ACCOUNT_ID"       => <YOUR-NR-ACCOUNT-ID>,
            "NEW_RELIC_REGION"           => "<US|EU>"
          }
}

Paramètres Puppet

Voici les paramètres de la classe publique newrelic_installer::install :

paramètres	Type	Est requis	Description des paramètres
`targets`	Chaîne	Requis	Spécifie la cible à instrumenter avec New Relic. Les valeurs prises en charge incluent : `'infrastructure'` - Agent d'infrastructure New Relic `'logs'` - intégration de logs pour l'agent New Relic Infrastructure. *nécessite `'infrastructure'` `'php'` - Agent APM PHP New Relic
`environment_variables`	hacher	Requis	hacher des variables d'environnement à définir avant l'exécution. `NEW_RELIC_API_KEY`: votre clé utilisateur New Relic. Required. `NEW_RELIC_ACCOUNT_ID`: votre identifiant de compte New Relic. Required. `NEW_RELIC_REGION`: votre régiondata center (`US` ou `EU`). La valeur par défaut est `US`. `NEW_RELIC_APPLICATION_NAME`: utilisé par `'php'`. Cette option de configuration définit le nom de l'application sous laquelle les données sont signalées dans APM. La valeur par défaut est `'PHP Application'` si elle n'est pas spécifiée.
`verbosity`	Chaîne	Facultatif	Spécifie la verbosité de la sortie de commande Les valeurs prises en charge incluent `debug` `trace`
`tags`	hacher	Facultatif	hacheur de tag associé à l'entité instrumentée avec New Relic. Exemples : `{'key-name' => 'value', 'foo' => 'bar'}`
`proxy`	Chaîne	Facultatif	Définit le serveur proxy que l'agent doit utiliser. Exemples : `https://myproxy.foo.com:8080` `http://10.10.254.254`
`install_timeout_seconds`	Entier	Facultatif	Définit le délai d'expiration en secondes pour les installations de New Relic. La valeur par défaut est `600`.

Cette traduction automatique est fournie pour votre commodité.