:GetLogs

Description de l'opération

• L'hôte (Host) dans la syntaxe de la requête se compose du nom du Projet et du point de terminaison de Simple Log Service. Vous devez spécifier le Projet dans l'hôte.

• Créez et obtenez une paire de clés AccessKey. Pour plus d'informations, consultez Paire de clés AccessKey.

La paire de clés AccessKey d'un compte Alibaba Cloud dispose d'autorisations d'accès à toutes les opérations d'API, ce qui présente des risques de sécurité élevés. Nous vous recommandons vivement de créer et d'utiliser un utilisateur Resource Access Management (RAM) pour l'accès à l'API ou les opérations de routine. L'utilisateur Resource Access Management (RAM) doit disposer des autorisations d'accès pour gérer les ressources EPS de Simple Log Service. Pour plus d'informations, consultez Créer un utilisateur RAM et autoriser l'utilisateur RAM.

• Déterminez le nom du Projet, la région et le nom du Logstore pour les journaux que vous souhaitez interroger. Pour plus d'informations, consultez Gérer un Projet et Gérer un Logstore.

• Simple Log Service impose des limites d'utilisation pour l'interrogation des journaux. Concevez des instructions de requête et d'analyse appropriées et définissez des plages de temps de requête adéquates. Pour plus d'informations, consultez Limites des requêtes de journaux et Limites de l'analyse des journaux.

• Avant d'interroger les journaux, configurez les index. Pour plus d'informations, consultez Créer des index.

• Lorsque le nombre de journaux impliqués dans une requête change de manière significative, l'API Simple Log Service ne peut pas prédire le nombre de fois que cette opération doit être appelée pour obtenir des résultats complets. Vérifiez la valeur d'état x-log-progress dans la réponse de chaque requête pour déterminer si vous devez appeler à nouveau cette opération pour obtenir des résultats complets. Chaque appel répété consomme le même nombre d'unités de calcul de requête (CU).

• Après l'écriture des journaux dans un Logstore, la latence avant que les opérations de requête (GetHistograms et GetLogs) puissent interroger les journaux varie en fonction du type de journal. Simple Log Service classe les journaux dans les deux types suivants en fonction des horodatages UNIX des journaux :

  • Données en temps réel : le point temporel dans le journal se situe dans la plage de (-180 secondes, 900 secondes] par rapport à l'heure actuelle sur le serveur. Par exemple, si l'heure du journal est UTC 2014-09-25 12:03:00 et que le serveur reçoit le journal à UTC 2014-09-25 12:05:00, le journal est traité comme des données en temps réel. Cela se produit généralement dans les scénarios normaux.

  • Données historiques : le point temporel dans le journal se situe dans la plage de [-7×86400 secondes, -180 secondes) par rapport à l'heure actuelle sur le serveur. Par exemple, si l'heure du journal est UTC 2014-09-25 12:00:00 et que le serveur reçoit le journal à UTC 2014-09-25 12:05:00, le journal est traité comme des données historiques. Cela se produit généralement dans les scénarios de remplissage de données. La latence entre l'écriture des données en temps réel et l'interrogation des données est d'environ 3 secondes.

• Simple Log Service fournit des exemples d'utilisation de l'opération GetLogs avec le SDK Java et le SDK Python. Pour plus d'informations, consultez Exemple de SDK Java pour GetLogs et Exemple de SDK Python pour GetLogs.

Ressources d'authentification

Le tableau suivant répertorie les informations d'autorisation correspondant à cette opération d'API. Vous pouvez ajouter ces informations à l'élément Action d'une instruction de stratégie d'accès RAM pour accorder à un utilisateur Resource Access Management (RAM) ou à un rôle RAM l'autorisation d'appeler cette opération d'API.