首页/云/可观测性速查/抓取限制:sample_limit 与标签上限保护
本包目录(282 条)
监控体系与方法40 条
Prometheus 与采集64 条
Grafana 与看板53 条日志平台52 条链路追踪23 条告警与响应50 条

抓取限制:sample_limit 与标签上限保护

每个抓取任务可配置样本数与标签长度上限,防止单个目标的指标爆炸拖垮采集端;超限时该次抓取被整体判定为失败,而不是部分丢弃。

可观测性速查云更新于 2026-10-12

配置示例

配置示例
- job_name: app
  sample_limit: 10000            # 单次抓取样本数上限,0 表示不限
  label_limit: 60                # 单条样本标签数上限
  label_name_length_limit: 200   # 标签名长度上限
  label_value_length_limit: 500  # 标签值长度上限
  body_size_limit: 50MB          # 响应体大小上限
  metric_relabel_configs:        # 先删无用指标,再受上限约束
    - source_labels: [__name__]
      regex: "go_gc_.*"
      action: drop
上限判定发生在 metric_relabel_configs 之后:想保住重要指标,先丢弃无关序列再定阈值。

易错点

  • 上限设得太小会让目标每次抓取都整体失败、指标完全缺失,排查先看日志里的 sample limit exceeded 报错
  • 示例中的 go_gc_ 前缀按实际指标名替换,正则写错时 drop 不生效、上限照样被触发

数据来源与参考

  • Prometheus 文档 · scrape_config
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌