Queries the number of alert logs that were generated during each interval of a time period.
This topic provides an example on how to query the number of alert logs of Elastic Compute Service (ECS) from the cloud service dimension.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeAlertLogHistogram |
The operation that you want to perform. Set the value to DescribeAlertLogHistogram. |
StartTime | Long | No | 1609988009694 |
The start timestamp of the alert logs to be queried. Unit: milliseconds. |
EndTime | Long | No | 1609989009694 |
The end timestamp of the alert logs to be queried. Unit: milliseconds. |
PageNumber | Integer | No | 1 |
The number of the page to return. Default value: 1 |
PageSize | Integer | No | 10 |
The number of entries to return on each page. Default value: 10. |
SearchKey | String | No | alert |
The keyword based on which the alert logs to be queried are searched. |
GroupId | String | No | 7301**** |
The ID of the application group. |
Product | String | No | ECS |
The abbreviation of the service name. |
Namespace | String | No | acs_ecs_dashboard |
The namespace of the cloud service. Note For more information about the namespaces of cloud services, see Appendix 1: Metrics.
|
Level | String | No | P4 |
The level and notification method of the alert. Valid values:
|
SendStatus | String | No | 0 |
The status of the alert. Valid values:
When the value of the SendStatus parameter is 0, the value P4 of the Level parameter indicates a triggered alert and the value OK indicates a cleared alert. |
ContactGroup | String | No | ECS_Group |
The alert group. |
RuleName | String | No | test123 |
The name of the alert rule. |
MetricName | String | No | cpu_total |
The name of the metric. Note For more information about the metrics of different cloud services, see Appendix 1: Metrics.
|
LastMin | String | No | 360 |
The statistical period of alert logs. Unit: minutes. |
GroupBy | String | No | product |
The dimension based on which data is aggregated. This parameter is similar to the Group By clause of SQL statements. Valid values:
|
For more information about common request parameters, see Common parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
AlertLogHistogramList | Array of AlertLogHistogramList | N/A |
The details about the number of alert logs that were generated during each interval of a time period. |
Count | Integer | 20 |
The number of alert logs. |
From | Long | 1610074791 |
The start timestamp of queried alert logs in an interval. Unit: seconds. |
To | Long | 1610074800 |
The end timestamp of queried alert logs in an interval. Unit: seconds. |
Code | String | 200 |
The HTTP status code. Note The HTTP status code 200 indicates a success.
|
Message | String | The specified resource is not found. |
The error message. |
RequestId | String | 1C4A3709-BF52-42EE-87B5-7435F0929585 |
The ID of the request. |
Success | Boolean | true |
Indicates whether the call was successful. Valid values:
|
Examples
Sample requests
http(s)://[Endpoint]/? Action=DescribeAlertLogHistogram
&Product=ECS
&GroupBy=product
&<Common request parameters>
Sample success responses
XML
format
<DescribeAlertLogHistogramResponse>
<RequestId>6DCB654A-4002-4977-A2E1-F58F85E7143D</RequestId>
<AlertLogHistogramList>
<Count>0</Count>
<From>1610074791</From>
<To>1610074800</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>0</Count>
<From>1610074800</From>
<To>1610074830</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>1</Count>
<From>1610074830</From>
<To>1610074860</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>0</Count>
<From>1610074860</From>
<To>1610074890</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>0</Count>
<From>1610074890</From>
<To>1610074920</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>1</Count>
<From>1610074920</From>
<To>1610074950</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>0</Count>
<From>1610074950</From>
<To>1610074980</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>0</Count>
<From>1610074980</From>
<To>1610075010</To>
</AlertLogHistogramList>
<AlertLogHistogramList>
<Count>0</Count>
<From>1610075010</From>
<To>1610075040</To>
</AlertLogHistogramList>
<Code>200</Code>
<Success>true</Success>
</DescribeAlertLogHistogramResponse>
JSON
format
{
"RequestId": "6DCB654A-4002-4977-A2E1-F58F85E7143D",
"AlertLogHistogramList": [
{
"Count": 0,
"From": 1610074791,
"To": 1610074800
},
{
"Count": 0,
"From": 1610074800,
"To": 1610074830
},
{
"Count": 1,
"From": 1610074830,
"To": 1610074860
},
{
"Count": 0,
"From": 1610074860,
"To": 1610074890
},
{
"Count": 0,
"From": 1610074890,
"To": 1610074920
},
{
"Count": 1,
"From": 1610074920,
"To": 1610074950
},
{
"Count": 0,
"From": 1610074950,
"To": 1610074980
},
{
"Count": 0,
"From": 1610074980,
"To": 1610075010
},
{
"Count": 0,
"From": 1610075010,
"To": 1610075040
}
],
"Code": 200,
"Success": true
}
Error codes
HTTP stat | Error code | Error message | Description |
---|---|---|---|
404 | ResourceNotFound | The specified resource is not found. | The error message returned because the specified resource is not found. |
For a list of error codes, visit the API Error Center.