PutLogMonitor - - Centre de documentation Alibaba Cloud

L'exemple de cette rubrique illustre la création de la métrique de surveillance des journaux cpu_total. La réponse confirme la création de la métrique et indique que son ID est 16****.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	PutLogMonitor	Opération à effectuer. Définissez la valeur sur PutLogMonitor.
Aggregates.N.Alias	String	Yes	Count	Alias de la fonction d'agrégation. Valeurs valides de N : 1 à 10.
Aggregates.N.FieldName	String	Yes	sourceCount	Nom du champ à agréger. Valeurs valides de N : 1 à 10.
Aggregates.N.Function	String	Yes	count	Fonction utilisée pour agréger les données de surveillance des journaux sur une période donnée. Valeurs valides de N : 1 à 10. Valeurs possibles : count : compte le nombre. sum : calcule la somme. avg : calcule la moyenne. max : sélectionne la valeur maximale. min : sélectionne la valeur minimale. countps : divise le nombre d'occurrences du champ spécifié par le nombre total de secondes de la période d'agrégation. sumps : divise la somme du champ spécifié par le nombre total de secondes de la période d'agrégation. distinct : compte le nombre de journaux contenant le champ spécifié durant la période d'agrégation.
MetricName	String	Yes	cpu_total	Nom de la métrique. Pour plus d'informations sur les métriques des services cloud, consultez l'Annexe 1 : Métriques.
SlsLogstore	String	Yes	test-logstore	Nom du Logstore Log Service.
SlsProject	String	Yes	test-project	Nom du projet Log Service.
SlsRegionId	String	Yes	cn-hangzhou	Région du projet Log Service.
ValueFilterRelation	String	Yes	and	Opérateur logique entre les conditions de filtre des journaux. Valeurs possibles : and or Remarque Les paramètres ValueFilterRelation et `ValueFilter.N.Key` doivent être utilisés conjointement.
LogId	String	No	16****	ID de la métrique de surveillance des journaux.
GroupId	String	No	7301****	ID du groupe d'applications.
MetricExpress	String	No	null	Champ étendu. Il permet d'effectuer des opérations de base sur les résultats d'agrégation. Par exemple, après agrégation des données, vous obtenez TotalNumber (nombre total de requêtes HTTP) et 5XXNumber (nombre de requêtes HTTP dont le code d'état est supérieur à 499). Vous pouvez calculer le taux d'erreur serveur en ajoutant la formule suivante au champ étendu : 5XXNumber/TotalNumber100. Format JSON : {"extend":{"errorPercent":"5XXNumber/TotalNumber100"}}. Description : extend : obligatoire. errorPercent : alias du champ résultant du calcul. Personnalisez l'alias selon vos besoins. 5XXNumber/TotalNumber*100 : expression de calcul.
Groupbys.N.Alias	String	No	CPUUtilization	Alias de la dimension de regroupement des données. Valeurs valides de N : 1 à 10.
Groupbys.N.FieldName	String	No	cpu	Nom du champ servant de dimension. Valeurs valides de N : 1 à 10.
ValueFilter.N.Key	String	No	lh_source	Nom du champ de journal utilisé pour la correspondance dans la condition de filtre. Valeurs valides de N : 1 à 10.
ValueFilter.N.Operator	String	No	contain	Méthode de correspondance de la valeur du champ. Valeurs valides de N : 1 à 10. Valeurs possibles : `contain` : contient `notContain` : ne contient pas `>` : supérieur à `<` : inférieur à `>=` : supérieur ou égal à `<=` : inférieur ou égal à
ValueFilter.N.Value	String	No	test	Valeur du champ à faire correspondre dans la condition de filtre. Valeurs valides de N : 1 à 10.
Tumblingwindows	String	No	60,300	Taille de la fenêtre glissante (tumbling window) pour le calcul. Unité : secondes. CloudMonitor agrège les données pour chaque fenêtre glissante.
Unit	String	No	Percent	Unité.

Pour plus d'informations sur les paramètres de requête communs, consultez les Paramètres communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	200	Code d'état HTTP. Remarque Le code 200 indique que l'appel a réussi.
LogId	String	16****	ID de la métrique de surveillance des journaux.
Message	String	successful	Message renvoyé. En cas de succès, la valeur `successful` est renvoyée. En cas d'échec, un message d'erreur est renvoyé. Exemple : `alias of aggreate must be set value.`
RequestId	String	91561287-0802-5F9C-9BDE-404C50D41B06	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs possibles : true : appel réussi. false : échec de l'appel.

Exemples

Exemple de requête

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
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

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

Format JSON

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

Codes d'erreur

HttpCode	Error code	Error message	Description
404	ResourceNotFound	The specified resource is not found.	La ressource spécifiée est introuvable.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.