Reports monitoring data.

Note We recommend that you call the PutHybridMonitorMetricData operation of Hybrid Cloud Monitoring to report monitoring data.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes PutCustomMetric

The operation that you want to perform. Set the value to PutCustomMetric.

MetricList.N.Type String Yes 0

The type of the reported data. Valid values of N: 1 to 21. Valid values:

  • 0: reports raw data
  • 1: reports aggregate data
Note We recommend that you report aggregate data in both the aggregation periods of 60s and 300s. Otherwise, you cannot query monitoring data in a time span that is more than seven days.
MetricList.N.MetricName String Yes cpu_total

The name of the metric. Valid values of N: 1 to 21. For more information, see Appendix 1: Metrics.

MetricList.N.Time String No 1508136760000

The timestamp when the metric data is generated. Valid values of N: 1 to 21. The timestamp can be in one of the following formats:

  • The UTC timestamp that is in the YYYY-MM-DDThh:mm:ssZ format. Example: 20171012T132456.888+0800.
  • The UNIX timestamp of the LONG type. Example: 1508136760000.
MetricList.N.GroupId String Yes 12345

The ID of the application group. Valid values of N: 1 to 21.

Note If the metric does not belong to any application group, enter 0.
MetricList.N.Values String Yes {"value":10.5}

The collection of metric values. Valid values of N: 1 to 21.

Note If the MetricList.N.Type parameter is set to 0, the keys in this parameter must be set to the specified value. CloudMonitor aggregates raw data in each aggregation period to generate multiple statistical values, such as the maximum value, the count, and the total value.
MetricList.N.Dimensions String Yes {"sampleName1":"value1","sampleName2":"value2"}

The dimensions that specify the resources whose monitoring data you want to query. Valid values of N: 1 to 21.

Set the value to a collection of key-value pairs. Format:{"Key":"Value"}.

The key or value must be 1 to 64 bytes in length. Excessive characters are truncated.

The key or value can contain letters, digits, periods (.), hyphens (-), underscores (_), forward slashes (/), and backslashes (\).

Note Dimensions must be formatted as a JSON string in a specified order.
MetricList.N.Period String No 60

The aggregation period. Valid values of N: 1 to 21. Unit: seconds. Valid values: 60 and 300.

Note If the MetricList.N.Type parameter is set to 1, the MetricList.N.Period parameter is required.

Response parameters

Parameter Type Example Description
Code String 200

The HTTP status code.

Note The status code 200 indicates that the call was successful.
Message String The request has failed due to a temporary failure of the server.

The error message.

RequestId String 05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=PutCustomMetric
&MetricList.1.Dimensions={"sampleName1":"value1","sampleName2":"value2"}
&MetricList.1.GroupId=12345
&MetricList.1.MetricName=cpu_total
&MetricList.1.Type=0
&MetricList.1.Values={"value":10.5}
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<PutCustomMetricResponse>
	<RequestId>75D115CE-5DA8-4647-9073-8F72BB85B6F7</RequestId>
	<Message>success</Message>
	<Code>200</Code>
</PutCustomMetricResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "75D115CE-5DA8-4647-9073-8F72BB85B6F7",
  "Message" : "success",
  "Code" : "200"
}

Error codes

For a list of error codes, see Service error codes.