调用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. 未找到指定资源。

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