Gestion de la sortie des journaux de l'agent

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Dernière rubrique modifiée : 2007-08-22

Cette rubrique explique comment configurer le fichier EdgeTransport.exe.config pour la gestion des fichiers journaux de l'agent de blocage du courrier indésirable. Par défaut, Microsoft Exchange Server 2007 consigne toutes les activités de l'agent de blocage du courrier indésirable dans le répertoire %programfiles%\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog. Pour filtrer les journaux de l'agent de blocage du courrier indésirable, utilisez la cmdlet Get-AgentLog. Pour plus d'informations, consultez la rubrique Get-AgentLog.

La configuration par défaut des fichiers journaux de l'agent est la suivante :

  • Taille maximale du répertoire des journaux de l'agent : 250 Mo

  • Taille maximale d'un seul fichier journal de l'agent : 10 Mo

  • Âge maximal des fichiers journaux : 30 jours

importantImportant :
Exchange 2007 Service Pack 1 (SP1) inclut des clés dans le fichier de configuration d'application EdgeTransport.exe.config qui vous permettent de modifier ces valeurs par défaut. La version de publication (RTM) de Exchange 2007 ne lit pas les clés référencées dans cette rubrique.

Modification du fichier EdgeTransport.exe.config

Toutes les modifications des options de configuration de la gestion de la sortie des journaux de l'agent doivent être effectuées dans le fichier EdgeTransport.exe.config situé dans le répertoire %programfiles%\Microsoft\Exchange Server\Bin. Le fichier EdgeTransport.exe.config file est un fichier de configuration d'application XML associé au fichier EdgeTransport.exe. EdgeTransport.exe et MSExchangeTransport.exe sont les fichiers exécutables utilisés par le service de transport  Microsoft Exchange. Ce service s'exécute sur chaque serveur de transport Hub et Edge. Les modifications enregistrées dans le fichier EdgeTransport.exe.config sont appliquées après le redémarrage du service de transport de Microsoft Exchange. La valeur par défaut est appliquée si l'une des conditions suivantes est vérifiée :

  • Il manque une option de configuration.

  • Une option de configuration est présente et contient la valeur par défaut.

Voici un exemple de base de la structure typique du fichier EdgeTransport.exe.config :

<configuration> 
<runtime> 
<gcServer enabled="true" /> 
</runtime> 
<appSettings> 
<add key=" Configuration Option " value=" Value " /> 

</appSettings> 
</configuration> 

Vous pouvez ajouter des options de configuration ou modifier des options de configuration existantes dans la section <appSettings>. La plupart des options de configuration disponibles ne sont pas liées à la sortie des journaux de l'agent. Les options de configuration qui ne sont pas liées à la sortie des journaux de l'agent ne sont pas traitées dans cette rubrique.

Clés de sortie des journaux de l'agent

La sortie des journaux de l'agent est gérée par les clés suivantes dans le fichier EdgeTransport.exe.config :

<add key="AgentLogEnabled" value="system.boolean" />
<add key="AgentLogMaxDirectorySize" value="system.int32" />
<add key="AgentLogMaxFileSize" value="system.int32" />
<add key="AgentLogMaxAge" value="system.timespan" />

Par défaut, seule la clé AgentLogEnabled figure dans le fichier EdgeTransport.exe.config. Vous devez ajouter toutes les autres clés. La table suivante décrit chaque clé plus en détail.

Clé Type de valeur Description

AgentLogEnabled

System.Boolean

Par défaut, cette clé figure dans EdgeTransport.exe.config. Les valeurs valides de cette clé sont true ou false. La valeur par défaut est true.

AgentLogMaxDirectorySize

System.Int32

Par défaut, cette clé n'existe pas dans EdgeTransport.exe.config. Sa valeur indique la taille maximale, en octets, du répertoire AgentLog. Lorsque cette valeur est dépassée, le fichier journal le plus ancien du répertoire est supprimé et un nouveau fichier journal est créé.

Si cette clé n'est pas spécifiée, la valeur par défaut est 250 Mo, ou 262144000 octets (250*1024*1024) dans Exchange 2007 RTM et Exchange 2007 SP1.

AgentLogMaxFileSize

System.Int32

Par défaut, cette clé n'existe pas dans EdgeTransport.exe.config. Sa valeur indique la taille maximale, en octets, de chaque fichier journal du répertoire. Une fois la taille de fichier journal atteinte, un nouveau fichier journal est créé.

Si cette clé n'est pas spécifiée, la valeur par défaut est 10 Mo, ou 10485760 octets (10*1024*1024) dans Exchange 2007 RTM et Exchange 2007 SP1.

AgentLogMaxAge

System.TimeSpan

Par défaut, cette clé n'existe pas dans EdgeTransport.exe.config. Sa valeur indique la limite d'âge maximal d'un fichier journal donné. Lorsqu'un fichier journal dépasse la limite d'âge, il est supprimé.

Le type système de cette clé est TimeSpan. La valeur de cette clé peut être représentée sous forme de chaîne au format d.hh:mm:ss.ffd correspond aux jours, hh aux heures, mm aux minutes, ss aux secondes, et ff aux fractions de secondes.

Si cette clé n'est pas spécifiée, la valeur par défaut est 30 jours, ou 30.00:00:00.00 dans Exchange 2007 RTM et Exchange 2007 SP1.

Avant de commencer

Pour exécuter cette procédure, vous devez utiliser un compte auquel ont été délégués :

  • Membre du groupe Administrateurs local sur l'ordinateur

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Procédure

Ajout et configuration des clés de sortie des journaux de l'agent dans le fichier EdgeTransport.exe.config

  1. Dans le serveur de transport Hub ou Edge sur lequel vous souhaitez gérer la sortie des journaux de l'agent, ouvrez EdgeTransport.exe.config dans un éditeur de texte ASCII comme le Bloc-notes. Le fichier EdgeTransport.exe.config se trouve dans le répertoire %programfiles%\Microsoft\Exchange Server\Bin directory.

  2. Localisez la clé AgentLogEnabled. Par défaut, les clés sont répertoriées par ordre alphabétique sous <appsettings>.

  3. Copiez et collez les clés suivantes sous les clés AgentLogEnabled :

    <add key="AgentLogMaxDirectorySize" value="system.int32" />
    <add key="AgentLogMaxFileSize" value="system.int32" />
    <add key="AgentLogMaxAge" value="system.timespan" />
    
  4. Vérifiez que la clé AgentLogEnabled est définie sur true, et ajoutez des valeurs aux autres clés.

  5. Une fois la mise à jour du fichier EdgeTransport.exe.config terminée, enregistrez le fichier et fermez-le.

  6. Vous devez redémarrer le service de transport Microsoft Exchange pour que les modifications configuration ne prennent effet.

Pour plus d'informations

Pour plus d'informations, consultez la rubrique Get-AgentLog.