以下将为您介绍如何通过 Exporter 导出火山引擎视频点播服务的监控指标数据至 Prometheus。

获取 API 访问密钥 #

登录火山引擎视频点播控制台，点击用户名并在下拉功能框点击 API访问密钥，并获取对应的 AccessKey ID、AccessKey Secret，简称 AK、SK。

配置 YAML 文件 #

在使用 Exporter 之前，请您获取 YAML 文件并进行配置，该文件已包含了火山引擎视频点播可导出监控指标以及必要的认证配置信息。

请您在 volc-exporter.yml 文件中，配置在准备操作获取的 AccessKey ID、AccessKey Secret 和您需要拉取的火山引擎视频点播监控指标，具体示例如下所示：

credential:
  access_key_id: <YOUR_ACCESS_KEY> #必填，您的 AK
  access_key_secret: <YOUR_SECRET_KEY> #必填，您的 SK
  region_id: <YOUR_REGION_ID> #区域，默认值为 cn-north-1，表示中国
metrics:
  vod: #必填，项目名称
    - name: edge_traffic 
      period: 60  
    - name: edge_bandwidth
      period: 60

在上面的示例中，Exporter 将使用 AK/SK 进行网关认证。此外还配置了火山引擎视频点播的 edge_traffic、edge_bandwidth 指标，分别表示边缘流量和边缘带宽，其查询时间粒度为 60s 。

运行 Exporter #

视频点播已提供 Docker 镜像，使您可以方便地部署和运行 Exporter。您可以在 volc-exporter.yml 所在目录下执行以下命令从 Docker Hub 拉取镜像：

docker run -p 2112:2112 -v $(pwd)/volc-exporter.yml:/opt/app/volc-exporter.yml livingsu/volc-exporter:0.0.1

在上面的命令中，配置文件已挂载到了容器中的 opt/app/volc-exporter.yml 路径下，这样 Exporter 就可以读取配置文件了。此外已将容器的 2112 端口映射到了宿主机的 2112 端口。命令执行完毕后，您可以访问 localhost:2112/metrics 查看指标是否抓取成功。

查看指标和自监控数据 #

访问 localhost:2112/metrics
volc_{project}_{metric} 指标名称：

• project 表示项目，例如 vod；
• metric表示指标，例如 edge_traffic。

当拉取失败或无数据时，则 volc_{project}_{metric} ，即volc_vod_edge_traffic 不存在。
request_latency_seconds 和 failed_request_latency_seconds 记录了获取指标数据的延时情况。
每一个指标对应两个自监控指标：

• volc_{project}_{metric}_up 表示指标是否拉取成功，取值如下所示：
  • 1：拉取成功
  • 0：拉取失败
• volc_{project}_{metric}_latency_seconds 表示指标拉取延时，单位为秒。

控制台页面	指标	指标名称	Dimensions	单位	Min Periods	时间延迟
数据统计 > 分发统计 > 带宽流量	点播CDN-边缘-带宽峰值	edge_bandwidth	DomainName	bps	60s	10min
	点播CDN-边缘-流量	edge_traffic	DomainName	Byte	60s	10min
	点播CDN-回源-带宽峰值	mirror_bandwidth	DomainName	bps	60s	10min
	点播CDN-回源-流量	mirror_traffic	DomainName	Byte	60s	10min
数据统计 > 分发统计 > 请求数	点播CDN请求数-边缘	edge_request_cnt	DomainName	count	60s	10min
	点播CDN请求数-回源	mirror_request_cnt	DomainName	count	60s	10min
数据统计 > 分发统计 > 状态码	点播CDN状态码-边缘-总览	edge_request_cnt_code_total	DomainName	count	60s	10min
	点播CDN状态码-边缘-2xx	edge_request_cnt_code_2xx	DomainName	count	60s	10min
	点播CDN状态码-边缘-3xx	edge_request_cnt_code_3xx	DomainName	count	60s	10min
	点播CDN状态码-边缘-4xx	edge_request_cnt_code_4xx	DomainName	count	60s	10min
	点播CDN状态码-边缘-5xx	edge_request_cnt_code_5xx	DomainName	count	60s	10min
	点播CDN状态码-回源-总览	mirror_request_cnt_code_total	DomainName	count	60s	10min
	点播CDN状态码-回源-2xx	mirror_request_cnt_code_2xx	DomainName	count	60s	10min
	点播CDN状态码-回源-3xx	mirror_request_cnt_code_3xx	DomainName	count	60s	10min
	点播CDN状态码-回源-4xx	mirror_request_cnt_code_4xx	DomainName	count	60s	10min
	点播CDN状态码-回源-5xx	mirror_request_cnt_code_5xx	DomainName	count	60s	10min
数据统计 > 分发统计 > 命中率	点播CDN命中率-流量	cdn_hit_rate_traffic	DomainName	Byte	60s	10min
	点播CDN命中率-请求次	cdn_hit_rate_request	DomainName	count	60s	10min

集成 Prometheus #

安装 #

请点击 Prometheus 官网下载并安装最新版本，您可以根据实际的操作系统和业务需求，选择合适的版本并按照 Prometheus 官方文档进行安装。

配置 #

安装完成后，您需要编辑 Prometheus 的 prometheus.yml 配置文件，以便 Prometheus 获取 Exporter 提供的指标信息。在 prometheus.yml 文件中添加以下内容：

scrape_configs:
  - job_name: 'volc-exporter' 
    static_configs:
      - targets: ["localhost:2112"]

在上面的配置中，我们定义了一个名为 volc-exporter 的任务，并让 Prometheus 从 localhost:2112 地址读取指标数据。

启动 #

在完成配置后，您可以启动 Prometheus 并开始监控您的应用程序或服务。在您的使用终端中，请进入 Prometheus 的安装目录，并运行以下命令启动 Prometheus 并使用您的prometheus.yml配置文件：

./prometheus --config.file=prometheus.yml

访问 UI 界面 #

启动 Prometheus 后，您可以通过在浏览器中访问 http://localhost:9090 来访问 Prometheus 的 UI 界面。在这里，您可以查看指标数据、定义报警规则等。