在消息处理器上配置堆内存大小

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

Apigee Edge 的消息处理器是基于 Java 的组件，使用 512 MB 的默认堆内存大小。但是，默认的堆内存大小可能并不足以满足 Apigee Edge 上的所有使用场景。您可能需要根据您的流量和处理要求，或解决任何与内存相关的问题，调整消息处理器的堆内存大小。

Java 应用的堆内存大小通过 Java 命令行参数 -Xms（最小堆大小）和 -Xmx（最大堆大小）控制。在 Apigee Edge 消息处理器上，这些设置通过 bin_setenv_min_mem 和 bin_setenv_max_mem 属性进行控制。如需详细了解这些属性，请参阅 修改 Java 内存设置。

本文档介绍如何在 Apigee Edge 的消息处理器上配置堆内存大小。

准备工作

更改消息处理器上的堆内存大小

本部分介绍了如何更改消息处理器上的堆内存大小。最小和最大堆内存可通过消息处理器组件上的 bin_setenv_min_mem 和 bin_setenv_max_mem 属性进行配置。

如需更改消息处理器上的堆内存大小，请执行以下步骤：

  1. 使用编辑器打开消息处理器机器上的 /opt/apigee/customer/application/message-processor.properties 文件。如果该文件尚不存在，则创建该文件。 例如： 
    vi /opt/apigee/customer/application/message-processor.properties
  2. 将以下代码行添加到此文件中： 
    bin_setenv_min_mem=minimum_heap_in_megabytes
bin_setenv_max_mem=maximum_heap_in_megabytes

    例如，如果您要将消息处理器上的最小堆和最大堆分别更改为 1 GB 和 2 GB，请在此文件中添加以下行： 

    bin_setenv_min_mem=1024m
bin_setenv_max_mem=2048m
  3. 保存您的更改。
  4. 请确保此属性文件归 apigee 用户所有。例如： 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. 使用以下命令重启消息处理器： 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. 如果您有多个消息处理器，请在所有消息处理器上重复执行这些步骤。

验证消息处理器上的堆内存大小

本部分介绍如何验证是否已成功修改消息处理器上的堆内存更改。

即使您使用 bin_setenv_min_mem 和 bin_setenv_max_mem 属性在消息处理器上更改了堆内存大小，您也需要验证实际 Java 命令行参数 -Xms 和 -Xmx 已使用新值设置，如下所示：

  1. 使用以下命令搜索命令行参数 -Xms 和 -Xmx 是否已设置为消息处理器的新值： 
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
  2. 如果消息处理器上的堆内存下限和上限已更改，则上一条命令会显示为 -Xms 和 -Xmx 列出的新值。

    在更改消息处理器上的最小堆和最大堆后，上述命令的示例结果如下所示： 

    Xms1024m
Xmx2048m

    请注意，在示例输出中，最小和最大堆的新值已设置。

  3. 如果您仍然看到 -Xms 和 -Xmx 的旧值，请验证是否已正确执行在消息处理器上更改堆内存大小中所述的所有步骤。如果您遗漏了任何步骤，请重新正确重复所有步骤。
  4. 如果您仍无法更改堆内存，请与 Apigee Edge 支持团队联系。

下一步该做什么？