Ansible-Rolle für FileBeat

Eine Ansible-Rolle, die FileBeat auf Red Hat/CentOS oder Debian/Ubuntu installiert.

Getestet auf

• EL / CentOS (6 / 7)
• Debian (Wheezy / Jessie)
• Ubuntu (Trusty / Xenial)
• Solaris

Rollen-Variablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit ihren Standardwerten, die in defaults/main.yml definiert sind.

FileBeat Benutzer und Gruppe. Wenn Sie FileBeat mit einem anderen Benutzer als root ausführen, stellen Sie sicher, dass Ihre Protokolle für den FileBeat-Benutzer lesbar sind. Fügen Sie den FileBeat-Benutzer zu einer privilegierten Gruppe hinzu, die Zugang zu Ihren Protokollen hat.

Auf Ubuntu würden Sie den Benutzer zur adm-Gruppe hinzufügen. Auf CentOS können Sie die Berechtigungen mit dem Befehl setfacl anpassen, z.B. sudo setfacl -m g:filebeat:r <path>.

filebeat_user: root
filebeat_group: root

Erstellen Sie den Benutzer und die Gruppe filebeat.

filebeat_create_user: true

FileBeat-Version, die verwendet werden soll.

filebeat_version: 6.3.0

Nutzen Sie das FileBeat apt-Repository.

Sie können eine URL verwenden, um eine bestimmte Version zu installieren. Dazu ändern Sie den Wert von filebeat_use_repo auf false, und passen optional den Wert von filebeat_package_baseurl an (der einen Standardwert für Sie hat).

filebeat_use_repo: true

FileBeat-Basis-URL für den Paket-Download, wenn filebeat_use_repo: false

filebeat_deb_baseurl: "https://artifacts.elastic.co/downloads/beats/filebeat"

Starten Sie FileBeat beim Booten.

filebeat_start_at_boot: true

FileBeat-Version-Upgrade. Diese Option ermöglicht Paket-Upgrades.

filebeat_upgrade: false

FileBeat-Konfigurationsdatei.

filebeat_config_file: /etc/filebeat/filebeat.yml

FileBeat-Registrierungsdatei.

filebeat_config_registry_file: /var/lib/filebeat/registry

Die FileBeat-Konfiguration wird basierend auf der Variablen filebeat_config erstellt. Zur einfacheren Verwaltung der Inhalte setzt sich die Variable filebeat_config aus mehreren anderen Variablen zusammen:

• filebeat_config_prospectors
• filebeat_config_output
• filebeat_config_shipper
• filebeat_config_logging

filebeat_config_prospectors: |
  filebeat:
    prospectors:
      -
        input_type: log
        paths:
          - /var/log/*.log
        registry_file: "{{filebeat_config_registry_file}}"
filebeat_config_output: |
  output:
    elasticsearch:
      hosts: [ 'localhost:9200' ]
filebeat_config_shipper: |
  shipper:
filebeat_config_logging: |
  logging:
    files:
      rotateeverybytes: 10485760 # = 10MB
filebeat_config: |
  {{filebeat_config_prospectors}}
  {{filebeat_config_output}}
  {{filebeat_config_shipper}}
  {{filebeat_config_logging}}

FileBeat-Vorlagen (eine Liste von Vorlagen zur Installation). Diese Vorlagen werden in das Verzeichnis /etc/filebeat kopiert und können beispielsweise im Elasticsearch-Ausgang verwendet werden.

https://www.elastic.co/guide/en/beats/filebeat/current/elasticsearch-output.html#_template

filebeat_templates: []

Verwendung

    - hosts: logging
      roles:
        - { role: torian.filebeat }

Lizenz

Siehe Lizenz

Autoreninformation

Diese Rolle wurde 2016 von Emiliano Castagnari erstellt.