第 7 章 为地址配置最大内存用量

流程

1. 打开 <broker_instance_dir>/etc/broker.xml 配置文件。

2. 在 core 元素内，添加 分页目录 元素。指定文件系统中分页目录的位置。

   <configuration ...>
     <core ...>
       ...
       <paging-directory>/path/to/paging-directory</paging-directory>
       ...
     </core>
   </configuration>

   对于您随后为分页配置的每个地址，代理会在您指定的分页目录中添加一个专用目录。

流程

1. 打开 <broker_instance_dir>/etc/broker.xml 配置文件。

2. 对于您为匹配地址或地址 集 配置的 address-setting 元素，添加配置元素以指定最大内存使用量并定义分页行为。例如：

   <address-settings>
       <address-setting match="my.paged.address">
           ...
           <max-size-bytes>104857600</max-size-bytes>
           <page-size-bytes>10485760</page-size-bytes>
           <address-full-policy>PAGE</address-full-policy>
           ...
       </address-setting>
   </address-settings>

   max-size-bytes

   代理执行为 address-full-policy 指定策略之前，地址允许的最大内存大小，以字节为单位。默认值为 -1，这意味着没有限制。您指定的值还支持字节表示法，如 "K"、"MB" 和 "GB"。

   page-size-bytes

   分页系统中使用的每个页面文件的大小（以字节为单位）。默认值为 10485760 （即 10 MiB）。您指定的值还支持字节表示法，如 "K"、"MB" 和 "GB"。

   address-full-policy

   代理在达到地址最大值时执行的操作。默认值为 PAGE。有效值为：

   页面

   代理将进一步的信息传输到磁盘。

   DROP

   代理会静默丢弃任何进一步的信息。

   FAIL

   代理会向客户端消息制作者丢弃任何其他消息和问题。

   BLOCK

   当客户端消息制作者尝试发送更多消息时，它们会阻止它们。

   以上示例中 未显示 的其他分页配置元素如下所述。

   page-max-cache-size

   代理保留在内存中的页面文件数量，以便在分页导航期间优化 IO。默认值为 5。

   page-sync-timeout

   定期页面同步之间的时间（以纳秒为单位）。如果您使用异步 IO 日志（即 journal-type 在 broker.xml 配置文件中被设置为 ASYNCIO ），则默认值为 3333333。如果您使用标准 Java NIO 日志（即 journal-type 设置为 NIO），则默认值是 journal-buffer-timeout 参数的配置值。

流程

1. 停止代理。

   1. 在 Linux 中：

      <broker_instance_dir>/bin/artemis stop

   2. 在 Windows 中：

      <broker_instance_dir>\bin\artemis-service.exe stop

2. 打开 <broker_instance_dir>/etc/broker.xml 配置文件。

3. 在 core 元素中，添加 global-max-size 元素并指定一个值。例如：

   <configuration>
     <core>
       ...
       <global-max-size>1GB</global-max-size>
       ...
     </core>
   </configuration>

   global-max-size

   代理可用于所有地址的内存总量，以字节为单位。达到这个限制时，对于与传入消息关联的地址，代理会执行指定为 address-full-policy 值的策略。global-max-size 的默认值是托管代理的 Java 虚拟机(JVM)可用的最大内存的一半。

   global-max-size 的值以字节为单位，但也支持字节表示法（例如："K"、"Mb"、"GB"）。

   在前面的示例中，代理被配置为在处理消息时最多使用一千兆字节的可用内存。

4. 启动代理。

   1. 在 Linux 中：

      <broker_instance_dir>/bin/artemis run

   2. 在 Windows 中：

      <broker_instance_dir>\bin\artemis-service.exe start

流程

1. 停止代理。

   1. 在 Linux 中：

      <broker_instance_dir>/bin/artemis stop

   2. 在 Windows 中：

      <broker_instance_dir>\bin\artemis-service.exe stop

2. 打开 <broker_instance_dir>/etc/broker.xml 配置文件。

3. 在 core 元素中添加 max-disk-usage 配置元素并指定一个值。例如：

   <configuration>
     <core>
       ...
       <max-disk-usage>50</max-disk-usage>
       ...
     </core>
   </configuration>

   max-disk-usage

   代理在分页消息时可使用的可用磁盘空间的最大百分比。达到这个限制时，代理会阻止传入的信息，而不是分页它们。默认值为 90。

   在前面的示例中，代理仅在分页消息时使用 50% 的磁盘空间。

4. 启动代理。

   1. 在 Linux 中：

      <broker_instance_dir>/bin/artemis run

   2. 在 Windows 中：

      <broker_instance_dir>\bin\artemis-service.exe start