Skip to main content

Capitolo 10 – Logging, Monitoraggio e Troubleshooting

La gestione dei server non si limita a deploy e configurazione: è fondamentale monitorare lo stato e poter diagnosticare problemi rapidamente.

Ansible offre strumenti integrati per log e debug, ma è utile combinarli con best practice sysadmin.

10.1 Verbosità e Output

Per ottenere informazioni dettagliate durante l’esecuzione:

ansible-playbook playbooks/site.yml -v       # livello base
ansible-playbook playbooks/site.yml -vv      # più dettagli
ansible-playbook playbooks/site.yml -vvv     # debug SSH e task
ansible-playbook playbooks/site.yml -vvvv    # dettagli estremi (output completo)
  • Utilizzare i livelli più alti solo in fase di debug
  • Per grandi infrastrutture, può generare molto output

10.2 Modulo Debug

Il modulo debug è fondamentale per verificare variabili o output intermedi.

Esempio:

- name: Mostra valore di una variabile
  debug:
    var: http_port

- name: Mostra messaggio personalizzato
  debug:
    msg: "Deploy completato su {{ inventory_hostname }}"

10.3 Check Mode

Permette di simulare l’esecuzione senza modificare i server.

ansible-playbook playbooks/base.yml --check

Utile per:

  • Verificare impatto dei cambiamenti
  • Evitare errori in produzione
  • Validare logica dei playbook

10.4 Test di Syntax

Prima di eseguire un playbook, controllarne la sintassi:

ansible-playbook playbooks/base.yml --syntax-check

Permette di:

  • Evitare errori di YAML
  • Verificare correttezza struttura tasks e ruoli

10.5 Registrare Output

È possibile salvare l’output di un task in una variabile per uso successivo:

- name: Controlla spazio disco
  command: df -h /var
  register: disco

- name: Mostra spazio disco
  debug:
    var: disco.stdout
  • register salva l’output del task
  • Permette logica condizionale e troubleshooting

10.6 Gestione Errori

  • Task possono essere ignorati con ignore_errors: yes
  • Condizioni di fallback con failed_when
  • Retry automatici con retries e delay (modulo until)

Esempio:

- name: Esegue comando con retry
  command: /usr/bin/check_service
  register: result
  retries: 3
  delay: 10
  until: result.rc == 0

10.7 Log Centralizzato

Per infrastrutture grandi, utile salvare output dei playbook:

ansible-playbook playbooks/site.yml | tee /var/log/ansible/site.log
  • Consente audit e storico modifiche
  • Utile per verificare esecuzioni su più server

10.8 Best Practice Troubleshooting

  • Testare playbook in staging prima di prod
  • Usare --check e --diff per evitare modifiche indesiderate
  • Usare debug per variabili e output
  • Registrare log per audit e rollback
  • Isolare task problematici per esecuzione separata

10.9 Conclusione

Un corretto approccio a logging e troubleshooting permette di:

  • Rilevare problemi rapidamente
  • Migliorare sicurezza e affidabilità
  • Automatizzare interventi di controllo
  • Mantenere infrastruttura coerente

Nei prossimi capitoli si potrà affrontare la gestione di deploy multi-tier e orchestrazione complessa con Ansible.

Back to top