使用prometheus_api_client触发IndexError: list index out of range问题排查

核心问题出在metric_object_list[1]这行——大概率是返回的指标列表长度不足2，哪怕基础查询有结果，范围查询的返回序列数量可能和预期不符。

先做排查 #

• 先打印列表的长度和全部内容，确认实际返回的指标数量：

  print(len(metric_object_list))
  print(metric_object_list)
  

• 检查范围查询的时间参数：比如起始/结束时间是否在Prometheus的存储保留期内，或者时间范围太窄导致没返回足够的指标序列。
• 核对范围查询的语句：有没有误改标签过滤条件，导致返回的指标序列数量变少。

安全取值的写法 #

别直接硬写索引，改成更稳妥的方式：

# 遍历所有返回的指标对象
for metric_obj in metric_object_list:
    print(metric_obj)
    # 这里加转DataFrame的逻辑
# 或者判断长度后再取指定索引
if len(metric_object_list) >= 2:
    my_metric_object = metric_object_list[1]
    print(my_metric_object)
else:
    print(f"只返回了{len(metric_object_list)}个指标序列，拿不到索引1的元素")

转DataFrame的正确操作 #

用库自带的MetricDataFrame直接转换范围查询结果更省心：

from prometheus_api_client import PrometheusConnect
from prometheus_api_client.metric import MetricDataFrame

# 初始化连接
prom = PrometheusConnect(url="http://你的Prometheus地址:9090", disable_ssl=True)
# 执行范围查询（示例：过去1小时，步长1分钟）
metric_result = prom.custom_query_range(
    query='你的指标查询语句',
    start_time='1h',
    end_time='now',
    step='1m'
)
# 转成DataFrame
metric_df = MetricDataFrame(metric_result)
print(metric_df.head())

内容的提问来源于stack exchange，提问作者Abdul Hakeem