Libri
Lua
Capitolo 5. Buone pratiche di programmazione
Registrazione delle Attività (Logging)

Lua:
Registrazione delle Attività (Logging)

Come fare:

Lua non ha un framework di logging incorporato, ma implementare una funzione di logging semplice è abbastanza diretto. Di seguito è riportato un esempio di base di tale funzione:

function logMessage(level, message)
    -- Logging di base su console
    print(string.format("[%s] %s: %s", os.date("%Y-%m-%d %H:%M:%S"), level, message))
end

-- Esempi di uso:
logMessage("INFO", "L'applicazione è stata avviata.")
logMessage("WARN", "Rilevata chiamata a funzione deprecata.")
logMessage("ERROR", "Apertura del file non riuscita.")

Quando si esegue il codice sopra, vedrai un output simile a questo:

[2023-03-22 14:55:01] INFO: L'applicazione è stata avviata.
[2023-03-22 14:55:01] WARN: Rilevata chiamata a funzione deprecata.
[2023-03-22 14:55:01] ERROR: Apertura del file non riuscita.

Per esigenze di logging più sofisticate, è possibile includere librerie di terze parti come LuaLogging per fornire funzionalità aggiuntive come livelli di log, gestori multipli e specifiche di formato.

Approfondimenti

Storicamente, il logging è stato un aspetto essenziale della diagnostica del software, diventando una pratica consolidata fin dai primi giorni della programmazione. L’importanza del logging non può essere sopravvalutata, in quanto funge da ‘black box’ in caso di guasto del sistema, fornendo informazioni sulle cause principali dei problemi.

Sebbene l’esempio sopra soddisfi solo le esigenze più rudimentali, ci sono molte alternative con set di funzionalità più ricche. Alcune di queste includono:

  • Logging su file per l’archiviazione persistente.
  • Rotazione dei file di log per gestire l’uso dello spazio su disco.
  • Inoltro dei log a un sistema o servizio di gestione dei log.

Quando ci si addentra nell’implementazione di un sistema di logging, i punti decisionali potrebbero includere la decisione sui livelli di log appropriati (debug, info, warn, error, fatal, ecc.), la strutturazione dei messaggi di log (ad esempio, JSON per un parsing facile) e assicurarsi che le prestazioni non siano significativamente impattate dall’attività di logging.

Per il logging nei sistemi distribuiti, è comune utilizzare soluzioni centralizzate di gestione dei log come ELK (Elasticsearch, Logstash e Kibana) o Splunk, che possono aggregare i log da più fonti, fornire capacità di ricerca robuste e visualizzare i dati per semplificare il debugging e l’analisi.

Vedi Anche

Gestione degli erroriOrganizzazione del codice in funzioni