Gérer les collecteurs de données

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Une ressource de type collecteur de données vous permet de collecter une grande variété de données personnalisées à partir du trafic des API. Après avoir créé un collecteur de données, vous spécifiez les données que vous souhaitez collecter à l'aide de la règle DataCapture. Le collecteur de données s'apparente à un chariot de courses. Dans ce contexte, la règle DataCapture correspond alors à la liste de courses, qui recense les données que vous souhaitez capturer.

Remarque : Si vous utilisez un collecteur de données dans plusieurs stratégies, les données capturées seront remplacées par la dernière stratégie exécutée.

Pour obtenir la liste des quantités associées au trafic d'API que vous pouvez capturer à l'aide de la ressource de collecteur de données, consultez la page Métriques.

Créer un collecteur de données

Vous pouvez créer une ressource de collecteur de données dans l'interface utilisateur d'Apigee ou avec l'API Apigee :

Remarque : Il existe une nouvelle version de l'interface utilisateur Apigee, intégrée à la console Google Cloud. La nouvelle interface utilisateur est appelée Apigee dans la console Cloud. Les instructions des deux premiers onglets ci-dessous expliquent comment utiliser Apigee dans la console Cloud ou la version classique d'Apigee.

Apigee dans la console Cloud

Pour créer une ressource de collecteur de données à l'aide d'Apigee dans la console Cloud, procédez comme suit :

1. Ouvrez l'interface utilisateur d'Apigee dans la console Cloud dans un navigateur.
2. Sélectionnez Gestion > Collecteurs de données dans le volet de navigation.
3. Dans la vue Collecteurs de données, cliquez sur Créer.
4. Cliquez sur + Créer pour afficher la boîte de dialogue Ajouter un collecteur de données.
5. Renseignez les informations suivantes dans la boîte de dialogue :
   • Name (Nom) : nom du collecteur de données.
     Remarque : Le nom d'un collecteur de données doit commencer par dc_.
     Avertissement : Ne créez pas deux collecteurs de données dont les noms ne diffèrent que par la casse, tels que dc_my_data et dc_My_Data. En effet, l'exportation des données génèrera une erreur "noms de colonnes en double".
   • Type : type de données à collecter (Integer, String, etc.).
   • Description : description informelle des données à collecter, indiquant éventuellement la raison de leur collecte. Ce champ est destiné aux autres développeurs d'API pouvant prendre part à l'analyse des données.
6. Cliquez sur AJOUTER.

Apigee classique

Procédez comme suit pour créer une ressource de collecteur de données à l'aide d'Apigee classique :

1. Ouvrez l'interface utilisateur Apigee dans un navigateur.

2. Sélectionnez Admin > Data Collectors (Admin > Collecteurs de données) dans le volet de navigation.

   

   Le volet "Collecteurs de données" s'affiche.

   

   Le volet ci-dessus est vide, car aucun collecteur de données n'a encore été créé. À ce stade, vous pouvez créer un collecteur de données. Après avoir créé quelques collecteurs de données, vous pouvez cliquer sur leur nom dans le volet pour les modifier.

3. Cliquez sur + CREATE (CRÉER) pour afficher la boîte de dialogue Add data collector (Ajouter un collecteur de données).

   
4. Ajoutez les informations suivantes dans la boîte de dialogue :
   • Name (Nom) : nom du collecteur de données.
     Remarque : Le nom d'un collecteur de données doit commencer par dc_.
     Remarque : Ne créez pas deux collecteurs de données dont les noms ne diffèrent que par la casse, tels que dc_my_data et dc_My_Data. En effet, l'exportation des données génèrera une erreur "noms de colonnes en double".
   • Type : type de données à collecter (Integer, String, etc.).
   • Description : description informelle des données à collecter, indiquant éventuellement la raison de leur collecte. Ce champ est destiné aux autres développeurs d'API pouvant prendre part à l'analyse des données.
5. Cliquez sur ADD (AJOUTER).

Le nouveau collecteur de données s'affiche désormais dans le volet "Data collector" ("Collecteur de données").

Pour modifier ou supprimer un collecteur de données, cliquez sur les trois points à la fin de la ligne sous Actions, puis sélectionnez Modifier ou Supprimer.

API Apigee

Vous pouvez créer une ressource de collecteur de données à l'aide de l'API Apigee. Exemple :

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -X POST -H "content-type:application/json" \
  -d '
{
  "name": "dc_data_collector",
  "description": "Collects data for analysis.",
  "type": "STRING",
}' \
  "https://apigee.googleapis.com/v1/organizations/ORG/datacollectors"

où ORG est le nom de l'organisation. Cela crée une ressource nommée dc_data_collector, que vous pouvez utiliser dans la stratégie DataCapture.

Remarques :

• Le nom de la ressource de collecteur de données doit commencer par le préfixe dc_.
• Si vous utilisez une ressource de collecteur de données dans plusieurs stratégies, les données capturées seront remplacées par la dernière stratégie exécutée.

Avertissement : Ne créez pas deux collecteurs de données dont les noms ne diffèrent que par la casse, tels que dc_my_data et dc_My_Data. En effet, l'exportation des données génèrera une erreur "noms de colonnes en double".