{
  "slug": "aggregation-temporality",
  "term": "Aggregation temporality",
  "aliases": [
    "Metric aggregation temporality",
    "Metric temporality"
  ],
  "definition": "Aggregation temporality specifies whether a metric aggregate covers a new reporting interval or accumulates measurements from a fixed start time.",
  "note": "OpenTelemetry uses delta and cumulative temporality for sums and histograms, including exponential histograms; gauges have no aggregation-temporality field. Delta points describe reporting intervals, while cumulative points retain a common start until accumulation state resets. [proto]\n\nSuccessive cumulative snapshots already share earlier observations. Adding their counts counts those observations again. For compatible snapshots from the same uninterrupted stream, subtraction can recover interval counts and sums, but not generally its minimum or maximum. [model]\n\nConstructed example: a first report for [1, 100] ms has count 2 and sum 101 ms. Adding either [10, 20] or [14, 16] ms gives the same cumulative count 4, sum 131 ms, extrema 1/100 ms and bucket counts [3, 1] at boundary 50 ms. Subtraction gives count 2 and sum 30 ms, but the interval extrema differ. Adding both cumulative counts instead gives 6. [example]\n\nKeep stream identity, units, start/end timestamps and bucket interpretation with each point. The conservative fixture rejects resets, incompatible layouts and overlapping or noncontiguous delta windows rather than inventing missing coverage; it is not a complete OTLP receiver. Detailed reset and overlap guidance in the reviewed data model remains Development. [model]",
  "related": [
    "opentelemetry-exponential-histogram"
  ],
  "citations": [
    {
      "id": "proto",
      "title": "OpenTelemetry Protocol metrics.proto: Sum, Histogram, ExponentialHistogram and AggregationTemporality; pinned d31f7acf.",
      "url": "https://github.com/open-telemetry/opentelemetry-proto/blob/d31f7acf9d461fd0601077de516ac1eb7051422f/opentelemetry/proto/metrics/v1/metrics.proto",
      "accessed": "2026-11-20"
    },
    {
      "id": "model",
      "title": "OpenTelemetry Metrics Data Model: Histogram, Temporality, Resets and Gaps, Overlap; pinned a0c5323b.",
      "url": "https://github.com/open-telemetry/opentelemetry-specification/blob/a0c5323bbc7fd2e3e309ec0e2cb4f02d87609974/specification/metrics/data-model.md",
      "accessed": "2026-11-20"
    },
    {
      "id": "example",
      "title": "Hesela: exact cumulative/delta histogram example and regression tests; no SDK execution.",
      "url": "https://hesela.dev/research/aggregation-temporality/model.test.mjs",
      "accessed": "2026-11-20"
    }
  ],
  "provenance": [
    "Source synthesis and exact non-negative-integer examples. No exporter, collector, SDK or device measurement was executed."
  ],
  "status": "research",
  "advantages": [],
  "limitations": [],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-11-20"
}
