Configurer les journaux et les métriques cloud pour la passerelle auto-hébergée de la Gestion des API Azure

  • Article

S’APPLIQUE À : Développeur | Premium

Cet article fournit des informations détaillées sur la configuration des métriques et des journaux cloud pour la passerelle auto-hébergée.

La passerelle auto-hébergée doit être associée à un service de gestion des API et nécessite une connectivité TCP/IP sortante vers Azure via le port 443. La passerelle utilise la connexion sortante pour envoyer des données de télémétrie à Azure, si elle est configurée à cet effet.

Métriques

Par défaut, la passerelle auto-hébergée émet un certain nombre de métriques via Azure Monitor, comme le fait la passerelle gérée dans le cloud.

Cette fonctionnalité peut être activée ou désactivée à l’aide de la clé telemetry.metrics.cloud située dans le ConfigMap du déploiement de la passerelle. Voici une description des configurations disponibles :

Champ Default Description
telemetry.metrics.cloud true Permet la journalisation via Azure Monitor. La valeur peut être true ou false.

Voici un exemple de configuration :

    apiVersion: v1
    kind: ConfigMap
    metadata:
        name: contoso-gateway-environment
    data:
        config.service.endpoint: "<contoso-gateway-management-endpoint>"
        telemetry.metrics.cloud: "true"

La passerelle auto-hébergée émet les métriques suivantes via Azure Monitor :

Métrique Description
Demandes Nombre de demandes API au cours de la période
Durée des requêtes de passerelle Nombre de millisecondes entre le moment où la passerelle a reçu la requête et celui où la réponse complète a été envoyée
Durée des requêtes back-end Nombre de millisecondes consacrées à l’ensemble des E/S du serveur principal (connexion, envoi et réception d’octets)

Journaux d’activité

La passerelle auto-hébergée n’envoie pas de journaux de diagnostic vers le cloud. Toutefois, il est possible de configurer et de conserver des journaux localement, à l’endroit où la passerelle auto-hébergée est déployée.

Si une passerelle est déployée dans Azure Kubernetes Service, vous pouvez activer Azure Monitor pour les conteneurs afin de collecter des journaux à partir de vos conteneurs et les afficher dans Log Analytics.

Étapes suivantes