Intégration de Looker Studio

Preview : intégration de Looker 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.

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 Looker Studio, qui connecte les données Apigee à Looker Studio de Google. Looker Studio est un outil puissant et flexible qui vous permet d'afficher des 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 Looker 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 Looker Studio.

Rôle requis

Pour utiliser Looker 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 Looker Studio. La page principale de Looker Studio est présentée ci-dessous :

   

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 autoriser Looker Studio à 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, Looker Studio affiche la page ci-dessous, dans laquelle vous pouvez créer un rapport :

   

La section suivante explique comment afficher un rapport de données Analytics dans Looker 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 Looker 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 Looker Studio

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

1. Sur la page Looker 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 boîte de dialogue Ajouter des données au rapport.
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 dans la console Cloud

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

1. Ouvrez l'interface utilisateur d'Apigee dans la console Cloud dans un navigateur.
2. Sélectionnez Analytics > Rapports personnalisés.
3. Cliquez sur Créer d'autres rapports à l'aide de Looker Studio en haut à droite. 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 boîte de dialogue Ajouter des données au rapport.
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.

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 Looker Studio.

Créer un rapport de données Analytics

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

1. Sur la page Looker 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 Looker Studio explique comment créer de nombreux types de rapports. Pour en savoir plus, consultez les ressources suivantes :

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