Consulte les journaux d'un projet. Vous pouvez utiliser cette opération pour interroger les journaux au niveau du projet.
Description de l'opération
Remarques sur l'utilisation
-
Host se compose d'un nom de projet et d'un point de terminaison Simple Log Service. Vous devez spécifier un projet dans Host.
-
Une paire AccessKey est créée et obtenue. Pour plus d'informations, consultez Paire AccessKey.
La paire AccessKey d'un compte Alibaba Cloud dispose des autorisations sur toutes les opérations d'API. L'utilisation de ces identifiants pour effectuer des opérations dans Simple Log Service est une opération à haut risque. Nous vous recommandons d'utiliser un utilisateur Resource Access Management (RAM) pour appeler des opérations d'API ou effectuer des opérations courantes d'exploitation et de maintenance (O&M). Pour créer un utilisateur RAM, connectez-vous à la console RAM. Assurez-vous que l'utilisateur RAM dispose des autorisations de gestion sur les ressources Simple Log Service. Pour plus d'informations, consultez Créer un utilisateur RAM et autoriser l'utilisateur RAM à accéder à Simple Log Service.
-
Les informations nécessaires pour interroger les journaux sont obtenues. Ces informations incluent le nom du projet auquel appartiennent les journaux et la région du projet. Pour plus d'informations, consultez Gérer un projet.
-
Les index sont configurés avant d'interroger les journaux. Pour plus d'informations, consultez Créer des index.
-
Des limites sont imposées lorsque vous utilisez Simple Log Service pour interroger des journaux. Nous vous recommandons de spécifier les instructions de requête et les plages de temps de requête en fonction de ces limites. Pour plus d'informations, consultez Présentation de la recherche de journaux et Présentation de l'analyse de journaux.
-
Vous devez définir query sur une instruction SQL standard.
-
Vous devez spécifier un Logstore dans la clause FROM d'une instruction SQL. Un Logstore peut être utilisé comme une table SQL.
-
Vous devez spécifier une plage de temps dans une instruction SQL en utilisant le paramètre __date__ ou __time__. La valeur du paramètre __date__ est un horodatage. La valeur du paramètre __time__ est un nombre entier, et l'unité de la valeur est la seconde.
Ressources d'authentification
Le tableau suivant décrit les informations d'autorisation requises pour cette opération. Vous pouvez ajouter ces informations à l'élément Action d'une instruction de stratégie RAM pour accorder à un utilisateur RAM ou à un rôle RAM les autorisations nécessaires pour appeler cette opération.
| Action | Resource |
log:GetProjectLogs | acs:log:{#regionId}:{#accountId}:project/{#ProjectName} |
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
Syntaxe de la requête
GET /logs HTTP/1.1Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| project |
string |
Oui |
Le nom du projet. |
ali-test-project |
| query |
string |
Oui |
L'instruction SQL standard. Dans cet exemple, l'instruction SQL interroge le nombre de pages vues (PV) du 2022-03-01 10:41:40 au 2022-03-01 10:56:40 dans un Logstore dont le nom est nginx-moni. |
SELECT COUNT(*) as pv FROM nginx-moni where __time__ > 1646102500 and __time__ < 1646103400 |
| powerSql |
boolean |
Non |
Indique si la fonctionnalité Dedicated SQL doit être activée. Pour plus d'informations, consultez Activer Dedicated SQL. Valeurs valides :
Vous pouvez utiliser le paramètre powerSql ou query pour configurer Dedicated SQL. |
false |
Exemples de requêtes
GET /logs?query=SELECT COUNT(*) as pv FROM nginx-moni where time > 1646102500 and time < 1646103400&powerSql=false HTTP/1.1 Host:ali-test-project.ch-hangzhou.log.aliyuncs.com Content-Type:application/json.
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
array |
Les journaux renvoyés. |
||
|
object |
Le journal renvoyé. |
[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ] |
|
|
string |
Le journal renvoyé. |
[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ] |
Exemples
JSON format
[
{
"key": "[ { \"__time__\" : 1409529660, \"__source__\" : \"192.168.1.100\", \"Key1\" : \"error\", \"Key2\" : \"Value2\" }, { \"__time__\" : 1409529680, \"__source__\" : \"192.168.1.100\", \"Key3\" : \"error\", \"Key4\" : \"Value4\" } ]"
}
]Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.