使用PutLogMonitor建立或修改日誌監控-CloudMonitor-阿里雲 - Cloud Monitor

呼叫 PutLogMonitor 介面建立或修改日誌監控。

介面說明

本文將提供一個示例，建立一個日誌監控cpu_total。返回結果顯示，建立日誌監控成功，日誌監控 ID 為16****。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cms:PutLogMonitor

create

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
LogId	string	否	日誌監控 ID。	16****
SlsRegionId	string	是	日誌服務中日誌專案（Project）所在地域。	cn-hangzhou
SlsProject	string	是	日誌服務中日誌專案的名稱。	test-project
SlsLogstore	string	是	日誌服務中日誌庫的名稱。	test-logstore
MetricName	string	是	監控項名稱。關於雲端監控支援雲端服務的監控項，請參見雲端產品監控項。	cpu_total
MetricExpress	string	否	擴展欄位。擴展欄位為統計方法中的結果提供四則運算的功能。例如：在統計方法中設定了 HTTP 狀態碼請求總數 TotalNumber 和 HTTP 狀態碼大於 499 的請求數 5xxNumber，則可以透過擴展欄位計算出伺服器端的錯誤率：5xxNumber/TotalNumber100。 JSON 格式：{"extend":{"errorPercent":"5xxNumber/TotalNumber100"}}。欄位說明如下： extend：必填欄位。 errorPercent：計算結果產生新欄位的別名，您可以根據實際情況自行命名。 errorPercent：現有欄位的計算運算式。	{"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}
GroupId	string	否	應用分組 ID。	7301****
ValueFilterRelation	string	是	日誌篩選的過濾條件。取值： and：和。 or：或。說明本參數需要與`ValueFilter.N.Key`配合使用。	and
Tumblingwindows	string	否	預計算視窗時間。單位：秒。雲端監控將在定義的預計算時間對資料做一次彙總計算。	60,300
Unit	string	否	單位。	Percent
Aggregates	array<object>	是	彙總計算定義。
	object	否
FieldName	string	是	彙總計算原始的欄位名稱。N 的取值範圍：1~10。	sourceCount
Function	string	是	在計算週期內根據選定的統計方法對日誌資料進行彙總處理。N 的取值範圍：1~10。取值： count：計數。 sum：求和。 avg：平均值。 max：最大值。 min：最小值。 countps：計算統計週期內指定欄位求 count 後的每秒平均值。 sumps：計算統計週期內指定欄位求 sum 後的每秒平均值。 distinct：去重後計算統計週期內指定欄位出現的次數。	count
Alias	string	是	彙總計算別名。N 的取值範圍：1~10。	Count
Groupbys	array<object>	否	對資料進行空間維度彙總。相當於 SQL 中的 Group By，根據指定的維度，對監控資料進行分組。如果 Group By 不選擇任何維度，則根據彙總方法對全部監控資料進行彙總。
	object	否
FieldName	string	否	GroupBy 欄位名稱。N 的取值範圍：1~10。	cpu
Alias	string	否	GroupBy 別名。N 的取值範圍：1~10。	CPUUtilization
ValueFilter	array<object>	否	篩選的過濾規則，配合 ValueFilterRelation 使用。相當於 SQL 中的 Where 條件。如果不填寫，則表示對全部資料進行處理。例如：日誌中有 Level 和 Error 欄位，如果需要統計每分鐘 Error 出現的次數，則統計方法可以定義為對 Level 求和，並且 Level=Error。
	object	否
Key	string	否	日誌匹配的欄位名稱。N 的取值範圍：1~10。	lh_source
Value	string	否	日誌匹配的欄位值。N 的取值範圍：1~10。	test
Operator	string	否	欄位值的匹配方式。N 的取值範圍：1~10。取值： `contain`：包含。 `notContain`：不包含。 `>`：大於。 `<`：小於。 `>=`：大於等於。 `<=`：小於等於。	contain

關於公共請求參數的詳情，請參見公共參數。

返回參數

名稱	類型	描述	樣本值
	object
Code	string	狀態碼。說明 200 表示成功。	200
Message	string	返回資訊。結果如下：當操作成功時，返回`successful`。當操作失敗時，返回錯誤資訊，例如：`alias of aggreate must be set value.`。	successful
RequestId	string	請求 ID。	91561287-0802-5F9C-9BDE-404C50D41B06
LogId	string	日誌監控 ID。	16****
Success	boolean	操作是否成功。取值： true：成功。 false：失敗。	true

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	ParameterInvalid	%s
400	LimitorError	Log monitor limit is not enough
500	InternalError	The request processing has failed due to some unknown error.
403	AccessForbidden	User not authorized to operate on the specified resource.
404	ResourceNotFound	The specified resource is not found.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。