Log di Nextcloud: quali sono i registri di­spo­ni­bi­li e come fare per aprirli?

Il processo di logging di Nextcloud rileva e documenta tutti gli eventi e i processi im­por­tan­ti che avvengono nel tuo ambiente cloud, al fine di con­trol­la­re lo stato del sistema e rilevare eventuali errori non appena si pre­sen­ta­no. La posizione in cui sono ar­chi­via­te o possono essere me­mo­riz­za­te le in­for­ma­zio­ni e la procedura per leggere i registri di Nextcloud varia a seconda della tipologia di registro se­le­zio­na­ta.

Che cosa si intende per logging di Nextcloud?

Il logging di Nextcloud si riferisce all’ac­qui­si­zio­ne e do­cu­men­ta­zio­ne di in­for­ma­zio­ni im­por­tan­ti per il sistema in un’istanza di Nextcloud. La funzione è uti­liz­za­ta so­prat­tut­to per mo­ni­to­ra­re lo stato del sistema e iden­ti­fi­ca­re tem­pe­sti­va­men­te le po­ten­zia­li fonti di errore. Il logging permette inoltre di mo­ni­to­ra­re attività insolite ed eventi im­por­tan­ti per la sicurezza, ad esempio i tentativi di accesso non au­to­riz­za­ti. Le in­for­ma­zio­ni raccolte sono ar­chi­via­te in registri che possono essere ana­liz­za­ti dagli am­mi­ni­stra­to­ri e dalle am­mi­ni­stra­tri­ci per garantire il corretto fun­zio­na­men­to del cloud o per risolvere eventuali problemi.

Quali sono i Nextcloud Log Level di­spo­ni­bi­li?

Nextcloud distingue tra cinque livelli di logging che indicano l’entità delle in­for­ma­zio­ni re­gi­stra­te. Questi co­sid­det­ti Nextcloud Log Level si pre­sen­ta­no così:

0 – DEBUG: a questo livello vengono re­gi­stra­te tutte le attività; si tratta del logging più det­ta­glia­to di­spo­ni­bi­le in un’istanza Nextcloud. 1 – INFO: in questo caso vengono re­gi­stra­te le attività sui file e gli accessi degli utenti, nonché gli avvisi, gli errori e quelli fatali. 2 – WARN: oltre agli errori e a quelli fatali, il livello 2 del logging di Nextcloud rileva solo le ope­ra­zio­ni eseguite cor­ret­ta­men­te, che però hanno portato a emettere un avviso per po­ten­zia­li problemi. 3 – ERROR: registra esclu­si­va­men­te gli errori fatali e le ope­ra­zio­ni non andate a buon fine che non hanno effetti negativi su altri servizi e processi. 4 – FATAL: la re­gi­stra­zio­ne avviene solo in caso di arresto del server.

I parametri relativi al livello di logging sono definiti nel file config/config.php. Il file config.php di Nextcloud è con­fi­gu­ra­to per il Log Level 2 (WARN) per im­po­sta­zio­ne pre­de­fi­ni­ta. Per la dia­gno­sti­ca dei problemi, ti con­si­glia­mo di attivare il livello DEBUG. Dopo aver ana­liz­za­to gli errori ti con­si­glia­mo però di riportare il logging a un livello meno det­ta­glia­to. DEBUG registra infatti molte in­for­ma­zio­ni e le pre­sta­zio­ni del server po­treb­be­ro ri­sen­tir­ne.

Quali sono i registri di Nextcloud di­spo­ni­bi­li e dove si trovano?

Nextcloud offre agli utenti diverse tipologie di registri per do­cu­men­ta­re attività e processi. Nelle parti seguenti troverai una de­scri­zio­ne più det­ta­glia­ta delle diverse opzioni di logging, ossia errorlog, file, syslog e systemd.

errorlog

Con questo metodo, tutte le in­for­ma­zio­ni di registro vengono inviate a error_log(), il file di registro degli errori del server web. La posizione di archiviazione dipende dalla scelta e dalla configurazione del server. Ad esempio, se si utilizza Apache, di solito il percorso del file è/var/log/apache2/error.log`. È comunque sempre possibile mo­di­fi­ca­re ma­nual­men­te la posizione di ar­chi­via­zio­ne in qualsiasi momento.

file

Tutti i registri di Nextcloud vengono ar­chi­via­ti in un file separato, de­no­mi­na­to nextcloud.log per im­po­sta­zio­ne pre­de­fi­ni­ta e che si trova in /var/www/nextcloud/data/. È possibile spe­ci­fi­ca­re il nome del file uti­liz­zan­do il parametro logfile, mentre il formato della data de­si­de­ra­to può essere scelto come opzione per mezzo del parametro logdateformat in config/config.php.

syslog

Tutte le in­for­ma­zio­ni di registro vengono inviate al programma daemon centrale del software cloud. Si tratta di un processo eseguito con­ti­nua­men­te in back­ground, che gestisce le richieste di servizio che si ve­ri­fi­ca­no pe­rio­di­ca­men­te.

systemd

Con questo tipo di logging di Nextcloud i registri vengono ar­chi­via­ti nel journal systemd, che gestisce i servizi in ese­cu­zio­ne sul sistema. Requisito ne­ces­sa­rio a tal fine è che sia in­stal­la­ta l’esten­sio­ne PHP php-systemd.

Come si fa ad aprire i registri di Nextcloud?

Uti­liz­zan­do il logging di Nextcloud basato su file è possibile con­sul­ta­re fa­cil­men­te tutti i dati di registro tramite le im­po­sta­zio­ni di am­mi­ni­stra­zio­ne (in “Logging”). Questa funzione è messa a di­spo­si­zio­ne dall’app Log Reader, che permette anche di scaricare i file di registro. Con le altre opzioni di logging è possibile aprire i registri uti­liz­zan­do un editor di testo e/o la riga di comando.

Close