DocumentaçãoKCS da Experience Cloud

Os logs personalizados do AEM não aparecem no Cloud Manager

Última atualização: 3 de julho de 2026

As instruções de log personalizadas não aparecem no Cloud Manager quando o agente de log está configurado para gravar em um arquivo de log personalizado, quando a configuração de fábrica do OSGi é nomeada incorretamente ou quando o nível de log é muito restritivo. O AEM as a Cloud Service não oferece suporte a arquivos de log personalizados e expõe apenas fluxos padrão, como aemerror. Portanto, a saída enviada para outro lugar é ignorada. A correção do caminho do arquivo de log, do nome do arquivo de configuração e do nível de log restaura as entradas esperadas. Para corrigir o problema, aponte o agente de log para logs/error.log e aplique valores de configuração válidos.

Descrição description

Ambiente

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

Problema/Sintomas

  • Arquivos de log personalizados, como my-custom.log ou saml.log, não aparecem no Cloud Manager.
  • As instruções de log não aparecem em aemerror apesar da execução bem-sucedida.
  • Os comandos tail de log falham ao acessar arquivos de log personalizados.
  • As entradas de log INFO ou DEBUG não aparecem devido a um nível de log restritivo.

Causa

O AEM as a Cloud Service impõe um modelo de log centralizado que grava toda a saída de log Java em logs/error.log, de modo que ignora qualquer configuração que defina caminhos de arquivo de log personalizados. Configuração incorreta do agente de log OSGi, convenções de nomenclatura de arquivo inválidas ou configurações restritivas de nível de log também impedem que as instruções de log sejam exibidas no fluxo aemerror.

Resolução resolution

Siga estas etapas para resolver o problema

  1. Revise as configurações do agente OSGi no repositório de código e identifique qualquer configuração em que org.apache.sling.commons.log.file especifique um caminho de arquivo de log personalizado em vez de logs/error.log.
  2. Atualize a configuração do agente de log para usar o arquivo com suporte definindo org.apache.sling.commons.log.file para logs/error.log e verifique se todas as propriedades relacionadas usam valores válidos.
  3. Valide se o nome do arquivo de configuração segue o formato necessário org.apache.sling.commons.log.LogManager.factory.config-.cfg.json e remova caracteres inválidos, como til ( ).
  4. Verifique a configuração do nível de log e defina-a com um valor válido de minúsculas como debug, info, warn ou erro, garantindo que ela não restrinja a saída esperada.
  5. Inspecione todas as configurações de agente de log e remova definições duplicadas ou conflitantes para o mesmo pacote.
  6. Implante a configuração atualizada por meio do pipeline e verifique se as entradas de log aparecem no fluxo de log aemerror no Cloud Manager.

Leitura relacionada

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