Prometheus query和series这两个api有什么区别？

Prometheus 是一个开源的监控和警报系统，它通过使用基于时间序列的数据来收集和存储指标。在 Prometheus 的 API 中，query 和 series 这两个端点确实都与数据查询相关，但它们的目的和返回结果有着本质的不同：

1. query API：

   • 目的：这个 API 用于执行 PromQL 查询并返回查询结果。PromQL 是 Prometheus 自定义的一种查询语言，允许用户以非常灵活的方式检索、聚合和计算指标数据。当你对特定的时间序列数据进行数学运算、过滤、聚合等操作时，就会用到 query API。
   • 返回内容：query API 返回的是根据 PromQL 查询表达式指定的指标数据点。这些数据点通常包含了时间戳和对应的值，也可能包括其他标签信息。结果可以是即时的单个数据点、时间序列范围内的数据点集合或者聚合后的结果。

2. series API：

   • 目的：相比之下，series API 的主要目的是列出匹配特定标签选择器的所有时间序列的元数据信息。这意味着它不返回具体的时间序列数据点，而是告诉你有哪些时间序列存在，并提供它们的标签集。
   • 返回内容：series API 返回的是一个对象列表，每个对象描述了一个时间序列，包含该系列的 metric 名称和所有标签对。这有助于了解哪些数据被 Prometheus 收集并可供查询，而不涉及实际的数值数据。

总结来说，如果你需要获取具体的指标数据或执行复杂的计算和分析，应该使用 query API；而如果你想了解当前系统中有哪些可用的时间序列及其标签配置，或者用于发现可用于构建 PromQL 查询的指标信息，那么 series API 就是更好的选择。虽然两者都与数据探索有关，但侧重点和应用场景明显不同。