darkwizard242.node_exporter
Rôle Ansible : Node Exporter
Rôle pour installer (par défaut) node_exporter sur les systèmes Debian/Ubuntu et EL.
Exigences
Aucune en soi.
Le fichier de service systemd créé pour node_exporter envoie la sortie standard et l'erreur standard vers syslog
et SyslogIdentifier est défini comme node_exporter
. Ainsi, vous pouvez consulter les journaux node_exporter
en exécutant la commande sudo journalctl -u node_exporter.service
sur le système. De plus, vous souhaiterez peut-être configurer rsyslog pour collecter les journaux avec programname node_exporter
et les sortir dans un fichier spécifique pour conserver les journaux. Pour la rotation des journaux, le rôle darkwizard242.logrotate est disponible sur Ansible Galaxy.
Variables du rôle
Les variables disponibles sont énumérées ci-dessous (situées dans defaults/main.yml
):
Liste des variables :
node_exporter_app: node_exporter
node_exporter_version: 1.5.0
node_exporter_osarch: linux-amd64
node_exporter_archive_format: tar.gz
node_exporter_dl_url: "https://github.com/prometheus/{{ node_exporter_app }}/releases/download/v{{ node_exporter_version }}/{{ node_exporter_app }}-{{ node_exporter_version }}.{{ node_exporter_osarch }}.{{ node_exporter_archive_format }}"
node_exporter_app_group: "{{ node_exporter_app }}"
node_exporter_app_group_desired_state: present
node_exporter_app_user: "{{ node_exporter_app }}"
node_exporter_app_user_desired_state: present
node_exporter_app_user_home_state: no
node_exporter_app_user_shell: /bin/false
node_exporter_temp_path: /tmp
node_exporter_bin_path: /usr/local/bin
node_exporter_bin_path_mode: '0755'
node_exporter_bin_path_remote_src: yes
node_exporter_systemd_service_setup: true
node_exporter_systemd_service_name: "{{ node_exporter_app }}"
node_exporter_systemd_service_flags: --collector.systemd --collector.processes --collector.mountstats
node_exporter_systemd_service_template: "{{ node_exporter_app }}.service.j2"
node_exporter_systemd_service_template_dest: "/etc/systemd/system/{{ node_exporter_app }}.service"
node_exporter_systemd_service_template_user: root
node_exporter_systemd_service_template_group: root
node_exporter_systemd_service_template_dest_mode: '0644'
node_exporter_systemd_service_template_backup: yes
node_exporter_systemd_service_desired_state: restarted
node_exporter_systemd_service_desired_boot_enabled: yes
node_exporter_app_port: 9100
node_exporter_app_check_status_code: 200
node_exporter_app_check_status_code_retries: 10
node_exporter_app_check_status_code_delay: 5
Tableau des variables :
Variable | Description |
---|---|
node_exporter_app | Définit l'application à installer, c'est-à-dire node_exporter |
node_exporter_version | Défini pour récupérer dynamiquement la version souhaitée à installer. Par défaut : 1.5.0 |
node_exporter_osarch | Définit l'architecture os. Utilisé pour obtenir le type correct de binaires selon l'architecture du système d'exploitation. Par défaut : linux-amd64 |
node_exporter_archive_format | Défini pour être utilisé lors du téléchargement de l'archive. |
node_exporter_dl_url | Définit l'URL pour télécharger le binaire node_exporter. |
node_exporter_app_group | Nom du groupe auquel appartient le propriétaire de node_exporter. Par défaut node_exporter . |
node_exporter_app_group_desired_state | présent indique de créer le groupe s'il n'existe pas. L'alternative est absent. |
node_exporter_app_user | Nom de l'utilisateur qui sera propriétaire de node_exporter. Par défaut node_exporter . |
node_exporter_app_user_desired_state | présent indique de créer l'utilisateur s'il n'existe pas. L'alternative est absent. |
node_exporter_app_user_home_state | Défini sur 'non' pour ne pas créer de répertoire personnel pour l'utilisateur node_exporter . |
node_exporter_app_user_shell | Variable utilisée pour définir si l'utilisateur doit avoir un shell par défaut. Défini sur /bin/false car non requis. |
node_exporter_temp_path | Chemin temporaire où l'archive node_exporter est téléchargée et extraite. |
node_exporter_bin_path | Chemin dans lequel placer le node_exporter réel. |
node_exporter_bin_path_mode | Permissions pour le binaire node_exporter . |
node_exporter_bin_path_remote_src | Défini pour permettre à Ansible de gérer l'opération de désarchive sur les hôtes distants. |
node_exporter_systemd_service_setup | Utilisé comme condition pour configurer un fichier de service systemd pour node_exporter . S'il est défini sur false , le fichier de service systemd pour node_exporter ne sera pas créé. |
node_exporter_systemd_service_name | Nom du fichier de service systemd lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_flags | Variable pour stocker et passer tout argument de ligne de commande de node_exporter dans son fichier de service lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_template | Fichier modèle de service systemd source Jinja2 à placer sur l'hôte lorsque le rôle est appliqué et que node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_template_dest | Nom de fichier de destination du service systemd node_exporter lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_template_user | Propriétaire du fichier de service systemd node_exporter lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_template_group | Groupe du fichier de service systemd node_exporter lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_template_dest_mode | Mode du fichier de service systemd node_exporter lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_template_backup | Pour sauvegarder tout fichier de service systemd node_exporter existant lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_desired_state | État souhaité du service systemd node_exporter lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_systemd_service_desired_boot_enabled | Pour activer le service node_exporter lorsque node_exporter_systemd_service_setup est défini sur vrai. |
node_exporter_app_port | Comme le port par défaut de node_exporter est 9100, cette variable est utilisée dans un gestionnaire qui vérifie si node_exporter fonctionne sur le port 9100 ou non. |
node_exporter_app_check_status_code | Code d'état que le gestionnaire recherche lors de la vérification de node_exporter. |
node_exporter_app_check_status_code_retries | Nombre de fois que le gestionnaire essaie de vérifier si node_exporter fonctionne. |
node_exporter_app_check_status_code_delay | Nombre de secondes de retard que le gestionnaire attend entre les vérifications de node_exporter. |
Dépendances
Aucune
Exemples de Playbook
Pour le comportement par défaut du rôle (c'est-à-dire l'installation de node_exporter) dans les playbooks Ansible.
- hosts: serveurs
roles:
- role: darkwizard242.node_exporter
Pour personnaliser le comportement du rôle (c'est-à-dire spécifier la version souhaitée de node_exporter) dans les playbooks Ansible.
- hosts: serveurs
roles:
- role: darkwizard242.node_exporter
vars:
node_exporter_version: 1.0.1
Pour personnaliser le comportement du rôle (c'est-à-dire désactiver la configuration du service systemd node_exporter) dans les playbooks Ansible.
- hosts: serveurs
roles:
- role: darkwizard242.node_exporter
vars:
node_exporter_systemd_service_setup: false
Licence
Informations sur l'auteur
Ce rôle a été créé par Ali Muhammad.
Installs & configures 'node_exporter' for scraping node metrics.
ansible-galaxy install darkwizard242.node_exporter