This topic describes how to report custom events by sending an HTTP request.


  • Public endpoint:
  • The following table describes the internal endpoints in different regions.
    Region RegionId Endpoint
    China (Hangzhou) cn-hangzhou
    China (Zhangjiakou) cn-zhangjiakou
    China (Shanghai) cn-shanghai
    China (Beijing) cn-beijing
    China (Qingdao) cn-qingdao
    China (Shenzhen) cn-shenzhen
    China (Hong Kong) cn-hongkong
    China (Hohhot) cn-huhehaote
    UAE (Dubai) me-east-1
    US (Silicon Valley) us-west-1
    US (Virginia) us-east-1
    Japan (Tokyo) ap-northeast-1
    Germany (Frankfurt) eu-central-1
    Australia (Sydney) ap-southeast-2
    Singapore (Singapore) ap-southeast-1
    Malaysia (Kuala Lumpur) ap-southeast-3
    India (Mumbai) ap-south-1

Request syntax

An HTTP request uses the following syntax to report custom events:
POST /event/custom/upload HTTP/1.1 
Content-Length:<Content Length>
Content-MD5:<Content MD5>
Date:<GMT Date>

Request headers and parameters

The following tables list the headers and parameters in an HTTP request for reporting custom events.
  • Request headers
    Header Type Description
    Authorization String The authorization string that is in the format of AccessKeyID:SignString.
    Content-Length Long The body length of the HTTP request that is defined in RFC 2616. This header is required only if the request has a body.
    Content-MD5 String The MD5 hash of the HTTP request body. The MD5 hash is a string that consists of uppercase letters and digits. This header is required only if the request has a body.
    Content-Type String The type of the content that is sent in the HTTP request. Set the value to application/json.
    Date String The standard timestamp header of the HTTP request. This timestamp header follows the time format defined in RFC 1123 and uses the UTC standard time.

    Example: Mon, 3 Jan 2010 08:33:47 UTC.

    Host String The full hostname of the HTTP request. This header does not include protocol headers such as https://.


    x-cms-api-version String The version of the API. Set the value to 1.0.
    x-cms-signature String The signature algorithm. Cloud Monitor supports the HMAC-SHA1 signature algorithm.
    x-cms-ip String The IP address of the host that reports the custom events.
    User-Agent String The description of the client.
  • Request parameters
    Parameter Type Required Description
    content String Yes The details of the custom event.
    name String Yes The name of the custom event.
    groupId Long No The ID of the application group to which the custom event belongs.
    time String No The time when the custom event occurred.

Sample response

The following code shows the sample response to an HTTP request that reports custom events:

  "code":"200",// The HTTP status code 200 indicates that the request was successful.
  "msg":""// The value is empty if the events are reported.