调用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。取值:

  • count:计数值。
  • sum:求和。
  • avg:平均值。
  • max:最大值。
  • min:最小值。
  • countps:计算统计周期内指定字段求count后的每秒平均值。
  • sumps:计算统计周期内指定字段求sum后的每秒平均值。
  • distinct:去重后计算统计周期内指定字段出现的次数。
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"}}。字段说明如下:

  • extend:必填字段。
  • errorPercent:计算结果生成新字段的别名,您可以根据真实情况自行命名。
  • errorPercent:现有字段的计算表达式。
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配合使用。取值:

  • and:和。
  • or:或。
ValueFilter.N.Key String lh_source

日志匹配的字段名。N的取值范围:1~10。

ValueFilter.N.Operator String Operator

字段值的匹配方式。N的取值范围:1~10。取值:

  • contain:包含。
  • notContain:不包含。
  • >:大于。
  • <:小于。
  • >=:大于等于。
  • <=:小于等于。
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

返回信息。结果如下:

  • 当操作成功时,返回successful
  • 当操作失败时,返回错误信息,例如:alias of aggreate must be set value.
RequestId String BBD7B294-1325-46D1-BD08-848D6A6B9AC6

请求ID。

Success Boolean true

操作是否成功。取值:

  • true:成功。
  • false:失败。

示例

请求示例

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
}

错误码

访问错误中心查看更多错误码。