Creación de una configuración de agente

• Consola
• CLI
• API

• 1. Abra el menú de navegación y haga clic en Observación y gestión. En Registro, haga clic en Configuración de agente.
  2. En Ámbito de lista, seleccione un compartimento en el que tenga permiso para trabajar.
  3. Haga clic en Crear configuración de agente.
  4. En el panel Crear configuración de agente, introduzca un nombre y una descripción para la configuración. Evite introducir información confidencial.
  5. Seleccione el compartimento en el que desea crear la configuración.
  6. En Grupos de hosts, donde puede definir qué máquinas virtuales se aplican a esta configuración, seleccione una de las siguientes opciones de la lista Tipo de grupo:
     • Grupo dinámico: Grupo dinámico hace referencia a un grupo de instancias que puede crear en la función IAM de la consola. Para obtener más información, consulte Acerca de los grupos dinámicos. Seleccione un grupo dinámico en la lista Grupo.
     • Grupo de usuarios: Grupo de usuarios hace referencia a la función Grupos de IAM de la consola. Para obtener más información, consulte Gestión de Grupos. Seleccione un grupo de usuarios de la lista Grupo.
  7. Para agregar más grupos, haga clic en + Otro grupo de hosts.

     Puede agregar una combinación de tipos de grupo para la configuración del agente.

     Nota
     
     Se permite un máximo de cinco grupos por configuración, y un host puede estar en un máximo de cinco grupos diferentes.
  8. En Configuración de agente, defina el formato de los logs (qué logs desea observar) en Configurar entradas de log. Seleccione una de las opciones de la lista Tipo de entrada:
     • En Log de evento de Windows, introduzca un nombre de entrada y seleccione uno o más canales de evento.
     • Para Ruta de acceso de log, introduzca un nombre de entrada y una o más rutas de acceso de archivo. Por ejemplo, /<ruta_de_log>/<nombre_de_log>.

     Puede especificar varias rutas de acceso de archivos log, separadas por una coma (,). Para obtener más información, consulte https://docs.fluentd.org/input/tail#path.

     <source>
     @type tail
     tag 757261.oc_oslogs_linux
     path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
      var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
     pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
     path_key tailed_path
     </source>

     Ejemplo de configuración:

     {{path C:\Program Files (x86)\<application>\<directory>*, 
      C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}

  9. Haga clic en Opciones avanzadas de analizador y, en el panel Opciones avanzadas de analizador, seleccione un analizador para especificar cómo analizar el log. Algunos analizadores requieren más entradas y tienen más opciones, en función del tipo elegido.
     Por ejemplo, para JSON, debe seleccionar un valor de Tipo de tiempo en la lista, mientras que, opcionalmente, puede especificar la hora de evento y la configuración del campo nulo. Para REGEXP, puede especificar la expresión regular para los logs coincidentes junto con el formato de hora. Para obtener más información, consulte Entradas y Analizadores de Log.

     Importante
     
     El tipo de analizador NONE es necesario, incluso si no desea especificar un tipo de analizador concreto.
  10. En Seleccionar destino de log, el grupo de usuarios o el grupo dinámico de la configuración que seleccione en el compartimento debe tener permiso para trabajar en el compartimento.

      Seleccione Grupo de logs y Nombre de log en las listas correspondientes.

      El nombre de log solo puede apuntar a un log personalizado, y el log personalizado debe existir en el grupo de logs seleccionado para que funcione la configuración.

  11. (Opcional) Haga clic en Mostrar opciones adicionales. En Métricas operativas del agente de registro, haga clic en Activar para ayudar a supervisar e identificar posibles problemas con el agente.
      En Emitir destino, seleccione el compartimento y especifique un espacio de nombres y, opcionalmente, especifique el grupo de recursos de los campos correspondientes.

      Nota
      
      Aunque el grupo de recursos es opcional, el valor por defecto es "defaultGroup" si no se selecciona nada.

      En Métricas operativas, seleccione las métricas operativas que desea activar para la configuración del agente.

      • Latido: estado de Unified Monitoring Agent. El valor 1 indica que el agente está disponible y el valor 0 indica que el agente no responde. Esta métrica siempre está activada y no se puede desactivar.

        Dimensiones: versión, sistema operativo, arquitectura, región, AD e ID de instancia de Unified Monitoring Agent de la instancia.

      • RestartMetric: a diferencia de la métrica Latido, que es periódica, RestartMetric se envía solo una vez durante la vida útil del agente, es decir, cuando se reinicia el agente. Los reinicios de supervisión son esenciales para comprender la estabilidad del agente. Los reinicios frecuentes pueden indicar un funcionamiento incorrecto del sistema, y tener en cuenta los reinicios inesperados puede ayudar a los operadores a abordar problemas de configuración o restricciones de recursos.

        Dimensiones: Identificador de Instancia.

      • EmitRecords: número total de registros de log emitidos. Un registro corresponde a las líneas de log enviadas al backend. Esta métrica proporciona estadísticas sobre el aumento y la disminución del número de líneas de log ingeridas y el volumen de logs que se está procesando. Una caída repentina o un aumento de este número pueden indicar problemas en el pipeline de registro. Por ejemplo, algunas líneas de log se pueden rechazar y no incluir durante la ingesta de log.

        Dimensiones: ID de instancia y etiqueta.

      • BufferSpaceAvailable: espacio de buffer disponible expresado como porcentaje. El valor comienza en 100 y disminuye a medida que se utiliza la cantidad de buffer. El agente utiliza buffers para manejar ráfagas de datos entrantes y la posible contrapresión de las salidas. El control de esta métrica ayuda a garantizar que no se quede sin espacio en el buffer, lo que podría provocar la pérdida de datos o la contrapresión. Si el espacio del buffer se está quedando corto de forma constante, puede que necesite optimizar la configuración del agente y asignar más recursos.

        Dimensiones: ID de instancia y etiqueta.

      • ShowFlushCount: número total de vaciados lentos. Flushing hace referencia al acto de enviar datos en buffer al destino deseado. Un vaciado lento significa que el vaciado de datos del buffer a su destino está tardando más que el umbral definido. Este número se incrementa cuando el vaciado del buffer es superior a 20 segundos. La supervisión de los vaciados lentos ayuda a identificar problemas de rendimiento. Si los vaciados son consistentemente lentos, el buffer puede llenarse más rápido de lo que se pueden borrar los datos, lo que genera problemas de pérdida de datos o contrapresión.

        Dimensiones: ID de instancia y etiqueta.

      • RollbackCount: número total de veces que el agente realiza un rollback de una transacción porque no ha podido vaciar correctamente el buffer en el destino de emisión. Las reversiones se suelen producir cuando falla una escritura o try_write, o cuando hay problemas con el servicio OCI Logging, problemas de red o problemas de configuración. Los recuentos altos de rollback son un claro indicador de problemas de fiabilidad en el pipeline de registro que necesitan investigación.

        Dimensiones: ID de instancia y etiqueta.

      • RetryCount: realiza un seguimiento del número de veces que el agente intenta volver a intentar una operación de envío de datos después de un fallo. Los reintentos indican problemas transitorios con la entrega de datos, y los recuentos altos de reintentos pueden indicar inestabilidad de red. Si bien los rollbacks pueden tratar problemas transaccionales mayores, los reintentos a menudo indican interrupciones más pequeñas y posiblemente más frecuentes.

        Dimensiones: ID de instancia y etiqueta.

      Una vez creada la configuración del agente, puede ver qué métricas operativas están activadas al obtener los detalles de una configuración de agente.

  12. (Opcional) Haga clic en Mostrar opciones adicionales. En Agregar etiquetas, agregue etiquetas según sea necesario.
  13. (Opcional) Haga clic en Guardar como pila para guardar la configuración de recursos como una pila.
      Para obtener más información, consulte Creación de una Pila desde una Página de Creación de Recursos.
  14. Haga clic en Crear.

  Se creará la configuración del agente y aparecerá en la página Configuraciones de agente.

• Utilice el comando oci logging agent-configuration create y los parámetros necesarios para crear una configuración de agente para el registro:

  oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]

  Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de los comandos de CLI.

• Ejecute la operación CreateUnifiedAgentConfiguration para crear una configuración de agente para el registro.