Intégration de Data Studio

Preview : intégration de Data Studio

Cette fonctionnalité est couverte par les Conditions des offres avant disponibilité générale des conditions d'utilisation de Google Cloud. Les fonctionnalités avant disponibilité générale sont susceptibles de présenter une compatibilité limitée, et les modifications apportées à ces fonctionnalités peuvent ne pas être compatibles avec d'autres versions avant disponibilité générale. Pour en savoir plus, consultez les descriptions des étapes de lancement.

L'assistance pour le lancement de la version preview de la détection des abus avec Advanced API Security est disponible via le forum de la communauté Apigee - Google Cloud.

Remarque : L'intégration de Data Studio n'est actuellement pas compatible avec les organisations pour lesquelles la résidence des données est activée.

En plus d'afficher les données Apigee Analytics et de monétisation dans l'UI d'Apigee, vous pouvez également les afficher à l'aide de l'intégration de Data Studio, qui connecte les données Apigee à Data Studio de Google. Data Studio est un outil puissant et flexible que vous pouvez utiliser pour afficher les données Apigee dans des tableaux de bord et des rapports entièrement personnalisables.

Remarque : Si votre organisation utilise VPC Service Controls, vous devez ajouter des règles d'entrée et de sortie au compte de service Data Studio afin d'autoriser les services pour les API suivantes :

• bigquery.googleapis.com
• bigquerydatatransfer.googleapis.com

Les sections suivantes expliquent comment créer un rapport de données Analytics dans Data Studio.

Rôle requis

Pour utiliser Data Studio, vous devez d'abord le connecter à une source de données (dans ce cas, Apigee). Pour établir la connexion, vous devez disposer du rôle roles/apigee.analyticsEditor.

Pour en savoir plus, consultez la section Rôles Apigee.

Se connecter à la source de données Apigee

Pour vous connecter à la source de données Apigee, procédez comme suit :

1. Ouvrez Data Studio. La page principale de Data Studio s'affiche comme suit :

   

2. Cliquez sur le bouton + Créer en haut de la page.
3. Sélectionnez Source de données pour afficher une page Source de données sans titre.
4. Faites défiler la page vers le bas, puis cliquez sur le bouton Apigee :

   

5. Cliquez sur le bouton Autoriser pour permettre à Data Studio de se connecter aux données Apigee.
6. Dans le champ Nom de l'organisation Apigee, saisissez l'ID de l'organisation. Remarque : L'ID de l'organisation est identique à l'ID du projet Google Cloud de l'organisation.

7. Cliquez sur Connecter en haut à droite de la fenêtre.

   Remarque : Vous devez disposer du rôle roles/apigee.analyticsEditor pour effectuer cette étape.

   Une fois la connexion à Apigee établie, Data Studio affiche la page ci-dessous, sur laquelle vous pouvez créer un rapport :

   

La section suivante explique comment afficher un rapport de données Analytics dans Data Studio à l'aide du modèle de la plate-forme d'API Apigee.

Utiliser le modèle de la plate-forme d'API Apigee

Les sections suivantes expliquent comment afficher un rapport prédéfini à l'aide du modèle de la plate-forme d'API Apigee.

• Ouvrir le modèle de la plate-forme d'API Apigee à partir de Data Studio
• Ouvrir le modèle de la plate-forme d'API Apigee à partir de l'UI d'Apigee

Ouvrir le modèle de la plate-forme d'API Apigee à partir de Data Studio

Pour ouvrir le modèle de la plate-forme d'API Apigee à partir de Data Studio :

1. Sur la page Data Studio, sélectionnez Modèles dans le volet de navigation.
2. Dans le menu Catégorie de la galerie de modèles, sélectionnez Apigee.
3. Sous Apigee, sélectionnez API Apigee Analytics. Le modèle de la plate-forme d'API Apigee s'affiche :

   

4. Cliquez sur Utiliser mes propres données en haut à droite de la page pour ouvrir la Ajouter des données au rapport boîte de dialogue.
5. Dans le champ Nom de l'organisation Apigee, saisissez l' ID de l'organisation. Remarque : L'ID de l'organisation est identique à l'ID du projet Google Cloud de l'organisation.
6. Cliquez sur Ajouter en bas à droite.

Ouvrir le modèle de la plate-forme d'API Apigee à partir de l'UI d'Apigee

Pour ouvrir le modèle de la plate-forme d'API Apigee à partir de l'UI d'Apigee :

1. Dans la Google Cloud console, accédez à la page Apigee > Analytics > Rapports personnalisés.

   Accéder aux rapports personnalisés

2. En haut à droite, cliquez sur Créer d'autres rapports à l'aide de Data Studio. Le modèle de la plate-forme d'API Apigee s'affiche :

   

3. Cliquez sur Utiliser mes propres données en haut à droite de la page pour ouvrir la Ajouter des données au rapport boîte de dialogue.
4. Dans le champ Nom de l'organisation Apigee, saisissez l' ID de l'organisation. Remarque : L'ID de l'organisation est identique à l'ID du projet Google Cloud de l'organisation.
5. Cliquez sur Ajouter en bas à droite.

Remarque : Dans le graphique Adoption des développeurs, le nombre situé sous Application correspond au nombre d'applications actives dans la plage de dates sélectionnée, affichée en haut à droite du modèle. Ce nombre diffère du nombre total d'applications (par exemple, dans le graphique Augmentation du trafic ci-dessus), qui inclut les applications inactives.

Vous pouvez afficher différents graphiques dans le rapport, y compris les suivants :

• Développement du produit d'API
• Augmentation du trafic
• Performances de latence
• Améliorations apportées au code d'erreur

Pour en savoir plus, consultez le guide de démarrage rapide de Data Studio .

Créer un rapport de données Analytics

Vous pouvez également créer un rapport de données Analytics directement dans Data Studio, sans utiliser le modèle de la plate-forme d'API Apigee :

1. Sur la page Data Studio, cliquez sur + Créer.
2. Sélectionnez Rapport.
3. Sous Ajouter des données au rapport, sélectionnez Mes sources de données.
4. Sélectionnez Apigee Analytics.
5. Cliquez sur Ajouter en bas à droite.
6. Dans la boîte de dialogue de confirmation, cliquez sur Ajouter au rapport. La page du rapport affiche les données Apigee Analytics disponibles à ajouter au rapport, comme indiqué ci-dessous :

   

Vous pouvez maintenant créer un rapport Analytics. Voici un exemple permettant de créer un graphique sur le trafic de l'API au fil du temps :

1. Sélectionnez le menu Insertion en haut de la page du rapport.
2. Sélectionnez Graphique de série temporelle.
3. Dans le volet Métrique situé à droite de la page du rapport, sélectionnez + Ajouter une métrique.
4. Faites défiler la page jusqu'à Champs disponibles, puis sélectionnez Trafic.

Un graphique de série temporelle sur le trafic récent s'affiche. Un exemple est présenté ci-dessous. (Vos données seront différentes.)

Si vous souhaitez afficher une autre période pour les données, revenez au menu Insertion et sélectionnez Sélecteur de plage de dates. Vous pouvez ensuite utiliser le sélecteur pour sélectionner une plage de dates pour les données à afficher.

La documentation de Data Studio explique comment créer de nombreux types de rapports. Pour en savoir plus, consultez les ressources suivantes :

• Guide de démarrage rapide de Data Studio
• Découvrir de nouvelles façons de visualiser vos données