Puede utilizar la consola para definir las propiedades del agente para la recopilación de logs de Logging Analytics en varios niveles de jerarquía, siendo el nivel de inquilino el más alto.

Puede especificar manualmente las propiedades de los archivos log editando las propiedades de configuración en la carpeta de instalación del agente.

Puede realizar esta tarea para todos los logs, excepto los eventos de Windows.

1. Si desea aplicar las propiedades a patrones y/u orígenes de log específicos, anote el ID de patrón y el ID de origen. Abra el archivo xml de configuración en la carpeta de instalación del agente agent_inst/state/laStorage/os_file/os_file.xml.

   • Ejemplo de ID de patrón: <Pattern id="495071102827757094" name="/tmp/w*.mgr" include="true">
   • Ejemplo de ID de origen: <LogSource id="-2574377491167724513" name="SS Concurrent Manager Logs" sourceType="os_file"/>

   La ubicación de la carpeta de instalación del agente varía según el tipo de origen. Por ejemplo, la ubicación es agent_inst/state/laStorage/database_sql/database_sql.xml para la base de datos SQL.

2. Edite el archivo de propiedades emd.properties de la ubicación agent_inst/config/emd.properties y agregue la siguiente propiedad para sustituir la configuración por defecto de Oracle Logging Analytics:

   loganalytics.src.override_config=true
       

3. Especifique las propiedades de zona horaria tz y de codificación de caracteres enc en el archivo emd.properties seleccionando uno de los siguientes ejemplos:

   • Aplique las propiedades para todos los orígenes y patrones:

     loganalytics.src.addl_src_ptn_configs=tz=UTC,enc=EUC-JP

   • Aplique las propiedades solo para orígenes de log específicos:

     loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,tz=UTC,enc=EUC-JP;srcid=-2574377491167724512,enc=UTF-8

     En este ejemplo, las propiedades de zona horaria UTC y codificación de caracteres EUC-JP se aplican para el origen -2574377491167724513 y la propiedad de codificación de caracteres UTF-8 se aplica para el origen -2574377491167724512.

   • Aplique las propiedades solo para patrones específicos:

     loganalytics.src.addl_src_ptn_configs=ptnid=495071102827757094,tz=UTC,enc=EUC-JP;ptnid=495071102827757095,enc=UTF-8

     En este ejemplo, las propiedades de zona horaria UTC y codificación de caracteres EUC-JP se aplican para el patrón 495071102827757094 y la propiedad de codificación de caracteres UTF-8 se aplica para el patrón 495071102827757095.

   • Aplique las propiedades solo para una combinación de orígenes y patrones específicos:

     loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,ptnid=495071102827757094,tz=UTC,enc=EUC-JP;srcid=-2574377491167724513,ptnid=495071102827757095,enc=UTF-8

     En este ejemplo, las propiedades de zona horaria UTC y codificación de caracteres EUC-JP se aplican a los logs con el patrón 495071102827757094 y el origen -2574377491167724513, y la propiedad de codificación de caracteres UTF-8 se aplica a los logs con el patrón 495071102827757095 y el origen -2574377491167724513.

Puede personalizar la programación de recopilación SQL para cada uno de los orígenes de log de base de datos especificando la periodicidad en un archivo CSV con el formato especificado a continuación.

1. Navegue al directorio de instalación de Management Agent u Oracle Cloud Agent en el host de la base de datos, por ejemplo agent_inst. Cree un directorio laconfig en el directorio de instalación del agente.

2. En el directorio laconfig, cree un archivo CSV logan_schedule_database_sql_*.csv. Este es el archivo de configuración de programa.

3. En el archivo de configuración de programa, proporcione los detalles del programa de origen con el siguiente formato:

   NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR
   <Source-Name>,DAY,1,1

   La fila de cabecera debe tener el contenido prescrito: NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR

   En las filas siguientes, especifique el programa para cada origen, uno por fila.

   Los parámetros de fila de cabecera y sus valores:

   Parámetro de fila de cabecera	Descripción	Valores Permitidos
   NAME	Nombre del origen de log de base de datos definido en Oracle Logging Analytics.	Cualquiera
   RECURRENCE_PATTERN_UNIT	Es la unidad de cadencia de la recopilación de SQL, por ejemplo, minutos o días. SEMANA y MES pueden tener varios valores separados por :	MIN: minutos HORA: horas DAY: días SEMANA: semanas MONTH: meses
   RECURRENCE_PATTERN_VALUE	Valor de la unidad de patrón seleccionada.	MIN: intervalo 5 MIN, 15 MIN HOUR: intervalo de 1 horas DAY: se ejecuta diariamente a las 1 o 12 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT MES: fecha 1-31, Último día del mes
   START_HOUR	La hora de inicio de la recopilación de SQL, por ejemplo, 0100 horas o 1200 horas. Si no se especifica este valor, la recopilación SQL comienza inmediatamente después de la asociación origen-entidad. Tenga en cuenta que, incluso si no se especifica el valor, la coma anterior debe estar presente en la fila para que la programación sea válida.	1 o 12.

4. Después de guardar el archivo CSV, reinicie el agente.

Algunos de los valores de ejemplo para la configuración de programa:

Las carpetas que contienen más de 10 000 archivos pueden provocar un uso elevado de recursos (memoria/almacenamiento/CPU) por parte del agente de gestión, lo que puede provocar una recopilación lenta de logs, afectar a otras funcionalidades del agente de gestión y también ralentizar la máquina host.

Cuando el plugin de Management Agent Logging Analytics encuentra carpetas grandes, se agrega un mensaje similar al siguiente mensaje de ejemplo al archivo mgmt_agent_logan.log de Management Agent:

2020-07-30 14:46:51,653 [LOG.Executor.2388 (LA_TASK_os_file)-61850] INFO - ignore large dir /u01/service/database/logs. set property loganalytics.enable_large_dir to enable.

Sin embargo, si desea continuar supervisando los logs en carpetas grandes, puede activar el soporte realizando los siguientes cambios.

Puede editar manualmente la propiedad de configuración loganalytics.enable_large_dir a true en la carpeta de instalación del agente para activar la recopilación de logs de carpetas con más de 10000 archivos. El valor por defecto de la propiedad es false.

Edite el archivo de propiedades emd.properties de la ubicación agent_inst/config/emd.properties y agregue el valor de propiedad anterior para sustituir la configuración por defecto de Oracle Logging Analytics:

sudo -u mgmt_agent echo "loganalytics.enable_large_dir=true" >> INSTALL_DIRECTORY/agent_inst/config/emd.properties

Sustituya INSTALL_DIRECTORY por la ruta de acceso a la carpeta agent_inst. Reinicie el agente de gestión después de editar el archivo emd.properties.

Puede que tenga que realizar algunos cambios de configuración en el agente de host para activar esta compatibilidad. Pruebe la nueva configuración en un entorno de desarrollo o prueba antes de ponerla en producción. Determine el aumento de los siguientes factores mediante el uso de un entorno representativo para probarlos. El aumento necesario real dependerá de factores como el número de archivos, el ratio de creación de archivos y los otros tipos de recopilación que está realizando Management Agent.

• Aumente el tamaño de pila del agente de gestión. Para los directorios con un gran número de archivos, el tamaño de pila necesario aumenta con el número de archivos. Consulte la documentación de Management Agent.
• Asegúrese de que haya suficiente espacio en disco e inodes disponibles para manejar la gran cantidad de archivos de estado que Management Agent puede tener que conservar. Depende del tipo de origen de log y analizador utilizado. Si el analizador utiliza la función Header-Detail, el agente crea y almacena la cabecera en un archivo de caché siempre que exista el archivo log original.
• Asegúrese de que la configuración del sistema operativo para el número de archivos abiertos puede soportar que Management Agent lea la carpeta grande y potencialmente un gran número de archivos de estado.

Utilice la macro ignore-case (?i) en el patrón de ruta del archivo log para interpretarla en el formato no sensible a mayúsculas/minúsculas. Se aplica al patrón de ruta de archivo log proporcionado en orígenes de log del tipo Archivo.

La macro (?i) solo se aplicará cuando esté al principio del elemento de la ruta.

Observe el ejemplo:

/tmp/(?i)FOO/*.log

En el ejemplo anterior, el elemento de la ruta que sigue a la macro es FOO. Esto se interpreta de forma no sensible a mayúsculas/minúsculas.