{
  "license": "CC BY 4.0",
  "recipe": {
    "slug": "telemetry-volume-by-event-name",
    "title": "Measure Telemetry Volume by Event Name",
    "testedWith": "Apache DataFusion 45.2.0",
    "lastReviewed": "2026-07-28"
  },
  "contract": {
    "tableName": "telemetry_ingestion_events",
    "schema": [
      {
        "name": "timestamp_utc",
        "type": "Timestamp",
        "description": "Ingestion attempt time in UTC."
      },
      {
        "name": "event_name",
        "type": "Utf8",
        "description": "Controlled event name."
      },
      {
        "name": "source",
        "type": "Utf8",
        "description": "Bounded producer or SDK source."
      },
      {
        "name": "payload_bytes",
        "type": "Int64",
        "description": "Serialized event size before transport compression."
      },
      {
        "name": "accepted",
        "type": "Boolean",
        "description": "Whether ingestion accepted the event."
      },
      {
        "name": "environment",
        "type": "Utf8",
        "description": "Deployment environment."
      }
    ]
  },
  "query": "SELECT\n  event_name,\n  source,\n  COUNT(*) AS events,\n  SUM(payload_bytes) AS total_payload_bytes,\n  AVG(payload_bytes) AS avg_payload_bytes,\n  SUM(CASE WHEN accepted THEN 0 ELSE 1 END) AS rejected_events,\n  100.0 * SUM(CASE WHEN accepted THEN 0 ELSE 1 END)\n    / NULLIF(COUNT(*), 0) AS rejection_rate_pct\nFROM telemetry_ingestion_events\nWHERE timestamp_utc >= now() - INTERVAL '24 hours'\n  AND environment = 'production'\nGROUP BY event_name, source\nORDER BY total_payload_bytes DESC, event_name;",
  "fixtureKind": "reproducible",
  "inputRows": [
    {
      "timestamp_utc": "2026-07-28T18:00:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:59:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:58:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:57:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": false,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:30:00.000Z",
      "event_name": "llm_request_completed",
      "source": "api",
      "payload_bytes": 1800,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:29:00.000Z",
      "event_name": "llm_request_completed",
      "source": "api",
      "payload_bytes": 2000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:28:00.000Z",
      "event_name": "llm_request_completed",
      "source": "api",
      "payload_bytes": 2200,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:00:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 500,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:59:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 520,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:58:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 480,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:57:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 510,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:56:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 530,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:55:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 460,
      "accepted": false,
      "environment": "production"
    }
  ],
  "illustrativeInputRows": [
    {
      "timestamp_utc": "2026-07-28T18:00:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:59:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:58:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:57:00.000Z",
      "event_name": "debug_trace",
      "source": "worker",
      "payload_bytes": 4000,
      "accepted": false,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:30:00.000Z",
      "event_name": "llm_request_completed",
      "source": "api",
      "payload_bytes": 1800,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:29:00.000Z",
      "event_name": "llm_request_completed",
      "source": "api",
      "payload_bytes": 2000,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:28:00.000Z",
      "event_name": "llm_request_completed",
      "source": "api",
      "payload_bytes": 2200,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T17:00:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 500,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:59:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 520,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:58:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 480,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:57:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 510,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:56:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 530,
      "accepted": true,
      "environment": "production"
    },
    {
      "timestamp_utc": "2026-07-28T16:55:00.000Z",
      "event_name": "page_viewed",
      "source": "web",
      "payload_bytes": 460,
      "accepted": false,
      "environment": "production"
    }
  ],
  "expectedOutput": {
    "columns": [
      "event_name",
      "source",
      "events",
      "total_payload_bytes",
      "avg_payload_bytes",
      "rejected_events",
      "rejection_rate_pct"
    ],
    "rows": [
      {
        "event_name": "debug_trace",
        "source": "worker",
        "events": 4,
        "total_payload_bytes": 16000,
        "avg_payload_bytes": 4000,
        "rejected_events": 1,
        "rejection_rate_pct": 25
      },
      {
        "event_name": "llm_request_completed",
        "source": "api",
        "events": 3,
        "total_payload_bytes": 6000,
        "avg_payload_bytes": 2000,
        "rejected_events": 0,
        "rejection_rate_pct": 0
      },
      {
        "event_name": "page_viewed",
        "source": "web",
        "events": 6,
        "total_payload_bytes": 3000,
        "avg_payload_bytes": 500,
        "rejected_events": 1,
        "rejection_rate_pct": 16.66666667
      }
    ]
  },
  "notes": [
    "The included synthetic input rows generate the expected output when timestamps are shifted into the documented query window.",
    "Run this fixture in the public browser SQL playground; the selected query executes locally with DuckDB-Wasm.",
    "Adapt time windows, thresholds, identities, and business definitions before operational use."
  ]
}