Servizio di telemetria operativa per AEM as a Cloud Service real-use-monitoring-service-for-aem-as-a-cloud-service
Panoramica overview
Il servizio di telemetria operativa è una tecnologia di monitoraggio delle prestazioni che monitora in tempo reale il traffico lato client su un sito Web o un'applicazione. Questo servizio si concentra sulla raccolta di metriche e dati chiave per ottimizzare le prestazioni monitorando il coinvolgimento dei siti web, anziché gli utenti stessi. Con la telemetria operativa, le metriche delle prestazioni chiave vengono tracciate dall’avvio dell’URL fino a quando la richiesta non viene trasmessa al browser.
Chi può beneficiare del servizio di telemetria operativa? who-can-benefit-from-operational-telemetry-service
La telemetria operativa aiuta i clienti e Adobe a comprendere come gli utenti finali interagiscono con i siti AEM. La telemetria operativa preserva la privacy dei visitatori attraverso una raccolta e un campionamento di dati limitati: viene monitorata solo una piccola parte di tutte le visualizzazioni di pagina.
Campionamento dei dati del servizio di telemetria operativa operational-telemetry-service-data-sampling
Le soluzioni di analisi web tradizionali tentano di raccogliere dati su ogni singolo visitatore. Il servizio di telemetria operativa di AEM acquisisce informazioni solo da una piccola frazione di visualizzazioni di pagina. Il servizio deve essere campionato e reso anonimo, anziché sostituire le funzioni di analisi. Per impostazione predefinita, le pagine hanno una proporzione di campionamento di 1:100. Al momento, gli operatori del sito non possono aumentare o diminuire la frequenza di campionamento. Per stimare con precisione il traffico totale, per ogni 100 visualizzazioni di pagina, i dati vengono raccolti da 1, fornendo un’approssimazione affidabile del traffico complessivo.
Quando si decide se raccogliere o meno i dati, la procedura avviene in modalità di visualizzazione pagina per pagina, rendendo praticamente impossibile tenere traccia delle interazioni tra più pagine. Per progettazione, la telemetria operativa non ha alcun concetto di visitatori o sessioni, ma solo di visualizzazioni di pagina.
Quali dati vengono raccolti? what-data-is-being-collected
Il servizio di telemetria operativa è progettato per ridurre al minimo la raccolta dei dati. Di seguito sono elencate tutte le informazioni raccolte tramite Telemetria operativa:
- Il nome host del sito visitato, ad esempio:
experienceleague.adobe.com - Tipo di agente utente e sistema operativo utilizzati per visualizzare la pagina, ad esempio:
desktop:windowsomobile:ios - Ora della raccolta dati, ad esempio:
2021-06-26 06:00:02.596000 UTC (in order to preserve privacy, we round all minutes to the previous hour, so that only seconds and milliseconds are tracked) - URL della pagina visitata, ad esempio:
https://experienceleague.adobe.com/docs?lang=it - URL referente (URL della pagina collegata alla pagina corrente, se l’utente ha seguito un collegamento)
- ID della visualizzazione pagina generato in modo casuale, in un formato simile a:
2Ac6 - Peso o inverso della frequenza di campionamento, ad esempio:
100. Significa che viene registrata solo una visualizzazione pagina su cento - Il punto di controllo, o nome, di un particolare evento nella sequenza di caricamento della pagina. Oppure, interagendo con esso come visitatore
- L’origine, o identificatore, dell’elemento DOM con cui l’utente interagisce per il punto di controllo indicato sopra. Ad esempio, potrebbe trattarsi di un’immagine
- La destinazione o il collegamento a una pagina o risorsa esterna con cui l’utente interagisce per il punto di controllo menzionato in precedenza. Esempio:
https://blog.adobe.com/jp/publish/2022/06/29/media_162fb947c7219d0537cce36adf22315d64fb86e94.png - Le metriche delle prestazioni Core Web Vitals (CWV) LCP (Largest Contentful Paint), Interaction to Next Paint (INP) e Cumulative Layout Shift (CLS) che descrivono la qualità dell'esperienza del visitatore.
Funzionamento della telemetria operativa per un cliente how-operational-telemetry-works-for-a-customer
La telemetria operativa controlla automaticamente il traffico lato client. In qualità di cliente di Adobe, non è necessario eseguire ulteriori passaggi, in quanto questo servizio è perfettamente integrato nella configurazione esistente. Il servizio di telemetria operativa è già disponibile e consente di usufruire automaticamente dei vantaggi di questa nuova funzionalità. Il servizio di telemetria operativa non espone attualmente al monitoraggio alcuna metrica visualizzata dai clienti. Stiamo lavorando per offrirti questa funzionalità il prima possibile.
Utilizzo della telemetria operativa in Adobe how-operational-telemetry-data-is-being-used
I dati di telemetria operativa vengono utilizzati per i seguenti scopi:
- Identificare e correggere i colli di bottiglia delle prestazioni per le sedi dei clienti
- Per comprendere come AEM interagisce con altri script (ad esempio analisi, targeting o librerie esterne) sulla stessa pagina, per aumentare la compatibilità.
Domande frequenti faq
-
Le metriche "Interaction to next paint" (Interazione con la vernice successiva), "Time to first byte" (Tempo al primo byte) e "First contentful paint" (Prima vernice di contenuto) vengono raccolte?
Vengono raccolte le interazioni con la vernice successiva (INP) e il valore TTFB (Time To First Byte). Al momento non viene raccolta la prima pittura di contenuto.
-
Il percorso
/.rumè bloccato sul sito, come posso risolvere il problema?Il percorso
/.rumè necessario per il funzionamento della raccolta di telemetria operativa. Se utilizzi una rete CDN davanti all'AEM as a Cloud Service di Adobe, accertati che il percorso/.ruminoltri alla stessa origine AEM degli altri contenuti AEM. E assicurati che non venga regolato in alcun modo. In alternativa, è possibile modificare l'host da utilizzare per la telemetria operativa inrum.hlx.pageimpostando una variabile di ambiente in Cloud Manager denominataAEM_OPTEL_EXTERNALal valoretrue. Se in un secondo momento desideri tornare alle stesse richieste di dominio, rimuovi semplicemente di nuovo la variabile di ambiente. -
La raccolta di telemetria operativa viene conteggiata per le richieste di contenuto a scopo contrattuale?
La libreria Telemetria operativa e la raccolta Telemetria operativa non vengono considerate come richieste di contenuto e non aumentano il numero riportato di visualizzazioni di pagina o chiamate API. Inoltre, per i clienti che utilizzano una rete CDN preconfigurata con AEM as a Cloud Service, la raccolta lato server è la base per le richieste di contenuto.
-
Come posso disabilitare la telemetria operativa?
Adobe consiglia di utilizzare la telemetria operativa per i suoi vantaggi significativi e per consentire ad Adobe di ottimizzare le esperienze digitali migliorando le prestazioni del sito web. Il servizio è progettato per essere semplice e non ha alcun impatto sulle prestazioni del sito web.
Rinunciare potrebbe significare perdere l’opportunità di migliorare il coinvolgimento del traffico sul sito web. Se tuttavia si verificano problemi, è possibile disattivare la telemetria operativa impostando una variabile di ambiente in Cloud Manager denominata
AEM_OPTEL_DISABLEDsul valoretrue. Per riattivare la telemetria operativa in un secondo momento, è sufficiente rimuovere nuovamente la variabile di ambiente. -
È possibile utilizzare criteri sulla sicurezza dei contenuti con un Nonce?
Il supporto per la telemetria operativa contiene una funzione sperimentale per supportare un criterio sulla sicurezza dei contenuti con un nonce. Questa funzionalità può essere abilitata impostando una variabile di ambiente in Cloud Manager denominata
AEM_OPTEL_NONCEsul valoretrue. Se desideri disattivarla nuovamente in un secondo momento, rimuovi semplicemente di nuovo la variabile di ambiente.In caso di problemi con questa funzione, contatta il supporto Adobe.
-
Come posso abilitare la telemetria operativa solo per determinate pagine?
Per impostazione predefinita, la telemetria operativa è attivata per tutte le pagine al di sotto della cartella
/contentnell'archivio. Se si imposta una variabile di ambiente in Cloud Manager denominataAEM_OPTEL_INCLUDED_PATHSsu un elenco di percorsi separati da virgola nell'archivio, la telemetria operativa verrà abilitata solo per tali pagine. Inoltre, è possibile impostareAEM_OPTEL_EXCLUDED_PATHSsu un elenco di percorsi nell'archivio che verranno esclusi. La combinazione di queste due impostazioni consente di regolare l'inclusione della telemetria operativa in base alle proprie esigenze.