QPID 操作指南

适用于私有云的 Edge 版本 4.53.00 附带 Qpid Broker-J 8.0.6。本页介绍了 Edge for Private Cloud(使用基于 Java 的代理)的 apigee-qpidd 组件的内存和磁盘注意事项。 以下部分仅适用于 Qpid 用例,并说明了如何使用 Apigee 的配置机制调整 Qpid。

Apigee 中的 Qpid

在 Apigee 中,Qpid 主要用于以下两个工作流:

  • 分析
  • 创收

在这两种工作流中,消息处理器都会生成消息,这些消息会汇总为批次并推送到 Qpid。对于 Google Analytics,这些消息由 Qpid 服务器读取;对于创收,这些消息由评分服务器(属于管理服务器)读取。读取后,系统会对分批的消息进行取消批处理和提取。

以下部分介绍了适用于 Qpid 的内存和磁盘的建议配置。这些配置基于 Google Analytics 或 变现。默认批量大小为 50 时,Qpid 中的每条消息大约为 100 KB。Apigee 允许代理修改消息和添加其他信息 (分析或创收)。在极端情况下,这可能会显著改变 Qpid 中的单条消息和整条批处理消息。虽然一般的 即使在这种情况下, 您可能需要对 Qpid 进行其他调整,以确保运行顺畅。

内存

Qpid Broker 使用两种内存:堆外内存和堆内存。Qpid 会将消息存储在非堆内存中,并使用堆内存来执行自己的内部任务、将消息直接发送到队列和交换等。在大多数情况下,Apigee 建议您将 Qpid Broker 的非堆内存与堆内存保持 3:1 的比例。

堆外内存中的消息会保留在磁盘上。此外,如果堆外内存的总利用率超出特定阈值,Qpid 会配置为将消息溢出到磁盘。

默认情况下,Apigee 会根据节点上的可用内存计算 Qpid Broker 的堆内存和非堆内存。对于 Qpid Broker 的堆和 堆外内存如果您想覆盖这些限制,可以使用以下两种配置: 以便设置您自己的 Qpid 堆内存和堆外内存值。

  • 堆内存的配置: bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • 对非堆内存的配置:bin_run-qpidd_qpid.run.jvm.max_direct_memory_size=3072m

如需了解如何替换配置,请参阅如何更改 Qpid 配置

如需了解详情,请参阅 Apache Qpid 内存参考文档

磁盘

Qpid Broker 的数据目录是 $APIGEE_ROOT/data/apigee-qpidd。 Qpid Broker 的日志存储在 $APIGEE_ROOT/var/log/apigee-qpidd 中。

托管数据目录的文件系统的性能是 作为一个整体的经纪人。为获得最佳性能,请选择延迟时间较短且符合以下条件的设备 以供其他应用使用

Qpid Broker 会在数据目录中保留其消息。默认情况下,代理会接受消息,直到托管数据目录的文件系统已满 80% 为止。您可以修改这一 以在每个 Qpid 节点上替换以下示例中显示的配置。

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

在此示例中,当底层文件系统已满 60% 时,代理会拒绝新消息。

如何更改 Qpid 配置

要更改 Qpid 配置,请执行以下操作:

  1. 创建或修改以下文件:
    $APIGEE_ROOT/customer/application/qpidd.properties
  2. 根据需要添加、移除或修改配置。 例如,如需将 Qpid Broker 的最大堆内存更改为 6 GB,请在文件中添加以下配置替换项:
    bin_run-qpidd_qpid.run.jvm.max_vm_heap=6144M
  3. 保存更改,并确保文件归 apigee 用户所有且可以读取:
    chown apigee:apigee $APIGEE_ROOT/customer/application/qpidd.properties
  4. 重启 qpidd 进程:
    apigee-service apigee-qpidd 重启