配置示例
配置示例
global:
external_labels:
cluster: dc1
region: east
# 远程写与联邦传输时这些标签随数据携带，本地查询结果中同样可见多集群部署时用它区分数据来源，与 Alertmanager 的集群维度抑制配合更有效。
本包目录（282 条）
监控体系与方法40 条
Prometheus 与采集64 条
- Prometheus 架构与组件概览
- 主机 CPU/内存/磁盘使用率的标准查询
- up 指标：抓取健康与目标存活
- 部署 node_exporter 采集主机指标
- rate 与 irate：计数器变化率
- histogram_quantile：分位计算实战
- 告警规则：expr、for 与 annotations
- prometheus.yml：配置结构总览
- PromQL 基础：瞬时向量与范围向量
- sum by 与 without：聚合与维度裁剪
- 比率查询：错误率与占比的写法
- 抓取任务（scrape_configs）基础写法
- relabel_configs：抓取前的目标标签改写
- node_exporter 关键指标速查
- 抓取间隔与超时的取值权衡
- metric_relabel_configs：抓取后的指标治理
- increase：窗口内的累计增量
- 标签匹配运算符：=、!=、=~、!~
- mysqld_exporter：MySQL 指标采集
- kubernetes_sd：Kubernetes 服务发现
- promtool：配置与规则校验工具
- topk 与 bottomk：找出靠前的序列
- absent 与 absent_over_time：检测指标缺失
- 比较运算符：过滤语义与 bool 修饰
- 时间聚合函数族：_over_time 系列
- 记录规则：把高频查询预先算好
- redis_exporter：Redis 指标采集
- cAdvisor：容器资源指标采集
- static_configs：静态目标列表
- file_sd：用文件做服务发现
- offset 与 @：时间平移查询
- 向量匹配：on、ignoring 与 group_left
- 向量匹配做指标关联（示例：成功率）
- remote write：把数据写到长期存储
- HTTP API：query 与 query_range 实战
- nginx-prometheus-exporter：Nginx 指标采集
- kube-state-metrics：集群对象状态指标
- TSDB 存储结构与保留策略
- Prometheus Operator 与 ServiceMonitor
- deriv：指标变化斜率
- 告警模板：$labels、$value 与 humanize
- blackbox 探测模块：http、tcp、icmp、dns
- Pushgateway 使用要点与清理
- 抓取限制：sample_limit 与标签上限保护
- predict_linear：容量耗尽预测查询
- changes 与 resets：变化次数与重置次数
- count_over_time：窗口内的样本数
- promtool test rules：告警规则单元测试
- 内置 UI：Targets、Rules 与查询页
- textfile 采集器：注入自定义静态指标
- dns_sd：基于 DNS SRV 记录发现目标
- label_replace：查询期改写标签
- keep_firing_for：减少抖动导致的漏看
- 联邦：从下级 Prometheus 拉取汇总数据
- 序列过期与 stale 标记（staleness）
- Exemplars：把指标关联到链路
- consul_sd：Consul 服务目录发现
- clamp 系列：数值截断与展示控制
- 时间函数：time、timestamp 与日期判断
- external_labels：给数据打上集群身份
- Agent 模式：只采集与远程写
- AWS EC2 服务发现（ec2_sd_configs）
- sort 与 sort_desc：结果排序
- honor_labels：标签冲突时听谁的
external_labels：给数据打上集群身份
external_labels 在通信场景（远程写、联邦、告警）附加到所有数据上，标识集群或区域；它不需要逐个目标配置，是分层部署的常用手段。
易错点
- external_labels 与目标自带标签冲突时的保留规则与抓取场景不同，排查跨集群数据先检查这里
- 修改 external_labels 相当于改变序列身份，历史与新数据不会自动合并
数据来源与参考
- Prometheus 文档 · external_labels