›

WebSphere 应用服务器

版本	1.5.0 (查看全部)
兼容的 Kibana 版本	8.13.0 或更高版本
支持的无服务器项目类型这是什么？	安全可观测性
订阅级别这是什么？	基本
支持级别这是什么？	Elastic

此 Elastic 集成用于从 IBM WebSphere 应用服务器收集以下指标

JDBC 指标
Servlet 指标
会话管理器指标
线程池指标

此集成使用 Prometheus 收集上述指标。

要打开 Prometheus 端点，请阅读以下说明。

兼容性

编辑

此集成已针对 WebSphere Application Server 传统版本 9.0.5.17 进行测试。

问题排查

编辑

如果在 metrics-* 数据视图下显示 host.ip 冲突，则可以通过重新索引 JDBC、Servlet、Session Manager 和 ThreadPool 数据流的索引来解决此问题。

JDBC

编辑

此数据流收集 JDBC (Java 数据库连接) 相关指标。

示例

以下是 jdbc 的示例事件

{
    "@timestamp": "2022-05-19T13:33:01.029Z",
    "agent": {
        "ephemeral_id": "7fca7599-6641-4340-ab44-e026d1b4935a",
        "id": "a0386d69-0749-44b4-8487-9b92e66852a1",
        "name": "docker-fleet-agent",
        "type": "metricbeat",
        "version": "8.2.0"
    },
    "data_stream": {
        "dataset": "websphere_application_server.jdbc",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "a0386d69-0749-44b4-8487-9b92e66852a1",
        "snapshot": false,
        "version": "8.2.0"
    },
    "event": {
        "agent_id_status": "verified",
        "category": "web",
        "dataset": "websphere_application_server.jdbc",
        "duration": 364066933,
        "ingested": "2022-05-19T13:33:04Z",
        "kind": "metric",
        "module": "websphere_application_server",
        "type": "info"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-fleet-agent",
        "ip": [
            "172.31.0.5"
        ],
        "mac": [
            "02-42-C0-A8-FB-04"
        ],
        "name": "docker-fleet-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "3.10.0-1160.45.1.el7.x86_64",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.4 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "collector",
        "period": 60000
    },
    "server": {
        "address": "elastic-package-service_websphere_application_server_1:9080"
    },
    "service": {
        "address": "http://elastic-package-service_websphere_application_server_1:9080/metrics",
        "type": "prometheus"
    },
    "tags": [
        "websphere_application_server-jdbc",
        "prometheus"
    ],
    "websphere_application_server": {
        "jdbc": {
            "connection": {
                "allocated": 0,
                "closed": 0,
                "created": 0,
                "free": 0,
                "handles": 0,
                "managed": 0,
                "returned": 0,
                "total": {
                    "fault": 0,
                    "in_use": 0,
                    "seconds_in_use": 0,
                    "wait": 0,
                    "wait_seconds": 0
                },
                "waiting_threads": 0
            },
            "data_source": "jms/built-in-jms-connectionfactory",
            "percent_used": 0,
            "pool_size": 0
        }
    }
}

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段

字段	描述	类型
@timestamp	事件时间戳。	date
data_stream.dataset	数据流数据集。	constant_keyword
data_stream.namespace	数据流命名空间。	constant_keyword
data_stream.type	数据流类型。	constant_keyword
event.category	事件类别。	constant_keyword
event.dataset	事件数据集。	constant_keyword
event.kind	事件种类	constant_keyword
event.module	事件模块	constant_keyword
event.type	事件类型	constant_keyword
websphere_application_server.jdbc.connection.allocated	分配的连接总数。	long
websphere_application_server.jdbc.connection.closed	关闭的连接总数。	long
websphere_application_server.jdbc.connection.created	创建的连接总数。	long
websphere_application_server.jdbc.connection.free	池中的空闲连接数。	long
websphere_application_server.jdbc.connection.handles	特定连接池正在使用的 Connection 对象数。此数字仅适用于 V5.0 数据源。	long
websphere_application_server.jdbc.connection.managed	特定连接池正在使用的 ManagedConnection 对象数。此数字仅适用于 V5.0 数据源。	long
websphere_application_server.jdbc.connection.returned	返回到池中的连接总数。	long
websphere_application_server.jdbc.connection.total.fault	池中的连接超时次数。	long
websphere_application_server.jdbc.connection.total.in_use	连接被使用的总次数。	long
websphere_application_server.jdbc.connection.total.operations_calls	JDBC 调用次数。	long
websphere_application_server.jdbc.connection.total.operations_seconds	运行 JDBC 调用所花费的总时间（以秒为单位），包括在 JDBC 驱动程序、网络和数据库中花费的时间。总时间仅适用于 V5.0 数据源。	double
websphere_application_server.jdbc.connection.total.seconds_in_use	使用连接的总时间（以秒为单位）。总时间是分配连接和返回连接之间的时间差。此值包括 JBDC 操作时间。	double
websphere_application_server.jdbc.connection.total.wait	等待授予连接的请求次数。	long
websphere_application_server.jdbc.connection.total.wait_seconds	授予连接之前的总等待时间（以秒为单位）。	double
websphere_application_server.jdbc.connection.waiting_threads	同时等待连接的线程数。	long
websphere_application_server.jdbc.data_source	数据源的名称。	keyword
websphere_application_server.jdbc.percent_used	池中正在使用的百分比。该值基于 ConnectionPool 中配置的连接总数，而不是当前连接数。	long
websphere_application_server.jdbc.pool_size	连接池的大小。	long
websphere_application_server.jdbc.total_cache_discarded	由于缓存已满而被丢弃的语句数。	long

Servlet

编辑

此数据流收集 Servlet 相关指标。

示例

以下是 servlet 的示例事件

{
    "@timestamp": "2022-05-20T11:44:31.768Z",
    "agent": {
        "ephemeral_id": "2cc9ade1-a44e-4151-91bf-1e4865a9e57e",
        "id": "c05318bf-e468-4a7a-bd1d-7c7e4320cbde",
        "name": "docker-fleet-agent",
        "type": "metricbeat",
        "version": "8.2.0"
    },
    "data_stream": {
        "dataset": "websphere_application_server.servlet",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "c05318bf-e468-4a7a-bd1d-7c7e4320cbde",
        "snapshot": false,
        "version": "8.2.0"
    },
    "event": {
        "agent_id_status": "verified",
        "category": "web",
        "dataset": "websphere_application_server.servlet",
        "duration": 153850315,
        "ingested": "2022-05-20T11:44:35Z",
        "kind": "metric",
        "module": "websphere_application_server",
        "type": "info"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-fleet-agent",
        "ip": [
            "192.168.112.7"
        ],
        "mac": [
            "02-42-C0-A8-FB-04"
        ],
        "name": "docker-fleet-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "3.10.0-1160.45.1.el7.x86_64",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.4 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "collector",
        "period": 60000
    },
    "server": {
        "address": "elastic-package-service_websphere_application_server_1:9080"
    },
    "service": {
        "address": "http://elastic-package-service_websphere_application_server_1:9080/metrics",
        "type": "prometheus"
    },
    "tags": [
        "websphere_application_server-servlet",
        "prometheus"
    ],
    "websphere_application_server": {
        "servlet": {
            "app_name": "isclite#isclite.war",
            "loaded": 0,
            "reloaded": 0
        }
    }
}

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段

字段	描述	类型
@timestamp	事件时间戳。	date
data_stream.dataset	数据流数据集。	constant_keyword
data_stream.namespace	数据流命名空间。	constant_keyword
data_stream.type	数据流类型。	constant_keyword
event.category	事件类别。	constant_keyword
event.dataset	事件数据集。	constant_keyword
event.kind	事件种类	constant_keyword
event.module	事件模块	constant_keyword
event.type	事件类型	constant_keyword
websphere_application_server.servlet.app_name	应用程序名称。	keyword
websphere_application_server.servlet.async_context.response_time_seconds	每个 servlet 完成 AsyncContext 响应所花费的总时间（以秒为单位）。	double
websphere_application_server.servlet.async_context.responses.total	指定 URL 的 AsyncContext 响应总数。	long
websphere_application_server.servlet.errors	响应请求时生成的错误数。	long
websphere_application_server.servlet.loaded	加载的 servlet 数。	long
websphere_application_server.servlet.reloaded	重新加载的 servlet 数。	long
websphere_application_server.servlet.requests.concurrent	发送到 servlet 的并发请求数。	long
websphere_application_server.servlet.requests.processed	servlet 处理的请求总数。	long
websphere_application_server.servlet.response_time_seconds	处理 servlet 请求的总响应时间（以秒为单位）。	double
websphere_application_server.servlet.responses.processed	servlet 处理的响应总数。	long
websphere_application_server.servlet.uri.async_context.response_time_seconds	每个 URL 完成 AsyncContext 响应所花费的总时间（以秒为单位）。	double
websphere_application_server.servlet.uri.async_context.responses.total	指定 URL 的 AsyncContext 响应总数。	long
websphere_application_server.servlet.uri.requests.concurrent	为指定的 URL 同时处理的请求数。	long
websphere_application_server.servlet.uri.requests.total	servlet 为指定的 URL 处理的请求总数。	long
websphere_application_server.servlet.uri.response_time_seconds	处理指定 URL 的请求的总响应时间（以秒为单位）。	double
websphere_application_server.servlet.uri.responses.total	指定 URL 的响应总数。	long

会话管理器

编辑

此数据流收集与会话相关的指标。

示例

以下是 session_manager 的示例事件

{
    "@timestamp": "2022-05-25T10:02:02.554Z",
    "agent": {
        "ephemeral_id": "ce98e7b5-b605-42ae-bc3e-93dfe4989d2b",
        "id": "9a7dfaf6-d476-47ba-8a87-e7196ca4d0a3",
        "name": "docker-fleet-agent",
        "type": "metricbeat",
        "version": "8.2.0"
    },
    "data_stream": {
        "dataset": "websphere_application_server.session_manager",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "9a7dfaf6-d476-47ba-8a87-e7196ca4d0a3",
        "snapshot": false,
        "version": "8.2.0"
    },
    "event": {
        "agent_id_status": "verified",
        "category": "web",
        "dataset": "websphere_application_server.session_manager",
        "duration": 35233763,
        "ingested": "2022-05-25T10:02:06Z",
        "kind": "metric",
        "module": "websphere_application_server",
        "type": "info"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-fleet-agent",
        "ip": [
            "192.168.240.6"
        ],
        "mac": [
            "02-42-C0-A8-FB-04"
        ],
        "name": "docker-fleet-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "3.10.0-1160.45.1.el7.x86_64",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.4 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "collector",
        "period": 60000
    },
    "server": {
        "address": "elastic-package-service_websphere_application_server_1:9080"
    },
    "service": {
        "address": "http://elastic-package-service_websphere_application_server_1:9080/metrics",
        "type": "prometheus"
    },
    "tags": [
        "websphere_application_server-session_manager",
        "prometheus"
    ],
    "websphere_application_server": {
        "session_manager": {
            "activated_non_existent_sessions": 0,
            "affinity_breaks": 0,
            "app_name": "ibmasyncrsp#ibmasyncrsp.war",
            "cache_discarded": 0,
            "external": {
                "bytes": {
                    "read": 0,
                    "written": 0
                },
                "time_seconds": {
                    "read": 0,
                    "written": 0
                }
            },
            "no_room_for_new_sessions": 0,
            "persistent_stores": {
                "data_read": 0,
                "data_written": 0
            },
            "sessions": {
                "active": 0,
                "created": 0,
                "current": 0,
                "invalidated": {
                    "by_timeouts": 0,
                    "total": 0
                },
                "life_time": 0
            },
            "time_since_session_last_activated": 0
        }
    }
}

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段

字段	描述	类型
@timestamp	事件时间戳。	date
data_stream.dataset	数据流数据集。	constant_keyword
data_stream.namespace	数据流命名空间。	constant_keyword
data_stream.type	数据流类型。	constant_keyword
event.category	事件类别。	constant_keyword
event.dataset	事件数据集。	constant_keyword
event.kind	事件种类	constant_keyword
event.module	事件模块	constant_keyword
event.type	事件类型	constant_keyword
websphere_application_server.session_manager.activated_non_existent_sessions	已激活的不存在会话数。	long
websphere_application_server.session_manager.affinity_breaks	会话关联中断的次数。	long
websphere_application_server.session_manager.app_name	应用程序的名称。	keyword
websphere_application_server.session_manager.cache_discarded	缓存被丢弃的次数。	long
websphere_application_server.session_manager.external.bytes.read	从持久性存储读取的会话数据大小（以字节为单位）。此大小仅适用于序列化的持久会话，类似于 externalReadTime 字段。	long
websphere_application_server.session_manager.external.bytes.written	写入持久性存储的会话数据大小（以字节为单位）。	long
websphere_application_server.session_manager.external.time_seconds.read	从持久性存储读取会话数据所花费的时间（以秒为单位）。对于 Multirow 会话，这些指标适用于属性；对于 SingleRow 会话，这些指标适用于整个会话。该时间仅适用于持久会话。当您使用 JMS 持久性存储时，如果您选择不序列化数据，则该计数器不可用。	long
websphere_application_server.session_manager.external.time_seconds.written	从持久性存储写入会话数据所花费的时间（以秒为单位）。此时间仅适用于（序列化的）持久会话，类似于 externalReadTime 字段。	long
websphere_application_server.session_manager.no_room_for_new_sessions	由于该值超过了最大会话计数，导致无法处理新会话请求的次数。	long
websphere_application_server.session_manager.persistent_stores.data_read	从持久性存储读取会话数据的总次数。	long
websphere_application_server.session_manager.persistent_stores.data_written	将会话数据写入持久性存储的总次数。	long
websphere_application_server.session_manager.sessions.active	当前由请求访问的会话数。	long
websphere_application_server.session_manager.sessions.created	服务器创建的会话数。	long
websphere_application_server.session_manager.sessions.current	至今为止的活动会话数。	long
websphere_application_server.session_manager.sessions.invalidated.by_timeouts	由于超时而失效的会话数。	long
websphere_application_server.session_manager.sessions.invalidated.total	失效的会话总数。	long
websphere_application_server.session_manager.sessions.life_time	会话的生存时间。	double
websphere_application_server.session_manager.time_since_session_last_activated	自上次激活此会话以来的时间。	double

线程池

编辑

此数据流收集与线程相关的指标。

示例

以下是 threadpool 的示例事件

{
    "@timestamp": "2022-05-25T05:29:29.876Z",
    "agent": {
        "ephemeral_id": "89977a47-6584-45ca-acf9-b0fcdf8c5ee0",
        "id": "37bf4307-b56f-4bf5-9f94-5a2ab9cf49f0",
        "name": "docker-fleet-agent",
        "type": "metricbeat",
        "version": "8.2.0"
    },
    "data_stream": {
        "dataset": "websphere_application_server.threadpool",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "37bf4307-b56f-4bf5-9f94-5a2ab9cf49f0",
        "snapshot": false,
        "version": "8.2.0"
    },
    "event": {
        "agent_id_status": "verified",
        "category": "web",
        "dataset": "websphere_application_server.threadpool",
        "duration": 417718741,
        "ingested": "2022-05-25T05:29:33Z",
        "kind": "metric",
        "module": "websphere_application_server",
        "type": "info"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-fleet-agent",
        "ip": [
            "192.168.144.7"
        ],
        "mac": [
            "02-42-C0-A8-FB-04"
        ],
        "name": "docker-fleet-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "3.10.0-1160.45.1.el7.x86_64",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.4 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "collector",
        "period": 60000
    },
    "server": {
        "address": "elastic-package-service_websphere_application_server_1:9080"
    },
    "service": {
        "address": "http://elastic-package-service_websphere_application_server_1:9080/metrics",
        "type": "prometheus"
    },
    "tags": [
        "websphere_application_server-threadpool",
        "prometheus"
    ],
    "websphere_application_server": {
        "threadpool": {
            "active_time_seconds": 0,
            "name": "AriesThreadPool",
            "threads": {
                "active": 0,
                "cleared": 0,
                "stopped": {
                    "concurrent": 0,
                    "declared": 0
                },
                "total": 0
            },
            "total": {
                "active": 0,
                "created": 0,
                "destroyed": 0
            }
        }
    }
}

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段

字段	描述	类型
@timestamp	事件时间戳。	date
data_stream.dataset	数据流数据集。	constant_keyword
data_stream.namespace	数据流命名空间。	constant_keyword
data_stream.type	数据流类型。	constant_keyword
event.category	事件类别。	constant_keyword
event.dataset	事件数据集。	constant_keyword
event.kind	事件种类	constant_keyword
event.module	事件模块	constant_keyword
event.type	事件类型	constant_keyword
websphere_application_server.threadpool.active_time_seconds	线程处于活动状态的总时间（以秒为单位）。	double
websphere_application_server.threadpool.name	线程池的名称。	keyword
websphere_application_server.threadpool.threads.active	并发活动线程数。	long
websphere_application_server.threadpool.threads.cleared	已清除的线程停止次数。	long
websphere_application_server.threadpool.threads.stopped.concurrent	并发停止的线程数。	long
websphere_application_server.threadpool.threads.stopped.declared	声明停止的线程数。	long
websphere_application_server.threadpool.threads.total	池中的线程数。	long
websphere_application_server.threadpool.total.active	处于活动状态的线程数。	long
websphere_application_server.threadpool.total.created	创建的线程总数。	long
websphere_application_server.threadpool.total.destroyed	销毁的线程总数。	long

更新日志

编辑

更新日志

版本	详细信息	Kibana 版本
1.5.0	增强 (查看拉取请求) ECS 版本已更新至 8.11.0。将 kibana 约束更新为 ^8.13.0。修改了字段定义，以删除 ecs@mappings 组件模板中冗余的 ECS 字段。	8.13.0 或更高版本
1.4.0	增强 (查看拉取请求) 在 data_stream.dataset 上添加全局过滤器以提高性能。	8.12.0 或更高版本
1.3.0	增强 (查看拉取请求) 为敏感字段启用密钥。有关更多详细信息，请参阅 https://elastic.ac.cn/guide/en/fleet/current/agent-policy.html#agent-policy-secret-values	8.12.0 或更高版本
1.2.1	错误修复 (查看拉取请求) 由于错误，为较旧的堆栈版本禁用密钥。	8.3.0 或更高版本
1.2.0	增强 (查看拉取请求) 为敏感字段启用密钥，从 8.12 版本开始支持。	8.3.0 或更高版本
1.1.1	增强 (查看拉取请求) 内联“通过引用”可视化	8.3.0 或更高版本
1.1.0	增强 (查看拉取请求) 将软件包 format_version 更新为 3.0.0。	8.3.0 或更高版本
1.0.1	错误修复 (查看拉取请求) 从指标数据流中删除转发的标签。	8.3.0 或更高版本
1.0.0	增强 (查看拉取请求) 使 WebSphere Application Server 正式发布。	8.3.0 或更高版本
0.9.1	错误修复 (查看拉取请求) 通过将 Docker 镜像版本升级到最新版本来修复测试失败。	—
0.9.0	增强 (查看拉取请求) 更新仪表板、可视化和屏幕截图。	—
0.8.1	错误修复 (查看拉取请求) 解决 host.ip 字段中的冲突。	—
0.8.0	增强 (查看拉取请求) 添加兼容性部分并更新标题。	—
0.7.0	增强 (查看拉取请求) 将所有权从 obs-service-integrations 重命名为 obs-infraobs-integrations	—
0.6.0	增强 (查看拉取请求) 将会话管理器和Servlet数据流可视化迁移到 Lens。	—
0.5.0	增强 (查看拉取请求) 将线程池数据流可视化迁移到 Lens。	—
0.4.0	增强 (查看拉取请求) 将 JDBC 数据流可视化迁移到 Lens。	—
0.3.1	增强 (查看拉取请求) 添加了类别和/或子类别。	—
0.3.0	增强 (查看拉取请求) 将 ECS 版本更新为 8.5.1	—
0.2.0	增强 (查看拉取请求) 添加了基础设施类别。	—
0.1.1	增强 (查看拉取请求) 带有 session_manager 数据流的 WebSphere Application Server 集成包。增强 (查看拉取请求) 带有线程池数据流的 WebSphere Application Server 集成包。增强 (查看拉取请求) 带有 servlet 数据流的 WebSphere Application Server 集成包。	—
0.1.0	增强 (查看拉取请求) 带有 JDBC 数据流的 WebSphere Application Server 集成包。	—

« WatchGuard Firebox Windows »