PutLogMonitor - - Centre de documentation Alibaba Cloud

Crée ou modifie une métrique de surveillance des logs en appelant l'opération PutLogMonitor.

Description de l'opération

Cette rubrique fournit un exemple de création d'une métrique de surveillance des logs nommée cpu_total. La réponse indique que la métrique de surveillance des logs a été créée. L'identifiant de la métrique de surveillance des logs est 16****.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

cms:PutLogMonitor

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
LogId	string	Non	L'identifiant de la métrique de surveillance des logs.	16****
SlsRegionId	string	Oui	La région où se trouve le projet Log Service.	cn-hangzhou
SlsProject	string	Oui	Le nom du projet Log Service.	test-project
SlsLogstore	string	Oui	Le nom du Logstore Log Service.	test-logstore
MetricName	string	Oui	Le nom de la métrique. Pour plus d'informations sur les métriques prises en charge par CloudMonitor pour les services Alibaba Cloud, consultez Métriques de surveillance des services cloud.	cpu_total
MetricExpress	string	Non	Le champ étendu. Le champ étendu fournit des opérations arithmétiques sur les résultats des méthodes statistiques. Par exemple, si vous configurez le nombre total de requêtes de codes d'état HTTP (TotalNumber) et le nombre de requêtes avec des codes d'état HTTP supérieurs à 499 (5xxNumber) dans les méthodes statistiques, vous pouvez utiliser le champ étendu pour calculer le taux d'erreur du serveur : 5xxNumber/TotalNumber100. Format JSON : {"extend":{"errorPercent":"5xxNumber/TotalNumber100"}}. Description des champs : extend : requis. errorPercent : l'alias du nouveau champ généré à partir du résultat du calcul. Vous pouvez spécifier un nom personnalisé. errorPercent : l'expression de calcul pour les champs existants.	{"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}
GroupId	string	Non	L'identifiant du groupe d'applications.	7301****
ValueFilterRelation	string	Oui	L'opérateur logique utilisé pour combiner les conditions de filtrage des logs. Valeurs valides : and or Remarque Ce paramètre doit être utilisé conjointement avec `ValueFilter.N.Key`.	and
Tumblingwindows	string	Non	La taille de la fenêtre tumbling pour la pré-agrégation. Unité : secondes. CloudMonitor effectue un calcul d'agrégation sur les données à l'intervalle spécifié.	60,300
Unit	string	Non	L'unité.	Percent
Aggregates	array<object>	Oui	Les définitions des fonctions d'agrégation.
	object	Non
FieldName	string	Oui	Le nom du champ d'origine pour l'agrégation. Valeurs valides de N : 1 à 10.	sourceCount
Function	string	Oui	La méthode statistique utilisée pour agréger les données de logs au cours d'une période statistique. Valeurs valides de N : 1 à 10. Valeurs valides : count : compte le nombre d'occurrences. sum : calcule la somme. avg : calcule la moyenne. max : renvoie la valeur maximale. min : renvoie la valeur minimale. countps : calcule le nombre moyen par seconde pour le champ spécifié au cours de la période statistique. sumps : calcule la somme moyenne par seconde pour le champ spécifié au cours de la période statistique. distinct : compte le nombre d'occurrences du champ spécifié après déduplication au cours de la période statistique.	count
Alias	string	Oui	L'alias de la fonction d'agrégation. Valeurs valides de N : 1 à 10.	Count
Groupbys	array<object>	Non	Les dimensions utilisées pour l'agrégation spatiale. Cela équivaut à la clause Group By en SQL, qui regroupe les données de surveillance selon les dimensions spécifiées. Si aucune dimension n'est spécifiée, toutes les données de surveillance sont agrégées en fonction de la fonction d'agrégation.
	object	Non
FieldName	string	Non	Le nom du champ Group By. Valeurs valides de N : 1 à 10.	cpu
Alias	string	Non	L'alias du champ Group By. Valeurs valides de N : 1 à 10.	CPUUtilization
ValueFilter	array<object>	Non	Les règles de filtrage, utilisées conjointement avec ValueFilterRelation. Cela équivaut à la clause Where en SQL. Si ce paramètre n'est pas spécifié, toutes les données sont traitées. Par exemple, si le log contient les champs Level et Error et que vous souhaitez compter le nombre d'occurrences de Error par minute, vous pouvez définir la méthode statistique pour faire la somme du champ Level avec la condition Level=Error.
	object	Non
Key	string	Non	Le nom du champ de log à faire correspondre. Valeurs valides de N : 1 à 10.	lh_source
Value	string	Non	La valeur du champ de log à faire correspondre. Valeurs valides de N : 1 à 10.	test
Operator	string	Non	La méthode de correspondance pour la valeur du champ. Valeurs valides de N : 1 à 10. Valeurs valides : `contain` : contient. `notContain` : ne contient pas. `>` : supérieur à. `<` : inférieur à. `>=` : supérieur ou égal à. `<=` : inférieur ou égal à.	contain

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

Éléments de réponse

Élément	Type	Description	Exemple
	object
Code	string	Le code d'état HTTP. Remarque 200 indique un succès.	200
Message	string	Le message renvoyé. Résultats : Si l'opération réussit, `successful` est renvoyé. Si l'opération échoue, un message d'erreur est renvoyé, tel que `alias of aggreate must be set value.`.	successful
RequestId	string	L'identifiant de la requête.	91561287-0802-5F9C-9BDE-404C50D41B06
LogId	string	L'identifiant de la métrique de surveillance des logs.	16****
Success	boolean	Indique si l'opération a réussi. Valeurs valides : true : l'opération a réussi. false : l'opération a échoué.	true

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.	The specified resource is not found.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.