Partager via

Paramètres d’échec d’un <échec> d’un pool d’applications

  • Article

Vue d’ensemble

L’élément <failure> de l’élément <add> de la <applicationPools> collection configure les actions à effectuer lorsqu’un pool d’applications échoue. Les attributs autoShutdownExe, orphanActionExe, rapidFailProtection de l’élément <failure> peuvent être particulièrement utiles lors de la résolution des problèmes ou du débogage d’applications car ils vous donnent la possibilité de spécifier l’action que les services Internet Information Services (IIS) effectuent lorsqu’une application échoue, comme l’exécution d’un exécutable externe pour journaliser ou déboguer l’échec.

Compatibilité

Version Notes
IIS 10.0 L’élément <failure> n’a fait l’objet d’aucune modification dans IIS 10.0.
IIS 8.5 L’élément <failure> n’a fait l’objet d’aucune modification dans IIS 8.5.
IIS 8.0 L’élément <failure> n’a fait l’objet d’aucune modification dans IIS 8.0.
IIS 7.5 L’élément <failure> n’a fait l’objet d’aucune modification dans IIS 7.5.
IIS 7.0 L’élément <failure> a été introduit dans IIS 7.0.
IIS 6.0 L’élément <failure> remplace les parties de la propriété métabase IIS 6.0 IIsApplicationPools.

Programme d’installation

L’élément <applicationPools> est inclus dans l’installation par défaut d’IIS 7.

Procédure

Comment modifier les paramètres de configuration de la protection avec échec rapide

  1. Ouvrez le Gestionnaire des services Internet (IIS) :

    • Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :

      • Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils puis sur Gestionnaire Internet Information Services (IIS).

    • Si vous utilisez Windows 8 ou Windows 8.1 :

      • Maintenez la touche Windows enfoncée, appuyez sur la lettre X puis cliquez sur Panneau de configuration.
      • Cliquez sur Outils d'administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).

    • Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :

      • Cliquez sur Démarrer, placez le curseur sur Outils d'administration puis cliquez sur Gestionnaire Internet Information Services (IIS).

    • Si vous utilisez Windows Vista ou Windows 7 :

      • Dans la barre des tâches, cliquez sur Démarrer puis sur Panneau de configuration.
      • Double-cliquez sur Outils d'administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).

  2. Dans le volet Connexions, développez le nom du serveur, cliquez sur Pools d’applications, puis cliquez sur le pool d’applications que vous souhaitez modifier.
    Image of Connections pane displaying App Default Pool option highlighted.

  3. Dans le volet Actions, cliquez sur Paramètres avancés...

  4. Dans la boîte de dialogue Paramètres avancés, cliquez sur la propriété de protection à échec rapide que vous souhaitez modifier puis modifiez la valeur dans la section valeur de propriété de la boîte de dialogue, puis cliquez sur OK. Par exemple, remplacez l’intervalle d’échec (minutes) par 4 et le nombre maximal d’échecs par 4.
    Screenshot of Advanced Settings dialog box displaying Maximum Failures highlighted.

Configuration

Attributs

Attribut Description
autoShutdownExe Attribut de chaîne facultatif. Spécifie un exécutable à exécuter lorsque le service WWW arrête un pool d’applications. Vous pouvez utiliser l’attribut autoShutdownParams pour envoyer des paramètres au fichier exécutable.
autoShutdownParams Attribut de chaîne facultatif. Spécifie les paramètres de ligne de commande pour l’exécutable spécifié dans l’attribut autoShutdownExe.
loadBalancerCapabilities Attribut d’énumération facultatif. Spécifie le comportement lorsqu’un processus de travail ne peut pas être démarré, par exemple lorsque la file d’attente de requêtes est complète ou qu’un pool d’applications est en protection rapide et échoue. L’attribut loadBalancerCapabilities peut être l’une des valeurs possibles suivantes. La valeur par défaut est HttpLevel.

Valeur Description
HttpLevel Spécifie qu’un code d’erreur 503 a été retourné. Les équilibreurs de charge qui ne sont pas compatibles HTTP ne basculent pas vers un autre nœud, car la réponse 503 indique à l’équilibreur de charge que l’ordinateur est sain.

La valeur numérique est 2.

TcpLevel Spécifie que la connexion TCP se termine. Cela est utile lorsque vous utilisez un équilibreur de charge qui n’est pas compatible HTTP.

La valeur numérique est 1.
orphanActionExe Attribut de chaîne facultatif. Spécifie un exécutable à exécuter lorsque le service WWW orpheline un processus de travail (si l’attribut orphanWorkerProcess est défini sur true). Vous pouvez utiliser l’attribut orphanActionParams pour envoyer des paramètres au fichier exécutable.
orphanActionParams Attribut de chaîne facultatif. Indique les paramètres de ligne de commande pour l’exécutable nommé par l’attribut orphanActionExe. Pour spécifier l’ID de processus du processus orphelin, utilisez %1%.
orphanWorkerProcess Attribut booléen facultatif. Spécifie s’il faut affecter un processus de travail à un état orphelin au lieu de le terminer lorsqu’un pool d’applications échoue.

La valeur par défaut est false.
rapidFailProtection Attribut booléen facultatif. La valeur true indique au service WWW de supprimer de toutes les applications qui se trouvent dans un pool d’applications quand :

  • Le nombre d’incidents de processus de travail a atteint le maximum spécifié dans l’attribut rapidFailProtectionMaxCrashes.
  • Les incidents se produisent dans le nombre de minutes spécifiés dans l’attribut rapidFailProtectionInterval.
La valeur par défaut est true.
rapidFailProtectionInterval Attribut timeSpan facultatif. Spécifie le nombre de minutes avant la réinitialisation du nombre d’échecs d’un processus.

La valeur par défaut est de 00:05:00 (cinq minutes).
rapidFailProtectionMaxCrashes Attribut uint facultatif. Spécifie le nombre maximal d’échecs autorisés dans le nombre de minutes spécifié par l’attribut rapidFailProtectionInterval. Remarque :  À partir d’IIS 7.5, cette valeur doit être comprise entre 1 et 2147483647.

La valeur par défaut est 5.

Éléments enfants

Aucune.

Exemple Configuration

L’exemple de configuration suivant active la protection rapide contre les défaillances pour un pool d’applications unique nommé DefaultAppPool, configure un intervalle de protection rapide contre les échecs de 5 minutes et définit le nombre maximal d’échecs dans le nombre de minutes à 5.

<applicationPools>
   <add name="DefaultAppPool">
     <failure rapidFailProtection="true"
        rapidFailProtectionInterval="00:05:00"
        rapidFailProtectionMaxCrashes="5" />
   </add>
   <applicationPoolDefaults>
     <processModel identityType="NetworkService" />
   </applicationPoolDefaults>
</applicationPools>

Exemple de code

Les exemples de code suivants permettent une protection rapide contre l’échec pour DefaultAppPool sur votre serveur puis définissent l’intervalle de protection sur cinq minutes et définissez le nombre maximal de blocages sur 5.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/applicationPools /[name='DefaultAppPool'].failure.rapidFailProtection:"True" /commit:apphost

appcmd.exe set config -section:system.applicationHost/applicationPools /[name='DefaultAppPool'].failure.rapidFailProtectionInterval:"00:05:00" /commit:apphost

appcmd.exe set config -section:system.applicationHost/applicationPools /[name='DefaultAppPool'].failure.rapidFailProtectionMaxCrashes:"5" /commit:apphost

Remarque

Vous devez veiller à définir le paramètre commit sur apphost quand vous utilisez AppCmd.exe pour configurer ces paramètres. Cela valide les paramètres de configuration dans la section d’emplacement appropriée dans le fichier ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{

   private static void Main()
   {

      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection applicationPoolsSection = config.GetSection("system.applicationHost/applicationPools");
         ConfigurationElementCollection applicationPoolsCollection = applicationPoolsSection.GetCollection();
         ConfigurationElement addElement = FindElement(applicationPoolsCollection, "add", "name", @"DefaultAppPool");
         if (addElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement failureElement = addElement.GetChildElement("failure");
         failureElement["rapidFailProtection"] = true;
         failureElement["rapidFailProtectionInterval"] = TimeSpan.Parse("00:05:00");
         failureElement["rapidFailProtectionMaxCrashes"] = 5;
         serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim applicationPoolsSection As ConfigurationSection = config.GetSection("system.applicationHost/applicationPools")
      Dim applicationPoolsCollection As ConfigurationElementCollection = applicationPoolsSection.GetCollection
      Dim addElement As ConfigurationElement = FindElement(applicationPoolsCollection, "add", "name", "DefaultAppPool")

      If (addElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim failureElement As ConfigurationElement = addElement.GetChildElement("failure")
      failureElement("rapidFailProtection") = True
      failureElement("rapidFailProtectionInterval") = TimeSpan.Parse("00:05:00")
      failureElement("rapidFailProtectionMaxCrashes") = 5

      serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST");

var applicationPoolsCollection = applicationPoolsSection.Collection;

var addElementPos = FindElement(applicationPoolsCollection, "add", ["name", "DefaultAppPool"]);
if (addElementPos == -1) throw "Element not found!";
var addElement = applicationPoolsCollection.Item(addElementPos);

var failureElement = addElement.ChildElements.Item("failure");
failureElement.Properties.Item("rapidFailProtection").Value = true;
failureElement.Properties.Item("rapidFailProtectionInterval").Value = "00:05:00";
failureElement.Properties.Item("rapidFailProtectionMaxCrashes").Value = 5;

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set applicationPoolsSection = adminManager.GetAdminSection("system.applicationHost/applicationPools", "MACHINE/WEBROOT/APPHOST")
Set applicationPoolsCollection = applicationPoolsSection.Collection
addElementPos = FindElement(applicationPoolsCollection, "add", Array("name", "DefaultAppPool"))

If (siteElementPos = -1) Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set addElement = applicationPoolsCollection.Item(addElementPos)
Set failureElement = addElement.ChildElements.Item("failure")
failureElement.Properties.Item("rapidFailProtection").Value = true
failureElement.Properties.Item("rapidFailProtectionInterval").Value = "00:05:00"
failureElement.Properties.Item("rapidFailProtectionMaxCrashes").Value = 5

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function