You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: Add Cayenne CDC and scan-path observability metrics
Document the new OpenTelemetry instruments registered for CDC
ingestion (burst duration, bytes, envelopes, fixed-cost phases)
and scan-path observability (listing table cache, fence wait,
scan duration) in the Cayenne deployment guide.
Copy file name to clipboardExpand all lines: website/docs/components/data-accelerators/cayenne/deployment.md
+18-1Lines changed: 18 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -72,7 +72,24 @@ Vortex compression typically delivers 2–4× better compression than Parquet Sn
72
72
73
73
## Metrics
74
74
75
-
Generic acceleration metrics are available with the `dataset_acceleration_` prefix. Cayenne-specific OpenTelemetry instruments are not currently registered at the runtime layer; use Cayenne's footer/segment cache hit rates surfaced via query plan explain and the generic acceleration counters.
75
+
Generic acceleration metrics are available with the `dataset_acceleration_` prefix. Cayenne also registers the following OpenTelemetry instruments for CDC ingestion and scan-path observability, all tagged by `dataset`:
76
+
77
+
### CDC Apply Metrics
78
+
79
+
| Metric | Type | Unit | Description |
80
+
| ------ | ---- | ---- | ----------- |
81
+
|`dataset_acceleration_cdc_apply_burst_duration_ms`| Histogram | ms | Duration to apply one coalesced CDC burst. |
82
+
|`dataset_acceleration_cdc_apply_burst_bytes`| Histogram | bytes | Arrow in-memory bytes in one coalesced CDC apply burst. |
83
+
|`dataset_acceleration_cdc_apply_burst_envelopes`| Histogram | envelopes | Number of source envelopes in one coalesced CDC apply burst. |
84
+
|`dataset_acceleration_cdc_apply_fixed_cost_ms`| Histogram | ms | Duration for fixed-cost phases of CDC apply (with `phase` label: `finalize_wait`, `commit_wait`, etc.). |
85
+
86
+
### Scan-Path Metrics
87
+
88
+
| Metric | Type | Unit | Description |
89
+
| ------ | ---- | ---- | ----------- |
90
+
|`cayenne_scan_listing_table_cache_entries`| Gauge | entries | Number of entries in the scan `ListingTable` cache. Cleared on snapshot change (compaction/sort/overwrite). |
91
+
|`cayenne_listing_fence_wait_duration_ms`| Histogram | ms | Time spent waiting on listing-fence reads during scans. |
92
+
|`cayenne_listing_scan_duration_ms`| Histogram | ms | Duration of listing-table scans. |
76
93
77
94
See [Component Metrics](../../../features/observability/component_metrics) for enabling and exporting metrics.
0 commit comments