Logstash 和 Bluemix 日志收集器
Liberty 在运行时生成各种事件,例如日志事件、跟踪事件、首次失败数据捕获 (ffdc) 事件、访问日志事件和垃圾回收事件。Logstash 收集器可帮助您将来自所有服务器的事件进行合并,以便能够对事件进行搜索、过滤和分析,特别是当您管理许多服务器时,或在不同平台上(例如在专用硬件上和在云中)运行服务器时。如果您使用 Liberty 时所在环境缺少问题确定数据所使用的持久文件存储,那么 Logstash 收集器也可帮助您将事件存储在单独的服务器上。
- 消息日志事件
- 跟踪日志事件
- HTTP 访问日志事件(来自 Liberty 服务器)
- FFDC 日志事件
- 垃圾回收事件(仅可用于 IBM JDK)
Logstash 收集器
Logstash 收集器功能部件(logstashCollector-1.0 或 logstashCollector-1.1)将事件发送至您提供的 Logstash 服务器。Logstash 可以与您提供、设置和管理的所有 Elasticsearch 搜索服务器和 Kibana 仪表板配合使用,以提供您整个企业中的日志或其他事件的统一视图。请注意,使用 Logstash 收集器转发事件时,Liberty 服务器上将不会设置任何单独的进程或代理程序。

事件结构
收集器将每个事件作为一组“字段名称/值”对发送。每个不同的事件类型都有自己的一组字段。当您创建自己的 Kibana 仪表板时,了解每个事件具有哪些字段很有用。| logstashCollector-1.0 字段名称 | logstashCollector-1.1/bluemixLogCollector-1.1 字段名称 | 字段描述 |
|---|---|---|
| 类型 | 类型 | 用于标识事件类型的字符串 |
| datetime | was_datetime | 事件发生的时间 |
| hostName | 主机 | 作为事件源的服务器的主机名 有关用于设置主机名的规则的更多信息,请参阅将 Logstash 和 Bluemix 日志收集器与 Docker 中运行的 Liberty 配合使用 |
| wlpUserDir | was_userDir | 作为事件源的服务器的用户目录,例如 D:\wlp\usr |
| serverName | was_serverName | 作为事件源的服务器的服务器名称 有关用于设置服务器名称的规则的更多信息,请参阅将 Logstash 和 Bluemix 日志收集器与 Docker 中运行的 Liberty 配合使用 |
| sequence | was_sequence | 事件的序列号(对具有相同时间戳记的记录进行排序时很有用) |
- 消息事件
表 2. 消息事件(类型:“liberty_message”:) logstashCollector-1.0 字段名称 logstashCollector-1.1/bluemixLogCollector-1.1 字段名称 字段描述 severity 严重性指示符(F = 致命,E = 错误,W = 警告,A = 审计,I = 参考,O = 系统输出,R = 系统错误) loglevel 严重性指示符(FATAL、ERROR、WARNING、AUDIT、INFO、CONFIG 或 DETAIL)
messageId was_messageId 日志行中的消息标识,可用于查找特定类型的错误,例如 SRVE0250I methodName was_methodName 日志记录中的方法名称 className was_className 日志记录中的类名 loggerName module 日志记录中的记录器名称 threadId was_threadId 日志行中的线程标识,例如 00000015。请注意,线程标识是字符串而非数字 message message 日志记录中的消息,以消息标识开头 - 跟踪事件
表 3. 跟踪事件(类型:“liberty_trace”:) logstashCollector-1.0 字段名称 logstashCollector-1.1/bluemixLogCollector-1.1 字段名称 字段描述 severity 严重性指示符(1 = 精细,2 = 较精细,3 = 最精细,> = 进入,< = 退出) loglevel 严重性指示符(FINE、FINER、FINEST、ENTRY 或 EXIT) methodName was_methodName 日志记录中的方法名称 className was_className 日志记录中的类名 loggerName module 日志记录中的记录器名称 threadId was_threadId 日志行中的线程标识,例如 00000015。请注意,线程标识是字符串而非数字 message message 日志记录中的消息 - HTTP 访问日志事件
表 4. HTTP 访问日志事件(类型:“liberty_accesslog”:) logstashCollector-1.0 字段名称 logstashCollector-1.1/bluemixLogCollector-1.1 字段名称 字段描述 uriPath was_uriPath 所请求 URL 的路径信息。这不包含查询参数,例如 /pushworksserver/ push/apps/tags requestMethod was_requestMethod 所使用的 HTTP 动词,例如 GET remoteHost was_remoteHost 远程主机的 IP 地址,例如 127.0.0.1 userAgent was_userAgent 请求中的 userAgent 值 requestProtocol was_requestProtocol 协议类型,例如 HTTP/1.1 queryString was_queryString 表示 HTTP 请求中的查询字符串的字符串,例如 color=blue&size=large
bytesReceived was_bytesReceived URL 中接收到的字节数,例如 94 responseCode was_responseCode HTTP 响应代码,例如 200 elapsedTime was_elapsedTime 处理请求所用的时间(以微秒计) requestHost was_requestHost 请求主机的 IP 地址,例如 127.0.0.1 requestPort was_requestPort 请求的端口号 - FFDC 事件
表 5. FFDC 事件(类型:“liberty_ffdc”:) logstashCollector-1.0 字段名称 logstashCollector-1.1/bluemixLogCollector-1.1 字段名称 字段描述 className was_className 发出 FFDC 条目的类 exceptionName was_exceptionName FFDC 条目中报告的异常 probeID was_probeID FFDC 点在类中的唯一标识 stackTrace was_stackTrace FFDC 事件的堆栈跟踪 objectDetails was_objectDetails FFDC 事件的事件详细信息 threadId was_threadId FFDC 事件的线程标识 - 垃圾回收事件
表 6. 垃圾回收事件(类型:“liberty_gc”:) logstashCollector-1.0 字段名称 logstashCollector-1.1/bluemixLogCollector-1.1 字段名称 字段描述 heap was_heap 可用堆总计 usedHeap was_usedHeap 已使用的堆数量 duration was_duration 运行垃圾回收的持续时间(以微秒计) gcType was_gcType 垃圾回收事件的类型(例如,Nursery、Global 等等) reason was_reason 垃圾回收的原因
将 Logstash 和 Bluemix 日志收集器与 Docker 中运行的 Liberty 配合使用
对于 Docker 容器或其他虚拟环境中正在运行的 Liberty 服务器,host/hostName 和 serverName/was_serverName 按如下所示进行设置:
- CONTAINER_HOST 环境变量的值
- Liberty 配置变量 ${defaultHostName} 的值
- JDK 所报告的规范主机名
- CONTAINER_NAME 环境变量的值
- Liberty 配置变量 ${wlp.server.name} 的值
在 Bluemix 容器服务中运行 Liberty 服务器时,已为您设置 CONTAINER_HOST 和 CONTAINER_NAME。
在 Liberty Docker 集合体中运行 Liberty 服务器时,已为您设置 CONTAINER_HOST 和 CONTAINER_NAME。
docker run -d -e LICENSE=accept -e CONTAINER_NAME=yourContainerName -e CONTAINER_HOST=yourContainerHost --name=yourContainerName yourImageName
概念主题