Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

feat(data-warehouse): describe four oura tables, close coverage gaps (#123988)

Tom Owersdd7a34b036eb
diff --git a/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md b/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md
index b79bfcf3a7c3..55ee53d27045 100644
--- a/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md
+++ b/products/warehouse_sources/backend/temporal/data_imports/sources/COVERAGE_GAPS_APPENDIX.md
@@ -8985,11 +8985,11 @@ Today (10): `daily_activity`, `daily_readiness`, `daily_sleep`, `daily_spo2`, `d
Diffed against: <https://cloud.ouraring.com/v2/static/json/openapi-1.37.json>
-- [ ] `/v2/usercollection/daily_resilience` — daily resilience score — one of Oura's headline daily scores, alongside the readiness/sleep/activity scores already synced (high)
-- [ ] `/v2/usercollection/daily_cardiovascular_age` — daily cardiovascular age, a headline long-term health metric with no equivalent in the current tables (medium)
-- [ ] `/v2/usercollection/vO2_max` — VO2 max estimates over time, the standard cardio-fitness trend series (medium)
+- [x] `/v2/usercollection/daily_resilience` — daily resilience score — one of Oura's headline daily scores, alongside the readiness/sleep/activity scores already synced (high)
+- [x] `/v2/usercollection/daily_cardiovascular_age` — daily cardiovascular age, a headline long-term health metric with no equivalent in the current tables (medium)
+- [x] `/v2/usercollection/vO2_max` — VO2 max estimates over time, the standard cardio-fitness trend series (medium)
- [ ] `/v2/usercollection/enhanced_tag` — user-annotated events (illness, alcohol, travel) — the dimension table for segmenting every daily metric (medium)
-- [ ] `/v2/usercollection/rest_mode_period` — rest-mode intervals that suppress scores; needed to exclude or explain anomalous daily rows (medium)
+- [x] `/v2/usercollection/rest_mode_period` — rest-mode intervals that suppress scores; needed to exclude or explain anomalous daily rows (medium)
- [ ] `/v2/usercollection/sleep_time` — recommended bedtime windows, joins to the sleep table for adherence analysis (low)
- [ ] `/v2/usercollection/tag` — legacy tag events; superseded by enhanced_tag but still the only history for older data (low)
- [ ] `/v2/usercollection/ring_configuration` — lookup resolving the ring/device that produced each measurement (hardware, size, firmware) (low)
diff --git a/products/warehouse_sources/backend/temporal/data_imports/sources/oura/canonical_descriptions.py b/products/warehouse_sources/backend/temporal/data_imports/sources/oura/canonical_descriptions.py
index f683faacd12f..21210322a033 100644
--- a/products/warehouse_sources/backend/temporal/data_imports/sources/oura/canonical_descriptions.py
+++ b/products/warehouse_sources/backend/temporal/data_imports/sources/oura/canonical_descriptions.py
@@ -106,6 +106,48 @@ CANONICAL_DESCRIPTIONS: CanonicalDescriptions = {
"source": "Context the sample was measured in (awake, rest, sleep, session, live, workout).",
},
},
+ "daily_resilience": {
+ "description": "Daily resilience level, the user's long-term ability to recover from stress.",
+ "docs_url": _DOCS,
+ "columns": {
+ "id": "Unique identifier for the daily resilience summary.",
+ "day": "Calendar day the resilience record was recorded (YYYY-MM-DD).",
+ "contributors": "Breakdown of sleep recovery, daytime recovery, and stress contributing to resilience.",
+ "level": "Resilience level (limited, adequate, solid, strong, or exceptional).",
+ },
+ },
+ "daily_cardiovascular_age": {
+ "description": "Daily predicted cardiovascular (vascular) age for the user.",
+ "docs_url": _DOCS,
+ "columns": {
+ "id": "Unique identifier for the daily cardiovascular age record.",
+ "day": "Calendar day the prediction belongs to (YYYY-MM-DD).",
+ "vascular_age": "Predicted vascular age in years, in the range 18-100.",
+ "pulse_wave_velocity": "Pulse wave velocity in metres per second, derived from vascular age.",
+ },
+ },
+ "vO2_max": {
+ "description": "VO2 max estimates, a measure of cardiorespiratory fitness.",
+ "docs_url": _DOCS,
+ "columns": {
+ "id": "Unique identifier for the VO2 max estimate.",
+ "day": "Calendar day the estimate belongs to (YYYY-MM-DD).",
+ "timestamp": "ISO 8601 timestamp when the estimate was created.",
+ "vo2_max": "Estimated VO2 max value.",
+ },
+ },
+ "rest_mode_period": {
+ "description": "Periods when the user enabled rest mode, during which Oura adjusts scores and targets.",
+ "docs_url": _DOCS,
+ "columns": {
+ "id": "Unique identifier for the rest mode period.",
+ "start_day": "Calendar day rest mode started (YYYY-MM-DD).",
+ "end_day": "Calendar day rest mode ended (YYYY-MM-DD), or null while still active.",
+ "start_time": "ISO 8601 timestamp when rest mode started.",
+ "end_time": "ISO 8601 timestamp when rest mode ended, or null while still active.",
+ "episodes": "Tagged episodes logged during the rest mode period.",
+ },
+ },
"personal_info": {
"description": "Static profile information for the authenticated user.",
"docs_url": _DOCS,