Apache ActiveMQ Artemis 2.24.0 User Manual

• 语言: 英语
• 格式: .pdf
• 来源: activemq.apache.org

摘要

文档主要介绍了Apache ActiveMQ Artemis 2.24.0版本的用户手册，涵盖了新功能、升级注意事项以及配置细节。主要内容包括审计日志的配置、用户名验证方式的变更、管理上下文的设置、队列创建的改进，以及性能优化和日志管理等。

AI总结

### Apache ActiveMQ Artemis 2.24.0 用户指南总结

#### 1. 概述
Apache ActiveMQ Artemis 是一个高性能、多协议的异步消息系统，支持嵌入式部署和集群。其特点包括：
- **高性能**：支持持久化和非持久化消息，性能卓越。
- **高可用性**：提供自动客户端故障转移，确保零消息丢失或重复。
- **多协议支持**：支持 OpenWire、AMQP 1.0、STOMP 等协议。
- **灵活的集群**：支持负载均衡和地理分布集群。
- **丰富功能**：包括地址/队列自动创建、JMX 集成、审计日志等。

#### 2. 主要功能
- **MQTT 支持**：提供对 MQTT 协议的支持。
- **CLI 工具**：改进了命令行工具，支持服务器启动、停止等操作。
- **资源限制配置**：支持配置资源限制，优化性能和安全性。
- **审计日志**：新增审计日志功能，支持 INFO 级别记录，可配置过滤规则。
- **性能优化**：改进了 `HierarchicalObjectRepository` 的性能，优化了地址和安全设置的存储。

#### 3. 版本更新亮点
##### 2.24.0
- **队列缓存优化**：支持直接将文件读入队列，无需软缓存。
- **MQTT 客户端影响**：CleanSession=1 的 MQTT 3.x 客户端队列变为非持久化。
- **用户名验证机制**：队列用户名基于验证后的用户，而非客户端提交的用户名。

##### 2.13.0
- **管理方法改进**：支持检查地址重复 ID 缓存大小和清除缓存。
- **过期延迟配置**：支持设置最小和最大过期延迟。
- **审计日志优化**：新增审计日志功能，默认过滤 INFO 级别日志。

##### 2.6.0
- **正则表达式支持**：支持使用正则表达式匹配客户端证书。
- **SASL 外部支持**：支持 SASL_EXTERNAL 机制。
- **虚拟主题映射示例**：新增虚拟主题映射和独占队列功能示例。

##### 2.5.0
- **独占消费者**：支持独占消费者。
- **虚拟主题命名**：提供与 ActiveMQ 5.x 相同的虚拟主题命名能力。
- **SSL 证书撤销列表**：支持 SSL 证书撤销列表功能。
- **日志插件**：支持可配置的broker插件，用于记录各种broker事件。

##### 2.4.0
- **JMX 配置改进**：支持通过 XML 配置 JMX，不再依赖系统属性。
- **STOMP 支持**：支持配置 STOMP WebSocket 的最大帧负载长度。
- **HA 配置**：支持通过 JDBC 持久化实现高可用性。
- **角色基于访问控制**：新增对管理对象的角色基于访问控制功能。

#### 4. 安装与使用
- **目录结构**：

  bin/          # 二进制文件和脚本
  examples/    # 示例
  lib/         # 依赖库
  web/         # Web 应用上下文
  user-manual/ # 用户指南

- **创建 Broker 实例**：通过 CLI 工具启动、停止 Broker，并管理地址和队列。

#### 5. 升级注意事项
- **2.24.0 升级**：MQTT 客户端和用户名验证机制可能需要调整。
- **2.13.0 升级**：审计日志默认过滤 INFO 级别，需更新 `logging.properties` 配置。
- **2.6.0 升级**：确保接受器 URL 配置兼容 HornetQ 和 Artemis 1.x 客户端。
- **2.5.0 升级**：需检查 SSL 证书和登录配置。
- **2.4.0 升级**：移除 Jolokia WAR 文件，新增管理 XML 配置。

#### 6. 性能与 HA
- **性能工具**：提供 journal 压缩工具和资源限制配置，优化性能。
- **高可用性**：支持通过 JDBC 持久化实现 HA，并提供自动客户端故障转移。

#### 7. 使用场景
- **企业级应用**：适合需要高性能、高可用性消息队列的场景。
- **嵌入式开发**：支持嵌入式部署，适合对延迟敏感的应用。
- **多协议支持**：适用于需要同时支持多种消息协议的环境。

---

总结：Apache ActiveMQ Artemis 是一个功能丰富、性能卓越的消息系统，支持多种协议和高可用性部署。2.24.0 版本在性能优化、审计日志和 MQTT 支持方面有显著提升，用户在升级时需注意配置调整和潜在的兼容性问题。