William-Yeh.fluentd

Überblick Versionen Einblicke

williamyeh.fluentd für Ansible Galaxy

Zusammenfassung

Rollenname in Ansible Galaxy: williamyeh.fluentd

Diese Ansible-Rolle bietet die folgenden Funktionen für Fluentd:

Installiert td-agent: das stabile Fluentd-Verpackungspaket, das von Treasure Data, Inc gepflegt wird.
Installiert mehrere Plugins.
Grundkonfiguration (echt Konfiguration sollte den Vorlagendateien des Benutzers überlassen bleiben; siehe Abschnitt Verwendung unten).

Rollenvariablen

Obligatorische Variablen

Keine.

Optionale Variablen

Benutzereinstellbare Standardwerte:

# td-agent-Version; z.B. 2.3.4
# Wenn nicht angegeben, wird die Standardversion (in der Regel die letzte stabile) installiert.
tdagent_version

# ein Array von Plugins (mit den neuesten Versionen), die installiert werden sollen
tdagent_plugins

# ein Dictionary von Plugins (mit angegebenen Versionen), die installiert werden sollen
# Dictionary-Felder:
#   - key: Erinnerung für dieses Plugin
#   - value:
#     - name:    Plugin-Name
#     - version: Plugin-Version
tdagent_plugins_versions

Benutzerinstallierbare Konfigurationsdateien - Hauptkonfiguration:

# conf-Datei (normalerweise td-agent.conf), die installiert werden soll,
# relativ zu `playbook_dir`;
# die Datei wird wörtlich kopiert
tdagent_conf_copy

# conf-Datei (normalerweise td-agent.conf.j2), die installiert werden soll,
# relativ zu `playbook_dir`;
# die Datei wird über das Ansible-Templatesystem kopiert
tdagent_conf_template

Benutzerinstallierbare Konfigurationsdateien - andere Konfigurationen:

# andere conf-Vorlagen, die nach "/etc/td-agent/conf.d" installiert werden sollen;
# Dictionary-Felder:
#   - key: Erinnerung für diese Konfiguration
#   - value:
#     - src:  Vorlagendatei relativ zu `playbook_dir`
#     - dest: Ziel-Datei relativ zu `/etc/td-agent/conf.d/`
tdagent_conf_others

Handler

reload td-agent
restart td-agent
stop td-agent

Verwendung

Schritt 1: Rolle hinzufügen

Fügen Sie den Rollennamen williamyeh.fluentd zu Ihrer Playbook-Datei hinzu.

Schritt 2: Variablen hinzufügen, falls vorhanden

Setzen Sie Variablen in Ihrer Playbook-Datei.

Ein einfaches Beispiel:

---
# Datei: simple-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

  vars:
    tdagent_plugins:
      - fluent-plugin-multiprocess
      - fluent-plugin-forest
      - fluent-plugin-elasticsearch

    tdagent_plugins_versions:
      prometheus:
        name: fluent-plugin-prometheus
        version: 0.1.2
      flowcounter:
        name: fluent-plugin-flowcounter
        version: 0.4.1

Schritt 3: Benutzerkonfigurationsdatei kopieren, falls notwendig

Ein praktisches Beispiel:

---
# Datei: complex-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

  vars:
    tdagent_plugins:
      - fluent-plugin-multiprocess
      - fluent-plugin-flowcounter
      - fluent-plugin-elasticsearch

    # wörtlich kopieren
    tdagent_conf_copy: "files/td-agent.conf"

    # über das Ansible-Templatesystem kopieren
    tdagent_conf_template: "templates/td-agent.conf.j2"

    # weitere Konfigurationen, die über das Ansible-Templatesystem kopiert werden sollen
    tdagent_conf_others:
      prometheus_metrics:
        src:  templates/prometheus.conf.j2
        dest: prometheus.conf