Skip to content

Add web-requests summary field groups and extend CDN Requests Summary (summary-metrics) - #2256

Draft
sandersonb wants to merge 1 commit into
adobe:masterfrom
sandersonb:feature-ghostwire-web-requests-summary
Draft

Add web-requests summary field groups and extend CDN Requests Summary (summary-metrics)#2256
sandersonb wants to merge 1 commit into
adobe:masterfrom
sandersonb:feature-ghostwire-web-requests-summary

Conversation

@sandersonb

Copy link
Copy Markdown
Contributor

Model aggregated web-request (CDN weblog) summaries for delivery to CJA as summary data, on the XDM Summary Metrics class:

  • web-requests-environment-summary: geo/device/environment via the standard placecontext/device/environment datatypes (paths match Konductor output).
  • web-requests-bot-detection-summary: botDetection score/name/ruleSource/ruleId; supersedes the coarse xdm:cdn.botType string.
  • web-requests-summary-classification: normalized deviceType derived dimension.
  • cdn-requests-summary: extended with aggregate requestBytes/responseBytes.
  • schemas/web-requests/web-requests-summary: reference composite schema and end-to-end example (also the Data Prep mapping target).

Client IP is excluded from summary output (enforced at the Data Prep layer). All schemas and examples pass npm test.

Please link to the issue #…

…(summary-metrics)

Model aggregated web-request (CDN weblog) summaries for delivery to Customer
Journey Analytics as summary data, on the XDM Summary Metrics class. Geo/device/
environment shapes reuse the standard datatypes so they match what the Edge
orchestration layer emits on interactive ExperienceEvents.

New field groups (intendedToExtend summarymetrics):
- web-requests-environment-summary: placeContext/device/environment via the
  standard placecontext, device, and environment datatypes.
- web-requests-bot-detection-summary: botDetection name/ruleSource/ruleId, plus
  additive scoreSum + scoredRequests so an average bot score
  (scoreSum / scoredRequests) re-aggregates correctly at any CJA grain.
- web-requests-summary-classification: normalized deviceType derived dimension.

Extended:
- cdn-requests-summary: aggregate requestBytes / responseBytes metrics.

Reference composite:
- schemas/web-requests/web-requests-summary: Summary Metrics class + all field
  groups merged, with an end-to-end example (also the Data Prep mapping target).

Design notes:
- ruleSource and deviceType are soft enums (meta:enum, no hard enum) so new
  detectors / device classes need no schema change.
- Aggregation grain is set per flow by the upstream GROUP BY; numeric fields are
  never group-by dimensions, so the schema stays a permissive superset.
- Client IP is excluded from summary output for PII; enforced at the Data Prep
  mapping layer (fields cannot be stripped from a $ref'd standard datatype).
- meta:titleId / meta:descriptionId omitted; generated by the localization
  pipeline.

All schemas and examples pass npm test.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@sandersonb
sandersonb force-pushed the feature-ghostwire-web-requests-summary branch from f411efd to 6dce30f Compare September 11, 2026 02:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant