Dokumentation

Bevara X-Correlation-Id i AEMaaCS-felsvar (404/500)

Last update: Thu Nov 13 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

I Adobe Experience Manager as a Cloud Service använder du huvudet X-Correlation-Id för att spåra begäranden i AEM-, Dispatcher- och CDN-lager. Även om den här rubriken visas i lyckade (200 OK) svar saknas den i felsvar som 404 Hittades inte eller 500 internt serverfel, även om AEM-loggar bekräftar att den har angetts. Som standard ersätter CDN AEM-felsvar med syntetiska sidor, som raderar anpassade rubriker. Detta avbryter arbetsflödena för övervakning och felsökning, vilket gör det svårt att korrelera fel på klientsidan med backend-loggar.

Åtgärda problemet genom att lägga till rubriken x-aem-error-pass: true i felsvaren. Detta anger för CDN att vidarebefordra det ursprungliga AEM-svaret i stället för att generera en syntetisk felsida, så att rubriken X-Correlation-Id bevaras i alla svarstyper.

Beskrivning description

Miljö

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • CDN-konfigurationer med responseTransformations
  • Sammanhang: När du implementerar korrelations-ID:n eller spårningsmekanismer i AEM, Dispatcher och CDN

Problem/symtom

  • X-Correlation-Id-huvudet finns i 200 OK svar men saknas i 404 eller 500 svar.
  • AEM-loggarna visar att rubriken är inställd, men den når inte webbläsaren eller API-klienten. Meddelas vid validering av spårning av begäran eller felsökning med cURL, Postman eller webbläsaren developer tools.
  • Övervakningssystemen kan inte spåra misslyckade transaktioner på grund av att korrelationsrubriker saknas.
  • CDN-konfigurationer verkar undertrycka rubriker i felsvar.

Upplösning resolution

Så här tillåter du AEM ursprungliga felsvar och dess rubriker att nå klienten:

  • Konfigurera din AEM-felhanterare så att den innehåller rubriken x-aem-error-pass: true i felsvaren.

  • Detta instruerar CDN att kringgå genereringen av syntetiska felsidor och vidarebefordra det ursprungliga svaret från AEM eller Dispatcher (inklusive dess rubriker) direkt till klienten.

  • När den här ändringen har tillämpats:

    • Rubriken X-Correlation-Id visas både i slutförda och misslyckade svar.
    • Övervakningsverktygen på klientsidan kan spåra hela livscykeln för begäran korrekt.

Ytterligare överväganden:

  • Säkerhet och kompatibilitet: Kontrollera att felnyttolasterna inte visar känslig intern information innan du aktiverar rubriken i produktionen.
  • Omfång: Detta gäller endast svar som genererats av AEM eller Dispatcher. CDN-nivåfel kan fortfarande användas för syntetiska sidor.
  • Vanligt fel: responseTransformations kan inte mata in rubriker igen i syntetiska felsvar.
  • Testtips: Använd verktygen curl -i -v eller för webbläsarutvecklare för att verifiera att huvudet finns före och efter korrigeringen. Exempel: -i -v https:///path-that-triggers-error

Rekommendationer om god praxis:

  • Generera och ange alltid ett korrelations-ID i backend-begäranden.
  • Inkludera samma ID i loggar och rubriker.
  • Använd x-aem-error-pass: true för felsvar som kräver fullständig spårbarhet, särskilt under felsökning eller integrationstestning.
  • Begränsa användningen i produktionen till kontrollerade scenarier för att undvika att CDN:s standardfelhantering åsidosätts.

Relaterad läsning

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f