このトピックでは、HTTPリクエストを送信してカスタムイベントをレポートする方法について説明します。
エンドポイント
カスタムイベントをレポートするエンドポイントの詳細については、「付録3: モニタリングデータをレポートするエンドポイント」をご参照ください。
リクエスト構文
HTTPリクエストは、次の構文を使用してカスタムイベントを報告します:
POST /event/custom/upload HTTP/1.1
権限付与:<AuthorizationString>
Content-Length:<Content Length>
Content-MD5:<コンテンツMD5>
Content-Type:application/json
日付:<GMT日付>
Hos t:metrichub-cms-cn-hangzhou.aliyuncs.com
x-cms-signature:hmac-sha1
x-cms-api-version:1.0
x-cms-ip:30.27.XX.XX
User-Agent:cms-java-sdk-v-1.0
[{"content":"EventContent","groupId":GroupId,"name":"EventName","time":"20171023T144439.948 + 0800"}]
リクエストヘッダーとパラメーター
次の表に、カスタムイベントをレポートするためのHTTPリクエストのヘッダーとパラメーターを示します。
リクエストヘッダー
ヘッダー
データ型
説明
承認
String
AccessKeyID:SignString
の形式の権限付与文字列。AccessKey IDの取得方法については、「AccessKey ペアの取得」をご参照ください。
文字列に署名する方法については、CloudMonitorはHMAC-SHA1署名アルゴリズムをサポートしていますか?.
Content-Length
Long
RFC 2616で定義されているHTTPリクエストのボディ長。 このヘッダーは、リクエストに本文がある場合にのみ必要です。
Content-MD5
String
HTTPリクエストボディのMD5ハッシュ。 MD5ハッシュは、大文字と数字で構成される文字列です。 このヘッダーは、リクエストに本文がある場合にのみ必要です。
Content-Type
String
HTTPリクエストで送信されるコンテンツのタイプ。 値を
application/json
に設定します。日付
String
HTTPリクエストの標準タイムスタンプヘッダー。 このタイムスタンプヘッダーは、RFC 1123で定義された時間形式に従い、UTC標準時間を使用します。
例:
月曜日、1月3日2010 08:33:47 GMT
ホスト
String
HTTPリクエストの完全なホスト名。 このヘッダーには、https:// などのプロトコルヘッダーは含まれません。
例:
metrichub-cms-cn-hangzhou.aliyuncs.com
。x-cms-api-version
String
API のバージョン。 値を 1.0 に設定します。
x-cms-signature
String
署名アルゴリズム。 CloudMonitorはHMAC-SHA1署名アルゴリズムをサポートしています。
x-cms-ip
String
カスタムイベントを報告するホストのIPアドレス。
User-Agent
String
クライアントの説明。
リクエストパラメーター
パラメーター
データ型
必須
説明
content
String
必須
カスタムイベントの詳細。
name
String
必須
カスタムイベントの名前。
groupId
Long
任意
カスタムイベントが属するアプリケーショングループのID。
time
String
任意
カスタムイベントが発生した時刻。
レスポンスの例
次のコードは、カスタムイベントを報告するHTTPリクエストに対するサンプル応答を示しています。
{
"code":"200",// HTTPステータスコード200は、リクエストが成功したことを示します。
"msg":"" // イベントが報告された場合、値は空です。
}