Configurer l'agent d'infrastructure à l'aide d'Ansible

Vous pouvez utiliser le rôle Ansible de New Relic pour vous aider à faire évoluer vos efforts d'observabilité New Relic à l'aide de la CLI New Relic et du référentiel d'installation ouverte New Relic. Pour obtenir des instructions sur l'utilisation d'Ansible, consultez la documentation d'Ansible. Il s’agit d’un effort soutenu par la communauté .

Vous souhaitez configurer l’agent d’infrastructure à l’aide d’Ansible ? Créez un compte New Relic gratuitement ! Aucune carte de crédit requise.

Exemple de code

New Relic fournit un exemple de code de gestion configuration pour vous aider à installer notre agent infrastructure à l'aide d'un workflow et d'outils communs à de nombreuses équipes d'opérations. Il s’agit d’un rôle Ansible de base et est destiné à être utilisé comme point de départ pour créer votre propre workflow personnalisé.

La configuration dépend de votre configuration et de vos normes spécifiques. Pour afficher un exemple de rôle Ansible et plus d'informations sur l'intégration, consultez la documentation Ansible Galaxy.

Compatibilité et exigences

Le rôle Ansible avec l'agent infrastructure de New Relic nécessite un système d'exploitation pris en charge.

Si vous avez besoin d’aide avec Ansible pour le système d’exploitation Windows , consultez Configuration d’un hôte Windows , sur le site de documentationAnsible .

Ce rôle est testé avec Ansible Core 2.13 et 2.14 et Python 3.10. Les versions d'Ansible Core antérieures à 2.10 ne sont pas prises en charge.

Configurer New Relic avec Ansible

installation

Ansible Galaxy

Lien vers Galaxy

$
ansible-galaxy install newrelic.newrelic_install

Assurez-vous d'avoir ansible.windows et ansible.utils s'ils ne sont pas déjà installés :

$
ansible-galaxy collection install ansible.windows ansible.utils

Manuel

Si vous souhaitez utiliser une copie locale du rôle, clonez le référentiel et exécutez make dans la racine du projet pour copier ce référentiel vers ~/.ansible/roles/newrelic.newrelic_install, permettant au rôle de se comporter comme s'il était installé depuis Galaxy.

Bien démarrer

Pour commencer à utiliser le rôle newrelic.newrelic_install:

1. Incluez le rôle dans votre manuel de jeu.
2. Personnalisez les variables requises.

Après l’installation, incluez le rôle newrelic.newrelic_install dans un playbook nouveau ou existant. Voici un exemple de configuration de votre rôle pour installer l'agent d'infrastructure :

---
- name: Install New Relic
  hosts: all
  roles:
    - role: newrelic.newrelic_install
      vars:
        targets:
          - infrastructure
          - logs
        tags:
          foo: bar
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>

Variables de configuration des rôles

Voici les variables disponibles pour configurer le rôle newrelic.newrelic_install :

Valeurs par défaut

Définir dans defaults/main.yml:

• cli_install_url
• cli_install_download_location
• target_name_map
• verbosity_on_log_file_path_linux
• verbosity_on_log_file_path_windows
• default_install_timeout_seconds

Variables d'environnement

Les valeurs sont définies sous le mot-clé environment dans votre playbook :

• NEW_RELIC_API_KEY (requis)
• NEW_RELIC_ACCOUNT_ID (requis)
• NEW_RELIC_REGION (facultatif : « US » ou « EU », par défaut « US »)

De plus, vous pouvez définir une variable HTTPS_PROXY facultative pour activer un proxy pour votre installation.

Consultez l'environnement distant d'Ansible pour plus d'informations.

Manuel d'exemples supplémentaires

- name: Install New Relic
  hosts: all
  roles:
    - role: newrelic.newrelic_install
      vars:
        targets:
          - infrastructure
          - logs
          - apm-php
        tags:
          foo: bar
        install_timeout_seconds: 1000
        verbosity: debug
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NEW_RELIC_APPLICATION_NAME: "My Application"
    HTTPS_PROXY: "http://my.proxy:8888"