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

🌐 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
