调用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
}

错误码

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