Debug AEM as a Cloud Service con Developer Console

AEM as a Cloud Service fornisce una Console per sviluppatori per ogni ambiente che espone vari dettagli del servizio AEM in esecuzione utili per il debug.

Ogni ambiente as a Cloud Service AEM dispone di una propria Console per sviluppatori.

Accesso a Developer Console

Per accedere e utilizzare la Console per sviluppatori, è necessario concedere le seguenti autorizzazioni all’Adobe ID dello sviluppatore tramite Admin Console Adobe.

  1. Assicurati che l’organizzazione di Adobe che ha interessato Cloud Manager e AEM prodotti as a Cloud Service sia attiva nel commutatore dell’organizzazione di Adobe.
  2. Lo sviluppatore deve essere membro del prodotto Cloud Manager Sviluppatore - Cloud Service Profilo prodotto.
    • Se l’iscrizione non esiste, lo sviluppatore non sarà in grado di accedere a Developer Console.
  3. Lo sviluppatore deve essere un membro del Utenti AEM o Amministratori AEM Profilo di prodotto in AEM Author e/o Publish.
    • Se l'appartenenza non esiste, il status le immagini si timeout con un errore 401 non autorizzato.

Risoluzione dei problemi di accesso a Developer Console

401 Errore non autorizzato in caso di dumping

Console per sviluppatori - 401 non autorizzato

Se si registra un errore 401 non autorizzato, il dumping indica che l'utente non esiste ancora con le 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 Non autorizzato:

  1. Assicurati che l’utente sia membro del profilo di prodotto Adobe IMS appropriato (amministratori AEM o utenti AEM) per l’istanza di prodotto as a Cloud Service AEM associata alla Console per sviluppatori.
    • Ricorda che Developer Console accede a 2 istanze di prodotto Adobe IMS; le AEM istanze di prodotto Author e Publish as a Cloud Service, quindi assicurati che vengano utilizzati i profili di prodotto corretti a seconda del livello di servizio che richiede l’accesso tramite Console per sviluppatori.
  2. Accedi alla AEM as a Cloud Service (Author o Publish) e assicurati che l'utente e i gruppi siano stati sincronizzati correttamente in AEM.
    • Developer Console richiede la creazione del record utente nel livello di servizio AEM corrispondente per l’autenticazione a tale livello di servizio.
  3. Elimina i cookie del browser e lo stato dell’applicazione (archiviazione locale) e accedi nuovamente a Developer Console, garantendo che il token di accesso utilizzato da Developer Console sia corretto e non sia scaduto.

Pod

AEM servizi di authoring e pubblicazione as a Cloud Service sono composti rispettivamente di più istanze per gestire la variabilità del traffico e gli aggiornamenti continui senza downtime. Queste istanze sono denominate Pods. La selezione del contenitore in Developer Console definisce l’ambito dei dati che verranno esposti tramite gli altri controlli.

Console per sviluppatori - Pod

  • Un pod è un’istanza discreta che fa parte di un servizio AEM (Author or or Publish)
  • I baccelli sono transitori, il che significa che AEM as a Cloud Service li crea e li distrugge in base alle necessità
  • Solo i pod che fanno parte dell’ambiente as a Cloud Service AEM associato sono elencati nel commutatore Pod della Console per sviluppatori dell’ambiente.
  • Nella parte inferiore dello switcher Pod, le opzioni di comodità consentono di selezionare i pod in base al tipo di servizio:
    • Tutti gli autori
    • Tutti gli editori
    • Tutte le istanze

Stato

Lo stato fornisce opzioni per l’output di uno stato di runtime AEM specifico nel testo o nell’output JSON. Developer Console fornisce informazioni simili alla console Web OSGi locale dell’SDK AEM, con la differenza marcata che Developer Console è in sola lettura.

Console per sviluppatori - Stato

Bundle

I bundle elencano tutti i bundle OSGi in AEM. Questa funzionalità è simile a Bundle OSGi locali dell’SDK AEM a /system/console/bundles.

I bundle aiutano a eseguire il debug:

  • Elencare tutti i bundle OSGi distribuiti su AEM as a Service
  • Elencare lo stato di ciascun bundle OSGi; anche se sono attivi o meno
  • Fornire dettagli sulle dipendenze non risolte che causano l’attivazione dei bundle OSGi

Componenti

Componenti elenca tutti i componenti OSGi in AEM. Questa funzionalità è simile a Componenti OSGi locali dell’SDK AEM a /system/console/components.

I componenti sono utili per il debug:

  • Elencare tutti i componenti OSGi distribuiti AEM as a Cloud Service
  • Fornire lo stato di ciascun componente OSGi; anche se sono attivi o insoddisfatti
  • Fornire dettagli in riferimenti di servizio non soddisfatti può causare l'attivazione dei componenti OSGi
  • Elencare le proprietà OSGi e i relativi valori associati al componente OSGi.

Configurazioni

Le configurazioni elencano tutte le configurazioni del componente OSGi (proprietà e valori OSGi). Questa funzionalità è simile a Gestione configurazione OSGi locale dell'SDK AEM a /system/console/configMgr.

Le configurazioni sono utili per il debug:

  • Elencare le proprietà OSGi e i loro valori dal componente OSGi
  • Individuazione e identificazione delle proprietà non configurate

Indici Oak

Gli indici Oak forniscono un’immagine dei nodi definiti sotto /oak:index. Tieni presente che questo non mostra gli indici uniti, che si verifica quando viene modificato un indice AEM.

Aiuto per gli indici Oak nel debug tramite:

  • Elencando tutte le definizioni di Oak Index che forniscono approfondimenti su come vengono eseguite le query di ricerca in AEM. Tieni presente che gli indici modificati in AEM non vengono riportati qui. Questa visualizzazione è utile solo per gli indici forniti esclusivamente da AEM o unicamente dal codice personalizzato.

Servizi OSGi

Componenti elenca tutti i servizi OSGi. Questa funzionalità è simile a Servizi OSGi locali dell’SDK AEM a /system/console/services.

Guida dei servizi OSGi per il debug:

  • Elencare tutti i servizi OSGi in AEM, insieme al suo bundle OSGi che fornisce, e tutti i bundle OSGi che lo utilizzano

Processi Sling

In Processi Sling sono elencate tutte le code di Processi Sling. Questa funzionalità è simile a Processi dell’avvio rapido locale dell’SDK AEM a /system/console/slingevent.

La guida dei processi Sling per il debug è disponibile nei seguenti modi:

  • Elenco delle code di lavoro Sling e delle relative configurazioni
  • Fornire informazioni sul numero di processi Sling attivi, in coda ed elaborati, utile per il debug dei problemi con Flusso di lavoro, Flusso di lavoro transitorio e altri lavori eseguiti da Processi Sling in AEM.

Pacchetti Java

I pacchetti Java consentono di verificare se un pacchetto Java e una versione sono disponibili per l'uso in AEM as a Cloud Service. Questa funzionalità è la stessa di Finder dipendenza dell’SDK AEM a /system/console/depfinder.

Console per sviluppatori - Pacchetti Java

I pacchetti Java vengono utilizzati per risolvere i problemi di avvio I bundle non vengono avviati a causa di importazioni non risolte o classi non risolte negli script (HTL, JSP, ecc.). Se i pacchetti Java segnalano che nessun bundle esporta un pacchetto Java (o la versione non corrisponde a quella importata da un bundle OSGi):

  • Assicurati che la versione della dipendenza AEM API maven del progetto corrisponda alla versione di rilascio AEM dell’ambiente (e, se possibile, aggiorna tutto all’ultima versione).
  • Se nel progetto Maven vengono utilizzate dipendenze Maven aggiuntive
    • Determina se è invece possibile utilizzare un’API alternativa fornita dalla dipendenza API SDK AEM.
    • Se la dipendenza extra è necessaria, assicurati che sia fornita come bundle OSGi (anziché come Jar normale) ed sia incorporata nel pacchetto di codice del tuo progetto, (ui.apps), simile al modo in cui il bundle OSGi principale è incorporato nel ui.apps pacchetto.

Servlet

Servlets viene utilizzato per fornire informazioni su come AEM risolve un URL a un servlet o a uno script Java (HTL, JSP) che gestisce in ultima analisi la richiesta. Questa funzionalità è la stessa di Risolutore del servlet Sling Servlet dell’SDK AEM locale a /system/console/servletresolver.

Console per sviluppatori - Servlet

I servlet consentono di determinare nel debug:

  • Modalità di decomposizione di un URL nelle relative parti indirizzabili (risorsa, selettore, estensione).
  • A quale servlet o script viene risolto un URL, per identificare gli URL formati male o i servlet/script non registrati.

Query

Le query forniscono informazioni dettagliate su cosa e come vengono eseguite le query di ricerca su AEM. Questa funzionalità è la stessa di Strumenti di avvio rapido locale dell’SDK AEM > Prestazioni query console.

Le query funzionano solo quando è selezionato un pod specifico, in quanto apre la console Web Query Performance del pod, che richiede allo sviluppatore di avere accesso per accedere al servizio AEM.

Console per sviluppatori - Query - Spiegare query

Le query consentono di eseguire il debug in base a:

  • Spiegazione di come le query vengono interpretate, analizzate ed eseguite da Oak. Questo è molto importante quando si tiene traccia del motivo per cui una query è lenta e si capisce come può essere accelerata.
  • Elencando le query più popolari in esecuzione in AEM, con la possibilità di Spiegarle.
  • Elencando le query più lente in esecuzione in AEM, con la possibilità di Spiegarle.

In questa pagina