Depuração do AEM as a Cloud Service com a Developer Console
O AEM as a Cloud Service fornece um Developer Console para cada ambiente que expõe vários detalhes do serviço 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.
Navegar até o Developer Console
O Developer Console é acessado por ambiente AEM as a Cloud Service via Cloud Manager.
- Navegue até Cloud Manager
- Abra o Programa que contém o ambiente do AEM as a Cloud Service para abrir o Developer Console.
- Localize o Ambiente e selecione o
.... - Selecione Developer Console na lista suspensa.
Acesso ao Developer Console
Para acessar e usar o Developer Console, as seguintes permissões devem ser fornecidas ao Adobe ID do desenvolvedor por meio de Adobe Admin Console.
-
Certifique-se de que, no alternador de Adobe Org, é possível visualizar a Adobe Org relacionada aos ambientes que você deseja inspecionar no Developer Console.
-
Para fazer logon na Developer Console, o desenvolvedor deve ser membro de qualquer uma das seguintes funções:
- Desenvolvedor - Cloud Service Perfil do Produto do Cloud Manager: nesse 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.
- Administradores de AEM Perfil de Produto em Autor de AEM: nesse caso, a lista de ambientes descritos no marcador anterior será limitada aos perfis de produto relacionados aos quais essa função for atribuída.
-
O desenvolvedor deve ser membro do Usuários do AEM ou do Administradores do AEM no Perfil de Produto no AEM Author e/ou no Publish.
- 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:
- Você selecionou o URL correto do Developer Console clicando nos três pontos do ambiente selecionado por meio do Cloud Manager e selecione Developer Console.
- Você tem o Perfil do Produto Desenvolvedor - Cloud Service do Cloud Manager para ver a lista completa de ambientes ou você faz parte do Perfil do Produto Administradores do AEM no Autor do AEM do ambiente não encontrado.
401 Erro não autorizado no status dedumping
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:
- Certifique-se de que o usuário é membro do Perfil de produto do Adobe IMS apropriado (Administradores de AEM ou Usuários de AEM) para a instância de produto associada do AEM as a Cloud Service na Developer Console.
- Lembre-se de que o Developer Console acessa 2 Instâncias de produto do Adobe IMS; as instâncias de produto do Autor do AEM as a Cloud Service e do 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.
- Faça logon no AEM as a Cloud Service (Author ou Publish) e verifique se o usuário e os grupos foram sincronizados corretamente no AEM.
- O Developer Console requer que seu registro de usuário seja criado na camada de serviço AEM correspondente para que ele seja autenticado nessa camada de serviço.
- 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 do AEM as a Cloud Service Author e do Publish são compostos de várias instâncias, respectivamente, para lidar com a variabilidade do tráfego e as 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.
-
Um pod é uma instância discreta que faz parte de um serviço AEM (Autor ou Publish)
-
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 AEM específico em uma saída de texto ou JSON. O Developer Console fornece informações semelhantes ao console da Web OSGi do SDK local do AEM, com a diferença acentuada de que o Developer Console é somente leitura.
Pacotes
Pacotes lista todos os pacotes OSGi no AEM. Esta funcionalidade é semelhante aos Pacotes OSGi de início rápido locais do SDK do AEM 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 do SDK local do AEM 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.
- Isso exibirá os valores reais inseridos por meio de variáveis de configuração de ambiente 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 SDK do AEM em /system/console/configMgr.
Ajuda das configurações na depuração de:
- Listagem de propriedades OSGi e seus valores por componente OSGi
- Isso NÃO exibirá os valores reais inseridos por meio de variáveis de configuração de ambiente OSGi. Consulte Componentes acima para obter os valores inseridos.
- 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:
- Listagem de todas as definições de índice Oak que fornecem insights sobre como as consultas de pesquisa são executadas no AEM. Lembre-se, que os índices AEM modificados não são refletidos aqui. Essa exibição é útil apenas para índices fornecidos exclusivamente pelo 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 do SDK local do AEM 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 inicialização rápida locais do SDK do AEM 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, fluxo de trabalho transitório e outro trabalho executado por 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 SDK do AEM em /system/console/depfinder.
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 do maven da API do AEM do seu projeto corresponde à versão do AEM 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 do SDK do AEM pode ser usada.
- 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 pacoteui.apps.
Servlets
Servlets são usados para fornecer informações sobre como o AEM resolve um URL para um servlet ou script Java (HTL, JSP) que, em última análise, lida com a solicitação. Esta funcionalidade é igual ao Resolvedor de Servlet Sling de início rápido local do SDK do AEM em /system/console/servletresolver.
Os servlets ajudam na depuração da determinação:
- Como um URL é decomposto em suas partes endereçáveis (recurso, seletor, extensão).
- A que servlet ou script um URL resolve, ajudando a identificar URLs mal formados ou servlets/scripts mal registrados.
Consultas
As consultas ajudam a fornecer insights sobre o que e como as consultas de pesquisa são executadas no AEM. Essa funcionalidade é a mesma do console Ferramentas > Desempenho da consulta do SDK local do AEM.
O Queries só funciona quando um pod específico é selecionado, pois abre o console da Web Desempenho de consulta desse pod, exigindo que o desenvolvedor tenha acesso para fazer logon no serviço AEM.
As consultas ajudam na depuração ao:
- Explicando como as consultas são interpretadas, analisadas e executadas pelo Oak. Isso é muito importante ao rastrear por que um query é lento e entender como ele pode ser acelerado.
- Listando as consultas mais populares executadas no AEM, com a capacidade de Explicá-las.
- Listar as consultas mais lentas em execução no AEM, com a capacidade de Explicá-las.