You need to enable JavaScript to run this app.
导航
通过 Exporter 导出视频点播监控数据至 Prometheus
最近更新时间:2023.03.10 16:53:07首次发布时间:2023.03.10 16:53:07

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

获取 API 访问密钥

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

配置 YAML 文件

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

volc-exporter.yml
1.04KB

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

说明

volc-exporter.yml 文件已包含了火山引擎视频点播服务端全部监控指标配置,您可以根据实际业务需要选择指标。该指标具体说明请参考下方的查看指标和自监控数据

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_trafficedge_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_secondsfailed_request_latency_seconds 记录了获取指标数据的延时情况。

每一个指标对应两个自监控指标:

  • volc_{project}_{metric}_up 表示指标是否拉取成功,取值如下所示:

    • 1:拉取成功
    • 0:拉取失败
  • volc_{project}_{metric}_latency_seconds 表示指标拉取延时,单位为秒。

说明

预计延迟时间仅供参考,实际时长请以您的页面返回时长为准。

控制台页面指标指标名称Dimensions单位Min Periods时间延迟
数据统计 > 分发统计 > 带宽流量点播CDN-边缘-带宽峰值edge_bandwidthDomainNamebps60s10min
点播CDN-边缘-流量edge_trafficDomainNameByte60s10min
点播CDN-回源-带宽峰值mirror_bandwidthDomainNamebps60s10min
点播CDN-回源-流量mirror_trafficDomainNameByte60s10min
数据统计 > 分发统计 > 请求数点播CDN请求数-边缘edge_request_cntDomainNamecount60s10min
点播CDN请求数-回源mirror_request_cntDomainNamecount60s10min
数据统计 > 分发统计 > 状态码点播CDN状态码-边缘-总览edge_request_cnt_code_totalDomainNamecount60s10min
点播CDN状态码-边缘-2xxedge_request_cnt_code_2xxDomainNamecount60s10min
点播CDN状态码-边缘-3xxedge_request_cnt_code_3xxDomainNamecount60s10min
点播CDN状态码-边缘-4xxedge_request_cnt_code_4xxDomainNamecount60s10min
点播CDN状态码-边缘-5xxedge_request_cnt_code_5xxDomainNamecount60s10min
点播CDN状态码-回源-总览mirror_request_cnt_code_totalDomainNamecount60s10min
点播CDN状态码-回源-2xxmirror_request_cnt_code_2xxDomainNamecount60s10min
点播CDN状态码-回源-3xxmirror_request_cnt_code_3xxDomainNamecount60s10min
点播CDN状态码-回源-4xxmirror_request_cnt_code_4xxDomainNamecount60s10min
点播CDN状态码-回源-5xxmirror_request_cnt_code_5xxDomainNamecount60s10min
数据统计 > 分发统计 > 命中率点播CDN命中率-流量cdn_hit_rate_trafficDomainNameByte60s10min
点播CDN命中率-请求次cdn_hit_rate_requestDomainNamecount60s10min

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