Recopiladores de registros Logstash y Bluemix

Liberty genera diversos sucesos en tiempo de ejecución, por ejemplo sucesos de registro, sucesos de rastreo, sucesos de captura de datos en primer error (FFDC), sucesos de registro de acceso y sucesos de recogida de basura. Es útil consolidar los sucesos de todos los servidores para que los sucesos se puedan buscar, filtrar y analizar, especialmente cuando se están gestionando muchos servidores o cuando se están ejecutando servidores en diferentes plataformas (por ejemplo en hardware dedicado y en la nube). También puede ser útil para almacenar sucesos en un servidor independiente en los casos en que se utiliza Liberty en entornos que carecen de almacenamiento de archivos persistente para los datos de determinación de problemas.

Liberty proporciona las características de recopilador de registro Logstash y Bluemix para ayudarle a consolidar sucesos de forma remota. Los recopiladores capturas sucesos en curso, los dividen en campos y envían los sucesos con seguridad al servidor de recopilación de registro Logstash o Bluemix configurado. Los recopiladores se pueden configurar para enviar uno o más de los tipos de datos siguientes:

  • Sucesos de registro de mensajes
  • Sucesos de registro de rastreo
  • Sucesos de registro de acceso HTTP (desde el servidor Liberty)
  • Sucesos de registro FFDC
  • Sucesos de recogida de basura (disponible solo para IBM JDK)

Recopilador logstash

La característica de recopilador Logstash (logstashCollector-1.0) envía sucesos a un servidor Logstash que proporcione.

Logstash puede utilizarse con el servidor de búsqueda Elasticsearch y el panel de control Kibana, todo lo cual el usuario proporciona, configura y gestiona, para proporcionar una vista consolidada de registros u otros sucesos a través de toda la empresa. No es necesario configurar procesos o agentes independientes en la máquina de servidor de Liberty para que el recopilador Logstash reenvíe sucesos.

Estructura de suceso

Los recopiladores envían cada suceso como un conjunto de pares de campos nombre-valor. Cada tipo diferente de suceso tiene su propio conjunto de campos. Es útil conocer qué campos tiene cada suceso cuando se crean los paneles de control Kibana propios.

Los campos siguientes son comunes y están presentes en todos los sucesos:
Tabla 1. Tipos de sucesos comunes
Nombre de campo de logstashCollector-1.0 Descripción de campo
type Una serie que identifica el tipo de suceso
datetime Hora cuando se produjo el suceso
hostName Nombre de host del servidor que fue el origen del suceso

Si desea más información sobre las reglas para establecer el nombre de host, consulte Utilización de recopiladores de registro Logstash y Bluemix con Liberty en ejecución en Docker.

wlpUserDir Directorio de usuario del servidor que fue el origen del suceso, por ejemplo, D:\wlp\usr
nombre_servidor Nombre de servidor del servidor que fue el origen del suceso

Si desea más información sobre las reglas para establecer el nombre del servidor, consulte Utilización de recopiladores de registro Logstash y Bluemix con Liberty en ejecución en Docker

sequence Número de secuencia de suceso (útil para ordenar registros con la misma indicación de fecha y hora)
Además de los campos comunes, cada uno de los tipos de suceso también tiene sus propios campos exclusivos:
  • Sucesos de mensaje
    Tabla 2. Sucesos de mensaje (tipo: "liberty_message":)
    Nombre de campo de logstashCollector-1.0 Descripción de campo
    severity Indicador de gravedad (F = Muy grave, E = Error, W = Aviso A = Auditoría, I = Info, O = Salida de sistema, R = Error de sistema)
     

    Indicador de gravedad (FATAL, ERROR, WARNING, AUDIT, INFO, CONFIG, DETAIL)

    messageId ID de mensaje en la línea de registro, que se puede utilizar para descubrir tipos de errores específicos, por ejemplo, SRVE0250I
    methodName Nombre de método de la entrada de registro
    className Nombre de clase de la entrada de registro
    loggerName Nombre de registrador de la entrada de registro
    threadId ID de hebra en la línea de registro, por ejemplo, 00000015. El ID de hebra es una serie y no un número
    message El mensaje de la entrada de registro, que empieza con el ID de mensaje
    [16.0.0.4 and later]Nota: Además de la infraestructura de registro y rastreo predeterminada, el recopilador Logstash reenvía sucesos de mensaje cuando el registro binario está habilitado.
  • Sucesos de rastreo
    Tabla 3. Sucesos de rastreo (tipo: "liberty_trace":)
    Nombre de campo de logstashCollector-1.0 Descripción de campo
    severity Indicador de gravedad (1 = Preciso, 2 = Más preciso, 3 = Lo más preciso, > = Entrada, < = Salida)
      Indicador de gravedad (FINE, FINER, FINEST, ENTRY, EXIT)
    methodName Nombre de método de la entrada de registro
    className Nombre de clase de la entrada de registro
    loggerName Nombre de registrador de la entrada de registro
    threadId ID de hebra en la línea de registro, por ejemplo, 00000015. El ID de hebra es una serie y no un número
    message El mensaje de la entrada de registro
    [16.0.0.4 and later]Nota: Además de la infraestructura de registro y rastreo predeterminada, el recopilador Logstash reenvía sucesos de rastreo cuando el registro binario está habilitado.
  • Sucesos de registro de acceso HTTP
    Tabla 4. Sucesos de registro de acceso HTTP (tipo: "liberty_accesslog":)
    Nombre de campo de logstashCollector-1.0 Descripción de campo
    uriPath Información de vía de acceso para el URL solicitado. Esta información de vía de acceso no contiene los parámetros de consulta, por ejemplo, /pushworksserver/ push/apps/tags.
    requestMethod Verbo HTTP, por ejemplo, GET
    remoteHost Dirección IP del host remoto, por ejemplo, 127.0.0.1
    userAgent El valor de userAgent en la solicitud
    requestProtocol Tipo de protocolo, por ejemplo, HTTP/1.1
    queryString Serie que representa la serie de consulta de la solicitud HTTP, por ejemplo, color=blue&size=large
    bytesReceived Bytes recibidos en el URL, por ejemplo, 94
    responseCode Código de respuesta HTTP, por ejemplo, 200
    elapsedTime Tiempo invertido en prestar servicio a la solicitud, en microsegundos
    requestHost Dirección IP del host de la solicitud, por ejemplo, 127.0.0.1
    requestPort Número de puerto de la solicitud
  • Sucesos FFDC
    Tabla 5. Sucesos FFDC (tipo: "liberty_ffdc":)
    Nombre de campo de logstashCollector-1.0 Descripción de campo
    className La clase que ha emitido la entrada FFDC
    exceptionName La excepción que se ha notificado en la entrada FFDC
    probeID El identificador exclusivo del punto FFDC dentro de la clase
    stackTrace El seguimiento de la pila del incidente FFDC
    objectDetails Los detalles del incidente para el incidente FFDC
    threadId El ID de hebra del incidente FFDC
  • Sucesos de recogida de basura
    Tabla 6. Sucesos de recogida de basura (tipo: "liberty_gc":)
    Nombre de campo de logstashCollector-1.0 Descripción de campo
    heap El almacenamiento dinámico total disponible
    usedHeap La cantidad de almacenamiento dinámico utilizado
    duration La duración de la recogida de basura que se ha ejecutado, en microsegundos
    gcType El tipo de suceso de recogida de basura (por ejemplo, Nursery, Global)
    reason La razón de la recogida de basura

Utilización de recopiladores de registro Logstash y Bluemix con Liberty en ejecución en Docker

Para ejecutar servidores Liberty en contenedores Docker u otros entornos virtualizados, los valores hostName y serverName se establecen de la forma siguiente:

El campo hostName se establece en el primero de los valores siguientes que está disponible:
  • El valor de la variable de entorno CONTAINER_HOST
  • El valor de la variable de configuración de Liberty ${defaultHostName}
  • El nombre de host canónico según el kit de desarrollo de software (JDK)
El campo serverName se establece en el primero de los valores siguientes que está disponible:
  • El valor de la variable de entorno CONTAINER_NAME
  • El valor de la variable de configuración de Liberty ${wlp.server.name}

Cuando los servidores de Liberty se ejecutan en el servicio de contenedor Bluemix, CONTAINER_HOST y CONTAINER_NAME ya se han establecido automáticamente.

Cuando los servidores Liberty se ejecutan en colectivos Liberty Docker, CONTAINER_HOST y CONTAINER_NAME ya se han establecido automáticamente.

Al ejecutar servidores Liberty en contenedores Docker u otros entornos virtuales que gestione, establezca las variables de entorno CONTAINER_HOST y CONTAINER_NAME al ejecutar la imagen. Estas variables de entorno garantizan que el recopilador de registro Logstash o Bluemix etiqueta los registros que envía con el nombre de host y contenedor adecuados, lo cual ayuda en la determinación de problemas. Si no establece estas variables de entorno, podría encontrar difícil determinar qué contenedor ha enviado sucesos al utilizar un panel de control que muestra sucesos de varios contenedores. Al iniciar un contenedor Docker, utilice un mandato parecido al siguiente:
docker run -d -e LICENSE=accept -e
CONTAINER_NAME=nombre de su
contenedor -e
CONTAINER_HOST=host de su
contenedor
--name=nombre de su contenedor
nombre de su imagen

Icono que indica el tipo de tema Tema de concepto



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwlp_analytics_collectors
Nombre de archivo:cwlp_analytics_collectors.html