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.

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 fornecidas ao Adobe ID do desenvolvedor por meio de Adobe Admin Console.

  1. 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.

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

  3. 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:

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 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.
  2. 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.
  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 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.

Developer Console - Pod

  • 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.

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 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.

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
  • 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.

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 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 pacote ui.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.

Developer Console - Servlets

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.

Developer Console - Consultas - Explicar consulta

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.
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69