调用PutLogMonitor接口创建或修改日志监控。

本文将提供一个示例，创建一个日志监控cpu_total。返回结果显示，创建日志监控成功，日志监控ID为16****。

调试

您可以在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：去重后计算统计周期内指定字段出现的次数。
MetricName String 是 cpu_total

监控项名称。关于云监控支持云服务的监控项，请参见云产品监控项。

SlsLogstore String 是 test-logstore

日志服务中日志库的名称。
SlsProject String 是 test-project

日志服务中日志项目的名称。
SlsRegionId String 是 cn-hangzhou

日志服务中日志项目（Project）所在地域。
ValueFilterRelation String 是 and

日志筛选的过滤条件。取值：

  • and：和。
  • or：或。
说明 本参数需要与ValueFilter.N.Key配合使用。
LogId String 否 16****

日志监控ID。
GroupId String 否 7301****

应用分组ID。
MetricExpress String 否 {"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}

扩展字段。 扩展字段为统计方法中的结果提供四则运算的功能。

例如：在统计方法中配置了HTTP状态码请求总数TotalNumber和HTTP状态码大于499的请求数5xxNumber，则可以通过扩展字段计算出服务端的错误率：5xxNumber/TotalNumber*100。

JSON格式：{"extend":{"errorPercent":"5xxNumber/TotalNumber*100"}}。字段说明如下：

  • extend：必填字段。
  • errorPercent：计算结果生成新字段的别名，您可以根据真实情况自行命名。
  • errorPercent：现有字段的计算表达式。
Groupbys.N.Alias String 否 CPUUtilization

GroupBy别名。N的取值范围：1~10。
Groupbys.N.FieldName String 否 cpu

GroupBy字段名称。N的取值范围：1~10。

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

状态码。

说明 200表示成功。
LogId String 16****

日志监控ID。
Message String successful

返回信息。结果如下：

  • 当操作成功时，返回successful。
  • 当操作失败时，返回错误信息，例如：alias of aggreate must be set value.。
RequestId String 91561287-0802-5F9C-9BDE-404C50D41B06

请求ID。
Success Boolean true

操作是否成功。取值：

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

示例

请求示例

http(s)://[Endpoint]/?Action=PutLogMonitor
&Aggregates.1.Alias=Count
&Aggregates.1.FieldName=sourceCount
&Aggregates.1.Function=count
&MetricName=cpu_total
&SlsLogstore=test-logstore
&SlsProject=test-project
&SlsRegionId=cn-hangzhou
&ValueFilterRelation=and
&<公共请求参数>

正常返回示例

XML格式 

<PutLogMonitorResponse>
	  <Message>successful</Message>
	  <RequestId>91561287-0802-5F9C-9BDE-404C50D41B06</RequestId>
	  <Code>200</Code>
	  <LogId>16****</LogId>
	  <Success>true</Success>
</PutLogMonitorResponse>

JSON格式 

{
    "Message": "successful",
    "RequestId": "91561287-0802-5F9C-9BDE-404C50D41B06",
    "Code": 200,
    "LogId": "16****",
    "Success": true
}

错误码

HttpCode 错误码 错误信息 描述
404 ResourceNotFound The specified resource is not found. 未找到指定资源。

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