Puede reemplazar los valores predeterminados del archivo de configuración del agente por valores de parámetros comunes que se aplican a la sección de configuración de cada agente para los agentes de Linux o de Windows.

Opciones comunes

Las opciones que se especifican en la sección [common|global] del archivo de configuración liagent.ini se propagan a todas las secciones; por su parte, las opciones especificadas en la sección [common|filelog] lo hacen únicamente a todas las secciones de filelog, al igual que las opciones [common|winlog] se propagan únicamente a todas las secciones de winlog.

Puede definir los siguientes parámetros en las secciones comunes: tags, include, exclude, event_marker, charset, exclude_fields y parser como aparece en este ejemplo. Este ejemplo es de un agente de 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

...
Este ejemplo especifica el siguiente comportamiento:
  • Todos los registros de las secciones de filelog cuentan con las etiquetas log_source_vm y collector_type con sus correspondientes valores.
  • Las etiquetas test_tag y some_other_tag se excluyen de todos los registros que se envían.
  • Se aplica el analizador auto a todos los registros obtenidos.
  • De forma predeterminada, todos los recopiladores excluyen los archivos *.trc de la supervisión.
También se aplican las opciones incluidas en [common|global] a todas las secciones de winlog.

Combinar y reemplazar criterios

Si las opciones están definidas en más de una sección, sus valores se combinan o se reemplazan y la sección que cuente con el ámbito más pequeño tiene mayor prioridad en dichos procesos. Esto significa que un valor contenido en [common|global] se combina con o se reemplaza por un valor de [common|filelog]] que, a su vez, se combina con o se reemplaza por un valor de [filelog|sample_section].

El comportamiento de reemplazo y combinación sigue estas reglas:

  • Las opciones cuyos valores representan una lista (tags, include, exclude y excluded_fields) se combinan con los valores de dicha opción de una sección con mayor prioridad. Además, en el caso de las etiquetas, los valores de las secciones con mayor prioridad reemplazan al de la misma etiqueta incluida en una sección con menor prioridad, como se describe anteriormente.
  • El valor de las opciones que puedan tener un valor simple (event_maker, charset y parser) se reemplazan por los valores de la misma opción que aparecen en secciones con mayor prioridad.

    Esto supone que el valor charset=UTF-8 de [filelog|sample_section] reemplaza el valor global charset= UTF-16LE de [common|global].

Así que, por ejemplo, si cuenta con tags={"app":"global-test"} en [common|filelog] y con tags={"app":"local-test","section":"flg_test_section"} en [filelog|flg_test_section], el valor de la etiqueta "app" de la sección [filelog|flg_test_section] reemplaza el valor de [common|filelog]. Todos los registros recopilados a través de esta sección de filelog tendrán una etiqueta "app" adicional con un valor "local-test" y una etiqueta "section" con el valor "flg_test_section". En las secciones de winlog, la cadena de prioridad es la misma, donde todas las secciones [winlog|...] tienen la prioridad más alta y [common|global] tienen la más baja.

Si se especifican valores no válidos en secciones comunes, normalmente se omiten y no se combinan con los valores de las secciones correspondientes de filelog o de winlog previas. En el caso de valores no válidos en etiquetas u opciones exclude_fields, el agente extrae todos los datos válidos posibles y omite el resto del archivo una vez que encuentra los datos no válidos. Todas las anomalías aparecen en el archivo de registro del agente. Consulte el archivo de registro si se produce un comportamiento inesperado y repare todos los errores de los que informa el agente.

Si el agente detecta un valor no válido para una opción en una sección de filelog o winlog, no combina los valores de la opción de dicha sección con los correspondientes de las secciones comunes. Además, no habilita dicha sección. Todos los errores aparecen en un archivo de registro del agente. Consulte el archivo de registro si se produce un comportamiento inesperado y repare todos los errores de los que informa el agente.