Beats-Client Ansible-Rolle

Ansible-Rolle zum Installieren und Konfigurieren von Elastic Beats-Clients. Hauptsächlich verwendet zum Versenden von Protokollen und Metriken an einen ELK-Stack. Standardmäßig wird diese Rolle Protokolle mit filebeat und metricbeat an Logstash auf demselben Server senden.

Anforderungen

• Ein Ziel, an das Daten gesendet werden - seit der Beats 5.x-Serie umfasst dies das Senden an file, kafka, redis, console, elasticsearch und/oder logstash.

Rollenvariablen

Sie benötigen ein SSL-Zertifikat, um Protokolle während der Übertragung zu logstash/elasticsearch zu verschlüsseln. Diese Logik wird von dieser Rolle nicht bereitgestellt, und die Verschlüsselung ist standardmäßig nicht aktiviert. Sie müssen die offiziellen Beatsby Dokumentationsleitfäden für Ausgabeoptionen über Variablen konsultieren.

Beispiel-Playbook

- name: Beats-Clients konfigurieren.
  hosts: clients
  roles:
    - role: freedomofpress.beats
  tags: clients

Tests ausführen

Diese Rolle verwendet Molecule und Testinfra zum Testen. Um es zu verwenden:

pip install -r requirements.txt
molecule test

Sie können auch selektive Befehle ausführen:

molecule idempotence
molecule verify

Um eine Elasticsearch-Benutzeroberfläche zur Fehlersuche zu starten, führen Sie aus:

make elastic-ui

Siehe die Molecule-Dokumentation für weitere Informationen.

Beitrage

Die folgenden Ressourcen waren für die Erstellung dieser Rolle von unschätzbarem Wert.

• geerlingguy.logstash
• DigitalOcean's ELK-Leitfaden
• filebeat-Konfigurationsleitfaden

Lizenz

MIT