Emmonitorrest 用户操作 - Teradata Ecosystem Manager

Teradata® Ecosystem Manager 安装、配置和升级指南（适用于客户）
Product
Teradata Ecosystem Manager
Release Number
16.20
Published
2018 年 10 月
Language
中文 (简体)
Last Update
2018-11-27
dita:mapPath
zh-CN/gif1512743927221.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-3203
Product Category
Analytical Ecosystem

API 调用的返回类型为 JSON。API 调用的一般格式为：http://[HOST:PORT]/<URI>

HOST 是指正在运行 emmonitorrest 服务的受监控系统。缺省 PORT 值为 8090。

REST 客户端指定每个请求中的媒体类型/版本和格式。

application/com.teradata.em.emmonitor.rest-v1.0+json

REST 客户端将在每个请求中都提供用户名和密码（缺省值 emem 和 em）。下表显示了方法和 URI：
HTTP 方法 URI 说明
GET /emmonitor/metricData/servers 返回服务器信息

示例：

 [{"name":"pontus", "platform":"Linux", "links":[{"rel":"self","href":" http://pontus:8090/emmonitor/metricData/servers/pontus" }, {"rel":"metricGroups","href":" http://pontus:8090/emmonitor/metricData/servers/pontus/metricGroups" }, {"rel":"metrics","href":" http://pontus:8090/emmonitor/metricData/servers/pontus/metrics" }] }]
GET /emmonitor/metricData/servers/<serverName>/metricGroups

针对指定的 <serverName> 返回 metricGroups 的 JSON 数组。

示例：

[{ "name":"CPU", "frequency":30,
"links":[{"rel":"self","href":"http://pontus:8090/emmonitor/metricData/servers/pontus/metricGroups/CPU"}]}, {"name":"MEMORY", "frequency":30, "links":[{"rel":"self","href":"http://
pontus:8090 emmonitor/metricData/servers/ pontus/metricGroups/
MEMORY "}]}, {"name":"DISK", "frequency":30,
"links":[{"rel":"self","href":"http://pontus:8090/emmonitor/metricData/servers/pontus/
/metricGroups/DISK"}]}, {"name":"NETWORK", "frequency":30,
"links":[{"rel":"self","href":"http://pontus:8090/emmonitor/metricData/servers/pontus/metricGroups/
NETWORK "}]}, }]
GET /emmonitor/metricData/servers/<serverName>/metrics

针对指定的 <serverName> 返回指标的 JSON 数组

请求参数：

  • startTime
  • endTime

这些均为可选项，表示请求指标的时间间隔范围。如果未指定，则为最新数据点或最后收集的值返回指标。

  • metricGroupName

此为可选参数。如果指定，则返回 metricGroup 的指标，而且可以采用 CPU、NETWORK、MEMORY 和 DISK 值之一。如果未指定，则在响应中返回所有指标。

响应字段：

  • name - 代表指标名称
  • label - 代表指标标签
  • startTime - 开始时间（如果已指定）
  • endTime - 结束时间（如果已指定）
  • values - 指标值元组
例如：
[
...
...
{"name": "UPTIME",
"label": "System Uptime",
"values": {"value": [2357.89],"collectedTime": 1438929885886},
"unit": "h",
"links": [{"rel": "self","href": "http://pontus:8090/emmonitor/metricData/servers/pontus/metrics/UPTIME"
}

{
"name": "DISKWRITERATE",
"label": "DISK WRITE RATE",
"values": {"value": [89.62,98.57,105.88,122.06], collectedFor": "[/],[/var],[/var/opt/teradata],[/data]","collectedTime": 1438929885880},
"unit": "b/s",
"links": [{"rel": "self","href": "http://pontus:8090/emmonitor/metricData/servers/pontus/metrics/DISKWRITERATE"}]
}
...
...
]