度量标准 API

使用度量标准 API

您可以使用度量标准 API 定期轮询有关集群、主机、容器和应用程序的数据。度量标准 API 只是从 DC/OS 获取度量标准的一种方式。它专为针对特定任务和主机的偶尔访问而设计。这并不是了解 DC/OS 上所有度量标准整体情况的最佳方式。对此,请参阅 DataDogPrometheus 以及 第三方插件 文档。

度量标准 API 由 [DC/OS 度量标准组件] 支持(/cn/1.11/overview/architecture/components/#dcos-metrics),后者在集群中的所有节点上运行。

有关如何使用度量标准 API 的示例,请参阅 度量标准快速入门指南

路由

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

/system/v1/metrics/v0/

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

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

要确定集群的 URL,请参阅 集群访问。节点的代理 ID 为其 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 权限获得所有路由。

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

资源

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