Fichier de configuration

L'horodatage du fichier de configuration est surveillé toutes les 60 secondes. Si l'horodatage du fichier change, l'agent réinitialise sa configuration de manière dynamique sans redémarrer. Pour plus d'informations, voir Modification des fichiers de configuration et de format de l'agent.

codepage

Page de codes du fichier surveillé. Utilisez ce paramètre dans le fichier de configuration lorsque la page de codes du fichier surveillé est différente de celle du système. Indiquez la page de codes du fichier surveillé, par exemple ibm-5348_P100-1997, UTF-16 ou UTF-8.

ConfigFilesAreUTF8=Y

Ce paramètre indique que le fichier de configuration et le fichier de format sont au format UTF-8. Utilisez ce paramètre si le codage des fichiers de configuration est UTF-8 et que la page de codes du système ne l'est pas. L'agent prend en charge le codage système (valeur par défaut).

DupDetectionKeyAttributes

Liste d'attributs Cloud APM séparés par des virgules et utilisés pour identifier les événements en double. Si tous les attributs nommés sont identiques dans deux événements, ces deux événements sont considérés comme des doublons. Cette option s'applique uniquement aux événements. Pour plus d'informations, voir Filtrage et récapitulatif des événements.

Remarque :

1. Les noms d'attribut sont sensibles à la casse. Vous devez donc entrer le nom exactement comme décrit.
2. Si vous ne spécifiez pas de liste d'attributs, les valeurs sont définies sur Class et Logname par défaut.

ENFORCE_STRICT_TEC_COMPATIBILITY

Ce paramètre fait référence à tous les caractères espaces figurant dans les données du journal pour s'assurer que les caractères sont respectés. Par exemple, lorsque vous utilisez le format "%s %s" pour extraire des informations de messages de journal, l'agent de système d'exploitation recherche non seulement un espace littéral mais également tout autre espace existant, comme des tabulations ou des retours chariot.

Lorsque ce paramètre n'est pas défini, le comportement par défaut de l'agent de système d'exploitation lors de la recherche d'une chaîne de format de style Tivoli Enterprise Console consiste à rechercher autant de texte d'entrée que possible en traitant le format de gauche à droite.

Par exemple, pour la chaîne de format %s:%s et la chaîne d'entrée one:two:three, l'agent de système d'exploitation affecte un.deux au premier paramètre (correspondant au premier caractère %s) et trois au second paramètre.

Remarque :

1. Ce paramètre ne s'applique pas aux instructions de format qui utilisent la syntaxe d'expression régulière.
2. La définition de ce paramètre a un impact sur les performances. Pour améliorer le comportement et les performances du processus de mise en correspondance, évitez de définir ce paramètre et utilisez des expressions régulières à la place.

EventSummaryInterval

Indique la durée en secondes pendant laquelle l'agent recherche des événements en double à supprimer. Définissez ce paramètre à un entier positif. Cette option s'applique uniquement aux événements. Pour plus d'informations, voir Filtrage et récapitulatif des événements.

EventFloodThreshold

Indique quels événements sont envoyés lorsque le système détecte des doublons parmi les événements. La valeur de ce paramètre est send_none, send_all, send_first ou un entier positif. Cette option s'applique uniquement aux événements. Pour plus d'informations, voir Filtrage et récapitulatif des événements.

EventMaxSize

Taille en octets maximale d'un événement généré. Si vous le spécifiez, ce paramètre est utilisé à deux endroits :

1. Le paramètre peut être utilisé par l'agent afin de définir la taille de la mémoire tampon utilisée pour le traitement des événements. S'il n'est pas défini, cette mémoire tampon a par défaut une taille de 16384 octets. Si la taille de la mémoire tampon est insuffisante, les événements sont tronqués et risquent d'être supprimés.
2. Le paramètre peut être utilisé par l'émetteur EIF afin de définir la taille de la mémoire tampon utilisée pour l'envoi des événements à un récepteur EIF (tel que la sonde OMNIbus EIF). S'il n'est pas défini, cette mémoire tampon a par défaut une taille de 4096 octets. Si la taille de la mémoire tampon est insuffisante, les événements sont supprimés.

FileComparisonMode

Indique quels fichiers journaux sont surveillés lorsque plusieurs fichiers journaux correspondent à un modèle générique. Les valeurs suivantes sont disponibles :

CompareByAllMatches

Cette valeur est le comportement par défaut. Tous les fichiers correspondant au modèle générique spécifié dans le paramètre LogSources sont surveillés.

CompareByLastUpdate

Parmi les fichiers correspondant au masque indiqué dans le paramètre LogSources, le fichier dont l'horodatage de mise à jour est le plus récent est surveillé.

CompareBySize

Si au moins deux fichiers correspondent aux critères de modèle de nom de fichier spécifiés, seul le fichier le plus volumineux est surveillé. N'utilisez pas la valeur CompareBySize avec des fichiers correspondants multiples qui sont mis à jour en même temps et dont la taille de fichier augmente. Si le fichier le plus volumineux est soumis à des changements fréquents, la surveillance risque de redémarrer indéfiniment au début du nouveau fichier sélectionné. Dans le cas de correspondances multiples où un seul fichier est actif et mis à jour à la fois, utilisez plutôt la valeur CompareBySize.

CompareByCreationTime

Parmi les fichiers correspondant au masque indiqué dans le paramètre LogSources, le fichier dont l'horodatage de création est le plus récent est surveillé. Cette valeur est soumise aux restrictions suivantes :

• La valeur ne concerne que les systèmes d'exploitation Windows car les systèmes d'exploitation UNIX et Linux n'enregistrent pas l'heure de création effective des fichiers.
• La valeur n'est pas prise en charge pour les fichiers distants surveillés par le biais du protocole SFTP/SSH (Secure Shell File Transfer Protocol).

Conseil : Les valeurs CompareByLastUpdate, CompareBySize et CompareByCreationTime peuvent toutes être utilisées pour la rotation des fichiers journaux. CompareByLastUpdate est généralement utilisé pour ces fichiers.

FQDomain

Indique si l'agent a défini un nom de domaine et la manière dont il l'a défini :

• Si ce paramètre a pour valeur yes, l'agent détermine le nom de domaine.
• Si ce paramètre a pour valeur no, l'agent ne définit pas le nom de domaine. L'attribut fqhostname comporte une chaîne vide.
• Si ce paramètre n'a pas pour valeur yes ou no, le système accepte le nom de domaine comme valeur et l'ajoute au nom d'hôte.

Pour plus d'informations, voir Fichier de format.

IncludeEIFEventAttr

L'agent inclut un attribut volumineux appelé EIFEvent, qui correspond à une représentation de l'événement envoyé via la fonction EIF si cette fonction est activée. Les informations contenues dans l'attribut EIFEvent peuvent également se trouver dans d'autres attributs. Sa taille élevée étant problématique, il est désactivé par défaut. Indiquez la valeur y pour réactiver l'attribut EIFEvent.

Remarque : L'utilisation de cet attribut risque d'entraîner l'échec des seuils si les événements sont volumineux. Dans ce contexte, un événement volumineux désigne un événement où le nombre total d'octets nécessaires pour contenir l'ensemble des valeurs, des attributs et de leurs noms représente une chaîne de plus de 3600 octets.

LognameIsBasename

Lorsque vous indiquez y, la valeur de l'attribut Logname est le nom de base du fichier journal où l'événement a été détecté. Cette option s'applique uniquement aux événements Performance Management. Le chemin est supprimé. Par exemple, /data/logs/journal.log devient journal.log. Si ce paramètre a pour valeur n, le chemin complet est indiqué. L'attribut étant limité à 64 caractères, le nom sera donc tronqué s'il est plus long. Pour cette raison, la valeur par défaut est y. Pour visualiser le chemin complet dans un attribut plus long, vous pouvez l'indiquer dans la section de mappages dans un format du fichier.fmt, par exemple filename FILENAME CustomSlot1. Le mappage complète l'attribut nommé filename avec le chemin complet du fichier dans lequel l'événement a été détecté et le mappe à l'entrée CustomSlot1 de 256 caractères.

LogSources

Indique les fichiers journaux texte à interroger pour les messages. Le chemin d'accès complet de chaque fichier doit être spécifié et les noms de fichier doivent être séparés par des virgules. Dans chaque nom de fichier, vous pouvez également utiliser un astérisque (*) pour représenter une séquence de caractères ou un point d'interrogation (?) pour représenter un caractère seul. Par exemple, journal* renvoie tous les fichiers journaux dont le nom commence par le mot journal alors que journal??? renvoie tous les fichiers journaux dont le nom inclut journal suivi de trois caractères. Ces caractères génériques ne s'appliquent qu'au nom de fichier ; vous devez spécifier le chemin de manière explicite.

Si vous souhaitez utiliser des expressions régulières ou la correspondance de modèles dans le chemin, voir la description du paramètre RegexLogSources.

Une source de fichier journal n'a pas besoin d'exister lorsque l'agent est démarré ; le fichier journal est interrogé lors de sa création.

NewFilePollInterval

Indique la fréquence en secondes à laquelle l'agent vérifie les nouveaux fichiers à surveiller. Par exemple, supposons qu'un nom de fichier indiqué dans le paramètre LogSources ou RegexLogSources du fichier de configuration n'existe pas encore. Lorsque l'agent démarre, il vérifie à nouveau l'existence des fichiers à l'issue de cet intervalle.

NumEventsToCatchUp

Indique l'événement à partir duquel l'agent démarre dans le journal. Ce paramètre offre une certaine flexibilité si la source surveillée est nouvelle ou que l'agent est arrêté pour une période prolongée. Les valeurs suivantes sont valides :

Remarque : Pour les fichiers texte, les valeurs 0 et -1 s'appliquent. Pour le journal des événements Windows, les valeurs 0, -1 et n s'appliquent.

0

Démarre au niveau de l'événement suivant des journaux. Cette valeur est la valeur par défaut.

-1

Lorsque le paramètre a pour valeur -1, l'agent enregistre sa position dans le fichier surveillé. Si l'agent est arrêté et redémarré plus tard, il pourra ainsi traiter tous les événements consignés dans le journal pendant son arrêt. En l'absence de ce paramètre, l'agent ignore les événements qui se sont produits alors qu'il était arrêté et redémarre à partir de la fin du fichier. Ce paramètre ne s'applique ni aux canaux, ni à la surveillance de syslog sur les systèmes UNIX et Linux.

n

La valeur est un entier positif. L'agent démarre à partir du nième événement par rapport à l'événement le plus récent consigné dans les journaux. Autrement dit, il démarre n événements avant l'événement le plus récent consigné dans les journaux. Si n est supérieur au nombre d'événements disponibles, tous les événements disponibles sont traités.

Remarque : Vous pouvez utiliser la valeur n uniquement avec le journal d'événements Windows. Le système ignore la valeur n lorsque le paramètre UseNewEventLogAPI est défini sur y.

PollInterval

Indique la fréquence en secondes à laquelle le système interroge chaque fichier journal spécifié dans le paramètre LogSources au sujet des nouveaux messages. La valeur par défaut est 5 secondes.

Si vous avez mis à jour un adaptateur de journal des événements Windows à partir d'une version précédente et que le paramètre PollingInterval est défini sur une valeur dans le registre Windows, vous devez définir le paramètre PollInterval sur la même valeur dans le fichier de configuration d'agent Windows. Cette règle s'applique uniquement si vous remplacez un agent de système d'exploitation Tivoli Enterprise Console qui avaient des valeurs dans le registre.

ProcessPriorityClass

Définit la priorité de processus pour l'agent. Vous pouvez ajuster cette valeur afin d'améliorer les performances système lorsque l'agent traite de grands volumes d'événements et sollicite trop de ressources processeur. Les valeurs admises sont :

• A - Priorité très faible
• B - Priorité faible
• C - Priorité moyenne
• D - Priorité moyenne haute
• E - Priorité élevée
• F - Priorité très élevée
• USE_CONF_FILE_VALUE - La valeur indiquée dans le fichier de configuration est utilisée. Cette valeur est la valeur par défaut.

RegexLogSources

Indique les fichiers journaux texte à interroger pour les messages. Ce paramètre est identique au paramètre LogSources, à ceci près que les métacaractères d'expression régulière peuvent être utilisés dans la partie nom de base du nom de fichier et dans un sous-répertoire du nom de fichier. Il offre plus de flexibilité que le paramètre LogSources, car il permet de décrire plusieurs fichiers à surveiller dans plusieurs répertoires.

Par exemple, la définition de /var/log/mylog* pour l'instruction LogSources est comparable à l'utilisation du métacaractère point (.) suivi du métacaractère astérisque (*) pour former /var/log/mylog.* dans l'instruction RegexLogSources. Dans cet exemple, le système interroge tous les fichiers journaux du répertoire /var/log dont le nom de base commence par le mot journal suivi de zéro caractère ou plus. Avec la chaîne /var/log/journal.+, le système interroge tous les fichiers journaux du répertoire /var/log dont le nom de base commence par le mot journal suivi d'un caractère ou plus.

A l'instar de LogSources, le chemin d'accès complet de chaque fichier doit être spécifié et les noms de fichier doivent être séparés par des virgules. Notez toutefois que les virgules sont des caractères valides dans les expressions régulières. Pour établir une distinction entre une virgule utilisée dans une expression régulière et une virgule utilisée pour séparer des noms de fichier, les virgules utilisées dans une expression régulière doivent être associées au caractère d'échappement barre oblique inversée (\).

Par exemple, si vous souhaitez rechercher des journaux correspondant à l'une des expressions régulières /logs/.*\.log et /other/logs/[a-z]{0,3}\.log, vous devez associer la clause {0,3} de la seconde expression au caractère d'échappement afin que l'agent ne la considère pas comme le début d'une nouvelle expression : RegexLogSources=/logs/.*\.log,/other/logs/[a-z]{0\,3}\.log

Si des métacaractères sont utilisés dans le nom de chemin, ils ne peuvent être utilisés que dans un seul sous-répertoire du chemin. Par exemple, vous pouvez spécifier /var/log/[0-9\.]*/journal.* pour avoir des métacaractères dans un sous-répertoire. La chaîne [0-9\.]* fait correspondre les sous-répertoire de /var/log comportant uniquement des chiffres et des points (.). La chaîne mylog.* fait correspondre les noms des fichiers des sous répertoires /var/log qui commencent par le mot journal et suivis de zéro caractère ou plus.

Etant donné que certains systèmes d'exploitation utilisent la barre oblique inversée (\) comme séparateur de répertoire, il peut être confondu avec un métacaractère d'échappement d'expression régulière. Pour éviter cette confusion, des barres obliques doivent toujours être utilisées pour désigner des répertoires. Par exemple, les fichiers Windows qui sont spécifiés sous la forme C:\temp\mylog. * peuvent signifier que le \t est un caractère de tabulation abrégé. Par conséquent, utilisez toujours des barres obliques (/) comme séparateurs de répertoire sur tous les systèmes d'exploitation. Par exemple, C:/temp/mylog.* représente tous les fichiers du répertoire C:/temp qui commencent par mylog.

Si plusieurs sous-répertoires contiennent des métacaractères, un message de trace est également généré. Par exemple, c:/[0-9\.]*/temp.files/journal.* inclut deux sous-répertoires qui contiennent des métacaractères. [0-9\.]* est le premier sous-répertoire défini avec des métacaractères et temp.files est le deuxième sous-répertoire qui utilise le métacaractère point (.). Dans ce cas, l'agent considère que le premier sous-répertoire défini avec le métacaractère est utilisé et que les répertoires suivants possédant des métacaractères sont ignorés.

SubnodeName

Valeur de chaîne pouvant être utilisée pour remplacer le nom par défaut affecté à un sous-noeud de profil de surveillance. Par défaut, le nom de sous-noeud affecté à un profil de surveillance correspond au nom de base du fichier de configuration utilisé pour ce profil. En utilisant ce paramètre, il est possible d'affecter un nom de sous-noeud différent.

SubnodeDescription

Valeur de chaîne pouvant être utilisée pour affecter une valeur à l'attribut Subnode Description de LFAProfiles.

UnmatchLog

Permet d'indiquer un fichier dans lequel sont consignés les événements supprimés qui ne peuvent pas être analysés dans une classe d'événement par l'agent. Les événements supprimés peuvent ensuite être analysés pour déterminer si le format de fichier de l'agent doit faire l'objet de modifications. Les événements correspondant à un masque qui utilise *DISCARD* n'apparaissent pas dans le journal de non correspondance, car ils correspondent à un masque.

Cette option est utilisée dans un environnement de test pour valider les filtres dans le fichier de format. Elle peut entraîner la saturation de votre système de fichiers si vous la conservez pendant des périodes prolongées.