AEM as a Cloud Service Developer Console developer-console
O AEM as a Cloud Service Developer Console inclui um conjunto de ferramentas somente leitura para depurar ambientes de nuvem. Ele pode ser acessado por meio de um link por ambiente no Cloud Manager e oferece recursos para visualizar pacotes, configurações OSGi, serviços e servlets e muito mais.
- O AEM Developer Console (Cloud Service) não deve ser confundido com o Adobe Developer Console de nome semelhante.
Acesso ao AEM Developer Console
Para acessar e usar o AEM Developer Console, as seguintes permissões devem ser concedidas ao Adobe ID do desenvolvedor por meio do Admin Console da Adobe.
- 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 do AEM.
- Para fazer logon na AEM 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 AEM 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. - 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.
Limpe os cookies do navegador, bem como o estado do aplicativo (armazenamento local) e faça logon novamente no AEM Developer Console
Solução de problemas de acesso ao AEM 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 AEM Developer Console clicando nos três pontos do ambiente selecionado por meio do Cloud Manager e selecione AEM Developer Console.
+ Você tem o Perfil de Produto do Cloud Manager - Cloud Service para ver a lista completa de ambientes ou você faz parte do Perfil de Produto Administradores do AEM no Autor do AEM para o ambiente não encontrado.
401 Erro não autorizado no status dedumping
Para resolver o problema não autorizado:
- 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 associado do AEM Developer Console.
+ Lembre-se de que o AEM 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 AEM Developer Console. - Aguarde até 30 minutos para que a associação do Perfil de produto do Adobe IMS seja sincronizada com o AEM as a Cloud Service.
- 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 AEM Developer Console exige 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. - Limpe os cookies do navegador, bem como o estado do aplicativo (armazenamento local) e faça logon novamente no AEM Developer Console, garantindo que o token de acesso que o AEM Developer Console está usando esteja correto e sem expiração.
Restrições de IP ip-restrictions
O acesso à Developer Console depende da sua capacidade de acessar a instância do autor. Se sua organização tiver configurado um incluo na lista de permissões IP no serviço de autoria no Cloud Manager, você deverá se conectar de um endereço IP dentro desse intervalo permitido.
Por exemplo, se a instância do autor estiver restrita à VPN corporativa, você só poderá usar o Developer Console enquanto estiver conectado a essa VPN.
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.
Ou abra esta URL para entrar: https://experience.adobe.com/skyline-console
Ou use este comando da CLI do Cloud Manager:
aio cloudmanager:open-developer-console <ENVIRONMENTID> --programId <PROGRAMID>
Seletor de ambiente/programa
Para usar o AEM Developer Console, você deve selecionar o ambiente e o programa que deseja inspecionar.
Os seletores estão localizados no canto superior esquerdo e direito da interface do usuário do AEM Developer Console.
Selecionar um ambiente acionará uma atualização dos dados no Developer Console do AEM e você verá os dados do ambiente selecionado.
Ao acessar o navegador do repositório, o ambiente selecionado será usado para abrir o navegador do repositório em uma nova guia.
Os botões de atualização ao lado dos seletores acionam uma limpeza do cache do navegador para as chamadas de programas/ambiente para o Cloud Manager.
Você pode usar isso se um novo ambiente tiver sido criado e você não o vir na lista de ambientes.
Ainda pode levar alguns minutos para que o novo ambiente esteja disponível no AEM Developer Console.
As luzes de status indicam a integridade do ambiente.
- Vermelho: indica que o ambiente não está saudável e indisponível (possivelmente hibernado).
- Laranja: o ambiente pode estar reiniciando ou degradado (alguns dos pods estão temporariamente inativos, mas ainda há pods íntegros disponíveis).
- Verde: em execução, todos os pods estão ativos e saudáveis
Depois de selecionar um ambiente, você pode usar as guias para navegar até as diferentes exibições do AEM Developer Console.
Você pode ver o status de cada camada do ambiente.
Pacotes OSGi
- Uma visão geral dos pacotes OSGI implantados no tipo de ambiente selecionado. Ela permite uma pesquisa de texto completo.
- É útil obter informações do estado real dos pacotes no ambiente. Você pode obter informações como pacotes exportados, pacotes importados, serviços usados e muito mais.
- Os desenvolvedores desejam verificar o ambiente real e verificar se o pacote faz o que esperam que ele faça.
- Exemplo de caso de uso: Um intervalo de versões de uma dependência é especificado no seu pacote. Algo está errado na dependência. Você deseja verificar qual versão da dependência está sendo conectada ao seu pacote. Para verificar, vá para os detalhes do pacote e use a importação de pacotes para verificar qual versão do pacote ou versão do pacote está sendo usada no tempo de execução. Com essas informações, você pode ajustar o intervalo de versões de dependência do Maven ou adaptar seu código.
Para pesquisar, use a barra de pesquisa. Para baixar a lista de pacotes como json, clique no botão Baixar lista na parte superior direita para obter um despejo JSON completo.
Se quiser obter o despejo de publicação ou visualização, use o seletor de ambiente para selecionar o ambiente de publicação ou visualização e baixe a lista.
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.
Clicar em um pacote resulta em ir para os detalhes do pacote:
Configurações configurations
- Uma lista pesquisável de configurações ativas no ambiente. Você pode ver quais propriedades são fornecidas pelas configurações, verificando a página de detalhes.
- Exemplo de caso de uso: um desenvolvedor deseja verificar se as configurações especificadas estão realmente presentes no ambiente. Se a configuração estiver ausente, eles poderão verificar o modelo de recurso ou o modo de execução ou pasta da configuração.
Para obter mais informações sobre como configurar permissões de usuário, consulte a Documentação do Cloud Manager.
Servlets servlets
- Um prompt de pesquisa no qual você pode especificar um caminho com seletores e uma extensão com GET ou POST. Em seguida, ele fornece os resultados dos servlets em ordem de preferência que lida com a solicitação no Sling.
- Exemplo de caso de uso: você tem um servlet OSGI que deve ser ativado mediante uma solicitação e imprimir a saída para a resposta. No entanto, em vez da saída esperada, a resposta retorna vazia. Você precisa verificar se algum outro servlet está tendo precedência sobre o seu servlet devido a seletores mais específicos,
resourceType, extensões ou classificação. Você pesquisa o caminho esperado e descobre que outro servlet está ativo com uma classificação mais alta. Em seguida, decida se você pode colocar seu servlet acima na classificação adicionando seletores, por exemplo.
Serviços services
Componentes lista todos os serviços OSGi.
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
Componentes OSGi osgi-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.
Integrações integrations
- Os administradores do sistema têm a capacidade de gerar, renomear e excluir credenciais de serviço e tokens de desenvolvedor.
- Mais informações sobre isso podem ser encontradas aqui: Gerando tokens de acesso para APIs do lado do servidor.
Repositório repository
- Abre o Navegador do repositório.
- Aviso: você precisará fazer logon no serviço AEM para acessar o navegador do repositório. Se você não conseguir fazer logon, entre em contato com o administrador do sistema para obter acesso.
- Você precisa de acesso concedido na camada que está tentando acessar. Por exemplo, se você estiver tentando acessar o navegador do repositório no nível de publicação, é necessário ter acesso (Administrador do AEM ou Usuário do AEM) concedido no nível de publicação.
Status de Despejos/Consultas status-dumps-queries
- Um texto completo ou despejo JSON do estado atual de pacotes, pacotes, configurações, serviços, componentes, trabalhos do sling ou definições do Oak.
- Útil especialmente se o desenvolvedor tiver descoberto algum estado inesperado e quiser comunicar ou documentar esse estado para outros desenvolvedores. Baixar o despejo fornece um instantâneo do estado para referência posterior.
Sling Jobs
Sling Jobs lista todas as filas de Sling Jobs.
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.
Definições do 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.
Ferramenta de desempenho de consulta
- As consultas ajudam a fornecer insights sobre o que e como as consultas de pesquisa são executadas no 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.
+ Listagem das 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.
Mais documentação pode ser encontrada aqui.