Découvrez les régions, les projets, les Logstores, les journaux et autres structures de données dans Simple Log Service (SLS).
Les concepts suivants décrivent le modèle de données de SLS.
Région
Une région est un nœud de service Alibaba Cloud. Déployez vos services dans différentes régions pour réduire la latence d'accès de vos utilisateurs.
Projet
Un projet est l'unité de gestion de base dans SLS pour l'isolation et le contrôle des ressources. Utilisez un projet pour gérer tous les journaux et sources de journaux d'une application.
Logstore
Un Logstore est l'unité de collecte, de stockage et de consommation des journaux dans SLS. Chaque Logstore appartient à un projet et un projet peut contenir plusieurs Logstores. Bonne pratique : créez un Logstore par type de journal. Par exemple, pour une application de jeu nommée big-game qui génère des journaux d'exploitation, des journaux d'application et des journaux d'accès, créez un projet nommé big-game avec trois Logstores, un pour chaque type de journal.
Journal
Un journal est la plus petite unité de données dans SLS. SLS utilise le modèle de données semi-structuré suivant :
| Champ | Description | Exigences |
| time | Champ réservé. Il indique l'heure de génération du journal, généralement extraite de l'horodatage du journal. | Entier. Horodatage UNIX en secondes (secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC). |
| topic | Champ personnalisé permettant de catégoriser les journaux. Par exemple, classez les journaux d'accès par site. | Toute chaîne, y compris une chaîne vide, jusqu'à 128 octets. La valeur par défaut est une chaîne vide. |
| source | Source du journal, telle que l'adresse IP de la machine d'origine. | Toute chaîne encodée en UTF-8 jusqu'à 128 octets. La valeur par défaut est une chaîne vide. |
| content | Contenu du journal, composé d'une ou plusieurs paires clé-valeur. | Clé : chaîne UTF-8 jusqu'à 128 octets. Caractères autorisés : lettres, chiffres et traits de soulignement (_). Ne peut pas commencer par un chiffre. Clés réservées :
|
| tags | Tags de journal :
|
Format dictionnaire. La clé et la valeur sont des chaînes. Dans la console, les tags s'affichent avec le préfixe __tag__:. |
Topic
Vous pouvez classer les journaux d'un Logstore par topic. Spécifiez un topic lors de l'écriture des journaux, puis filtrez par topic lors des requêtes. Par exemple, utilisez un ID utilisateur comme topic afin que chaque utilisateur ne voie que ses propres journaux. Si aucune catégorisation n'est nécessaire, utilisez le même topic pour tous les journaux.
Une chaîne vide est un topic valide et constitue la valeur par défaut pour l'écriture et les requêtes. Si vous n'avez pas besoin de topics, utilisez la chaîne vide par défaut.
L'exemple suivant mappe un journal d'accès Nginx brut au modèle de données SLS. L'adresse IP du serveur Nginx est 10.10.10.1 :
10.1.1.1 - - [01/Mar/2012:16:12:07 +0800] "GET /Send?AccessKeyId=82251054** HTTP/1.1" 200 5 "-" "Mozilla/5.0 (X11; Linux i686 on x86_64; rv:10.0.2) Gecko/20100101 Firefox/10.0.2"Ce journal brut correspond au modèle de données SLS comme suit :
| Champ | Contenu | Description |
| topic | Aucun | La valeur par défaut (une chaîne vide) est utilisée. |
| time | 1330589527 | Heure exacte de génération du journal en secondes, convertie à partir de l'horodatage du journal brut. |
| source | 10.10.10.1 | L'adresse IP du serveur est utilisée comme source du journal. |
| content | Paires clé-valeur | Le contenu spécifique du journal. |
Extrayez le contenu du journal brut en paires clé-valeur comme suit :
| key | value |
| ip | 10.1.1.1 |
| method | GET |
| status | 200 |
| length | 5 |
| ref_url | - |
| browser | Mozilla/5,0 (X11; Linux i686 on x86_64; rv:10.0.2) Gecko/20100101 Firefox/10.0.2 |
Journaux
Une collection de journaux.
LogGroup
Un groupe de journaux.
LogGroupList
Une collection de LogGroups servant à renvoyer les résultats.
Méthodes d'encodage
SLS prend en charge les méthodes d'encodage suivantes. Spécifiez la méthode via l'en-tête Content-Type dans l'API RESTful.
| Signification | Description | Content-Type |
| Protobuf | Modèle de données encodé en Protobuf. | application/x-protobuf |
Détails du format Protobuf : Méthodes d'encodage des données.
Protobuf n'impose pas l'unicité des paires clé-valeur, mais des clés dupliquées peuvent entraîner un comportement indéfini.
Encodez les champs dans l'ordre de leurs numéros de champ Protobuf. Les champs hors ordre risquent de ne pas être analysés correctement.