Rôle Ansible pour l'agent d'infrastructure New Relic

Ce rôle installe et configure l'agent d'infrastructure New Relic.

Notez qu'il s'agit d'un rôle simple, destiné à servir de point de départ pour votre propre flux de travail personnalisé.

Installation et utilisation du rôle Ansible

Ce que newrelic-infra affecte

• Ajoute la source du dépôt de packages de New Relic.
• Installe et configure l'agent d'infrastructure New Relic.

Commencer avec le rôle

Commencez par inclure le rôle dans votre playbook et personnalisez les variables requises.

Toutes les interactions typiques avec newrelic-infra se font par la configuration du rôle.

Installer l'agent d'infrastructure avec le rôle

Utilisez le code suivant pour installer l'agent.

---
- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_config:
          license_key: VOTRE_CLÉ_DE_LICENCE
          log_file: /var/log/nr-infra.log
          log_to_stdout: false

Référence

Configuration du rôle

Variables

nrinfragent_config (Requis)

Utilisé pour remplir la configuration de l'agent. Au minimum, vous devez fournir license_key. Pour les options de configuration actuelles, voir la documentation de New Relic.

nrinfragent_state (Optionnel)

Décrit ce que vous souhaitez faire avec l'agent :

• 'latest' - [par défaut] installe la dernière version de l'agent. Également present.
• 'absent' - Désinstalle l'agent.

nrinfragent_os_name (Optionnel)

Spécifie le système d'exploitation cible sur lequel l'agent d'infrastructure sera installé. Par défaut, c'est ansible_os_family. Pour une liste des systèmes d'exploitation pris en charge, voir le fichier meta/main.yml.

nrinfragent_os_version (Optionnel)

Spécifie la version du système d'exploitation du package d'installation nécessaire pour cette machine. Par défaut, c'est ansible_lsb.major_release. Principalement utilisé pour les systèmes d'exploitation de la famille RedHat. Pour une liste des systèmes d'exploitation pris en charge, voir le fichier meta/main.yml.

nrinfragent_os_codename (Optionnel)

Spécifie le code de nom du système d'exploitation du package d'installation nécessaire pour cette machine. Par défaut, c'est ansible_lsb.codename. Principalement utilisé pour les systèmes d'exploitation de la famille Debian. Pour une liste des systèmes d'exploitation pris en charge, voir le fichier meta/main.yml.

nrinfragent_choco_version (Optionnel)

Spécifie la version du package Chocolatey à installer newrelic-infra sur Windows. Peut être utilisé pour fixer la version ou mettre à niveau l'agent.

nrinfragent_service_state (Optionnel)

Spécifie l'état du service newrelic-infra après l'installation. Par défaut, c'est started, ce qui garantit que le service sera en cours d'exécution. Vous pouvez le changer en stopped pour l'installer simplement, sans le démarrer immédiatement.

nrinfragent_service_enabled (Optionnel)

Spécifie si le service démarrera au démarrage. Par défaut, c'est yes; changez-le en no pour empêcher le service de démarrer automatiquement au démarrage.

nrinfragent_integrations (Optionnel)

Spécifie les intégrations d'infrastructure à installer. La liste des intégrations disponibles peut être trouvée ici.

Chaque package doit fournir son name et son state. Le nom du package d'intégrations se trouve dans la section Installer et activer de la documentation des intégrations individuelles. Par convention, leur nom est celui du service avec le préfixe nri- (nri-apache, nri-redis, etc.).

Par défaut, l'état est absent, ce qui n'installe pas le package ; vous pouvez le changer en latest ou present. Par exemple :

nrinfragent_integrations:
  - { name: nri-nginx, state: "latest" }
  - { name: nri-mysql, state: "absent" }

Le code source de chaque intégration est disponible sur l'organisation GitHub de New Relic.

Suppression du package newrelic-infra-integrations et de ses intégrations associées

Cela ne s'applique que si vous avez le package newrelic-infra-integrations installé

Si vous souhaitez supprimer le package newrelic-infra-integrations ou l'une des intégrations associées (nri-redis, nri-cassandra, nri-apache, nri-nginx, nri-mysql), ajoutez newrelic-infra-integrations en tant que premier élément de nrinfragent_integrations avec l'état absent.

nrinfragent_integrations:
  - { name: newrelic-infra-integrations, state: "absent" }

Obsolète

Vous pouvez spécifier la clé de licence pour assurer la compatibilité. Nous vous recommandons d'utiliser license_key dans nrinfragent_config à la place. Si les deux sont spécifiés, celui dans nrinfragent_config prend le pas.

Compatibilité

Plateformes

• RHEL/CentOS
  • RHEL/CentOS 8
  • RHEL/CentOS 7
  • RHEL/CentOS 6
  • RHEL/CentOS 5
• Ubuntu
  • 18 Bionic
  • 16 Xenial
  • 14 Trusty
  • 12 Precise
• Debian
  • 10 Buster
  • 9 Stretch
  • 8 Jessie
  • 7 Wheezy
• SUSE Linux Enterprise
  • 12
• Windows
  • Tous
  • Avertissement: Le support Windows dépend du package tiers newrelic-infra Chocolatey, qui est maintenu par @ripclawffb et @xandrellas. Il est distribué sans aucune garantie ou support de New Relic.

Publication sur Ansible Galaxy

Pour publier une nouvelle version sur Ansible Galaxy, suivez ces étapes :

• Mettez à jour le CHANGELOG.md.
• Créez une nouvelle version sur GitHub.
• Assurez-vous que la version est importée dans Ansible Galaxy; en cas de problème, demandez à l'un des propriétaires du projet.

Support

Si vous avez besoin d'assistance avec les produits New Relic, vous êtes entre de bonnes mains avec plusieurs outils de diagnostic de support et canaux de support.

Si le problème a été confirmé comme un bug ou s'il s'agit d'une demande de fonctionnalité, ouvrez un problème sur GitHub.

Canaux de support

• Documentation de New Relic : Guide complet pour utiliser notre plateforme.
• Communauté New Relic : Le meilleur endroit pour poser des questions de dépannage.
• Développeur New Relic : Ressources pour construire des applications d'observabilité personnalisées.
• Université New Relic : Une gamme de formations en ligne pour les utilisateurs de New Relic, à tous les niveaux.
• Support technique New Relic 24/7/365 avec tickets. Lisez-en plus sur nos offres de support technique.

Confidentialité

Chez New Relic, nous prenons votre confidentialité et la sécurité de vos informations très au sérieux, et nous nous engageons à protéger vos informations. Nous devons souligner l'importance de ne pas partager de données personnelles dans des forums publics, et nous demandons à tous les utilisateurs de supprimer les journaux et les informations de diagnostic sensibles, qu'elles soient personnelles, confidentielles ou autres.

Nous définissons « Données personnelles » comme toute information relative à une personne identifiée ou identifiable, y compris, par exemple, votre nom, votre numéro de téléphone, votre code postal, votre identifiant de périphérique, votre adresse IP et votre adresse e-mail.

Pour plus d'informations, consultez l'avis général de confidentialité des données de New Relic.

Contribuer

Nous encourageons vos contributions pour améliorer ce projet ! Gardez à l'esprit que lorsque vous soumettez votre demande de tirage, vous devrez signer le CLA en passant par le clic. Vous devez signer le CLA une seule fois par projet.

Si vous avez des questions, ou pour exécuter notre CLA d'entreprise (qui est requis si votre contribution est au nom d'une entreprise), envoyez-nous un e-mail à opensource@newrelic.com.

Une note sur les vulnérabilités

Comme indiqué dans notre politique de sécurité, New Relic s'engage à la confidentialité et à la sécurité de nos clients et de leurs données. Nous croyons que fournir une divulgation coordonnée par des chercheurs en sécurité et collaborer avec la communauté de la sécurité sont des moyens importants d'atteindre nos objectifs de sécurité.

Si vous pensez avoir trouvé une vulnérabilité de sécurité dans ce projet ou dans l'un des produits ou sites Web de New Relic, nous vous invitons à nous le signaler via HackerOne.

Si vous souhaitez contribuer à ce projet, consultez ces directives.

À tous les contributeurs, nous vous remercions ! Sans votre contribution, ce projet ne serait pas ce qu'il est aujourd'hui.

Licence

infrastructure-agent-ansible est sous licence Apache 2.0.