调用PutLogMonitor接口创建或修改日志监控。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | PutLogMonitor |
要执行的操作,取值:PutLogMonitor。 |
Aggregates.N.Alias | String | 是 | Count |
聚合计算别名。N的取值范围:1~10。 |
Aggregates.N.FieldName | String | 是 | sourceCount |
需要被聚合计算原始的字段名称。N的取值范围:1~10。 |
Aggregates.N.Function | String | 是 | count |
统计方法:指在统计周期内如何计算日志数据的函数方法。N的取值范围:1~10。取值:
|
SlsLogstore | String | 是 | test-logstore |
日志服务名称。 |
SlsProject | String | 是 | test-project |
日志Project。 |
SlsRegionId | String | 是 | cn-hangzhou |
日志服务所在的地域ID。 |
LogId | String | 否 | 12345 |
日志ID。 |
MetricName | String | 否 | cpu_total |
监控项名称。详情请参见云产品监控项。 |
MetricExpress | String | 否 | {"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}} |
扩展字段。 扩展字段为统计方法中的结果提供四则运算的功能。 例如:如果在统计方法中已配置HTTP状态码请求总数TotalNumber,HTTP状态码大于499的请求数5XXNumber,则可以通过扩展字段计算出服务端错误率,公式:5XXNumber/TotalNumber*100。 JSON格式:{"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}。字段说明如下:
|
GroupId | String | 否 | 12345 |
应用分组ID。 |
Groupbys.N.Alias | String | 否 | CPUUtilization |
GroupBy别名。N的取值范围:1~10。 |
Groupbys.N.FieldName | String | 否 | cpu |
GroupBy字段名称。N的取值范围:1~10。 |
ValueFilterRelation | String | 否 | and |
日志筛选的过滤条件。需要和ValueFilter配合使用。取值:
|
ValueFilter.N.Key | String | 否 | lh_source |
日志匹配的字段名。N的取值范围:1~10。 |
ValueFilter.N.Operator | String | 否 | Operator |
字段值的匹配方式。N的取值范围:1~10。取值:
|
ValueFilter.N.Value | String | 否 | test |
日志匹配的字段值。N的取值范围:1~10。 |
Tumblingwindows | String | 否 | 60,300 |
预计算窗口时间。单位:秒。系统将在定义的预计算时间对数据做一次聚合计算。 |
Unit | String | 否 | Percent |
单位。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 |
状态码。 |
LogId | String | 12345 |
如果创建或者修改成功,返回日志监控ID。 |
Message | String | successful |
返回信息。结果如下:
|
RequestId | String | BBD7B294-1325-46D1-BD08-848D6A6B9AC6 |
请求ID。 |
Success | Boolean | true |
操作是否成功。取值:
|
示例
请求示例
http(s)://[Endpoint]/?Action=PutLogMonitor
&Aggregates.1.Alias=Count
&Aggregates.1.FieldName=sourceCount
&Aggregates.1.Function=count
&SlsLogstore=test-logstore
&SlsProject=test-project
&SlsRegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<PutLogMonitorResponse>
<Message>successful</Message>
<RequestId>BA75EC4B-9363-4F96-9CD4-59F7CDFC2293</RequestId>
<Code>200</Code>
<LogId>12345</LogId>
<Success>true</Success>
</PutLogMonitorResponse>
JSON
格式
{
"Message": "successful",
"RequestId": "BA75EC4B-9363-4F96-9CD4-59F7CDFC2293",
"Code": 200,
"LogId": 12345,
"Success": true
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交