Surveiller une API

Cette page explique comment surveiller l'état de vos API API Gateway à l'aide des journaux et des métriques qu'API Gateway gère automatiquement pour vous.

Lorsque vous créez une API, API Gateway crée automatiquement un service géré correspondant. Vous pouvez trouver le nom du service géré créé dans le résultat de la commande suivante:

gcloud api-gateway apis describe API_ID

Le nom de votre service correspond à la valeur du champ managedService.

Lorsque des utilisateurs adressent des requêtes à votre API, API Gateway enregistre des informations sur les requêtes et les réponses. API Gateway suit également trois des quatre signaux clés de surveillance : la latence, le trafic et les erreurs. Ces métriques d'utilisation et de performances vous aident à surveiller l'API.

Avant de commencer

Pour générer des journaux et des métriques à afficher, déployez une API et envoyez-lui des requêtes. Si vous n'avez pas encore créé et déployé d'API sur une passerelle, consultez le guide de démarrage rapide de l'API Gateway.

Présentation de l'API

Lorsque vous corrigez un problème lié au service ou que vous souhaitez simplement vérifier que tout s'exécute comme prévu, accédez à la présentation de l'API :

  1. Dans la console Google Cloud, accédez à la page API Gateway > API de votre projet:

    Accéder à la page API

  2. Si vous possédez plusieurs API, cliquez sur celle que vous souhaitez surveiller.

  3. Assurez-vous que vous êtes sur l'onglet Aperçu.

Graphes

La page "Vue d'ensemble" fournit plusieurs graphiques pour certaines métriques, ce qui vous permet d'identifier immédiatement les pics, les baisses ou les activités inattendues. Grâce aux filtres situés en haut de la page, vous pouvez:

  • Utiliser la liste déroulante Sélectionner des graphiques pour afficher les graphiques des métriques qui vous intéressent et supprimer ceux que vous ne souhaitez pas afficher.
  • Ajustez la portée des graphiques en sélectionnant l'une des périodes. Ce paramètre permet d'ajuster la période des valeurs affichées, ce qui modifie également la précision du point.

Table des méthodes

Pour une exploration plus approfondie, consultez le tableau situé en dessous des graphiques contenant les métriques par méthode de votre API. Vous pouvez :

  • En haut à gauche du tableau, cliquez sur l'icône Filtrer le tableau pour sélectionner les options de requête de filtre affiné dans le tableau déroulant. Ajoutez un OR entre chaque requête de filtre pour rechercher plusieurs termes.
  • En haut à droite du tableau, cliquez sur l'icône Options d'affichage des colonnes pour afficher une liste déroulante. Cochez les métriques qui vous intéressent et décochez celles que vous ne souhaitez pas afficher.
  • Dans le coin supérieur droit de l'aperçu, sélectionnez une période pour les valeurs de métriques du tableau à l'aide de l'outil de sélection de périodes. Cette sélection s'applique aux graphiques ainsi qu'au tableau.

Journaux

Lorsque vous détectez un problème dans les métriques, vous pouvez utiliser la page Explorateur de journaux de la console Google Cloud pour afficher les journaux des requêtes et des réponses de votre API.

  • Pour afficher les journaux par méthode de l'API, cliquez sur Afficher les journaux dans le tableau.

  • Pour afficher les journaux de toutes les méthodes de l'API, cliquez sur Afficher tous les journaux dans le coin inférieur droit.

  • Pour localiser les journaux d'API Gateway directement à partir de la page de l'explorateur de journaux, procédez comme suit :

    1. Dans la console Google Cloud, accédez à la page Explorateur de journaux.

      Accéder à la page "Explorateur de journaux"

    2. Sélectionnez API produite, SERVICE_NAME, où SERVICE_NAME est le nom du service géré.

Pour en savoir plus sur la structure des journaux dans l'explorateur de journaux, consultez la documentation de référence des journaux d'API Gateway.

Découvrez tout ce que vous pouvez faire d'autre avec les journaux :

  • Commencez à utiliser l'explorateur de journaux.

    Utilisez le volet de requête pour spécifier l'ensemble des entrées de journal que vous souhaitez afficher, par exemple pour obtenir toutes les requêtes dont la latence est supérieure à 300 millisecondes.

  • Configurez et gérez les récepteurs. Vous pouvez ainsi transférer les journaux vers BigQuery pour les analyser plus en détail, enregistrer les journaux bruts dans Cloud Storage, ou les envoyer aux sujets de messagerie Pub/Sub.

Filtrer un projet pour un consommateur spécifique

Pour filtrer les métriques pour un projet client spécifique, procédez comme suit :

  1. Obtenez le numéro du projet du client utilisant l'API. Si vous n'êtes pas autorisé à accéder au projet du client de l'API, demandez à une personne disposant des autorisations nécessaires d'obtenir le numéro de projet pour vous.

  2. Dans la console Google Cloud, accédez à la page API Gateway > API de votre projet.

    Accéder à la page API

  3. Dans l'angle supérieur gauche de la page Présentation, saisissez le numéro du projet dans le champ Filtrer par numéro de projet.

  4. Cliquez sur Filtrer.

Les métriques de la page sont mises à jour pour correspondre au trafic provenant uniquement du projet indiqué.

Étapes suivantes