Interroge les détails d'une métrique de surveillance des journaux.
Débogage
Paramètres de requête
|
Paramètre |
Type |
Obligatoire |
Exemple |
Description |
|
Action |
String |
Oui |
DescribeLogMonitorAttribute |
Opération à effectuer. Définissez la valeur sur DescribeLogMonitorAttribute. |
|
MetricName |
String |
Oui |
cpu_total |
Nom de la métrique de surveillance des journaux. La correspondance exacte est prise en charge. Pour plus d'informations, consultez Annexe 1 : Métriques. |
Paramètres de réponse
| Paramètre | Type | Exemple | Description |
| Code | String | 200 | Code d'état HTTP. Remarque Le code d'état 200 indique que l'appel a réussi. |
| LogMonitor | Struct | N/A | Détails de la métrique de surveillance des journaux. |
| Aggregates | Array of Aggregate | N/A | Fonctions d'agrégation. |
| Alias | String | HostName | Alias de la fonction d'agrégation. |
| FieldName | String | hostName | Nom du champ dans les journaux. |
| Function | String | count | Fonction utilisée pour agréger les données de surveillance des journaux au cours d'une période d'agrégation. Valeurs valides :
|
| Max | String | 10 | Valeur maximale. |
| Min | String | 0 | Valeur minimale. |
| GmtCreate | Long | 1547431398000 | Heure de création de la métrique de surveillance des journaux. Cette valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis l'époque, soit le 1er janvier 1970 à 00:00:00 UTC. |
| GroupId | Long | 12345 | ID du groupe d'applications. |
| Groupbys | List | value | Dimension selon laquelle les données sont regroupées. Ce paramètre équivaut à la clause GROUP BY dans les instructions SQL. Si aucune dimension n'est spécifiée, toutes les données sont agrégées sur la base de la fonction d'agrégation. |
| LogId | Long | 1234 | ID renvoyé par Log Service. |
| MetricExpress | String | {"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}} | Champ étendu. Le champ étendu permet d'effectuer des opérations de base sur les résultats d'agrégation. Supposons que vous avez calculé TotalNumber et 5XXNumber en agrégeant les données. TotalNumber indique le nombre total de requêtes HTTP et 5XXNumber indique le nombre de requêtes HTTP dont le code d'état est supérieur à 499. Vous pouvez calculer le taux d'erreur du serveur en ajoutant la formule suivante au champ étendu : 5XXNumber/TotalNumber*100. |
| MetricName | String | cpu_total | Nom de la métrique de surveillance des journaux. Pour plus d'informations, consultez Annexe 1 : Métriques. |
| SlsLogstore | String | test-logstore | Nom du Logstore Log Service. |
| SlsProject | String | test-project | Nom du projet Log Service. |
| SlsRegionId | String | cn-hangzhou | ID de la région où réside le Logstore Log Service. |
| Tumblingwindows | List | 60 | Taille de la fenêtre glissante pour le calcul. Unité : secondes. Le système effectue une agrégation pour chaque fenêtre glissante. |
| ValueFilter | Array of ValueFilterObject | N/A | Condition utilisée pour filtrer les journaux. Les paramètres ValueFilter et ValueFilterRelation sont utilisés conjointement. La condition de filtre équivaut à la clause WHERE dans les instructions SQL. Si aucune condition de filtre n'est spécifiée, tous les journaux sont traités. Supposons que les journaux contiennent le champ Level, qui peut être défini sur Error. Si vous devez calculer le nombre de fois où les journaux de niveau Error apparaissent chaque minute, vous pouvez définir la condition de filtre sur Level=Error et compter le nombre de journaux qui satisfont à cette condition. |
| Key | String | hostName | Nom du champ de journal utilisé pour la correspondance dans la condition de filtre. |
| Operator | String | contain | Méthode utilisée pour faire correspondre la valeur du champ. Valeurs valides :
|
| Value | String | portal | Valeur de champ à faire correspondre dans la condition de filtre. |
| ValueFilterRelation | String | and | Opérateur logique utilisé entre les conditions de filtre des journaux. Les paramètres ValueFilter et ValueFilterRelation sont utilisés conjointement. Valeurs valides :
|
| Message | String | successful | Message renvoyé. Si l'appel a réussi, la valeur success est renvoyée. Si l'appel a échoué, un message d'erreur est renvoyé. |
| RequestId | String | C6718537-E673-4A58-8EE1-24B8B38C7AAE | ID de la requête. |
| Success | Boolean | true | Indique si l'appel a réussi. Valeurs valides :
|
Exemples
Exemples de requêtes
http(s)://[Endpoint]/?Action=DescribeLogMonitorAttribute
&MetricName=cpu_total
&<Common request parameters>
Exemples de réponses réussies
XML format
<DescribeLogMonitorAttributeResponse>
<Message>successful</Message>
<RequestId>BBD7B294-1325-46D1-BD08-848D6A6B9AC6</RequestId>
<LogMonitor>
<SlsProject>slsProject</SlsProject>
<Tumblingwindows>60</Tumblingwindows>
<SlsLogstore>slsLogstore</SlsLogstore>
<MetricExpress>{"extend":{}}</MetricExpress>
<GroupId>12345</GroupId>
<MetricName>cpu_total</MetricName>
<GmtCreate>1577766395000</GmtCreate>
<Aggregates>
<Function>count</Function>
<Min></Min>
<Max></Max>
<Alias>lh_source_count</Alias>
<FieldName>lh_source</FieldName>
</Aggregates>
<ValueFilterRelation>and</ValueFilterRelation>
<ValueFilter>
<Operator>contais</Operator>
<Value>test</Value>
<Key>hostName</Key>
</ValueFilter>
<LogId>1234</LogId>
<SlsRegionId>cn-hangzhou</SlsRegionId>
</LogMonitor>
<Code>200</Code>
<Success>true</Success>
</DescribeLogMonitorAttributeResponse>
JSON format
{
"Message": "successful",
"RequestId": "BBD7B294-1325-46D1-BD08-848D6A6B9AC6",
"LogMonitor": {
"SlsProject": "slsProject",
"Tumblingwindows": [
60
],
"SlsLogstore": "slsLogstore",
"MetricExpress": "{\"extend\":{}}",
"GroupId": 12345,
"MetricName": "cpu_total",
"GmtCreate": 1577766395000,
"Aggregates": [
{
"Function": "count",
"Min": "",
"Max": "",
"Alias": "lh_source_count",
"FieldName": "lh_source"
}
],
"Groupbys": [],
"ValueFilterRelation": "and",
"ValueFilter": [
{
"Operator": "contais",
"Value": "test",
"Key": "hostName"
}
],
"LogId": 1234,
"SlsRegionId": "cn-hangzhou"
},
"Code": 200,
"Success": true
}
Codes d'erreur
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.