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.

Ahora 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 o logstashCollector-1.1) 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. Tenga en cuenta que no hay procesos o agentes independientes que se deban configurar en la máquina de servidor de Liberty cuando se utiliza el recopilador logstash para reenviar sucesos.

Figura 1. Recopilador logstash
Este diagrama muestra el flujo de sucesos para el servidor Elasticsearch a través del conducto de sucesos de logstash.

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 al crear los paneles de control Kibana propios.
Nota: La característica logstashCollector-1.0 tiene distintos nombres de campo que las características logstashCollector-1.1 y bluemixLogCollector-1.1.
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 Nombre de campo de logstashCollector-1.1 / bluemixLogCollector-1.1 Descripción de campo
type type una serie que identifica el tipo de suceso
datetime was_datetime hora cuando se produjo el suceso
hostName host 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 was_userDir directorio de usuario del servidor que fue el origen del suceso, por ejemplo, D:\wlp\usr
serverName was_serverName nombre 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 was_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 Nombre de campo de logstashCollector-1.1 / bluemixLogCollector-1.1 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)
      loglevel

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

    messageId was_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 was_methodName nombre de método de la entrada de registro
    className was_className nombre de clase de entrada de registro
    loggerName módulo nombre de registrador de la entrada de registro
    threadId was_threadId ID de hebra en la línea de registro, por ejemplo, 00000015. Tenga en cuenta que el ID de hebra es una serie y no un número
    message message el mensaje de la entrada de registro, que empieza con el ID de mensaje
  • Sucesos de rastreo
    Tabla 3. Sucesos de rastreo (tipo: "liberty_trace":)
    Nombre de campo de logstashCollector-1.0 Nombre de campo de logstashCollector-1.1 / bluemixLogCollector-1.1 Descripción de campo
    severity   indicador de gravedad (1 = Preciso, 2 = Más preciso, 3 = Lo más preciso, > = Entrada, < = Salida)
      loglevel indicador de gravedad (FINE, FINER, FINEST, ENTRY, EXIT)
    methodName was_methodName nombre de método de la entrada de registro
    className was_className nombre de clase de entrada de registro
    loggerName módulo nombre de registrador de la entrada de registro
    threadId was_threadId ID de hebra en la línea de registro, por ejemplo, 00000015. Tenga en cuenta que el ID de hebra es una serie y no un número
    message message el mensaje de la entrada de registro
  • Sucesos de registro de acceso HTTP
    Tabla 4. Sucesos de registro de acceso HTTP (tipo: "liberty_accesslog":)
    Nombre de campo de logstashCollector-1.0 Nombre de campo de logstashCollector-1.1 / bluemixLogCollector-1.1 Descripción de campo
    uriPath was_uriPath Información de vía de acceso para el URL solicitado. Esto NO contiene los parámetros de consulta, por ejemplo, /pushworksserver/ push/apps/tags
    requestMethod was_requestMethod Verbo HTTP utilizado, por ejemplo, GET
    remoteHost was_remoteHost dirección IP de host remoto, por ejemplo, 127.0.0.1
    userAgent was_userAgent valor de userAgent en la solicitud
    requestProtocol was_requestProtocol Tipo de protocolo, por ejemplo, HTTP/1.1
    queryString was_queryString

    serie que representa la serie de consulta de la solicitud HTTP, por ejemplo, color=blue&size=large

    bytesReceived was_bytesReceived bytes recibidos en el URL, por ejemplo, 94
    responseCode was_responseCode Código de respuesta HTTP, por ejemplo, 200
    elapsedTime was_elapsedTime tiempo invertido en prestar servicio a la solicitud, en microsegundos
    requestHost was_requestHost Dirección IP del host de la solicitud, por ejemplo, 127.0.0.1
    requestPort was_requestPort Número de puerto de la solicitud
  • Sucesos FFDC
    Tabla 5. Sucesos FFDC (tipo: "liberty_ffdc":)
    Nombre de campo de logstashCollector-1.0 Nombre de campo de logstashCollector-1.1 / bluemixLogCollector-1.1 Descripción de campo
    className was_className La clase que ha emitido la entrada FFDC
    exceptionName was_exceptionName La excepción que se ha notificado en la entrada FFDC
    probeID was_probeID El identificador exclusivo del punto FFDC dentro de la clase
    stackTrace was_stackTrace El seguimiento de la pila del incidente FFDC
    objectDetails was_objectDetails Los detalles del incidente para el incidente FFDC
    threadId was_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 Nombre de campo de logstashCollector-1.1 / bluemixLogCollector-1.1 Descripción de campo
    heap was_heap El almacenamiento dinámico total disponible
    usedHeap was_usedHeap La cantidad de almacenamiento dinámico utilizado
    duration was_duration La duración de la recogida de basura que se ha ejecutado, en microsegundos
    gcType was_gcType El tipo de suceso de recogida de basura (por ejemplo: Nursery, Global, etc.)
    reason was_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 host/hostName y serverName/was_serverName se establecen de la forma siguiente:

El campo host/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 JDK
El serverName/was_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}

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

Al ejecutar servidores Liberty en colectivos Liberty Docker, los valores 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 varialbes de entorno CONTAINER_HOST y CONTAINER_NAME al ejecutar la imagen. Esto garantizará 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: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=cwlp_analytics_collectors
Nombre de archivo:cwlp_analytics_collectors.html