Puede reenviar los logs desde vRealize Automation a vRealize Log Insight para aprovechar la función más robusta de análisis de logs y la generación de informes.

vRealize Automation se incluye con un agente de creación de logs basado en Fluent. El agente recopila y almacena los logs para que puedan incluirse en un paquete de logs y se puedan examinar más adelante. Puede configurar el agente para que reenvíe una copia de los logs a un servidor de vRealize Log Insight mediante REST API de vRealize Log Insight. La API permite que otros programas se comuniquen con vRealize Log Insight.

Para obtener más información sobre vRealize Log Insight, incluida la documentación de REST API de vRealize Log Insight, consulte la documentación de vRealize Log Insight.

Configure el agente de creación de logs para que reenvíe de forma continua los logs de vRealize Automation a vRealize Log Insight mediante la utilidad de línea de comandos de vracli proporcionada.

Todas las líneas de log se etiquetan con un nombre de host y una etiqueta de entorno, y se pueden examinar en vRealize Log Insight. En un entorno de alta disponibilidad (High Availability, HA), los logs se etiquetan con diferentes nombres de host en función del nodo del que provengan. La etiqueta de entorno se puede configurar mediante la opción --environment ENV como se describe a continuación en la sección Configurar o actualizar la integración de vRealize Log Insight. En un entorno de alta disponibilidad, la etiqueta de entorno tiene el mismo valor para todas las líneas de log, independientemente del nodo del que provengan.

Puede encontrar información sobre cómo utilizar la utilidad de línea de comandos vracli si utiliza el argumento --help en la línea de comandos de vracli. Por ejemplo: vracli vrli --help. Para obtener una respuesta fácil de usar, inicie el comando con vracli -j vrli.

Nota: Solo puede configurar una única integración de registro remoto. Se da prioridad a vRealize Log Insight en el caso de que estén disponibles tanto un servidor de vRealize Log Insight como un servidor syslog.

Comprobar la configuración existente de vRealize Log Insight

Command

vracli vrli

Arguments

No hay argumentos de línea de comandos.

Output

La configuración actual de la integración de vRealize Log Insight se genera en formato JSON.

Exit codes
Los siguientes códigos de salida son posibles:
  • 0: se configuró la integración con vRealize Log Insight.
  • 1: se produjo una excepción como parte de la ejecución del comando. Revise el mensaje de error para conocer los detalles.
  • 61 (ENODATA): no se configuró la integración con vRealize Log Insight. Revise el mensaje de error para conocer los detalles.
Example - check integration configuration 
$ vracli vrli
No vRLI integration configured
 
$ vracli vrli
{
    "agentId": "0",
    "environment": "prod",
    "host": "my-vrli.local",
    "port": 9543,
    "scheme": "https",
    "sslVerify": false
}

Configurar o actualizar la integración de vRealize Log Insight

Command

vracli vrli set [options] FQDN_OR_URL

Nota: Después de ejecutar el comando, el agente de creación de logs puede tardar hasta dos minutos en aplicar la configuración especificada.
Arguments
  • FQDN_OR_URL

    Especifica la dirección URL o el FQDN del servidor de vRealize Log Insight que se utilizará para publicar logs. De forma predeterminada, se usan el puerto 9543 y HTTPS. Si hay que cambiar alguna de estas opciones de configuración, puede usar una URL en su lugar. 

    vracli vrli set <options> https://FQDN:9543
    Nota:
    Puede establecer un esquema de host (el valor predeterminado es HTTPS) y un puerto (el valor predeterminado para HTTPS es 9543, y para HTTP es 9000) diferentes para usarlos al enviar los logs, como se muestra en los siguientes ejemplos: 
    vracli vrli set https://HOSTNAME:9543
vracli vrli set --insecure HOSTNAME
vracli vrli set http://HOSTNAME:9000

    La instancia de REST API de consumo de vRealize Log Insight utiliza los puertos 9543 para HTTPS y 9000 para HTTP, como se describe en el tema Administrar vRealize Log Insight Puertos e interfaces externas de la documentación de vRealize Log Insight.

  • Opciones
    • --agent-id SOME_ID

      Establece el identificador del agente de creación de logs de este dispositivo. El valor predeterminado es 0. Se utiliza para identificar el agente cuando se publican logs en vRealize Log Insight mediante REST API de vRealize Log Insight.

    • --environment ENV

      Establece un identificador para el entorno actual. Estará disponible en los logs de vRealize Log Insight como una etiqueta para cada entrada de log. El valor predeterminado es prod.

    • --ca-file /path/to/server-ca.crt

      Especifica un archivo que contiene el certificado de la entidad de certificación (CA) que se utilizó para firmar el certificado del servidor de vRealize Log Insight. Esto hace que el agente de creación de logs confíe en la entidad de certificación especificada y que permita la comprobación del certificado del servidor de vRealize Log Insight si estaba firmado por una entidad que no es de confianza. El archivo puede contener una cadena de certificados completa para comprobar el certificado. En el caso de un certificado autofirmado, apruebe el certificado en sí.

    • --ca-cert CA_CERT

      La definición es idéntica a la de --ca-file que se indica más arriba, pero aprueba el certificado (cadena) en línea como una cadena.

    • --insecure

      Desactiva la verificación SSL del certificado del servidor. Obliga al agente de creación de logs a aceptar cualquier certificado SSL al publicar los logs.

  • Opciones avanzadas
    • --request-max-size BYTES

      Se recopilan varios eventos de log con una sola llamada de API. Este argumento controla el tamaño de carga útil máximo, en bytes, de cada solicitud. Los valores válidos son números entre 4000 y 4 000 000. El valor predeterminado es 256 000. Para obtener información relacionada con los valores permitidos, consulte la sección sobre el consumo de eventos de vRealize Log Insight en la documentación de REST API de vRealize Log Insight. Si se establece un valor demasiado bajo, es posible que se descarten eventos de creación de logs que superen el tamaño permitido.

    • --request-timeout SECONDS

      Una llamada a la API puede dejar de responder por varios motivos, entre los que se incluyen problemas con un punto remoto, problemas de redes, etc. Este parámetro controla la cantidad de segundos que se debe esperar para que se complete cada operación, como abrir una conexión, escribir datos o esperar una respuesta, antes de que la llamada se reconozca como con errores. El valor no puede ser inferior a 1 segundo. El valor predeterminado es 30.

    • --request-immediate-retries RETRIES

      Los logs se almacenan en búfer en fragmentos agregados antes de su envío a vRealize Log Insight (consulte a continuación --buffer-flush-thread-count). Si se produce un error en una solicitud de API, se vuelve a intentar el log inmediatamente. La cantidad predeterminada de reintentos inmediatos es 3. Si ninguno de los reintentos se realiza correctamente, se revierte el fragmento de logs completo y se vuelve a intentar más tarde.

    • --request-http-compress

      Para reducir los volúmenes de tráfico de red, puede aplicar la compresión gzip a las solicitudes que se envían al servidor de vRealize Log Insight. Si no se especifica este parámetro, no se utiliza ninguna compresión.

    • --buffer-flush-thread-count THREADS

      Para obtener un mejor rendimiento y limitar el tráfico de red, los logs se almacenan en búfer de forma local en fragmentos antes de que se vacíen y se envíen al servidor de logs. Cada fragmento contiene logs de un solo servicio. En función de su entorno, los fragmentos pueden crecer y tardar mucho tiempo en depurarse. Este argumento controla la cantidad de fragmentos que se pueden vaciar simultáneamente. El valor predeterminado es 2.

Nota:

Al configurar la integración a través de HTTPS, si el servidor de vRealize Log Insight está configurado para utilizar un certificado que no es de confianza, como un certificado autofirmado o un certificado firmado por una entidad que no es de confianza, utilice una de las opciones --ca-file, --ca-cert o --insecure. En caso contrario, el agente de creación de logs no podrá validar la identidad del servidor y no enviará los logs. Cuando se utiliza --ca-file o --ca-cert, el certificado del servidor de vRealize Log Insight debe ser válido para el nombre de host del servidor. En todos los casos, compruebe la integración. Para ello, deje unos minutos para el procesamiento y, a continuación, compruebe que vRealize Log Insight haya recibido los logs.

Output

No se espera ningún resultado.

Exit codes
Los siguientes códigos de salida son posibles:
  • 0: se actualizó la configuración.
  • 1: se produjo una excepción como parte de la ejecución. Revise el mensaje de error para conocer los detalles.
Examples - Configure or update integration configuration
Las siguientes instrucciones de ejemplo se muestran en líneas de comandos separadas; sin embargo, los argumentos se pueden combinar en una sola línea de comandos. Por ejemplo, puede incluir varios argumentos al utilizar vracli vrli set {somehost} o vracli vrli set --ca-file path/to/server-ca.crt para modificar el identificador del agente o los valores del entorno predeterminados. Para obtener información relacionada, consulte la ayuda de comandos en línea en vracli vrli --help. 
$ vracli vrli set my-vrli.local 
$ vracli vrli set 10.20.30.40
$ vracli vrli set --ca-file /etc/ssl/certs/ca.crt 10.20.30.40
$ vracli vrli set --ca-cert "$(cat /etc/ssl/certs/ca.crt)" 10.20.30.40
$ vracli vrli set --insecure http://my-vrli.local:8080
$ vracli vrli set --agent-id my-vrli-agent my-vrli.local
$ vracli vrli set --request-http-compress
$ vracli vrli set --environment staging my-vrli.local
$ vracli vrli set --environment staging --request-max-size 10000 --request-timeout 120 --request-immediate-retries 5 --buffer-flush-thread-count 4 my-vrli.local

Borrar la integración de vRealize Log Insight

Command

vracli vrli unset

Nota: Después de ejecutar el comando, el agente de creación de logs puede tardar hasta dos minutos en aplicar la configuración especificada.
Arguments

No hay argumentos de línea de comandos.

Output

La confirmación se envía como texto sin formato.

Exit codes
Están disponibles los siguientes códigos de salida:
  • 0: se borró la configuración o no existía ninguna.
  • 1: se produjo una excepción como parte de la ejecución. Revise el mensaje de error para conocer los detalles.
Examples - Clear integration 
$ vracli vrli unset
Clearing vRLI integration configuration
 
$ vracli vrli unset
No vRLI integration configured