如何让Prometheus指标返回Datetime而非浮点型时间戳？

Prometheus 的 Gauge 指标类型仅支持存储数值型数据，无法直接存储字符串格式的 datetime，因此要实现需求有两种可行方向：

1. 保留时间戳存储，在查询/可视化层转换（推荐） #

继续使用时间戳作为指标值，在查询或可视化工具（如 Grafana）中把时间戳转换为可读的 datetime 格式，这是最符合 Prometheus 指标设计规范的方案：

• 在 PromQL 中（Prometheus 2.40+ 版本支持），可以用 format_time 函数直接转换：

  format_time(date_to_catch, "%Y-%m-%d %H:%M:%S")
  

• 在 Grafana 中，将指标面板的显示格式设置为「Date & Time」即可自动把时间戳转为可读时间。

你的代码不需要修改，保持原有逻辑即可：

self.add_metric(
    prom.Gauge,
    "date_to_catch",
    "The timestamp when the event happened",
)
@property
def date_to_catch(self):
    return self.get_metric("date_to_catch")

def get_the_date(self):
    self.date_to_catch.set(datetime.now().timestamp())

2. 通过标签附加格式化时间（谨慎使用） #

如果必须在指标层面携带可读的 datetime，可以给 Gauge 添加标签存储格式化后的时间，但注意：频繁变化的标签会生成大量时间序列，导致 Prometheus 存储压力陡增，仅适合低频率更新的场景：

修改代码如下：

self.add_metric(
    prom.Gauge,
    "date_to_catch",
    "The timestamp when the event happened (formatted datetime in label)",
    labels=["formatted_datetime"]  # 新增标签用于存储可读时间
)
@property
def date_to_catch(self):
    return self.get_metric("date_to_catch")

def get_the_date(self):
    now = datetime.now()
    # 同时获取时间戳和格式化后的datetime
    timestamp = now.timestamp()
    formatted_dt = now.strftime("%Y-%m-%d %H:%M:%S")
    # 通过标签绑定格式化时间，设置指标值
    self.date_to_catch.labels(formatted_datetime=formatted_dt).set(timestamp)

内容的提问来源于stack exchange，提问作者Yosra MH