可观测性与稳定性 / 系统课时

job 和 instance 标签表示什么

job 和 instance 标签表示什么

当 Prometheus 同时抓取多台服务器和多个服务时,仅看指标名无法知道样本来自哪里。job 与 instance 是最常见的目标标签:前者表示一类抓取任务,后者标识其中某个具体抓取目标。

学习目标

  • 解释 job 与 instance 的默认来源和职责
  • 使用两个标签筛选同类服务或单个目标
  • 避免把 job、instance 当成业务标签或主机名的固定替代品

两个标签分别回答什么问题

job 回答“这组目标属于哪一类抓取任务”。在常见配置中,它默认来自 scrape_configs 里的 job_name。例如把所有 Node Exporter 节点放到 linux-nodes 任务中,它们通常都会带上 job="linux-nodes"。

instance 回答“这个样本来自哪个具体抓取目标”。如果没有在重标签阶段显式提供 instance,Prometheus 通常会用最终抓取地址生成它,例如 <HOST>:9100。因此同一个 job 下可以有多个不同的 instance。

job 与 instance 标签如何从抓取任务映射到多个目标

下面是一个最小配置片段。它声明了一个抓取任务和两个目标:

yaml
scrape_configs:
  - job_name: linux-nodes
    static_configs:
      - targets:
          - "<HOST_A>:9100"
          - "<HOST_B>:9100"

这是片段示例,需要放入有效的 Prometheus 配置文件并替换主机占位符。配置加载后,可在目标页面确认两个抓取目标都归属于 linux-nodes,并检查实际生成的 instance 值。

用 PromQL 按来源筛选

查询同一类目标时,通常按 job 过滤:

text
up{job="linux-nodes"}

预期结果

text
up{instance="<HOST_A>:9100",job="linux-nodes"} 1
up{instance="<HOST_B>:9100",job="linux-nodes"} 1

up 的值为 1 表示最近一次抓取成功;真实环境中的标签集合、目标地址和排序可能不同。

只检查一个目标时,再增加 instance 条件:

text
up{job="linux-nodes",instance="<HOST_A>:9100"}

预期结果

text
up{instance="<HOST_A>:9100",job="linux-nodes"} 1

这种写法适合定位“整类服务异常”还是“单个目标异常”。如果图表按 job 聚合,就能观察服务组整体状态;如果按 instance 分组,就能看到每个目标的差异。

不要把标签含义想得过于固定

job 不是应用进程自动上报的“业务名称”,而是 Prometheus 抓取配置中的目标分组标签。一个应用完全可能因为不同环境或抓取策略而出现在不同 job 中。

instance 也不一定等于操作系统主机名。默认情况下它更接近“Prometheus 实际抓取的目标地址”,可能是主机加端口、服务发现产生的地址,或经过 relabeling 后的值。需要稳定的机器名、集群名、环境名时,应使用语义明确的独立标签,例如 host、cluster、env。

设计查询时怎样使用它们

排查抓取问题时,先看 job 能快速判断某类目标是否普遍失败;再看 instance 可以缩小到具体端点。做容量或业务聚合时,不应默认把 instance 当成永久身份,因为目标地址可能随部署方式变化。

把 job 理解为“目标组”,把 instance 理解为“具体抓取端点”,就能在绝大多数 Prometheus 查询中正确使用这两个标签,同时把真正的业务维度交给更明确的自定义标签。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

job 和 instance 标签表示什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通