采集配置
更新时间:2024-09-05
概述
采集任务(Job)是一组 Target 的配置集合。定义了抓取间隔、访问限制等作用于一组 Target 的抓取行为。Prometheus 监控服务默认预置常用基础监控的采集任务,也支持自定义采集任务。本文将介绍如何创建、管理、复制采集任务配置。
准备工作
-
登录百度智能云控制台:
- 登录成功后,选择“产品服务 > 云原生 > Prometheus 监控服务”,进入“监控实例 > 实例列表”页面。
- 创建监控实例,监控实例与目标监控集群必须在同一地域下,详情见 创建实例。
- (可选)在监控实例详情中,接入目标集群所在的私有网络 VPC,详情见 接入网络。
- 在监控实例详情中,关联目标 CCE 集群(安装 Agent),详情见 安装Agent。
创建采集任务
- 登录 Prometheus监控服务控制台,选择【监控实例】,点击目标实例名称进入实例详情页,在左侧选择【关联集群】,找到目标关联集群,在操作列点击【采集任务】进入采集配置页面。
- 点击【创建采集任务】,使用 YAML 配置 Agent 采集任务规则,点击确认即完成提交。
- 采集任务配置包括:采集时间间隔、采集超时时间、采集协议、采集指标的端口号等。一个任务支持多组 Job 配置。相应配置项说明如下:
scrape_configs:
job_name: kube-state-metrics # 必选,Job 的名称
scrape_interval: 30s # 可选,该 Job 的采集时间间隔,优先级高于全局配置
scrape_timeout: 30s # 可选,该 Job 的采集超时时间,优先级高于全局配置
metrics_path: /metrics # 必选,采集指标的 URI 路径,默认为 /metrics
honor_labels: true # 可选,标签冲突处理策略,配置为 true 表示保留标签;配置为 false 表示重命名标签
honor_timestamps: true # 可选,是否使用指标中的时间戳
scheme: http # 必选,采集协议,支持 http 和 https ,默认为 http
params: # 可选,http 协议参数,仅 scheme 为 http 时有效
p1: ["v1", "v2"]
tls_config: # 可选,https 协议时的 TLS 配置,仅 scheme 为 https 时有效
ca: MIICXwIBAA*** # 配置 CA 证书
cert: MIICjzCCAfg*** # 配置 TLS 证书
key: MIICXQIBAA*** # 配置 TLS 密钥
server_name: tls-server-demo # 配置 TLS 服务器名称
insecure_skip_verify: true # 是否禁用 https 服务器证书验证
min_version: TLS12 # TLS 最小支持的版本号,取值:TLS10 (TLS 1.0), TLS11 (TLS 1.1), TLS12 (TLS 1.2), TLS13 (TLS 1.3)
headers: # 可选,http 请求中的自定义 header
- a
- b
kubernetes_sd_configs:
- role: pod # K8s 服务发现配置
relabel_configs: # 可选,配置指标的 relabel,可配置多个relabel,按顺序执行多个 relabel 规则。如没有需求,可省略
- action: replace # 标签匹配后的操作,包括:replace(替换)、keep(保留)和 drop(丢弃)
source_labels: [ xxxxxx ] # 从原始 labels 中取哪些 label 的值进行 relabel
separator: ; # 定义 regex 中的分隔符,默认为 ;
target_label: xxxxxx # 当 action 为 replace 时,需要添加或重置的标签名称
regex: (.*) # 对 source_labels 对应的值进行正则匹配
modulus: 123 # 源标签 Hash 值的模数
replacement: $1
metric_relabel_configs: # 可选,配置指标抓取之后的 relabel。如没有需求,可省略
- action: replace # 标签匹配后的操作,包括:replace(替换)、keep(保留)和 drop(丢弃)
source_labels: [ xxxxxx ] # 从原始 labels 中取哪些 label 的值进行 relabel
separator: ; # 定义 regex 中的分隔符,默认为 ;
target_label: xxxxxx # 当 action 为 replace 时,需要添加或重置的标签名称
regex: (.*) # 对 source_labels 对应的值进行正则匹配
modulus: 123 # 源标签 Hash 值的模数
replacement: $1
sample_limit: 1024 # 可选,采集器每次采集的样本数量,取值为 0 表示无限制
以下为一个简单采集任务规则例子:
scrape_configs:
job_name: 'kubernetes-biz-pods'
scrape_interval: 30s
scrape_timeout: 30s
metrics_path: /metrics
scheme: http
kubernetes_sd_configs:
- role: pod
relabel_configs:
- source_labels: [__meta_kubernetes_service_annotation_prometheus_io_scheme]
action: replace
target_label: __scheme__
regex: (https?)
- source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape_pods]
action: keep
regex: true
- source_labels: [__address__, __meta_kubernetes_pod_annotation_prometheus_io_port]
action: replace
regex: ([^:]+)(?::\d+)?;(\d+)
replacement: $1:$2
target_label: __address__
- source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_path]
action: replace
target_label: __metrics_path__
regex: (.+)
- action: labelmap
regex: __meta_kubernetes_pod_label_(.+)
- action: labeldrop
regex: (.+)_revision_hash|(.+)_template_generation
说明:
- 更多配置项说明,可参见 官网文档。
- 采集任务配置修改并下发后,约 1 分钟 后才会生效,请您耐心等待。
管理采集任务
-
创建采集任务成功后,在“监控实例 > 采集配置”中可查看当前监控实例关联集群的 Agent 采集任务列表,展示任务名称、监控类型、请求路径、状态、创建时间等信息。
说明:集群 Agent 配置中预设配置中预设了基础监控的采集任务,默认采集核心组件的监控指标数据。
- 采集任务创建成功后,默认启用,即规则生效。可在采集任务的操作列中,点击“禁用”,采集任务状态将变成“禁用”,则规则失效,可点击“启用”恢复。
复制采集任务
创建采集任务成功后,在“监控实例 > 采集配置”中可查看当前监控实例关联集群的采集任务列表,在您需要复制的采集任务操作列中,点击“复制”,在二次确认弹窗中,输入新任务名称后点击“确认”,即可复制一条采集任务。