API呼び出しの戻り型は、JSONです。API呼び出しの一般的な形式は、次のとおりです: http://[HOST:PORT]/<URI>
ホストは、emmonitorrestサービスが実行されている監視対象システムを参照します。デフォルトのポートの値は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配列を返します。 リクエストのパラメータ:
これらはオプションで、測定基準が要求される時間間隔の範囲を表わします。指定されない場合、最新のデータ ポイントまたは最後に収集された値に対する測定基準を返します。
これは、任意選択のパラメータです。指定されると、metricGroupの測定基準が返され、CPU、NETWORK、MEMORY、DISKのいずれかの値を取ることができます。指定されない場合、すべての測定基準が応答で返されます。 応答のフィールド:
例:
[ ... ... {"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"}] } ... ... ] |