From 564734e3371f461ce5c18be7a2a95d2a645e9bed Mon Sep 17 00:00:00 2001 From: Jordan Zucker Date: Tue, 16 Dec 2025 14:45:15 -0800 Subject: [PATCH 1/6] Adding more for new datetime metrics --- content/components/prometheus.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/components/prometheus.md b/content/components/prometheus.md index 60ef05e582..c605f8f7f8 100644 --- a/content/components/prometheus.md +++ b/content/components/prometheus.md @@ -51,6 +51,9 @@ prometheus: - Cover - Switch - Lock +- Datetime +- Date +- Time - Text Sensor - Text - Event From c532bfdea7e1bf3a4160fe67662f5183228a295a Mon Sep 17 00:00:00 2001 From: Jordan Zucker Date: Fri, 19 Dec 2025 13:30:06 -0800 Subject: [PATCH 2/6] And now, that's cool --- content/components/prometheus.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/content/components/prometheus.md b/content/components/prometheus.md index c605f8f7f8..9bcafc2daf 100644 --- a/content/components/prometheus.md +++ b/content/components/prometheus.md @@ -181,6 +181,18 @@ esphome_text_value{id="template_text",area="Dev",node="devidfprometheus",name="T #TYPE esphome_event_failed gauge esphome_event_failed{id="template_event",area="Dev",node="devidfprometheus",name="Template Event"} 0 esphome_event_value{id="template_event",area="Dev",node="devidfprometheus",name="Template Event",last_event_type="custom_event_1"} 1.0 +#TYPE esphome_date_value gauge +#TYPE esphome_date_failed gauge +esphome_date_failed{id="date",area="Dev",node="devidfprometheus",name="Date"} 0 +esphome_date_value{id="date",area="Dev",node="devidfprometheus",name="Date"} 946800000 +#TYPE esphome_time_value gauge +#TYPE esphome_time_failed gauge +esphome_time_failed{id="time",area="Dev",node="devidfprometheus",name="Time"} 0 +esphome_time_value{id="time",area="Dev",node="devidfprometheus",name="Time"} 2096 +#TYPE esphome_datetime_value gauge +#TYPE esphome_datetime_failed gauge +esphome_datetime_failed{id="datetime",area="Dev",node="devidfprometheus",name="Datetime"} 0 +esphome_datetime_value{id="datetime",area="Dev",node="devidfprometheus",name="Datetime"} 946845296 ``` ## See Also From 0175f1c4510e435969832c8378f18b7ed210c8f5 Mon Sep 17 00:00:00 2001 From: Jordan Zucker Date: Fri, 16 Jan 2026 13:54:56 -0800 Subject: [PATCH 3/6] Adjusting docs for updates --- content/components/prometheus.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/components/prometheus.md b/content/components/prometheus.md index 9bcafc2daf..0ae7d180b3 100644 --- a/content/components/prometheus.md +++ b/content/components/prometheus.md @@ -184,15 +184,15 @@ esphome_event_value{id="template_event",area="Dev",node="devidfprometheus",name= #TYPE esphome_date_value gauge #TYPE esphome_date_failed gauge esphome_date_failed{id="date",area="Dev",node="devidfprometheus",name="Date"} 0 -esphome_date_value{id="date",area="Dev",node="devidfprometheus",name="Date"} 946800000 +esphome_date_value{id="date",area="Dev",node="devidfprometheus",name="Date"} 946800000000 #TYPE esphome_time_value gauge #TYPE esphome_time_failed gauge esphome_time_failed{id="time",area="Dev",node="devidfprometheus",name="Time"} 0 -esphome_time_value{id="time",area="Dev",node="devidfprometheus",name="Time"} 2096 +esphome_time_value{id="time",area="Dev",node="devidfprometheus",name="Time"} 2096000 #TYPE esphome_datetime_value gauge #TYPE esphome_datetime_failed gauge esphome_datetime_failed{id="datetime",area="Dev",node="devidfprometheus",name="Datetime"} 0 -esphome_datetime_value{id="datetime",area="Dev",node="devidfprometheus",name="Datetime"} 946845296 +esphome_datetime_value{id="datetime",area="Dev",node="devidfprometheus",name="Datetime"} 946845296000 ``` ## See Also From d3b4b574b9a7f2b67411486152acf772ad3dbc28 Mon Sep 17 00:00:00 2001 From: Jordan Zucker Date: Fri, 16 Jan 2026 15:09:55 -0800 Subject: [PATCH 4/6] Updated with some notes that clear things up --- content/components/prometheus.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/components/prometheus.md b/content/components/prometheus.md index 0ae7d180b3..c3ef74b33a 100644 --- a/content/components/prometheus.md +++ b/content/components/prometheus.md @@ -64,6 +64,10 @@ prometheus: - Valve - Climate +> [!NOTE] +> The prometheus metrics for datetime based entities (datetime, date, time) +> are in milliseconds since the Unix epoch, [as mentioned in the Grafana Time Units Docs](https://grafana.com/docs/grafana/latest/visualizations/panels-visualizations/configure-standard-options/#time-format-units) + ## Supported Prometheus Labels The following labels are supported in all Prometheus metrics. Some metrics may have more labels. From d44519fdf0ff5f975ff64df702664d0fcd496939 Mon Sep 17 00:00:00 2001 From: Jordan Zucker Date: Fri, 16 Jan 2026 15:23:22 -0800 Subject: [PATCH 5/6] One last pass on linting here --- content/components/prometheus.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/components/prometheus.md b/content/components/prometheus.md index c3ef74b33a..1aa9f7c36f 100644 --- a/content/components/prometheus.md +++ b/content/components/prometheus.md @@ -65,7 +65,7 @@ prometheus: - Climate > [!NOTE] -> The prometheus metrics for datetime based entities (datetime, date, time) +> The prometheus metrics for datetime based entities (datetime, date, time) > are in milliseconds since the Unix epoch, [as mentioned in the Grafana Time Units Docs](https://grafana.com/docs/grafana/latest/visualizations/panels-visualizations/configure-standard-options/#time-format-units) ## Supported Prometheus Labels From 50b910345851a1b2a46d045ba1db96715f127121 Mon Sep 17 00:00:00 2001 From: Jordan Zucker Date: Fri, 16 Jan 2026 15:28:30 -0800 Subject: [PATCH 6/6] One last tweak --- content/components/prometheus.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/components/prometheus.md b/content/components/prometheus.md index 1aa9f7c36f..f77458cd75 100644 --- a/content/components/prometheus.md +++ b/content/components/prometheus.md @@ -66,7 +66,8 @@ prometheus: > [!NOTE] > The prometheus metrics for datetime based entities (datetime, date, time) -> are in milliseconds since the Unix epoch, [as mentioned in the Grafana Time Units Docs](https://grafana.com/docs/grafana/latest/visualizations/panels-visualizations/configure-standard-options/#time-format-units) +> are in milliseconds since the Unix epoch for easy use in +> grafana, [as mentioned in the Grafana Time Units Docs](https://grafana.com/docs/grafana/latest/visualizations/panels-visualizations/configure-standard-options/#time-format-units) ## Supported Prometheus Labels