CDN logging knowledge base

See what happened at the edge. Explain what happens next.

CDNLog.com is a practical reference for edge log analytics, CDN monitoring, real-time log delivery, HTTP performance analysis, retention design, and security investigations—without vendor-specific guesswork.

  • Vendor-neutral schemas
  • Clean implementation patterns
  • Operationally useful metrics
Illustrated CDN logging pipeline from edge events through normalization to metrics, search, and alerts
Core topics

From event to decision

A complete map of edge visibility

Use request-level evidence to understand performance, reliability, security, cost, and user-facing outcomes across the delivery path.

See all use cases
01

Edge Log Analytics

Normalize request, cache, routing, timing, and policy fields into a model that answers operational questions.

Analyze the edge
02

CDN Monitoring

Derive stable metrics, SLIs, dashboards, and alerts without turning every high-cardinality event into a time series.

Build useful monitoring
03

Log Streaming API

Design ingestion, retries, redaction, schema evolution, backpressure, replay, and dual real-time/archive paths.

Design the pipeline
04

HTTP Performance

Separate cache, connection, first-byte, transfer, route, region, and origin effects to locate where time changed.

Trace latency
05

Security Log Analysis

Detect material changes in behavior, correlate policy outcomes, protect sensitive fields, and control alert noise.

Investigate securely
06

Retention & Governance

Balance hot search, warm analytics, raw replay, long-term aggregates, deletion, access control, and total cost.

Plan retention
Reference architecture for a CDN log pipeline

Reference architecture

One event model. Two delivery paths. Many decisions.

Keep the fast path small and actionable. Send the complete source to durable storage. Tie both to the same request identity, schema version, and data-quality signals.

  • Receive and validate: authenticate delivery, decompress safely, enforce limits, and reject malformed records visibly.
  • Redact and normalize: remove sensitive values before fan-out and map provider fields into a canonical envelope.
  • Stream and archive: deliver a compact operational event quickly while retaining replayable source records.
  • Measure the pipeline: monitor lag, coverage, duplicates, parse failures, schema drift, and consumer health.

Operational signal set

Metrics that keep their meaning

A strong dashboard separates user outcomes, delivery behavior, and data-pipeline health instead of mixing them into one generic traffic chart.

Delivery freshnessobserved − eventKnow whether the data is current enough to act on.
Eligible cache ratiohits / eligibleKeep bypasses and uncacheable traffic out of the denominator.
Origin latencyp50 · p95 · p99Segment by route, cache state, region, and origin pool.
Coveragereceived / expectedDo not interpret a missing stream as a healthy service.

Field design

Capture evidence, not noise

Start with a governed field contract that supports request tracing, HTTP analysis, cache decisions, origin performance, routing, and security context.

View the reference event
Field familyWhat it explainsCore examplesCommon mistake
IdentityWhich request and schema produced the recordevent time, observed time, request ID, provider, schema versionUsing export time as event time
HTTPWhat the client requested and receivedmethod, host, route, status, protocol, bytesIndexing raw query strings by default
CacheWhy the edge did or did not contact originhit, miss, bypass, revalidated, age, TTL, key versionCombining every non-hit outcome
TimingWhere time entered the delivery pathconnect, first byte, origin, transfer, total edge durationComparing different timing boundaries
PolicyWhich control acted and howaction, rule ID, rate limit, bot signal, result sourceTreating a score as a verdict
Pipeline healthWhether the observability data is trustworthydelivery lag, duplicates, parse failures, coverageAlerting on service data while logs are incomplete

Edge Signal Journal

Recent field guides

Deep, implementation-focused articles for platform engineers, SRE teams, security analysts, and developers working with CDN request data.

Browse all 10 articles

Frequently asked

CDN logging fundamentals

Clear answers to the questions that shape schemas, pipelines, monitoring, and investigations.

Build an edge logging model your teams can trust.

Start with the developer reference, then connect fields to dashboards, investigations, and SLOs.