16.4. 高级 Undertow 配置


16.4.1. IO 配置

自 PAXWEB-1255 起,可以更改监听器使用的 XNIO worker 和缓冲池的配置。在 undertow.xml 模板中有一个指定某些与 IO 相关参数的默认值的部分:

<!-- Only "default" worker and buffer-pool are supported and can be used to override the default values used by all listeners
    buffer-pool:
     - buffer-size defaults to:
        - when < 64MB of Xmx: 512
        - when < 128MB of Xmx: 1024
        - when >= 128MB of Xmx: 16K - 20
     - direct-buffers defaults to:
        - when < 64MB of Xmx: false
        - when >= 64MB of Xmx: true
    worker:
     - io-threads defaults to Math.max(Runtime.getRuntime().availableProcessors(), 2);
     - task-core-threads and task-max-threads default to io-threads * 8
-->

<!--
<subsystem xmlns="urn:jboss:domain:io:3.0">
    <buffer-pool name="default" buffer-size="16364" direct-buffers="true" />
    <worker name="default" io-threads="8" task-core-threads="64" task-max-threads="64" task-keepalive="60000" />
</subsystem>
-->

可以指定以下 buffer-pool 参数:

buffer-size
指定用于 IO 操作的缓冲区的大小。如果没有指定,大小会根据可用内存计算。
direct-buffers
确定应使用 java.nio.ByteBuffer#allocateDirect 或 java.nio.ByteBuffer#allocate。

可指定以下 worker 参数:

io-threads
为 worker 创建的 I/O 线程数量。如果没有指定,线程数量将设置为 CPU 的数量 2。
task-core-threads
核心任务线程池的线程数量。
task-max-threads
worker 任务线程池的最大线程数量。如果没有指定,则最大线程数被设置为 CPU 340 16 的数量。

16.4.2. worker IO 配置

可以在每个服务或捆绑包的基础上配置 Undertow 线程池及其名称,这有助于从 Hawtio 控制台进行监控并更有效地调试。

在捆绑包蓝图配置文件中(通常存储在 Maven 项目中的 src/main/resources/OSGI-INF/blueprint 目录下),您可以像以下示例所示配置 workerIOName 和 ThreadPool。

例 16.1. httpu:engine-factory 元素带有 workerIOName 和 ThreadPool 配置

<httpu:engine-factory>
    <httpu:engine port="9001">
        <httpu:threadingParameters minThreads="99" maxThreads="777" workerIOThreads="8" workerIOName="WorkerIOTest"/>
    </httpu:engine>
</httpu:engine-factory>

可指定 以下线程参数

minThreads
指定 worker 任务线程池的"core"线程数量。通常,每个 CPU 内核至少应有 10 个。
最大线程数
指定 worker 任务线程池的最大线程数量。

可指定以下 worker 参数:

workerIOThreads
指定为 worker 创建的 I/O 线程数量。若不指定,则会选择一个默认。每个 CPU 内核一个 IO 线程是合理的默认值。
workerIOName
指定 worker 的名称。如果没有指定,将选择默认的 "XNIO-1"。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.