DocumentazioneExperience Cloud KCS

I registri personalizzati di AEM non vengono visualizzati in Cloud Manager

Ultimo aggiornamento: 3 luglio 2026

Le istruzioni di registro personalizzate non vengono visualizzate in Cloud Manager quando il logger è configurato per scrivere su un file di registro personalizzato, quando la configurazione di fabbrica OSGi non è denominata correttamente o quando il livello di registro è troppo restrittivo. AEM as a Cloud Service non supporta file di registro personalizzati ed espone solo flussi standard come aemerror, pertanto l’output inviato altrove viene ignorato. Se si corregge il percorso del file logger, il nome del file di configurazione e il livello di registro, vengono ripristinate le voci previste. Per risolvere il problema, puntare il logger su logs/error.log e applicare valori di configurazione validi.

Descrizione description

Ambiente

  • Adobe Experience Manager as a Cloud Service
  • AEM Managed Services
  • AEM Assets Essentials

Problema/Sintomi

  • I file di registro personalizzati come my-custom.log o saml.log non vengono visualizzati in Cloud Manager.
  • Le istruzioni di registro non vengono visualizzate in aemerror nonostante l’esecuzione sia riuscita.
  • I comandi di log tail non riescono quando si accede a file di log personalizzati.
  • Le voci del registro INFO o DEBUG non vengono visualizzate a causa di un livello di registro restrittivo.

Causa

AEM as a Cloud Service applica un modello di registrazione centralizzato che scrive tutti gli output del registro Java in logs/error.log. Pertanto ignora qualsiasi configurazione che definisce percorsi di file di registro personalizzati. Inoltre, una configurazione del logger OSGi errata, convenzioni di denominazione dei file non valide o impostazioni restrittive del livello di registro impediscono la visualizzazione delle istruzioni di registro nel flusso di errore.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito

  1. Rivedi le configurazioni del logger OSGi nel tuo archivio di codice e identifica eventuali configurazioni in cui org.apache.sling.commons.log.file specifica un percorso di file di registro personalizzato invece di logs/error.log.
  2. Aggiornare la configurazione del logger per utilizzare il file supportato impostandolo su logs/error.log e verificare che tutte le proprietà correlate utilizzino valori validi.org.apache.sling.commons.log.file
  3. Verificare che il nome del file di configurazione segua il formato richiesto org.apache.sling.commons.log.LogManager.factory.config-.cfg.json e rimuovere i caratteri non validi, ad esempio tilde ( ).
  4. Controllare la configurazione a livello di log e impostarla su un valore in minuscolo valido, ad esempio debug, info, warn o error, assicurandosi che non limiti l’output previsto.
  5. Controllare tutte le configurazioni del logger e rimuovere le definizioni duplicate o in conflitto per lo stesso pacchetto.
  6. Distribuisci la configurazione aggiornata tramite la pipeline e verifica che le voci di registro vengano visualizzate nel flusso di registro aemerror in Cloud Manager.

Lettura correlata

recommendation-more-help
experience-cloud-kcs-help-kbarticles