Un audit AEM serve a rispondere a una domanda semplice: in che stato è davvero la nostra installazione, e che cosa conviene fare adesso? Le risposte intuitive sono spesso sbagliate. Un'istanza percepita come lenta può soffrire di una singola query senza indice, mentre un'istanza considerata sana può nascondere centinaia di configurazioni OSGi non versionate e overlay di /libs impossibili da portare nel cloud. L'assessment AEM sostituisce le opinioni con evidenze verificabili.
Lavoriamo su AEM Sites e AEM Assets, su qualunque versione e modello di hosting. L'analisi è statica e dinamica: leggiamo il codice e il repository, ma osserviamo anche il comportamento reale tramite log, metriche, tempi di replica e profili di traffico. Quando il contesto lo consente, partiamo dai report del Best Practices Analyzer e li verifichiamo manualmente, perché un report automatico segnala, ma non decide la priorità.
L'output non è un documento di cento pagine. È un backlog tecnico in cui ogni voce ha una descrizione, un'evidenza, un rischio, uno sforzo stimato e un criterio di verifica, accompagnato da una roadmap che distingue gli interventi immediati da quelli da pianificare. Il team può prenderlo in carico senza di noi, oppure può affidarci le voci a più alto impatto.
Che cosa analizza un audit AEM
Sul fronte del codice esaminiamo la struttura dei moduli Maven (core, ui.apps, ui.config, ui.content, ui.frontend, dispatcher), l'uso di API deprecate, la qualità dei bundle OSGi, la presenza di servizi con stato condiviso, l'uso corretto di service user al posto di sessioni amministrative e la copertura dei test. Controlliamo i Sling Models, gli script HTL e le clientlibs per individuare logica di business nel posto sbagliato e duplicazioni.
Sul repository analizziamo la struttura dei contenuti, la presenza di codice e configurazioni sotto /content o /conf, gli overlay di /libs, le dimensioni dei rami, i nodi con troppi figli, le versioni e i log di audit che crescono senza controllo. Questi sintomi determinano sia le prestazioni quotidiane sia il costo di una futura migrazione, e sono quelli che più spesso emergono solo con un esame diretto.
Indici Oak, query e workflow
Le query lente sono una causa frequente di degrado. Analizziamo i log delle query, verifichiamo se esistono indici Oak personalizzati e se le definizioni sono coerenti con il motore di indicizzazione Lucene, e controlliamo che le query più usate da componenti e servlet sfruttino davvero un indice. Su AEM as a Cloud Service gli indici devono essere consegnati come codice, e questo rende il controllo ancora più importante.
Sui workflow verifichiamo quali modelli girano, con quale frequenza, su quanti payload e con quali step personalizzati. Workflow di aggiornamento asset troppo pesanti, step che eseguono operazioni sincrone su sistemi esterni o istanze in stato di errore mai ripulite sono problemi tipici. Su Assets valutiamo anche se i profili di processing e i workflow personalizzati siano compatibili con il modello di Asset Compute del cloud.
Dispatcher, CDN e delivery
La configurazione del Dispatcher è spesso la parte meno documentata e più fragile. Leggiamo farm, filtri, regole di cache, gestione dei parametri di query, regole di riscrittura e politiche di invalidazione. Cerchiamo filtri troppo permissivi, che espongono percorsi non destinati al pubblico, e regole troppo prudenti, che riducono il cache hit ratio. Verifichiamo come vengono impostati gli header Cache-Control e come si comporta la CDN davanti al Dispatcher.
Misuriamo poi l'impatto sull'esperienza utente osservando LCP, INP e CLS sui template principali, distinguendo i problemi che nascono lato AEM (markup, clientlibs, immagini) da quelli che nascono nei tag di terze parti. Il dettaglio degli interventi di ottimizzazione è descritto nella pagina su performance, Dispatcher e CDN.
Pipeline, ambienti e processo di rilascio
Un audit completo include il modo in cui il codice arriva in produzione. Su AEM as a Cloud Service analizziamo le pipeline di Cloud Manager, i quality gate di codice, sicurezza e performance, la gestione delle variabili d'ambiente e la parità tra ambienti di sviluppo, stage e produzione. Su installazioni on-premise osserviamo invece procedure di deploy, pacchetti, strategie di rollback e finestre di rilascio.
Valutiamo anche il processo editoriale: modelli di permessi, uso dei Launch, gestione delle traduzioni, rollout dei Live Copy e Experience Fragment, eventuale uso di Content Fragment. Spesso la causa di un problema tecnico è una pratica editoriale che il sistema non ha mai governato, e ignorarla significa ripresentare lo stesso problema dopo la bonifica.
Che cosa consegniamo e cosa succede dopo
Al termine consegniamo un rapporto sintetico, un backlog in formato importabile nello strumento di gestione che il tuo team usa, una matrice di rischio e una roadmap in tre orizzonti: interventi immediati a basso sforzo, interventi pianificabili nei prossimi trimestri e decisioni architetturali da prendere. Una sessione di restituzione con architetti e responsabili di prodotto chiude l'attività, con spazio per domande e contestazioni.
Dopo l'assessment le strade sono diverse. Alcuni clienti procedono internamente, altri ci affidano la bonifica del codice o la migrazione ad AEM as a Cloud Service, altri ancora attivano un supporto evolutivo. In ogni caso il backlog resta di proprietà del cliente. I tempi di un assessment dipendono dal perimetro e vanno stimati dopo una prima call.
FAQ
Domande frequenti sull'audit AEM
Di norma accesso in sola lettura al repository del codice, ai log, alla configurazione Dispatcher e a Cloud Manager, più un confronto con sviluppatori e amministratori. Per le analisi sul repository vivo si usano pacchetti esportati o ambienti non di produzione, se possibile.
No, lo usa come punto di partenza. Il BPA segnala pattern incompatibili con AEM as a Cloud Service, ma non stabilisce priorità né analizza Dispatcher, processo di rilascio e pratiche editoriali. Il nostro lavoro è verificare i risultati e trasformarli in un backlog ordinato.
Sì. Gli stessi problemi di indici, workflow, cache e codice impattano anche le installazioni on-premise. L'assessment è utile per ridurre il debito tecnico, preparare un aggiornamento di versione o semplicemente capire dove si concentra il costo di manutenzione.
Certo. L'assessment può essere tematico: solo delivery, solo Assets, solo pipeline e qualità del codice. Definiamo insieme il perimetro all'inizio, così il risultato resta mirato e confrontabile con il budget disponibile.
Il cliente. Backlog, matrice di rischio e roadmap sono consegnati in formati modificabili e possono essere usati con o senza il nostro coinvolgimento successivo.
Richiedi un assessment AEM
Indicaci versione, modello di hosting e problema principale. Definiamo un perimetro d'audit e ti diciamo quali accessi servono per iniziare.
Parla con un consulente AEM