Nouveaux champs ajoutés aux événements ActionTrail - ActionTrail

À compter du 16 décembre 2020 à 00:00:00, ActionTrail ajoute trois nouveaux champs aux événements : eventRW, resourceName et resourceType. Cette évolution vous permet d'analyser plus efficacement les événements futurs sans impacter l'analyse des événements existants.

Détails de la modification

ActionTrail intègre les champs suivants aux événements :

Nom	Type	Description	Exemple
eventRW	String	Indique si l'événement correspond à une opération de lecture ou d'écriture. Valeurs possibles : `Write` : opération d'écriture. `Read` : opération de lecture.	Read
resourceName	String	Nom ou ID de la ressource associée à l'événement. Ce champ fournit l'identifiant unique de la ressource, extrait du champ existant `referenceResources`. Utilisez `resourceName` comme index dans Log Service pour interroger les événements par nom de ressource.	Pour un événement impliquant une seule ressource d'un type unique : `i-bp1example1`. Pour un événement impliquant plusieurs ressources du même type : `i-bp1example1,i-bp1example2`. Pour un événement impliquant plusieurs ressources de types différents : `i-bp1example1,i-bp1example2;v-bp1example1`. Remarque Utilisez des virgules (,) pour séparer les identifiants de ressources de même type et des points-virgules (;) pour séparer les identifiants de types différents.
resourceType	String	Type de la ressource associée à l'événement. Ce champ est extrait du champ existant `referenceResources`. Utilisez `resourceType` comme index dans Log Service pour interroger les événements par type de ressource.	Pour un événement impliquant une seule ressource d'un type unique : `ACS::ECS::Instance`. Pour un événement impliquant plusieurs ressources du même type : `ACS::ECS::Instance`. Pour un événement impliquant plusieurs ressources de types différents : `ACS::ECS::Instance;ACS::VPC::VPC`. Remarque Utilisez un point-virgule (;) pour séparer plusieurs types de ressources.

Les exemples suivants illustrent la structure des événements avant et après la modification :

Avant

{
  "referenceResources": {
    "ACS::ECS::Instance": [
      "i-bp1fadfuy****",
      "i-bp1fadfad****"
    ]
  }
}

Après

{
  "eventRW": "Read",
  "referenceResources": {
    "ACS::ECS::Instance": [
      "i-bp1fadfuy****",
      "i-bp1fadfad****"
    ]
  },
    "resourceName": "i-bp1fadfuy****,i-bp1fadfad****",
    "resourceType": "ACS::ECS::Instance"
}

Impact

Cette modification n'affecte pas l'analyse des événements délivrés par les traces existantes.

Une fois la modification appliquée :

Pour les traces existantes et nouvelles, les événements livrés vers un Logstore Log Service ou un compartiment OSS incluent les nouveaux champs.
Pour les nouvelles traces, Log Service crée automatiquement un index dans le Logstore pour les nouveaux champs.
Pour les traces existantes, Log Service ne crée pas automatiquement d'index pour les nouveaux champs. Pour interroger et analyser ces champs, ajoutez l'index manuellement.
- Ajouter des index pour les nouveaux champs dans la console Log Service
  1. Connectez-vous à la console Log Service.
  2. Dans la section Projects, cliquez sur le nom du projet correspondant à votre trace.
  3. Cliquez sur le nom du Logstore. Dans le coin supérieur droit de la page, choisissez Index Attributes > Attributes.
  4. Cliquez sur le signe plus (+) sous la liste des champs pour ajouter les champs eventRW, resourceName et resourceType.
  5. Cliquez sur Confirm.
- Ajouter des index pour les nouveaux champs dans Cloud Shell
  
  Exécutez la commande suivante dans Cloud Shell :
```
actiontrail-update-index [project] [logstore] [regionId]
```
  Remplacez les paramètres project, logstore et regionId par le projet, le Logstore et l'ID de région de votre trace. Par exemple :
```
actiontrail-update-index actiontrail-ev****  actiontrail-test**** cn-hangzhou
```