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. Le nom du service géré créé se trouve 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 envoient 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, essayez le guide de démarrage rapide d'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 à API Gateway > la page API de votre projet:

    Accéder à la page des 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 propose plusieurs graphiques pour certaines métriques. Vous pouvez ainsi repérer immédiatement les pics, les baisses ou les activités inattendues. Les filtres en haut de la page vous permettent d'effectuer les opérations suivantes:

  • 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 les différentes périodes. Cette option permet d'ajuster la période des valeurs affichées, ce qui modifie également la précision des points.

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 la requête de filtre affinée. 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 repérez un problème dans les métriques, vous pouvez utiliser la page Explorateur de journaux de la section 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é.

Consultez le Documentation de référence des journaux d'API Gateway pour en savoir plus sur la structure des journaux dans l'explorateur de journaux.

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 à afficher. comme obtenir toutes les requêtes dont la latence dépasse 300 millisecondes.

  • Configurer et gérer 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 selon un projet client 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 à API Gateway > Page API pour votre projet.

    Accéder à la page des 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é.

Étape suivante