Créer une sonde personnalisée pour Application Gateway à l’aide du portail

Dans cet article, une sonde d’intégrité personnalisée est ajoutée à une passerelle d’application existante via le portail Azure. Azure Application Gateway utilise des sondes d’intégrité pour surveiller l’intégrité des ressources dans le pool principal.

Avant de commencer

Si vous ne disposez pas déjà d’une passerelle d’application, consultez Créer une passerelle d’application pour créer une passerelle d’application fonctionnelle.

Créer une sonde pour la référence SKU Application Gateway v2

Les sondes sont configurées via un processus en deux étapes sur le portail. La première étape consiste à entrer les valeurs requises pour la configuration de la sonde. Dans la deuxième étape, vous testez l’intégrité du serveur back-end à l’aide de la configuration de cette sonde et enregistrez la sonde.

Entrer les propriétés de la sonde

1. Connectez-vous au portail Azure. Si vous ne possédez pas encore de compte, vous pouvez vous inscrire pour bénéficier d’un essai gratuit d’un mois.

2. Dans le volet Favoris du portail Azure, sélectionnez Toutes les ressources. Sélectionnez la passerelle d’application dans le panneau Toutes les ressources. Si l’abonnement que vous avez déjà sélectionné comporte déjà plusieurs ressources, vous pouvez entrer partners.contoso.net dans la zone Filtrer par nom… pour accéder facilement à la passerelle d’application.

3. Sélectionnez Sondes d’intégrité, puis sélectionnez Ajouter pour ajouter une nouvelle sonde d’intégrité.

   

4. Sur la page Ajouter une sonde d’intégrité, fournissez les informations nécessaires à la sonde, puis sélectionnez OK une fois que vous avez terminé.

   Paramètre	Valeur	Détails
   Nom	customProbe	Cette valeur est le nom convivial donné à la sonde accessible par le biais du portail.
   Protocole	HTTP ou HTTPS	Protocole utilisé par la sonde d’intégrité.
   Hôte	c’est-à-dire contoso.com	Cette valeur est le nom de l’hôte virtuel (différent du nom d’hôte de machine virtuelle) en cours d’exécution sur le serveur d’application. La sonde est envoyée à <protocol>://<host name>:<port>/<urlPath>. Il peut également s’agir de l’adresse IP privée du serveur, de l’adresse IP publique ou de l’entrée DNS de l’adresse IP publique. La sonde tente d’accéder au serveur lorsqu’elle est utilisée avec une entrée de chemin d’accès basée sur un fichier et vérifie qu’un fichier spécifique existe sur le serveur comme contrôle d’intégrité.
   Choisir le nom d’hôte à partir des paramètres back-end	Oui ou Non	Définit l’en-tête de l’hôte dans la sonde sur le nom d’hôte à partir des paramètres principaux auxquels cette sonde est associée. Spécialement requis pour les backends multilocataires tels qu'Azure App Service. En savoir plus
   Choisir un port à partir des paramètres back-end	Oui ou Non	Définit le port de la sonde d’intégrité sur le port des paramètres principaux auxquels cette sonde est associée. Si vous choisissez Non, vous pouvez entrer un port de destination personnalisé à utiliser
   Port	1-65535	Port personnalisé à utiliser pour les sondes d’intégrité
   Chemin d’accès	/ ou n’importe quel chemin valide	Reste de l’URL complète de la sonde personnalisée. Un chemin valide commence par « / ». Pour le chemin d’accès par défaut de http://contoso.com, utilisez simplement « / ». Vous pouvez également entrer un chemin de serveur vers un fichier pour un contrôle d’intégrité statique au lieu d’une approche basée sur le web. Des chemins de fichier doivent être utilisés lors de l’utilisation d’une adresse IP publique/privée ou d’une entrée DNS d’adresse IP publique en tant qu’entrée de nom d’hôte.
   Intervalle (secondes)	30	Fréquence d’exécution de la sonde pour le contrôle d’intégrité. Il n’est pas recommandé de définir la valeur sur moins de 30 secondes.
   Délai d’expiration (secondes)	30	Durée d’attente de la sonde avant l’expiration du délai d’attente. Si une réponse valide n’est pas reçue dans ce délai d’expiration, la sonde est marquée comme ayant échoué. L’intervalle de délai d’attente doit être suffisamment élevé pour qu’un appel HTTP puisse être envoyé afin de garantir que la page d’intégrité backend est disponible. La valeur de délai d’expiration ne doit pas être supérieure à la valeur « Interval » utilisée dans ce paramètre de sonde ou à la valeur « Délai d’expiration de la requête » dans le paramètre back-end, qui sera associée à cette sonde.
   Seuil de défaillance sur le plan de l’intégrité	3	Nombre d’échecs consécutifs nécessaires pour marquer l’instance comme étant défaillante. Le seuil peut être défini sur 0 ou plus.
   Utiliser des conditions de correspondance de sonde	Oui ou Non	Par défaut, une réponse HTTP(S) avec un code d’état compris entre 200 et 399 est considérée comme intègre. Vous pouvez modifier la plage acceptable du code de réponse back-end ou du corps de la réponse back-end. En savoir plus
   Paramètres principaux	sélection dans une liste déroulante	La sonde est associée aux paramètres principaux sélectionnés ici et surveille donc l’intégrité de ce pool principal, qui est associé au paramètre back-end sélectionné. Il utilise le même port pour la requête de sonde que celui utilisé dans le paramètre back-end sélectionné. Vous pouvez uniquement choisir ces paramètres principaux, qui ne sont associés à aucune autre sonde personnalisée. Les seuls paramètres backend disponibles pour l’association sont ceux qui ont le même protocole que le protocole choisi dans cette configuration de sonde, et qui partagent le même état pour le paramètre Choisir le nom d’hôte à partir du backend.

   Important

   La sonde surveille l’intégrité du back-end uniquement lorsqu’elle est associée à un ou plusieurs paramètres back-end. Il surveille les ressources principales de ces pools principaux associés aux paramètres principaux auxquels cette sonde est associée. La requête de probe est envoyée en tant que <protocol>://<hostName>:<port>/<urlPath>.

Tester l’intégrité du back-end avec la sonde

Après avoir entré les propriétés de la sonde, vous pouvez tester l’intégrité des ressources back-end pour vérifier que la configuration de la sonde est correcte et que les ressources back-end fonctionnent comme prévu.

1. Sélectionnez Tester et notez le résultat de la sonde. Application Gateway teste l’intégrité de toutes les ressources back-end dans les pools principaux associés aux paramètres principaux utilisés pour cette sonde.

   

2. S’il existe des ressources back-end non intègres, vérifiez la colonne Détails pour comprendre la raison de l’état non intègre de la ressource. Si la ressource a été marquée comme non intègre en raison d’une configuration de sonde incorrecte, sélectionnez le lien Revenir à la sonde et modifiez la configuration de la sonde. Sinon, si la ressource a été marquée comme non intègre en raison d’un problème avec le back-end, résolvez les problèmes avec la ressource back-end, puis testez de nouveau le back-end en sélectionnant le lien Revenir à la sonde et Tester.

   Remarque

   Vous pouvez choisir d’enregistrer la sonde même avec des ressources back-end non intègres, mais cela n’est pas recommandé. Cela est dû au fait qu’Application Gateway ne transfère pas les requêtes aux serveurs back-end du pool de back-ends qui sont considérés comme non sains par la sonde. Si aucune ressource saine n’est présente dans un pool principal, vous ne pourrez pas accéder à votre application et obtiendrez une erreur HTTP 502.

   

3. Sélectionnez Ajouter pour enregistrer la sonde.

Créer une sonde pour la référence SKU Application Gateway v1

Les sondes sont configurées via un processus en deux étapes sur le portail. La première étape consiste à créer la sonde. Dans la deuxième étape, vous allez ajouter la sonde aux paramètres http backend de la passerelle d’application.

Créer la sonde

1. Connectez-vous au portail Azure. Si vous ne possédez pas encore de compte, vous pouvez vous inscrire pour bénéficier d’un essai gratuit d’un mois.

2. Dans le volet Favoris du portail Azure, sélectionnez Toutes les ressources. Sélectionnez la passerelle d’application dans la page Toutes les ressources. Si l’abonnement que vous avez déjà sélectionné comporte déjà plusieurs ressources, vous pouvez entrer partners.contoso.net dans la zone Filtrer par nom… pour accéder facilement à la passerelle d’application.

3. Sélectionnez Sondes puis sélectionnez Ajouter pour ajouter une sonde.

   

4. Dans le volet Ajouter une sonde d’intégrité, fournissez les informations nécessaires à la sonde, puis sélectionnez OK une fois que vous avez terminé.

   Paramètre	Valeur	Détails
   Nom	customProbe	Cette valeur est le nom convivial donné à la sonde accessible par le biais du portail.
   Protocole	HTTP ou HTTPS	Protocole utilisé par la sonde d’intégrité.
   Hôte	c’est-à-dire contoso.com	Cette valeur est le nom de l’hôte virtuel (différent du nom d’hôte de machine virtuelle) en cours d’exécution sur le serveur d’application. La sonde est envoyée à (protocole)://(nom d’hôte):(port de httpsetting)/urlPath. Cela s’applique lorsque plusieurs sites sont configurés sur Application Gateway. Si Application Gateway est configurée pour un seul site, entrez « 127.0.0.1 ». Vous pouvez également entrer un chemin de serveur vers un fichier pour un contrôle d’intégrité statique au lieu d’une approche basée sur le web. Des chemins de fichier doivent être utilisés lors de l’utilisation d’une adresse IP publique/privée ou d’une entrée DNS d’adresse IP publique en tant qu’entrée de nom d’hôte.
   Choisir un nom d'hôte à partir de paramètres HTTP back-end	Oui ou Non	Définit l’en-tête hôte dans la sonde sur le nom d’hôte de la ressource back-end dans le pool de back-ends associé au paramètre HTTP auquel cette sonde est liée. Spécialement requis pour les backends multilocataires tels qu'Azure App Service. En savoir plus
   Chemin d’accès	/ ou n’importe quel chemin valide	Reste de l’URL complète de la sonde personnalisée. Un chemin valide commence par « / ». Pour le chemin par défaut http://contoso.com, utilisez simplement « / ». Vous pouvez également entrer un chemin de serveur vers un fichier pour un contrôle d’intégrité statique au lieu d’une approche basée sur le web. Des chemins de fichier doivent être utilisés lors de l’utilisation d’une adresse IP publique/privée ou d’une entrée DNS d’adresse IP publique en tant qu’entrée de nom d’hôte.
   Intervalle (secondes)	30	Fréquence d’exécution de la sonde pour le contrôle d’intégrité. Il n’est pas recommandé de définir la valeur sur moins de 30 secondes.
   Délai d’expiration (secondes)	30	Durée d’attente de la sonde avant l’expiration du délai d’attente. Si une réponse valide n’est pas reçue dans ce délai d’expiration, la sonde est marquée comme ayant échoué. L’intervalle de délai d’attente doit être suffisamment élevé pour qu’un appel HTTP puisse être envoyé afin de garantir que la page d’intégrité backend est disponible. La valeur de délai d’expiration ne doit pas être supérieure à la valeur « Interval » utilisée dans ce paramètre de sonde ou à la valeur « Délai d’expiration de la requête » dans le paramètre HTTP, qui sera associée à cette sonde.
   Seuil de défaillance sur le plan de l’intégrité	3	Nombre d’échecs consécutifs nécessaires pour marquer l’instance comme étant défaillante. Le seuil peut être défini sur 1 ou plus.
   Utiliser des conditions de correspondance de sonde	Oui ou Non	Par défaut, une réponse HTTP(S) avec un code d’état compris entre 200 et 399 est considérée comme intègre. Vous pouvez modifier la plage acceptable du code de réponse back-end ou du corps de la réponse back-end. En savoir plus

   Important

   Le nom d’hôte n’est pas identique au nom du serveur. Cette valeur est le nom de l’hôte virtuel en cours d’exécution sur le serveur d’application. La probe est envoyée à <protocol>://<hostName>:<port des paramètres HTTP>/<urlPath>

Ajouter une sonde à la passerelle

Maintenant que la sonde a été créée, il est temps de l’ajouter à la passerelle. Les paramètres de la sonde sont définis sur les paramètres http principaux de la passerelle d’application.

1. Sélectionnez les paramètres principaux sur la passerelle Application Gateway pour afficher le panneau de configuration, cliquez sur les paramètres http principaux actuels répertoriés dans la fenêtre.

   

2. Dans la page des paramètres appGatewayBackEndHttpSettings, cochez la case Utiliser la sonde personnalisée, puis choisissez la sonde créée à la section Créer la sonde dans la liste déroulante Sonde personnalisée. Quand vous avez terminé, cliquez sur Enregistrer pour appliquer les paramètres.

Étapes suivantes

Affichez l’intégrité des serveurs principaux tel que déterminé par la sonde à l’aide de l’affichage d’intégrité du back-end.