Osservabilità tramite OpenTelemetry

Scopri come AEM as a Cloud Service utilizza OpenTelemetry per inviare tracce, metriche e registri alla piattaforma di monitoraggio delle prestazioni delle applicazioni (APM) desiderata.

Adobe sta sostituendo l’integrazione integrata di Application Performance Monitoring (APM) in AEM as a Cloud Service con OpenTelemetry, uno standard aperto per la raccolta e l’esportazione di tracce, metriche e registri. Con OpenTelemetry, inserisci il tuo endpoint APM e monitora AEM insieme alle altre applicazioni, utilizzando gli strumenti già noti ai tuoi team. Per ulteriori informazioni, vedere la documentazione OpenTelemetry.

Questo articolo spiega cosa fornisce l’integrazione, come la telemetria scorre da AEM alla piattaforma APM, cosa controlli e cosa considerare prima di abilitarla. Nell’esercitazione sulla configurazione viene illustrato come impostare OpenTelemetry per l’ambiente AEM.

Perché OpenTelemetry

Con OpenTelemetry è possibile:

Adobe fornisce e aggiorna l’agente Java OpenTelemetry che viene eseguito con AEM, in modo da non installarlo o aggiornarlo. Si decide dove andare la telemetria.

Come funziona

Il diagramma seguente mostra il flusso logico della telemetria dai servizi AEM alla piattaforma di osservabilità:

L’agente Java OpenTelemetry raccoglie la telemetria dell’applicazione dai servizi AEM e la invia a un agente OpenTelemetry Collector in esecuzione nell’ambiente AEM. Il raccoglitore elabora la telemetria e la inoltra su OTLP/HTTPS alla piattaforma di osservabilità configurata.

Viene inviata solo la telemetria generata dall’applicazione AEM. Le informazioni relative al runtime e alla piattaforma sottostanti, ad esempio nomi host interni, indirizzi, identificatori dei contenitori e dettagli del sistema operativo o del processo, vengono rimosse prima che i dati lascino l’ambiente.

Che cos’è la telemetria disponibile

Alcuni dettagli da tenere a mente:

Come vengono identificati i servizi AEM

Ogni traccia, metrica e voce di registro contiene attributi di risorse che consentono alla piattaforma di distinguere ambienti e livelli:

Utilizzare questi attributi per filtrare e raggruppare la telemetria e per correlare i registri con tracce e metriche dello stesso servizio.

Cosa controlli

L’integrazione viene configurata distribuendo il file config/otel.yaml tramite la pipeline di configurazione di Cloud Manager.

Il file di configurazione di esempio è:

kind: "Otel"
version: "v1"
metadata:
  envTypes:
    - "dev"
    - "stage"
    - "prod"
data:
  enabled: true
  type: "generic"
  endpoint: "<YOUR_OTLP_HTTPS_ENDPOINT>"
  authHeaderName: "Authorization"
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"
  metrics: true
  logs: true
  advancedNetworking: false

La configurazione determina:

Le credenziali di autenticazione (authHeaderValue) devono essere archiviate come variabile di ambiente Cloud Manager secret denominata OTEL_CUSTOMER_AUTH e a cui si fa riferimento dal file di configurazione. Non memorizzare mai le credenziali come testo normale nell’archivio.

Se l’endpoint OTLP/HTTPS è privato o richiede traffico in uscita da un indirizzo IP stabile noto, abilitare Rete avanzata con uscita dedicata. L’impostazione advancedNetworking non ha alcun effetto a meno che Cloud Manager non abbia già eseguito il provisioning di Advanced Networking per l’ambiente. Un endpoint SaaS pubblico utilizza il percorso di rete in uscita standard.

Destinazioni supportati

Puoi inviare telemetria a qualsiasi piattaforma APM che espone un endpoint OTLP/HTTPS, tra cui:

Questo elenco non è esaustivo. OpenTelemetry definisce il formato di telemetria e il protocollo di esportazione e la piattaforma selezionata determina il modo in cui i dati vengono interrogati, visualizzati, conservati e avvisati.

Scegli una piattaforma di osservabilità

Per ricevere la telemetria è necessaria una piattaforma che accetti OTLP/HTTPS. Adobe non lo fornisce, devi fornire una tua piattaforma di osservabilità.

Se la tua organizzazione utilizza già una delle piattaforme descritte qui sopra, inizia da lì. In caso contrario, scegli tra una piattaforma ospitata dal fornitore (SaaS) e una con hosting autonomo:

Prima di iniziare

Passaggi successivi

Segui l’esercitazione sulla configurazione per configurare OpenTelemetry con il progetto di esempio AEM WKND o con il tuo progetto AEM.

Risorse aggiuntive