第 18 章 日志
AMQ Broker 使用 JBoss Logging 框架进行日志记录，并通过 <broker_instance_dir>/etc/logging.properties 配置文件进行配置。此配置文件是键值对的列表。
您可以在代理配置中指定日志记录器，方法是将它们包含在 logging.properties 配置文件的 loggers 密钥中，如下所示。
loggers=org.eclipse.jetty,org.jboss.logging,org.apache.activemq.artemis.core.server,org.apache.activemq.artemis.utils,org.apache.activemq.artemis.journal,org.apache.activemq.artemis.jms.server,org.apache.activemq.artemis.integration.bootstrap,org.apache.activemq.audit.base,org.apache.activemq.audit.message,org.apache.activemq.audit.resource
下表中显示了 AMQ Broker 中可用的日志记录器。
| 日志记录器 | Description |
|---|---|
| org.jboss.logging | 根日志记录器.记录其他代理日志记录器未处理的所有调用。 |
| org.apache.activemq.artemis.core.server | 记录代理内核 |
| org.apache.activemq.artemis.utils | 日志实用程序调用 |
| org.apache.activemq.artemis.journal | 日志日志调用 |
| org.apache.activemq.artemis.jms | 日志 JMS 调用 |
| org.apache.activemq.artemis.integration.bootstrap | 日志 bootstrap 调用 |
| org.apache.activemq.audit.base | 记录对所有 JMX 对象方法的访问 |
| org.apache.activemq.audit.message | 记录消息操作，如生产、消耗和浏览消息 |
| org.apache.activemq.audit.resource | 从 JMX 或 AMQ Broker 管理控制台记录身份验证事件、创建或删除代理资源，并在管理控制台中浏览消息 |
在 logger.handlers 键中也配置了两个默认的日志记录处理程序，如下所示：
logger.handlers=FILE,CONSOLE
logger.handlers=FILE- 日志记录器将日志条目输出到文件中。
logger.handlers=CONSOLE- 日志记录器将日志条目输出到 AMQ Broker 管理控制台。
18.1. 更改日志级别
所有日志记录器的默认日志记录级别为 INFO，在根日志记录器上配置，如下所示。
logger.level=INFO
您可以单独为所有其他日志记录器配置日志级别，如下所示：
logger.org.apache.activemq.artemis.core.server.level=INFO logger.org.apache.activemq.artemis.journal.level=INFO logger.org.apache.activemq.artemis.utils.level=INFO logger.org.apache.activemq.artemis.jms.level=INFO logger.org.apache.activemq.artemis.integration.bootstrap.level=INFO logger.org.apache.activemq.audit.base.level=INFO logger.org.apache.activemq.audit.message.level=INFO logger.org.apache.activemq.audit.resource.level=INFO
下表中描述了可用的日志记录级别。日志记录级别以升序列出，从最不详细到最不详细的顺序。
| 级别 | Description |
|---|---|
| FATAL | 对于指示关键服务失败的事件，使用 FATAL 日志记录级别。如果服务发出 FATAL 错误，则完全无法执行任何类型的请求。 |
| ERROR | 将 ERROR 日志记录级别用于指示请求中中断的事件或为请求服务的功能。服务应具有 一些 容量，以便在出现此级别的错误时继续服务请求。 |
| WARN | 对于可能指示非关键服务错误的事件，请使用 WARN 日志记录级别。请求预期可重复使用的错误或次要漏洞符合此描述。WARN 和 ERROR 之间的区别是应用开发人员可以做出的。进行此区别的一个简单标准是错误是否需要用户寻求技术支持。如果错误需要技术支持，请将日志级别设置为 ERROR。否则，将级别设置为 WARN。 |
| INFO | 将 INFO 日志记录级别用于服务生命周期事件和其他关键相关信息。给定服务类别的 INFO 级别消息应清楚指明服务所处的状态。 |
| DEBUG | 将 DEBUG 日志级别用于日志消息，这些消息为生命周期事件传达额外信息。使用此日志级别获取面向开发人员的信息或技术支持所需的深度信息。启用 DEBUG 日志记录级别后，JBoss 服务器日志 不应与 服务器请求数量成比例增长。给定服务类别的 DEBUG 和 INFO 级别消息应清楚指明服务所处的状态，以及该服务使用的代理资源、端口、接口和日志文件等。 |
| TRACE |
将 TRACE 日志记录级别用于与请求活动直接关联的日志消息。此类消息不应提交到日志记录器，除非日志记录器类别优先级阈值表示将呈现消息。使用 |
-
INFO是 logger.org.apache.activemq.audit.base、logger.org.apache.activemq.audit.message 和 logger.org.apache.activemq.audit审计日志记录器唯一可用的日志记录级别。.message和 logger.activemq.audit.resource -
为根日志记录器指定的日志记录级别决定了 所有 日志记录器的最详细日志记录级别，即使其他日志记录器在其配置中指定了更详细的日志记录级别。例如，假设
org.apache.activemq.artemis.utils具有指定的DEBUG记录，而根日志记录器org.jboss.logging具有指定的日志记录级别WARN。在这种情况下，两个日志记录器都使用日志记录器的日志记录级别WARN。
