DocumentaciónKCS de Experience Cloud

Los registros personalizados de AEM no aparecen en Cloud Manager

Última actualización: 3 de julio de 2026

Las instrucciones de registro personalizadas no aparecen en Cloud Manager cuando el registrador está configurado para escribir en un archivo de registro personalizado, cuando la configuración de fábrica de OSGi tiene un nombre incorrecto o cuando el nivel de registro es demasiado restrictivo. AEM as a Cloud Service no admite archivos de registro personalizados y expone únicamente secuencias estándar como aemerror, por lo que se omitirá la salida enviada a otra parte. Al corregir la ruta del archivo de registro, el nombre del archivo de configuración y el nivel de registro, se restauran las entradas esperadas. Para solucionar el problema, señale el registrador a logs/error.log y aplique valores de configuración válidos.

Descripción description

Entorno

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

Problema/Síntomas

  • Los archivos de registro personalizados como my-custom.log o saml.log no aparecen en Cloud Manager.
  • Las instrucciones de registro no aparecen en aemerror a pesar de la ejecución correcta.
  • Los comandos de cola de registro fallan al acceder a archivos de registro personalizados.
  • Las entradas de registro INFO o DEPURACIÓN no aparecen debido a un nivel de registro restrictivo.

Causa

AEM as a Cloud Service aplica un modelo de registro centralizado que escribe toda la salida de registro de Java en logs/error.log, por lo que ignora cualquier configuración que defina rutas de archivo de registro personalizadas. La configuración incorrecta del registrador OSGi, las convenciones de nomenclatura de archivos no válidas o la configuración restrictiva del nivel de registro también impiden que las instrucciones de registro aparezcan en el flujo de error de AEM.

Resolución resolution

Siga estos pasos para resolver el problema

  1. Revise las configuraciones del registrador OSGi en su repositorio de código e identifique cualquier configuración en la que org.apache.sling.commons.log.file especifique una ruta de archivo de registro personalizada en lugar de logs/error.log.
  2. Actualice la configuración del registrador para utilizar el archivo admitido estableciendo org.apache.sling.commons.log.file en logs/error.log y compruebe que todas las propiedades relacionadas utilicen valores válidos.
  3. Compruebe que el nombre del archivo de configuración sigue el formato requerido org.apache.sling.commons.log.LogManager.factory.config-.cfg.json y quite caracteres no válidos como tilde ( ).
  4. Compruebe la configuración del nivel de registro y establézcala en un valor en minúsculas válido como debug, info, warn o error, asegurándose de que no restrinja la salida esperada.
  5. Inspeccione todas las configuraciones del registrador y elimine definiciones duplicadas o en conflicto para el mismo paquete.
  6. Implemente la configuración actualizada a través de la canalización y compruebe que las entradas de registro aparezcan en el flujo de registro aemerror en Cloud Manager.

Lectura relacionada

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