Debug di AEM as a Cloud Service con Developer Console
AEM as a Cloud Service fornisce un Developer Console per ogni ambiente che espone vari dettagli del servizio AEM in esecuzione che sono utili per il debug.
Ogni ambiente AEM as a Cloud Service dispone di un proprio Developer Console.
Passa a Developer Console
Developer Console è accessibile per ogni ambiente AEM as a Cloud Service tramite Cloud Manager.
- Passa a Cloud Manager
- Apri il programma che contiene l'ambiente AEM as a Cloud Service per aprire Developer Console.
- Individuare l'ambiente e selezionare
.... - Seleziona Developer Console dall'elenco a discesa.
Accesso a Developer Console
Per accedere e utilizzare Developer Console, è necessario concedere le seguenti autorizzazioni all'Adobe ID dello sviluppatore tramite l'Admin Console di Adobe.
-
Assicurati che nel selettore dell’organizzazione di Adobe sia visibile l’organizzazione di Adobe relativa agli ambienti che desideri ispezionare in Developer Console.
-
Per accedere a Developer Console, lo sviluppatore deve essere membro di uno dei seguenti ruoli:
- Profilo prodotto Sviluppatore - Cloud Service di Cloud Manager: in questo caso, lo sviluppatore visualizzerà l'elenco completo degli ambienti disponibili nell'URL Developer Console selezionato; se è stato selezionato un ambiente di sviluppo o un RDE in Cloud Manager, è possibile che vengano visualizzati altri ambienti di sviluppo o RDE nello stesso programma.
- Amministratori AEM profilo di prodotto in Autore AEM: in questo caso, l'elenco degli ambienti descritti nel punto precedente sarà limitato ai profili di prodotto correlati a cui è assegnato questo ruolo.
-
Lo sviluppatore deve essere membro del profilo di prodotto Utenti AEM o Amministratori AEM in AEM Author e/o Publish.
- Se l'appartenenza non esiste, le immagini di stato stato si interromperanno con un errore 401 Non autorizzato.
Risoluzione dei problemi di accesso a Developer Console
Quando accedo non vedo elencato l’ambiente che sto cercando
Verifica quanto segue:
- Hai selezionato l’URL Developer Console corretto facendo clic sui tre punti per l’ambiente selezionato tramite Cloud Manager e seleziona Developer Console.
- Hai il profilo di prodotto Sviluppatore - Cloud Service di Cloud Manager per visualizzare l'elenco completo degli ambienti oppure fai parte del profilo di prodotto Amministratori AEM in Autore AEM per l'ambiente che non trovi.
401 Errore non autorizzato durante il dumping dello stato
Se viene segnalato un errore 401 Unauthorized, significa che l’utente non dispone ancora delle autorizzazioni necessarie in AEM as a Cloud Service oppure che l’utilizzo dei token di accesso non è valido o è scaduto.
Per risolvere il problema 401 Unauthorized:
- Assicurati che l’utente sia membro del profilo di prodotto Adobe IMS appropriato (Amministratori AEM o Utenti AEM) per l’istanza di prodotto AEM as a Cloud Service associata a Developer Console.
- Ricorda che Developer Console accede a 2 istanze di prodotto Adobe IMS; le istanze di prodotto AEM as a Cloud Service Author e Publish, quindi assicurati che vengano utilizzati i profili di prodotto corretti a seconda del livello di servizio a cui è necessario accedere tramite Developer Console.
- Accedi ad AEM as a Cloud Service (Author o Publish) e assicurati che l’utente e i gruppi siano sincronizzati correttamente nell’AEM.
- Developer Console richiede la creazione del record utente nel livello di servizio AEM corrispondente per l'autenticazione in tale livello di servizio.
- Cancella i cookie del browser e lo stato dell’applicazione (archiviazione locale) ed effettua di nuovo l’accesso a Developer Console, verificando che il token di accesso utilizzato da Developer Console sia corretto e non scaduto.
Pod
I servizi AEM as a Cloud Service Author e Publish sono composti rispettivamente da più istanze per gestire la variabilità del traffico e gli aggiornamenti continui senza tempi di inattività. Queste istanze sono denominate Pod. La selezione del pod in Developer Console definisce l’ambito dei dati che verranno esposti tramite gli altri controlli.
-
Un pod è un’istanza discreta che fa parte di un servizio AEM (Author o Publish)
-
I baccelli sono transitori, il che significa che AEM as a Cloud Service li crea e li distrugge in base alle esigenze
-
Solo i pod che fanno parte dell’ambiente AEM as a Cloud Service associato, sono elencati nello switcher Pod di tale ambiente Developer Console.
-
Nella parte inferiore dello switcher Pod, le opzioni di praticità consentono di selezionare i Pod in base al tipo di servizio:
- Tutti gli autori
- Tutti gli editori
- Tutte le istanze
Stato
Stato fornisce opzioni per l’output di uno stato di runtime AEM specifico nell’output di testo o JSON. Developer Console fornisce informazioni simili a quelle della console web OSGi QuickStart locale dell’SDK dell’AEM, con la netta differenza che Developer Console è di sola lettura.
Bundle
I bundle elencano tutti i bundle OSGi in AEM. Questa funzionalità è simile ai bundle OSGi locali dell'SDK AEM in /system/console/bundles.
I bundle consentono di eseguire il debug in base a:
- Elenco di tutti i bundle OSGi implementati in AEM as a Service
- Elencando lo stato di ciascun bundle OSGi, anche se è attivo o meno
- Fornire dettagli sulle dipendenze non risolte che causano l’attivazione dei bundle OSGi
Componenti
Componenti elenca tutti i componenti OSGi nell’AEM. Questa funzionalità è simile ai componenti OSGi dell'SDK quickstart locale di AEM in /system/console/components.
I componenti facilitano il debug mediante:
- Elenco di tutti i componenti OSGi distribuiti in AEM as a Cloud Service
- Fornire lo stato di ciascun componente OSGi, anche se è attivo o non soddisfatto
- Se si forniscono dettagli sui riferimenti di servizio non soddisfatti, i componenti OSGi potrebbero diventare attivi
- Elenco delle proprietà OSGi e dei relativi valori associati al componente OSGi.
- Verranno visualizzati i valori effettivi inseriti tramite variabili di configurazione dell'ambiente OSGi.
Configurazioni
Configurazioni elenca tutte le configurazioni del componente OSGi (proprietà e valori OSGi). Questa funzionalità è simile a quella di Gestione configurazione OSGi quickstart locale dell'SDK dell'AEM in /system/console/configMgr.
Le configurazioni aiutano a eseguire il debug:
- Elenco delle proprietà OSGi e dei relativi valori per componente OSGi
- I valori effettivi inseriti tramite variabili di configurazione dell'ambiente OSGi NON verranno visualizzati. Vedere Componenti sopra, per i valori inseriti.
- Individuazione e identificazione delle proprietà non configurate correttamente
Indici Oak
Gli indici Oak forniscono un dump dei nodi definiti sotto /oak:index. Tieni presente che questo non mostra indici uniti, che si verifica quando viene modificato un indice AEM.
Gli indici di Oak aiutano nel debug:
- Elenco di tutte le definizioni degli indici di Oak che forniscono informazioni sul modo in cui le query di ricerca vengono eseguite nell’AEM. Tieni presente che le modifiche apportate agli indici AEM non vengono riportate qui. Questa visualizzazione è utile solo per gli indici forniti esclusivamente dall’AEM o solo dal codice personalizzato.
Servizi OSGi
Componenti elenca tutti i servizi OSGi. Questa funzionalità è simile ai servizi OSGi dell'SDK quickstart locale di AEM in /system/console/services.
I servizi OSGi aiutano nel debug:
- Elenco di tutti i servizi OSGi in AEM, del bundle OSGi fornito e di tutti i bundle OSGi utilizzati
Processi Sling
Processi Sling elenca tutte le code dei processi Sling. Questa funzionalità è simile ai processi dell'avvio rapido locale dell'SDK AEM in /system/console/slingevent.
I processi Sling facilitano il debug:
- Elenco delle code di processi Sling e relative configurazioni
- Fornire informazioni sul numero di processi Sling attivi, in coda ed elaborati, utile per il debug dei problemi relativi ai flussi di lavoro, ai flussi di lavoro transitori e ad altri lavori eseguiti dai processi Sling in AEM.
Pacchetti Java
I pacchetti Java consentono di verificare se un pacchetto Java, e una versione, sono disponibili per l’utilizzo in AEM as a Cloud Service. Questa funzionalità è uguale a quella del Finder dipendenze🔗 dell'SDK quickstart locale di AEM in /system/console/depfinder.
I pacchetti Java vengono utilizzati per risolvere i problemi che impediscono l’avvio dei bundle di ripresa a causa di importazioni non risolte o classi non risolte negli script (HTL, JSP, ecc.). Se in Pacchetti Java non viene segnalato alcun bundle, esporta un pacchetto Java (o la versione non corrisponde a quella importata da un bundle OSGi):
-
Assicurati che la versione della dipendenza Maven dall’API AEM del tuo progetto corrisponda alla versione dell’ambiente rilasciata dall’AEM (e, se possibile, aggiorna tutto alla versione più recente).
-
Se nel progetto Maven vengono utilizzate dipendenze Maven aggiuntive
- Determina se è possibile utilizzare un’API alternativa fornita dalla dipendenza API dell’SDK AEM.
- Se è necessaria una dipendenza aggiuntiva, assicurati che sia fornita come bundle OSGi (anziché come Jar normale) e che sia incorporata nel pacchetto di codice del progetto, (
ui.apps), in modo analogo a come il bundle OSGi principale è incorporato nel pacchettoui.apps.
Servlet
I servlet vengono utilizzati per fornire approfondimenti su come AEM risolve un URL in un servlet o script Java (HTL, JSP) che alla fine gestisce la richiesta. Questa funzionalità è la stessa del modulo di risoluzione Sling Servlet 🔗 dell'SDK Sling per l'avvio rapido locale di AEM in /system/console/servletresolver.
I servlet consentono di determinare mediante debug:
- Come un URL viene decomposto nelle sue parti indirizzabili (risorsa, selettore, estensione).
- Quale servlet o script viene risolto da un URL, aiutando a identificare gli URL con formato errato o i servlet/script non registrati correttamente.
Query
Le query forniscono informazioni approfondite su cosa e come vengono eseguite le query di ricerca sull’AEM. Questa funzionalità è la stessa della console QuickStart locale dell'SDK AEM Strumenti > Prestazioni query.
Le query funzionano solo quando viene selezionato un pod specifico, poiché apre la console web Prestazioni query del pod, che richiede allo sviluppatore di avere accesso al servizio AEM.
Le query consentono di eseguire il debug mediante:
- Spiegazione del modo in cui Oak interpreta, analizza ed esegue le query. Questo è molto importante quando si tiene traccia del motivo per cui una query è lenta e si capisce come può essere velocizzata.
- Elencare le query più popolari in esecuzione in AEM, con la possibilità di spiegarle.
- Elencare le query più lente in esecuzione in AEM, con la possibilità di spiegarle.