文档中心

托管 Prometheus

云服务接入

云服务器自定义接入

托管 Prometheus 支持接入云服务器，满足用户对云上基础资源和自定义业务的统一监控需求。本文为您介绍 ECS 实例接入的流程和步骤。

背景信息

云服务器是一种安全稳定、可弹性伸缩的云上虚拟服务器，包含 CPU、内存、硬盘、网络等资源。您可以使用 ECS 服务器打造弹性易用、安全可靠的业务环境，有效降低 IT 维护成本。

当您使用云服务器（Elastic Compute Service，ECS）产品，或在云服务器产品上部署自定义业务时，允许接入托管 Prometheus，实现对云服务器实例基础资源和自定义业务的监控。

说明

更多产品详情，请参见云服务器（ECS）产品文档。

前提条件

注册并开通 VMP、ECS 服务。

已创建托管 Prometheus 工作区，详情请参见创建工作区。

已创建 ECS 实例。详情请参见创建 ECS 实例。

监控 ECS 基础资源时，请确认 ECS 实例中已经安装监控组件（cloud-monitor-agent、node-exporter 等）。详情请参见如何处理ECS实例的“Cloud-monitor-agent无法采集监控数据”问题。

监控 ECS 上的自定义业务时，请确认自定义业务部署完成，且已暴露指标接口，或已部署对应的 expoter。

已配置安全组。详情请参见创建安全组。

创建托管采集器使用的安全组，并在出规则中放行 ECS 实例所在网段和端口。

配置 ECS 所属安全组，并在入规则中允许托管采集器使用的安全组访问对应端口。

说明

托管 Prometheus 工作区和目标 ECS 实例必须处于相同地域。

操作步骤

在顶部导航栏，选择目标地域。

在左侧导航栏中选择接入中心 > 组件，单击云服务器自定义采集。

（可选）服务授权。

当第一次配置 ECS 集成任务时，需要对 VMP 服务面向 ECS 服务和 VPC 服务进行跨服务访问授权。单击去授权，配置服务授权。

单击立刻授权，为 VMP 跨服务访问请求进行授权。

配置集成任务详情。

配置项	说明
任务名称	配置集成任务的名称。
工作区	选择已创建的托管 Prometheus 工作区。
ECS VPC	选择 ECS 实例所在的 VPC。
安全组	选择托管采集器使用的安全组，允许托管采集器访问用户 VPC 中的资源。注意为确保托管采集器能够正确采集到 ECS 中的指标，请将云服务器所在的目标网段、端口添加到所选的安全组出访问规则中。
子网	选择 VPC 子网。主要用于网络打通，配合云服务器对象使用子网过滤支持过滤监控指标采集的 ECS 范围。
云服务器对象使用子网过滤	进行监控指标采集的 ECS 范围。关闭：（默认）不使用子网过滤。系统会在所选 VPC 下进行 ECS 服务发现，将对 VPC 中所有子网内的 ECS 进行监控指标采集。开启：使用子网过滤。系统会在所选子网下进行 ECS 服务发现，仅对 VPC 中指定子网内的 ECS 进行监控指标采集。

Job 配置，包括：采集时间间隔、采集超时时间、采集协议、采集指标的端口号等。一个任务支持多组 Job 配置。

目前提供 3 种服务发现配置：

服务发现配置	配置示例
volc_sd_configs	默认的服务发现配置，示例如下： volc_sd_configs: - port: 9091 # 必选，采集指标的端口号。 project_name: project_a # 可选，通过 Project 对 ECS 实例进行筛选 tag_filters: # 可选，通过标签对 ECS 实例进行筛选。 - key: ecs-label # 筛选 ECS 实例的标签名称。 values: ["demo-a", "demo-b"] # 筛选 ECS 实例的标签值。 instance_ids: # 可选，通过 ECS 实例 ID 进行筛选。 - i-ycpy3h* - i-ycroi4* instance_name: ecs-demo # 可选，通过 ECS 实例名称进行模糊匹配和筛选。
http_sd_configs	Prometheus 原生支持的服务发现配置，无生态依赖，适合不需要复杂服务发现机制、灵活对接各类后端的场景，例如：无服务注册中心的轻量架构、对接自定义注册中心等场景。更多详细说明参见：官方文档，示例如下： http_sd_configs: - url: 'https://service-discovery.example.com/targets' # 必选，获取目标列表的 HTTP/HTTPS 端点。 refresh_interval: 15s # 可选，拉取目标列表的间隔。 timeout: 8s # 单次请求端点的超时时间。 basic_auth: # 可选，基础认证（用户名+密码）。 username: 'prometheus-sd' # 认证用户名。 password: 'secure-pass-123' # 认证密码。 tls_config: # 可选，HTTPS 端点的 TLS 配置，确保通信安全。 ca_file: '/etc/prometheus/root-ca.crt' # 客户端证书，用于双向认证。 server_name: 'service-discovery.example.com' # 验证服务器证书的主机名。 insecure_skip_verify: false # 是否跳过证书验证。生产环境不建议开启。
consul_sd_configs	Prometheus 原生支持的服务发现配置，原生集成 Consul，自动化程度高，适合已落地 Consul 服务网格或需要大规模动态监控的场景，例如：已部署 Consul 作为服务注册中心、大规模微服务集群监控、多数据中心等场景。更多详细说明参见：官方文档，示例如下： consul_sd_configs: - server: 'consul-server:8500' # 必选，Consul 服务的 HTTP API 地址。 datacenter: 'dc-prod' # 可选，Consul 数据中心名称，要求与 Consul 集群配置一致。 services: ['user-service', 'order-service', 'payment-*'] # 可选，需要监控的服务，支持通配符。 health_check: true # 可选，是否仅保留 Consul 健康检查状态为 passing 的实例，生产环境建议启用。 acl_token_file: '/etc/prometheus/consul-acl-token.txt' # 可选，存储 Consul ACL 令牌的文件路径，支持从文件读取 ACL 令牌。 timeout: 8s # 可选，连接 Consul 超时时间。

以下 Job 配置的完整示例以 volc_sd_configs 服务发现进行详细说明：

说明

更多配置项说明，请参见官方文档。

Job 配置修改并下发后，约 1 分钟后才会生效，请您耐心等待。

当您配置多个 ECS 筛选条件时，多个条件之间为与关系，即只有同时满足所有筛选条件的 ECS 实例才会被发现并监控。

单击确认，完成配置。

结果验证

配置完成后，您可以查看任务状态和任务详情。确定目标 ECS 实例是否正确接入 Promethues 服务。

在左侧导航栏中选择接入中心 > 接入任务，并选择托管环境页签。

在任务列表中选择目标任务，单击任务名称，进入接入任务详情。选择目标列表页签，即可查看已正确接入托管 Prometheus 的 ECS 实例。