Vous pouvez remplacer les valeurs par défaut du fichier de configuration de l'agent par des valeurs de paramètre communes qui s'appliquent à la section de configuration de chaque agent pour les agents Windows ou Linux.

Options communes

Les options spécifiées dans la section [common|global] du fichier de configuration liagent.ini sont propagées sur toutes les sections, les options spécifiées dans la section [common|filelog] sont propagées uniquement sur les sections filelog, et les options [common|winlog] sont propagées uniquement sur les sections winlog.

Vous pouvez définir les paramètres suivants dans les sections communes : tags, include, exclude, event_marker, charset, exclude_fields et parser comme indiqué dans l'exemple ci-dessous. Cet exemple s'applique à un agent Windows : 

[common|global]

tags = {"log_source_vm":"win-2008r2-64"}
exclude_fields = test_tag;some_other_tag
parser = auto

[common|filelog]
tags = {"collector_type":"filelog"}
exclude = *.trc

[filelog|channel_1]
directory = C:\app\log
include = *.log

...
Cet exemple spécifie le comportement suivant :
  • Tous les journaux des sections filelog contiennent des balises log_source_vm et collector_type avec leurs valeurs correspondantes.
  • Les balises test_tag et some_other_tag sont exclues de tous les journaux envoyés.
  • L'analyseur auto est appliqué à tous les journaux collectés.
  • Par défaut, tous les collecteurs filelog excluent les fichiers *.trc de la surveillance.
Les options dans [common|global] s'appliquent également à toutes les sections winlog.

Fusionner et remplacer des critères

Si des options sont définies dans plusieurs sections, leurs valeurs sont fusionnées ou remplacées et la section avec une étendue inférieure a une priorité supérieure lors de la fusion/du remplacement. Cela signifie qu'une valeur de [common|global] est fusionnée avec ou remplacée par une valeur de [common|filelog], qui en retour est combinée avec ou remplacée par une valeur de [filelog|sample_section].

Le comportement Fusionner et remplacer suit les règles suivantes :

  • Les options dont les valeurs représentent une liste de valeurs (tags, include, exclude et exclude_fields) sont fusionnées avec des valeurs de cette option d'une section avec une priorité supérieure. Et, dans le cas de balises, les valeurs tags de sections avec une priorité supérieures remplacent la valeur de cette même balise d'une section avec une priorité inférieure, comme décrit précédemment.
  • Les valeurs d'options pouvant avoir une valeur unique (event_marker, charset et parser) sont remplacées par des valeurs de cette option de sections avec une priorité supérieure.

    Cela signifie que la valeur de charset=UTF-8 de [filelog|sample_section] remplace la valeur générale de charset= UTF-16LE de [common|global].

Par exemple, si vous disposez de tags={"app":"global-test"} dans [common|filelog] et de tags={"app":"local-test","section":"flg_test_section"} dans [filelog|flg_test_section], la valeur de la balise « app » de la section [filelog|flg_test_section] remplace la valeur de [common|filelog]. Tous les journaux collectés via cette section filelog auront une balise « app » supplémentaire avec la valeur « local-test » et une balise « section » avec la valeur « flg_test_section ». Pour les sections winlog, la chaîne de priorité est la même, avec n'importe quelle section [winlog|...] avec la priorité la plus élevée et [common|global] avec la priorité la plus faible.

Lorsque des valeurs non valides sont spécifiées dans des sections communes, elles sont en général ignorées et non fusionnées avec des valeurs de sections filelog/winlog précédentes et correspondantes. Dans le cas de valeurs non valides dans des balises ou des options exclude_fields, l'agent extrait autant de données valides que possible et ignore le reste du fichier lorsque des données non valides sont détectées. Toutes les anomalies sont signalées dans le fichier journal de l'agent. Consultez le fichier journal si un comportement inattendu est rencontré et corrigez toutes les erreurs signalées par l'agent.

Si l'agent détecte une valeur non valide pour une option dans une section filelog ou winlog, il ne fusionne pas les valeurs d'option de cette section avec les valeurs d'option de sections communes et il n'active pas cette section. Toutes les erreurs sont signalées dans un fichier journal de l'agent. Consultez le fichier journal si un comportement inattendu est rencontré et corrigez toutes les erreurs signalées par l'agent.