javiergayala.filebeat

Przegląd Wersje Wgląd

Ansible Rola: Filebeat

Rola Ansible Wynik jakości Ansible Wydanie Github (najnowsze SemVer) Data wydania Github

Instaluje Filebeat na systemach RedHat/CentOS.

Ta rola instaluje i konfiguruje najnowszą wersję Filebeat (6.x) z oficjalnego repozytorium Elastic.co Repo.

Wymagania

Brak.

Zmienne roli

Wartości domyślne (szczegóły w `defaults/main.yml`):

es_major_version: "6.x"

Wersja Filebeat powinna zawsze odpowiadać wersji Elasticsearch w twoim stosie ELK. To oznacza główną wersję Elasticsearch.

es_use_repository: undefined

Ta wartość nie jest zdefiniowana w roli. Udokumentowałem to, ponieważ jest to wartość zazwyczaj zdefiniowana w roli elastic.elasticsearch przez Elastic.co. Jeśli instalujesz tę rolę Filebeat obok roli elastic.elasticsearch, to ta rola zazwyczaj zainstaluje repozytorium za Ciebie. Pozwolenie tej roli Filebeat na zainstalowanie repozytorium spowoduje lekką modyfikację pliku repozytorium, co prowadzi do tego, że rola przestaje zwracać wyniki idempotentne. Jednak jeśli powiesz roli elastic.elasticsearch, aby NIE instalowała repozytorium, to ta rola Filebeat zainstaluje repozytorium, aby uzyskać dostęp do oprogramowania.

es_version: "6.2.3"

Pełny numer wersji Elasticsearch/Filebeat.

filebeat_create_config: "true"

Określa, czy rola może utworzyć plik konfiguracyjny Filebeat.

filebeat_enabled: "yes"

Definiuje, czy usługa Filebeat powinna być włączona przy starcie.

filebeat_repo_key: 'https://artifacts.elastic.co/GPG-KEY-elasticsearch'

Adres URL do klucza PGP używanego dla repozytorium Elastic.co.

filebeat_run_state: started

Określa, czy usługa Filebeat powinna być uruchomiona.

filebeat_config_content:
  filebeat.prospectors:
    - type: log
      enabled: "true"
      paths:
        - "/var/log/*.log"
  filebeat.config.modules:
    reload.enabled: "false"
    path: "{{ filebeat_modules_dir }}/*.yml"
  setup.template.settings:
    index.number_of_shards: 3
  output.elasticsearch:
    hosts:
      - "localhost:9200"

Zmienna filebeat_config_content to słownik, który zawiera podstawową konfigurację Filebeat. Wartość tej zmiennej zostanie użyta do wypełnienia pliku konfiguracyjnego filebeat.yml. Typowe klucze, które chcesz zdefiniować to:

filebeat.prospectors
filebeat.config.modules
setup.template.settings
Wyjście (np. output.elasticsearch lub output.logstash)

filebeat_module_config: {}

Zmienna filebeat_module_config to słownik podobny do filebeat_config_content, jednak służy do tworzenia plików konfiguracyjnych dla modułów Filebeat. Klucz w słowniku to nazwa modułu, który chcesz włączyć, a zawartość tego klucza to również słownik zawierający konfigurację dla tego modułu.

Na przykład:

filebeat_module_config:
  system:
    syslog:
      enabled: "true"
    auth:
      enabled: "true"

Wartości specyficzne dla RedHat (szczegóły w `vars/filebeat-RedHat.yml`)

filebeat_home: /usr/share/filebeat

Ścieżka, gdzie zainstalowano Filebeat.

filebeat_bin_dir: "{{ filebeat_home }}/bin"

Ścieżka, gdzie zainstalowano plik wykonywalny Filebeat.

filebeat_config_dir: "/etc/filebeat"

Ścieżka do katalogu konfiguracyjnego Filebeat.

filebeat_config_file: "{{ filebeat_config_dir }}/filebeat.yml"

Pełna ścieżka do pliku konfiguracyjnego Filebeat.

filebeat_modules_dir: "{{ filebeat_config_dir }}/modules.d"

Ścieżka, w której przechowywana jest konfiguracja modułów Filebeat.

Zależności

Brak.

Przykładowy playbook

- hosts: servers
  roles:
     - role: javiergayala.filebeat
       filebeat_module_config:
         system:
           syslog:
             enabled: "true"
           auth:
             enabled: "true"