Partager via

Schéma LoadBalancerProbe de définition d’Azure Cloud Services (support étendu)

Important

À compter du 31 mars 2025, les services cloud (support étendu) sont déconseillés et seront entièrement mis hors service le 31 mars 2027. Découvrez plus d’informations sur cette dépréciation et comment migrer.

La sonde d’équilibreur de charge est une sonde d’intégrité définie par le client qui vérifie les points de terminaison UDP et les points de terminaison dans les instances de rôle. LaLoadBalancerProbe n’est pas un élément autonome ; elle est associée au rôle Web ou au Worker dans un fichier de définition de service. Plusieurs rôles peuvent utiliser une LoadBalancerProbe.

L’extension par défaut du fichier de définition du service est csdef.

Fonction d’une sonde d’équilibreur de charge

Azure Load Balancer est chargé du routage du trafic entrant vers vos instances de rôle. L’équilibreur de charge détermine quelles instances peuvent recevoir du trafic en sondant régulièrement chaque instance afin de déterminer son état de santé. L’équilibreur de charge sonde chaque instance plusieurs fois par minute. Il existe deux options pour fournir l’intégrité de l’instance à l’équilibreur de charge : la sonde d’équilibreur de charge par défaut ou une sonde d’équilibreur de charge personnalisée, qui est implémentée en définissant LoadBalancerProbe dans le fichier csdef.

La sonde d’équilibreur de charge par défaut utilise l’agent invité de la machine virtuelle, qui écoute et répond avec une réponse HTTP 200 OK uniquement si l’état de l’instance est Prêt (c.-à-d., si l’état de l’instance n’est pas Occupé, Recyclage, Arrêté, etc.). Si l’agent invité ne répond pas avec HTTP 200 OK, Azure Load Balancer marque l’instance comme ne répondant pas et arrête d’envoyer du trafic vers celle-ci. Azure Load Balancer continue à effectuer des tests ping de l’instance, et si l’agent invité répond avec HTTP 200, Azure Load Balancer envoie de nouveau le trafic vers cette instance. Lorsque vous utilisez un rôle web, le code de votre site web s’exécute généralement dans w3wp.exe, qui n’est pas surveillé par l’agent Azure Fabric ou l’agent invité, ce qui signifie que les échecs dans w3wp.exe (par exemple, réponses HTTP 500) ne sont pas signalés à l’agent invité et l’équilibreur de charge ne sait pas comment sortir l’instance de la rotation.

La sonde d’équilibreur de charge personnalisée remplace la sonde de l’agent invité par défaut et vous permet de créer votre propre logique personnalisée pour déterminer l’intégrité de l’instance de rôle. L’équilibreur de charge sonde régulièrement votre point de terminaison (par défaut toutes les 15 secondes) et l’instance est considérée en rotation si elle répond avec TCP ACK ou HTTP 200 dans le délai imparti (31 secondes par défaut). Il peut être utile d’implémenter votre propre logique pour retirer temporairement des instances de la rotation de l'équilibreur de charge, par exemple en renvoyant un statut autre que 200 si l’instance dépasse les 90 % d’utilisation du processeur. Pour les rôles web qui utilisent w3wp.exe, cela signifie également que vous obtenez une analyse automatique de votre site web, dans la mesure où les défaillances dans votre code de site web renvoient un état autre que 200 à la sonde d’équilibreur de charge. Si vous ne définissez pas de LoadBalancerProbe dans le fichier csdef, le comportement par défaut de l’équilibreur de charge (comme décrit précédemment) est utilisé.

Si vous utilisez une sonde d’équilibreur de charge personnalisée, vous devez vous assurer que votre logique prend en compte la méthode RoleEnvironment.OnStop. Lorsque vous utilisez la sonde d’équilibreur de charge par défaut, l’instance est extraite de la rotation avant qu’OnStop ne soit appelé, mais une sonde d’équilibreur de charge personnalisée peut continuer à retourner une réponse 200 OK pendant l’événement OnStop. Si vous utilisez l’événement OnStop pour nettoyer le cache, arrêter le service ou apporter toute autre modification qui peut affecter le comportement du runtime de votre service, vous devez vous assurer que votre logique de sonde d’équilibreur de charge personnalisée retire l’instance de la rotation.

Schéma de définition de service de base pour une sonde d’équilibreur de charge

Le format de base d’un fichier de définition de service contenant une sonde d’équilibreur de charge est le suivant.

<ServiceDefinition …>
   <LoadBalancerProbes>
      <LoadBalancerProbe name="<load-balancer-probe-name>" protocol="[http|tcp]" path="<uri-for-checking-health-status-of-vm>" port="<port-number>" intervalInSeconds="<interval-in-seconds>" timeoutInSeconds="<timeout-in-seconds>"/>
   </LoadBalancerProbes>
</ServiceDefinition>

Éléments du schéma

L’élément LoadBalancerProbes du fichier de définition de service inclut les éléments suivants :

Élément LoadBalancerProbes

L’élément LoadBalancerProbes décrit la collection de sondes d’équilibreur de charge. Cet élément est l'élément parent de l'élément LoadBalancerProbe.

Élément LoadBalancerProbe

L’élément LoadBalancerProbe définit la sonde de santé pour un modèle. Vous pouvez définir plusieurs sondes d’équilibreur de charge.

Le tableau suivant décrit les attributs de l’élément LoadBalancerProbe :

Attribut Catégorie Descriptif
name string Obligatoire. Le nom de la sonde d’équilibreur de charge. Le nom doit être unique.
protocol string Obligatoire. Spécifie le protocole du point de terminaison. Les valeurs possibles sont http ou tcp. Si tcp est spécifié, une réponse ACK est requise pour que la sonde réussisse. Si http est spécifié, une réponse 200 OK de l’URI spécifiée est requise pour que la sonde réussisse.
path string L’URI utilisée pour demander l’état d’intégrité de la machine virtuelle. path est nécessaire si protocol est défini sur http. Sinon, il n’est pas autorisé.

Il n’existe aucune valeur par défaut.
port integer facultatif. Le port de communication de la sonde. Cet attribut est facultatif pour tous les points de terminaison, car le même port est utilisé pour la sonde. Vous pouvez également configurer un port différent pour leur détection. Les valeurs possibles sont comprises entre 1 et 65535, ces deux valeurs étant incluses.

La valeur par défaut est définie par le point de terminaison.
intervalInSeconds integer facultatif. L'intervalle, en secondes, pour déterminer la fréquence à laquelle vérifier l'état de santé du point de terminaison. En règle générale, l’intervalle est légèrement inférieur à la moitié du délai d’expiration alloué (en secondes), ce qui permet d’utiliser deux sondes complètes avant de mettre l’instance hors rotation.

La valeur par défaut est 15. La valeur minimale est 5.
timeoutInSeconds integer facultatif. Le délai d’expiration, en secondes, appliqué à la sonde lorsqu’aucune réponse n’entraîne l’arrêt du trafic vers le point de terminaison. Cette valeur permet d'extraire des points de terminaison de la rotation plus rapidement ou plus lentement que les délais habituels utilisés dans Azure (qui sont les valeurs par défaut).

La valeur par défaut est 31. La valeur minimale est 11.

Voir aussi

Schéma de définition du service cloud (support étendu).

  • Last updated on