Depuração do AEM as a Cloud Service com a Developer Console

Última atualização: 5 de maio de 2025
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Iniciante
  • Desenvolvedor

O AEM as a Cloud Service fornece um Developer Console para cada ambiente que expõe vários detalhes do serviço do AEM em execução que são úteis na depuração.

Cada ambiente do AEM as a Cloud Service tem seu próprio Developer Console.

O Developer Console é acessado por ambiente AEM as a Cloud Service via Cloud Manager.

Navegar até o Developer Console

  1. Navegue até Cloud Manager
  2. Abra o Programa que contém o ambiente do AEM as a Cloud Service para abrir o Developer Console.
  3. Localize o Ambiente e selecione o ....
  4. Selecione Developer Console na lista suspensa.

Acesso ao Developer Console

Para acessar e usar o Developer Console, as seguintes permissões devem ser concedidas ao Adobe ID do desenvolvedor via Admin Console da Adobe.

  1. Certifique-se de que, no alternador da Organização do Adobe, é possível visualizar a Organização do Adobe relacionada aos ambientes que você deseja inspecionar no Developer Console.

  2. Para fazer logon na Developer Console, o desenvolvedor deve ser membro de qualquer uma das seguintes funções:

    • Perfil do Produto do Cloud Manager - Cloud Service: neste caso, o desenvolvedor verá a lista completa de ambientes disponíveis na URL do Developer Console selecionada; se um ambiente de desenvolvimento ou RDE tiver sido selecionado no Cloud Manager, outro ambiente de desenvolvimento ou RDEs nesse mesmo Programa poderão ser exibidos.
    • Perfil de Produto de Administradores do AEM em Autor do AEM: nesse caso, a lista de ambientes descrita no marcador anterior será limitada aos perfis de produto relacionados aos quais essa função for atribuída.

  3. O desenvolvedor deve ser membro do Perfil de Produto Usuários do AEM ou Administradores do AEM no Autor e/ou Publicação do AEM.

    • Se esta associação não existir, os despejos de status atingirão o tempo limite com um erro 401 Não autorizado.

Solução de problemas de acesso ao Developer Console

Quando eu fizer login, não vejo um ambiente listado que estou procurando

Certifique-se do seguinte:

401 Erro não autorizado no status dedumping

Developer Console - 401 Não autorizado

Se for relatado um erro 401 Não autorizado despejando qualquer status, significa que o usuário ainda não existe com as permissões necessárias no AEM as a Cloud Service ou os tokens de logon usados são inválidos ou expiraram.

Para resolver o problema 401 Não autorizado:

  1. Certifique-se de que o usuário é membro do Perfil de produto do Adobe IMS apropriado (Administradores do AEM ou Usuários do AEM) para a instância de produto associada do Developer Console AEM as a Cloud Service.
    • Lembre-se de que o Developer Console acessa 2 Instâncias de produto do Adobe IMS; as instâncias de produto do AEM as a Cloud Service Author e Publish, portanto, verifique se os Perfis de produto corretos são usados, dependendo de qual camada de serviço requer acesso por meio do Developer Console.
  2. Faça logon na AEM as a Cloud Service (Autor ou Publicação) e verifique se o usuário e os grupos foram sincronizados corretamente na AEM.
    • O Developer Console requer que seu registro de usuário seja criado na camada de serviço correspondente do AEM para que ele seja autenticado nessa camada de serviço.
  3. Limpe os cookies dos navegadores, o estado do aplicativo (armazenamento local) e faça logon novamente no Developer Console, garantindo que o token de acesso que a Developer Console está usando esteja correto e sem expiração.

Pod

Os serviços de Autor e Publicação do AEM as a Cloud Service são compostos de várias instâncias, respectivamente, para lidar com a variabilidade do tráfego e atualizações contínuas sem tempo de inatividade. Essas instâncias são chamadas de Pods. A seleção de pods no Developer Console define o escopo dos dados que serão expostos por meio dos outros controles.

Developer Console - Pod

  • Um pod é uma instância discreta que faz parte de um serviço do AEM (Autor ou Publicação)

  • Os pods são transitórios, o que significa que o AEM as a Cloud Service os cria e destrói conforme necessário

  • Somente os pods que fazem parte do ambiente associado do AEM as a Cloud Service são listados no alternador de pods do Developer Console desse ambiente.

  • Na parte inferior do alternador de pods, as opções de conveniência permitem selecionar pods por tipo de serviço:

    • Todos os autores
    • Todos os editores
    • Todas as instâncias

Status

Status fornece opções para a saída de um estado de tempo de execução específico do AEM em texto ou saída JSON. O Developer Console fornece informações semelhantes ao console OSGi da Web de início rápido local do AEM SDK, com a diferença marcada de que o Developer Console é somente leitura.

Developer Console - Status

Pacotes

Pacotes lista todos os pacotes OSGi no AEM. Esta funcionalidade é semelhante aos Pacotes OSGi de início rápido locais do AEM SDK em /system/console/bundles.

Pacotes de ajuda na depuração ao:

  • Listando todos os pacotes OSGi implantados no AEM as a Service
  • Listando o estado de cada pacote OSGi; incluindo se eles estão ativos ou não
  • Fornecer detalhes em dependências não resolvidas que fazem com que pacotes OSGi se tornem ativos

Componentes

Componentes lista todos os componentes OSGi no AEM. Esta funcionalidade é semelhante aos Componentes OSGi de início rápido locais do AEM SDK em /system/console/components.

Ajuda dos componentes na depuração ao:

  • Listagem de todos os componentes OSGi implantados no AEM as a Cloud Service
  • Fornecer o estado de cada componente OSGi; incluindo se ele estiver ativo ou insatisfeito
  • Fornecer detalhes em referências de serviço insatisfeitas pode fazer com que os componentes OSGi se tornem ativos
  • Listagem de propriedades OSGi e seus valores vinculados ao componente OSGi.

Configurações

Configurações lista todas as configurações do componente OSGi (propriedades e valores OSGi). Esta funcionalidade é semelhante ao Gerenciador de configurações OSGi de início rápido local do AEM SDK em /system/console/configMgr.

Ajuda das configurações na depuração de:

  • Listagem de propriedades OSGi e seus valores por componente OSGi
  • Localizar e identificar propriedades configuradas incorretamente

Índices Oak

Os Índices Oak fornecem um despejo dos nós definidos abaixo de /oak:index. Lembre-se de que isso não mostra índices mesclados, que ocorrem quando um índice AEM é modificado.

A ajuda dos Índices Oak na depuração por:

  • Listando todas as definições de índice do Oak, fornecendo insights sobre como as consultas de pesquisa são executadas no AEM. Lembre-se, que os índices modificados do AEM não são refletidos aqui. Essa exibição é útil apenas para índices fornecidos exclusivamente pela AEM ou fornecidos exclusivamente pelo código personalizado.

Serviços OSGi

Componentes lista todos os serviços OSGi. Esta funcionalidade é semelhante aos Serviços OSGi de início rápido locais do AEM SDK em /system/console/services.

Ajuda dos Serviços OSGi na depuração de:

  • Listagem de todos os serviços OSGi no AEM, juntamente com o pacote OSGi de fornecimento e todos os pacotes OSGi que o consomem

Sling Jobs

Sling Jobs lista todas as filas de Sling Jobs. Esta funcionalidade é semelhante aos Trabalhos de início rápido locais do AEM SDK em /system/console/slingevent.

Ajuda dos trabalhos do Sling na depuração ao:

  • Listagem de filas de trabalhos do Sling e suas configurações
  • Fornecer insights sobre o número de trabalhos Sling ativos, enfileirados e processados, o que é útil para depurar problemas com o fluxo de trabalho, o fluxo de trabalho transitório e outro trabalho executado pelos trabalhos Sling no AEM.

Pacotes Java

Pacotes Java permitem verificar se um pacote Java e a versão estão disponíveis para uso no AEM as a Cloud Service. Esta funcionalidade é igual ao Localizador de dependências de início rápido local do AEM SDK em /system/console/depfinder.

Developer Console - Pacotes Java

Os pacotes Java são usados para solucionar problemas. Os pacotes não são iniciados devido a importações não resolvidas ou classes não resolvidas em scripts (HTL, JSP etc). Se os relatórios de Pacotes Java não exportam pacotes Java (ou a versão não corresponde à importada por um pacote OSGi):

  • Verifique se a versão da dependência da API do Maven do AEM do seu projeto corresponde à versão do AEM Release do ambiente (e, se possível, atualize tudo para a versão mais recente).

  • Se dependências Maven extras forem usadas no projeto Maven

    • Determine se uma API alternativa fornecida pela dependência da API SDK do AEM pode ser usada em seu lugar.
    • Se a dependência extra for necessária, verifique se ela é fornecida como um pacote OSGi (em vez de um Jar simples) e se está incorporada ao pacote de código do seu projeto, (ui.apps), de modo semelhante a como o Pacote OSGi principal está incorporado ao pacote ui.apps.