📡 Spedire log come un professionista: Fluent Bit incontra Ansible nel mio homelab

Illustrazione: un uomo seduto per terra con un portatile che mostra Ansible

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

Ormai il mio piccolo homelab è cresciuto fino a diventare una flotta di macchine virtuali piccola ma agguerrita — quasi una dozzina, che ronzano tranquille. Ma più servizi significano più log… e più caos. 🌀

Per mettere ordine in quel caos, uso il log shipper open source Fluent Bit per raccogliere i log da tutte le mie VM e inoltrarli a un’istanza centralizzata di OpenSearch per l’analisi e la visualizzazione.

L’obiettivo? Raccogliere tutto — dagli avvisi sullo spazio su disco ai tentativi di login falliti, dal rumore di systemd ai succosi messaggi del kernel. Tutti i log di tutte le mie macchine devono finire ordinatamente indicizzati e ricercabili in un’unica dashboard di OpenSearch.

(Ti spiegherò il setup di OpenSearch presto in un post a parte.)

Ora, invece di entrare a mano in ogni VM e configurare Fluent Bit manualmente (no grazie 🙃), ho costruito un piccolo e ordinato Playbook Ansible che automatizza l’intero setup.

Ecco cosa fa il playbook:

  • Installa Fluent Bit
  • Carica un file di configurazione personalizzato dalla directory locale files/
  • Si assicura che il servizio sia avviato e abilitato

Una volta pronto il playbook, posso distribuire Fluent Bit su tutte le VM in una volta, in parallelo — nessun lavoro manuale. Un solo comando, e Ansible si occupa del resto.

Una delle cose migliori di Ansible è la sua idempotenza: controlla in modo intelligente lo stato di ogni sistema di destinazione ed esegue solo i task che servono davvero. Puoi eseguire il playbook più volte senza rompere niente — ed è pura magia DevOps. ✨

Perché funzioni serve un altro file: un inventory hosts.ini, che elenca gli indirizzi IP di tutte le mie VM e specifica come Ansible deve collegarsi via SSH.

--- # Ansible Playbook to install Fluent Bit
- name: Install packages and configure Fluent Bit on Debian 12
  hosts: homelab
  become: true

  vars:
    fluentbit_custom_config: true  # Set to true to upload your own config file from "files/"

  tasks:

    - name: Ensure gpg is installed
      ansible.builtin.apt:
        name: gnupg
        state: present
        update_cache: yes

    - name: Import Fluent Bit GPG key
      ansible.builtin.apt_key:
        url: https://packages.fluentbit.io/fluentbit.key
        keyring: /usr/share/keyrings/fluentbit-archive-keyring.gpg
        state: present

    - name: Add Fluent Bit repository
      ansible.builtin.apt_repository:
        repo: deb [signed-by=/usr/share/keyrings/fluentbit-archive-keyring.gpg] https://packages.fluentbit.io/debian/bookworm bookworm main
        filename: fluentbit
        state: present

    - name: Update apt cache
      ansible.builtin.apt:
        update_cache: yes

    - name: Install Fluent Bit
      ansible.builtin.apt:
        name: fluent-bit
        state: present

    - name: Optional - Deploy custom fluent-bit.conf from files/
      ansible.builtin.copy:
        src: fluent-bit.conf
        dest: /etc/fluent-bit/fluent-bit.conf
        owner: root
        group: root
        mode: '0644'
      notify: Restart fluent-bit
      when: fluentbit_custom_config | default(false)

    - name: Enable and start Fluent Bit service
      ansible.builtin.systemd:
        name: fluent-bit
        enabled: yes
        state: started

  handlers:
    - name: Restart fluent-bit
      ansible.builtin.systemd:
        name: fluent-bit
        state: restarted

Ecco un output di esempio dopo l’esecuzione del playbook. Come vedi, tutto è andato liscio — tranne per pihole, dove all’inizio mancava gpg, facendo fallire in parte la prima installazione. Dopo aver installato gpg, il playbook è andato fino in fondo senza problemi:

root@seedVM:~/ansible/fluent-bit# ansible-playbook install_and_configure.yml -i hosts.ini

PLAY [Install packages and configure Fluent Bit on Debian 12] ************************************************

TASK [Gathering Facts] ***************************************************************************************
ok: [pihole]
ok: [gitlab]
...

TASK [Install Fluent Bit] ************************************************************************************
ok: [gitlab]
ok: [grafana]
changed: [pihole]
...

TASK [Enable and start Fluent Bit service] *******************************************************************
ok: [nextcloud]
changed: [pihole]
...

RUNNING HANDLER [Restart fluent-bit] *************************************************************************
changed: [pihole]

PLAY RECAP ****************************************************************************************************
blog     : ok=8  changed=0  unreachable=0  failed=0
pihole   : ok=9  changed=7  unreachable=0  failed=0
seedVM   : ok=8  changed=0  unreachable=0  failed=0
Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli