DocumentazioneCommerceGuida alla configurazione

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Abilita registrazione

Last update: Wed Nov 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore
WARNING
Tutti i comandi CLI di Magento devono essere eseguiti dal proprietario del file system.

Debug logging

Per impostazione predefinita, Commerce scrive nel registro di debug (<install_directory>/var/log/debug.log) quando è in modalità predefinita o di sviluppo, ma non quando è in modalità di produzione. Utilizzare il comando bin/magento setup:config:set --enable-debug-logging per modificare il valore predefinito.

INFO
A partire da Commerce 2.3.1, non è più possibile utilizzare il comando bin/magento config:set dev/debug/debug_logging per abilitare o disabilitare la registrazione di debug per la modalità corrente.

Per abilitare la registrazione di debug

  1. Utilizzare il comando setup:config:set per abilitare la registrazione di debug per la modalità corrente.

    code language-bash 
    bin/magento setup:config:set --enable-debug-logging=true

  2. Svuota la cache.

    code language-bash 
    bin/magento cache:flush

Per disabilitare la registrazione di debug

  1. Utilizzare il comando setup:config:set per disabilitare la registrazione di debug per la modalità corrente.

    code language-bash 
    bin/magento setup:config:set --enable-debug-logging=false

  2. Svuota la cache.

    code language-bash 
    bin/magento cache:flush

Registrazione del database

Per impostazione predefinita, Commerce scrive i log delle attività del database nel file <install-dir>/var/debug/db.log.

Percorso di archiviazione registrazione query

Quando la registrazione del database è abilitata, Commerce memorizza i registri delle query nel percorso seguente:

  • File di registro query: <install-directory>/var/debug/db.log
  • Directory di registro: <install-directory>/var/debug/

Il registro query contiene:

  • Query SQL eseguite dall’applicazione
  • Tempi di esecuzione della query
  • Parametri di query e associazioni
  • Informazioni sulla connessione al database
NOTE
Il file di registro delle query può crescere rapidamente in ambienti con traffico elevato. Monitorare lo spazio su disco e implementare la rotazione del registro o la pulizia periodica del file di registro delle query.

Per abilitare la registrazione del database

  1. Utilizzare il comando dev:query-log per abilitare o disabilitare la registrazione del database.

    code language-bash 
    bin/magento dev:query-log:enable
    code language-bash 
    bin/magento dev:query-log:disable

  2. Svuota la cache.

    code language-bash 
    bin/magento cache:flush

Per visualizzare i registri delle query

Puoi visualizzare i registri delle query utilizzando i comandi standard di visualizzazione dei file:

# View the entire query log
cat var/debug/db.log

# View the last 100 lines of the query log
tail -n 100 var/debug/db.log

# Monitor the query log in real-time
tail -f var/debug/db.log

# Search for specific queries
grep "SELECT" var/debug/db.log

Registrazione Cron

Con la versione 2.3.1 di, Commerce ora crea un registro cron separato.
Commerce ha recentemente reso la registrazione cron più dettagliata, fornendo ulteriori informazioni ma allungando notevolmente system.log.
Spostando le informazioni di cron in un registro dedicato, è più facile leggere entrambi i registri.

Per impostazione predefinita, Commerce scrive cron informazioni nel file <install-directory>/var/log/cron.log.

Registrazione Syslog

Per impostazione predefinita, Commerce scrive i registri syslog nel file syslog del sistema operativo.
A partire da Commerce 2.3.1, è necessario utilizzare il comando magento per abilitare o disabilitare syslog.
L’impostazione in Admin (Amministrazione) è stata rimossa.

Per abilitare la registrazione syslog

La registrazione a syslog è disabilitata per impostazione predefinita.

  1. Utilizzare il comando setup:config:set per modificare il valore del database dev/syslog/syslog_logging in true.

    code language-bash 
    bin/magento setup:config:set --enable-syslog-logging=true

  2. Svuota la cache.

    code language-bash 
    bin/magento cache:flush

Per disattivare la registrazione syslog

  1. Utilizzare il comando setup:config:set per modificare il valore del database dev/syslog/syslog_logging in false.

    code language-bash 
    bin/magento setup:config:set --enable-syslog-logging=false

  2. Svuota la cache.

    code language-bash 
    bin/magento cache:flush
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c