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

获取 API 访问密钥

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

配置 YAML 文件

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

volc-exporter.yml

1.04KB

请您在 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 表示指标拉取延时，单位为秒。

集成 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 界面。在这里，您可以查看指标数据、定义报警规则等。