: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.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
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.mdindex 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`, `dDiffed 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.pyindex 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,