Documentación de Oracle Cloud Infrastructure

Opciones de configuración avanzadas para Management Agent

Modificar propiedades del agente

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

Puede definir las propiedades del agente en cualquiera de los siguientes niveles que se muestran en el orden de jerarquía. Para obtener las instrucciones de navegación para editar las propiedades del agente, siga el enlace que se encuentra junto al nivel.
Nota

El valor de propiedad aplicado en un nivel superior se aplica a todos los niveles inferiores. El conjunto de propiedades de agente en el nivel inferior tiene prioridad si la misma propiedad se define en varios niveles.

En todos los niveles anteriores, vaya al cuadro de diálogo donde se muestran las propiedades del agente para ese tipo de origen siguiendo los pasos de la sección correspondiente para cada tipo de nivel. La tabla del cuadro de diálogo muestra el valor actual de cada propiedad. Pase el cursor sobre el icono de información icono de información para saber cuál es el valor por defecto.

  • En el campo Nuevo valor, introduzca el nuevo valor para la propiedad que desea modificar. Asegúrese de que el tipo de dato del valor es el especificado. Para obtener la lista de propiedades que puede modificar para cada tipo de origen y sus tipos de dato correspondientes, consulte Propiedades del Agente que Puede Modificar.

  • Para cambiar la propiedad al valor por defecto, haga clic en el icono de menú Icono Acciones Acciones y seleccione Restablecer a valor por defecto.

  • Para borrar el valor actual de la propiedad, haga clic en el icono de menú Icono Acciones Acciones y seleccione Borrar valor actual. Si borra el valor actual, el nuevo valor se hereda. El nuevo valor se muestra en la tabla después de guardar los cambios actuales y volver a abrir este cuadro de diálogo.

  • Guarde los cambios.

Modificar propiedades de agente en el nivel de arrendamiento

Los cambios que realice en este nivel se reflejarán en los agentes de todo el arrendamiento.

  1. Vaya a la página Detalles del servicio. Consulte Visualización de detalles del servicio Log Analytics.

  2. Junto a Propiedades de recopilación de agentes globales, haga clic en Editar. Se abre el cuadro de diálogo Editar propiedades de recopilación de agentes globales.

  3. Seleccione el tipo de origen. En función del tipo de origen que seleccione, las propiedades que puede modificar se muestran en la tabla.

Modificar propiedades de agente en el nivel de agente

Los cambios que realice en este nivel se reflejarán en las entidades y orígenes gestionados por el agente específico.

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Log Analytics, haga clic en Administración.

  2. Los recursos de administración se muestran en el panel en Administración en la izquierda. Haga clic en Entidades.

    Se abre la página Entidades. Filtre las entidades especificando el tipo como agente de gestión.

    Se muestran las entidades del agente.

  3. Haga clic sobre el nombre de la entidad del agente. Se abre la página Detalles de entidad.

  4. Junto a Propiedades de recopilación de agentes globales, haga clic en Editar. Seleccione el tipo de origen. Las propiedades del agente que se pueden modificar para ese tipo de origen se muestran en la tabla.

Modificación de propiedades de agente para un origen específico

Los cambios que realice en este nivel se reflejarán en todas las entidades asociadas a este origen y los patrones de origen.

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Log Analytics, haga clic en Administración.

  2. Los recursos de administración se muestran en el panel en Administración en la izquierda. Haga clic en Orígenes.

    Se abre la página Orígenes. Haga clic en el icono de menú Acciones Icono de menú Acciones junto al origen y seleccione Editar.

    Se abre la página Editar origen.

  3. Haga clic en Mostrar propiedades de recopilación de agente. Las propiedades del agente que se pueden modificar para ese tipo de origen se muestran en una tabla.

Modificación de Propiedades de Agente para un Patrón de Origen Creado por el Usuario

Los cambios que realice en este nivel se reflejarán en todas las entidades asociadas a este origen que utilizan el patrón de origen específico que ha creado el usuario.

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Log Analytics, haga clic en Administración.

  2. Los recursos de administración se muestran en el panel en Administración en la izquierda. Haga clic en Orígenes.

    Se abre la página Orígenes. Haga clic en el icono de menú Acciones Icono de menú Acciones junto al origen y seleccione Editar.

    Se abre la página Editar origen.

  3. Junto al patrón creado por el usuario del origen, haga clic en el icono de menú Icono Acciones Acciones y haga clic en Editar propiedades de recopilación. Las propiedades del agente que se pueden modificar para ese tipo de origen se muestran en una tabla.

Modificación de propiedades de agente para una entidad

Los cambios que realice en este nivel se reflejarán en la entidad de agente específica y las asociaciones de la entidad de agente con los orígenes.

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Log Analytics, haga clic en Administración.

  2. Los recursos de administración se muestran en el panel en Administración en la izquierda. Haga clic en Entidades.

    Se abre la página Entidades. Filtre las entidades especificando el tipo como agente de gestión.

    Se muestran las entidades del agente.

  3. Haga clic en el icono de menú Acciones Icono Acciones junto al nombre de la entidad de agente y haga clic en Editar. Se abre el cuadro de diálogo Editar entidad.

  4. Haga clic en Mostrar propiedades de recopilación de agente. Seleccione el tipo de origen. Las propiedades del agente que se pueden modificar para ese tipo de origen se muestran en la tabla.

Modificar propiedades de agente en el nivel de asociación de entidad-origen

Los cambios que realice en este nivel se reflejarán en la entidad de agente específica asociada al origen.

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Log Analytics, haga clic en Administración.

  2. Los recursos de administración se muestran en el panel en Administración en la izquierda. Haga clic en Orígenes.

    Se abre la página Orígenes. Haga clic en el nombre del origen para abrir la página de detalles del origen.

    Las entidades de agente asociadas al origen se muestran en la tabla.

  3. Haga clic en el icono de menú Acciones Icono Acciones junto al nombre de la entidad de agente y haga clic en Editar asociación. Se abre el cuadro de diálogo Editar asociación.

  4. Haga clic en Mostrar propiedades de recopilación de agente. Las propiedades del agente que se pueden modificar para ese tipo de origen se muestran en la tabla.

Propiedades de agente que puede modificar

Propiedad Tipo de origen soportado Tipo de datos Niveles aplicables Descripción Rango de valores
Zona horaria Archivo, base de datos, log de diagnóstico de Oracle (ODL), API de REST Cadena Todos los niveles Valor de zona horaria en formatos admitidos por java.util.TimeZone; ejemplo: GMT. Si no se proporciona esta propiedad, el agente intenta determinarla a partir del contenido del archivo log. De lo contrario, selecciona la zona horaria del agente (que es GMT por defecto). Valor de zona horaria en formatos admitidos por java.util.TimeZone
Metadatos Archivo, base de datos, log de diagnóstico de Oracle (ODL), API de REST, listener de Syslog JSON Todos los niveles Metadatos para asociar a cada entrada de log; ejemplo: {"accounts":["hr", "finance"], "status":["enabled"]} Máx. 1024 caracteres
Activar supervisión de directorio grande Archivo, log de diagnóstico de Oracle (ODL) Booleano Inquilino, agente Activar el procesamiento de directorios grandes; ejemplo: false -
Codificación de juego de caracteres Archivo, log de diagnóstico de Oracle (ODL) Cadena Todos los niveles Juego de caracteres para el contenido del log; ejemplo: UTF-8. Si no se proporciona esta propiedad, el agente intenta determinarla a partir del contenido del archivo log. Nombre canónico de la API java.nio de Java 8. Consulte Supported Encodings.
SQLNET.ALLOWED_LOGON_VERSION Base de datos Cadena Inquilino, Agente, Entidad Ejemplo: 12 Valores válidos: 8, 12
Máximo de días anteriores Base de datos Entero Todos los niveles Máximo de filas antiguas que recuperar en un ciclo de recopilación de logs; ejemplo: 1000000 Número positivo, incluido cero
Ventana de tiempo de limpieza de estado API de REST Entero Inquilino, agente Ventana de tiempo que indica cuántos archivos de estado antiguos se deben limpiar; Formato: ISO 8601; Ejemplo: P7D. Mayor que cero
Datos Históricos API de REST Cadena Inquilino, Agente, Entidad

Tiempo que representa la cantidad de registros antiguos que se van a recuperar; formato: ISO 8601; ejemplo: P30D.

Si solo se proporciona un número, el agente utilizará por defecto días. Ejemplo: 30 se establecerá por defecto en 30d.

Los datos históricos se pueden proporcionar como entidad en el nivel de regla de log

Para especificar el número de días para recopilar datos en los 30 días anteriores: 30d. También puede especificar horas (h) y minutos (m). Ejemplo: 12h, 30m. También puede proporcionar el registro de hora exacto con el formato "yyyy-MM-dd'T'HH:mm:ss.SSSZ". Ejemplo: 2001-07-04T12:08:56.100-0700
Activar filtro de registros duplicados API de REST Booleano Todos los niveles Activar el filtrado de duplicados; ejemplo: true. -
Longitud máxima de registro de log Listener de Syslog Entero Todos los niveles Longitud máxima del log de mensajes de syslog en kilobytes; ejemplo: 64. 1-640

Especificación manual de la zona horaria y la codificación de caracteres para archivos

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 Log 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 UTC de zona horaria y codificación de caracteres EUC-JP se aplican para el origen -2574377491167724513 y las propiedades UTF-8 de codificación de caracteres se aplican 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 UTC de zona horaria y codificación de caracteres EUC-JP se aplican para el patrón 495071102827757094 y las propiedades UTF-8 de codificación de caracteres se aplican 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 UTC y codificación del carácter EUC-JP de la zona horaria se aplican a los logs con el patrón 495071102827757094 y el origen -2574377491167724513, y las propiedades UTF-8 de codificación del carácter se aplican a los logs con el patrón 495071102827757095 y el origen -2574377491167724513.

Configurar programa de recopilación SQL de base de datos

Puede personalizar el programa de recopilación de SQL para cada origen de log de la base de datos especificando la periodicidad en un archivo CSV en 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 indicado: 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 Log Analytics.

    Cualquiera

    RECURRENCE_PATTERN_UNIT

    Ésta es la unidad de cadencia de la recopilación SQL, por ejemplo, minutos o días.

    SEMANA y MES pueden tener varios valores separados por :

    • MIN: minutos
    • HOUR: horas
    • DAY: días
    • SEMANA: semanas
    • MES: meses

    RECURRENCE_PATTERN_VALUE

    Valor de la unidad de patrón seleccionada.
    • MIN: intervalo 5 MIN, 15 MIN
    • HOUR: intervalo de 1 hora
    • DAY: ejecución diaria a las 1 o 12
    • WEEK: SUN, MON, TUE, WED, THU, FRI, SAT
    • MES: fecha 1-31, ÚLTIMO día del mes

    START_HOUR

    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, aunque no se especifique el valor, la coma anterior debe estar presente en la fila para que el programa sea válido.

    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:

Contenido de fila de origen Descripción

<Source-Name>,MIN,5,

Programe la consulta SQL cada 5 minutos a partir del tiempo de asociación entre la entidad y el origen.

<Source-Name>,HOUR,1,

Programe la consulta SQL cada hora a partir de la hora de asociación de la entidad de origen.

<Source-Name>,DAY,1,1

Programe la consulta SQL todos los días a las 0100 horas del sistema.

<Source-Name>,DAY,1,12

Programe la consulta SQL todos los días a las 1200 horas del sistema.

<Source-Name>,WEEK,FRI,1

Programe la consulta SQL cada semana los viernes a las 0100 horas del sistema.

<Source-Name>,WEEK,WED:THU,1

Programe la consulta SQL cada semana los miércoles y jueves a las 0100 horas del sistema.

<Source-Name>,MONTH,7,1

Programe la consulta SQL cada mes en la fecha 7 a las 0100 horas del sistema.

<Source1-Name>,MIN,5,

<Source2-Name>,DAY,1,1

Asocie primero Source1 a la entidad y espere a que se inicie la recopilación de logs y, a continuación, actualice la configuración agregando la asociación de Source2 a la misma entidad

Activar recopilación de logs de carpetas grandes

Las carpetas que contienen más de 10.000 archivos pueden causar 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 funciones del agente de gestión y también ralentizar la máquina host.

Cuando el plugin de Management Agent Log Analytics encuentra carpetas grandes, se agrega un mensaje similar al siguiente mensaje del ejemplo al archivo mgmt_agent_logan.log del agente de gestión: 

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.
Nota

Se recomienda evitar las carpetas grandes. Utilice un mecanismo de limpieza para eliminar archivos poco después de que se recopilen, de modo que Management Agent tenga tiempo suficiente para volver a recopilarlos.

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

Puede editar manualmente la propiedad de configuración loganalytics.enable_large_dir en true en la carpeta de instalación del agente para activar la recopilación de logs de carpetas que tienen más de 10000 archivos. Por defecto, el valor 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 Log 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 host para activar este soporte. Pruebe la nueva configuración en un entorno de desarrollo o prueba antes de convertirla en producción. Determine el aumento para 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 el agente de gestión.

  • 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 el gran número de archivos de estado que puede tener que conservar el agente de gestión. Esto 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 posiblemente un gran número de archivos de estado.

Usar macro para coincidencia no sensible a mayúsculas/minúsculas de ruta de archivo log

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

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

Considere 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 en forma no sensible a mayúsculas/minúsculas.

Nota

Si el valor de una propiedad contiene el carácter de barra diagonal /, se debe tener cuidado para garantizar el uso adecuado de la macro de caso de omisión. Por ejemplo, si la propiedad de entidad es logdir=/tmp/logs/, el patrón de ruta de acceso del archivo de origen de log es (?i){logdir}/foo.log y se aplica la macro de ignorar mayúsculas/minúsculas, el patrón de ruta de acceso del archivo de origen de log se interpreta como (?i)/tmp/logs/foo.log, que no es el resultado deseado.

En tales casos, agregue varias propiedades que no sean sensibles a mayúsculas/minúsculas y cree la ruta de patrón de log a partir de ellas mediante la macro de ignorar mayúsculas/minúsculas.