您可以使用度量标准 API 定期轮询有关群集、主机、容器和应用程序的数据。度量标准 API 是从 DC/OS 获取度量标准的一种方式™。它专为针对特定任务和主机的偶尔访问而设计。这并不是了解 DC/OS 上所有度量标准整体情况的最佳方式。建议使用 DC/OS 监控服务 来监控群集上的所有度量标准。
度量标准 API 由 Telegraf™ 支持,后者在群集中的所有节点上运行。
要开始使用 DC/OS 度量标准组件以及了解如何使用度量 API,请参阅 度量快速入门指南.
路由
对度量标准 API 的访问是通过 Admin Router 向每个节点代理的。当前领导者的统计数据预先确定:
/system/v1/metrics/v0/
代理节点的统计数据预先确定:
/system/v1/agent/{agent_id}/metrics/v0/
要确定群集的 URL,请参阅 群集访问. 节点的代理 ID 为其 Apache® Mesos® ID。
格式
Mesos API 的请求和响应主体被编排成 JSON 格式。
请求必须包含接受标题:
Accept: application/json
响应将包括内容类型标题:
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
权限获得所有路由。
要为您的帐户分配权限,请参阅 权限参考 文档。
资源
以下两个路由均提供以下资源: