darkwizard242.node_exporter
Rola Ansible: Node Exporter
Rola do instalacji (domyślnie) node_exporter na systemach Debian/Ubuntu oraz EL.
Wymagania
Brak wymagań.
Utworzony plik usługi systemd dla node_exporter przekazuje standardowe dane wyjściowe i błędy do syslog
, a SyslogIdentifier ustawiony jest na node_exporter
. Możesz przeglądać logi node_exporter
, wykonując polecenie sudo journalctl -u node_exporter.service
na systemie. Możesz także skonfigurować rsyslog, aby zbierać logi z programname node_exporter
i zapisywać je w konkretnym pliku dla utrzymania logów. Dla rotacji logów dostępna jest rola darkwizard242.logrotate na Ansible Galaxy.
Zmienne roli
Dostępne zmienne są wymienione poniżej (znajdują się w defaults/main.yml
):
Lista zmiennych:
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
Tabela zmiennych:
Zmienna | Opis |
---|---|
node_exporter_app | Definiuje aplikację do zainstalowania, tj. node_exporter |
node_exporter_version | Określa pożądana wersję do zainstalowania. Domyślnie: 1.5.0 |
node_exporter_osarch | Definiuje architekturę systemu operacyjnego. Używane do uzyskania odpowiedniego typu binarek w zależności od architektury systemu. Domyślnie: linux-amd64 |
node_exporter_archive_format | Używane podczas pobierania archiwum. |
node_exporter_dl_url | Definiuje URL do pobrania binarki node_exporter. |
node_exporter_app_group | Nazwa grupy, do której należy właściciel node_exporter. Domyślnie node_exporter . |
node_exporter_app_group_desired_state | "present" oznacza utworzenie grupy, jeśli nie istnieje. Alternatywą jest "absent". |
node_exporter_app_user | Nazwa użytkownika, który będzie właścicielem node_exporter. Domyślnie node_exporter . |
node_exporter_app_user_desired_state | "present" oznacza utworzenie użytkownika, jeśli nie istnieje. Alternatywą jest "absent". |
node_exporter_app_user_home_state | Ustawione na 'no', aby nie tworzyć katalogu domowego dla użytkownika node_exporter . |
node_exporter_app_user_shell | Używane do określenia, czy użytkownik powinien mieć domyślną powłokę. Ustawione na /bin/false , ponieważ nie jest to wymagane. |
node_exporter_temp_path | Tymczasowa ścieżka, gdzie pobierane i rozpakowywane jest archiwum node_exporter. |
node_exporter_bin_path | Ścieżka, w której umieszczana jest binarka node_exporter . |
node_exporter_bin_path_mode | Uprawnienia do binarki node_exporter . |
node_exporter_bin_path_remote_src | Ustalono, aby pozwolić ansible zarządzać operacją rozpakowywania na zdalnych hostach. |
node_exporter_systemd_service_setup | Używane jako warunek do skonfigurowania pliku usługi systemd dla node_exporter . Jeśli ustawione na false , plik usługi systemd dla node_exporter nie zostanie utworzony. |
node_exporter_systemd_service_name | Nazwa pliku usługi systemd, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_flags | Zmienna do przechowywania i przekazywania dowolnych flag wiersza poleceń node_exporter w jego pliku usługi, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_template | Szablon pliku usługi systemd w formacie Jinja2, który ma zostać umieszczony na hoście, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_template_dest | Docelowa nazwa pliku usługi systemd node_exporter, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_template_user | Właściciel pliku usługi systemd node_exporter, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_template_group | Grupa pliku usługi systemd node_exporter, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_template_dest_mode | Tryb pliku usługi systemd node_exporter, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_template_backup | Umożliwia utworzenie kopii zapasowej istniejącego pliku usługi systemd node_exporter, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_desired_state | Pożądany stan usługi systemd node_exporter, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_systemd_service_desired_boot_enabled | Ustawia usługę node_exporter jako włączoną przy rozruchu, gdy node_exporter_systemd_service_setup jest ustawione na "true". |
node_exporter_app_port | Domyślny port node_exporter to 9100, ta zmienna jest wykorzystywana w funkcji, która sprawdza, czy node_exporter działa na porcie 9100. |
node_exporter_app_check_status_code | Kod statusu, który serwis sprawdza, kiedy wykonuje kontrolę dla node_exporter. |
node_exporter_app_check_status_code_retries | Liczba prób sprawdzenia, czy node_exporter działa. |
node_exporter_app_check_status_code_delay | Czas opóźnienia w sekundach, który serwis czeka pomiędzy sprawdzeniami dla node_exporter. |
Zależności
Brak
Przykładowy Playbook
Dla domyślnego działania roli (tj. instalacji node_exporter) w playbookach ansible.
- hosts: serwery
roles:
- role: darkwizard242.node_exporter
Dla dostosowania działania roli (tj. określenia pożądanej wersji node_exporter) w playbookach ansible.
- hosts: serwery
roles:
- role: darkwizard242.node_exporter
vars:
node_exporter_version: 1.0.1
Dla dostosowania działania roli (tj. wyłączenia konfigurowania usługi systemd node_exporter) w playbookach ansible.
- hosts: serwery
roles:
- role: darkwizard242.node_exporter
vars:
node_exporter_systemd_service_setup: false
Licencja
Informacje o autorze
Ta rola została stworzona przez Ali Muhammada.
Installs & configures 'node_exporter' for scraping node metrics.
ansible-galaxy install darkwizard242.node_exporter