度量标准 API

使用度量标准 API

您可以使用度量标准 API 定期轮询有关群集、主机、容器和应用程序的数据。度量标准 API 是从 DC/OS 获取度量标准的一种方式。它专为针对特定任务和主机的偶尔访问而设计。这并不是了解 DC/OS 上所有度量标准整体情况的最佳方式。建议使用 DC/OS 监控服务 来监控群集上的所有度量标准。

度量标准 API 由 Telegraf 支持,后者在群集中的所有节点上运行。

要开始使用 DC/OS 度量标准组件以及了解如何使用度量 API,请参阅 度量快速入门指南

路由

对度量标准 API 的访问是通过 Admin Router 向每个节点代理的。当前领导者的统计数据预先确定:

  1. /system/v1/metrics/v0/

重要信息: /system/v1/metrics/v0/ 预计在管理节点上为 404。

代理节点的统计数据预先确定:

  1. /system/v1/agent/{agent_id}/metrics/v0/

要确定群集的 URL,请参阅 群集访问。节点的代理 ID 为其 Mesos ID。

格式

Mesos API 的请求和响应主体被编排成 JSON 格式。

请求必须包含接受标题:

  1. Accept: application/json

响应将包括内容类型标题:

  1. Content-Type: application/json

身份认证

所有度量标准 API 路由需要认证才能使用。

要验证 API 请求,请参阅 获取认证令牌传递认证令牌 文档。

度量标准 API 还需要通过以下权限授权:

路由权限
/system/v1/metrics/v0/dcos:adminrouter:ops:system-metrics
/system/v1/agent/{agent_id}/metrics/v0/dcos:adminrouter:system:agent

用户也可以通过 dcos:superuser 权限获得所有路由。

要为您的帐户分配权限,请参阅 权限参考 文档。

资源

以下两个路由均提供以下资源:

度量标准 API - 图1