Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

20.2. 命令

Apache Karaf 不是更改 etc/org.ops4j.pax.logging.cfg 文件，而是提供一组命令来动态更改日志配置并查看日志内容：

20.2.1. log:clear
复制链接

log:clear 命令清除日志条目。

20.2.2. log:display
复制链接

log:display 命令显示日志条目。

默认情况下，它显示 rootLogger 的日志条目： 

karaf@root()> log:display
2015-07-01 19:12:46,208 | INFO  | FelixStartLevel  | SecurityUtils                    | 16 - org.apache.sshd.core - 0.12.0 | BouncyCastle not registered, using the default JCE provider
2015-07-01 19:12:47,368 | INFO  | FelixStartLevel  | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Starting JMX OSGi agent
Copy to Clipboard Toggle word wrap

您还可以使用 logger 参数显示来自特定日志记录器 的日志条目 ： 

karaf@root()> log:display ssh
2015-07-01 19:12:46,208 | INFO  | FelixStartLevel  | SecurityUtils                    | 16 - org.apache.sshd.core - 0.12.0 | BouncyCastle not registered, using the default JCE provider
Copy to Clipboard Toggle word wrap

默认情况下，所有日志条目都将显示。如果 Apache Karaf 容器自很长时间以来正在运行，则可能比较长。您可以使用 -n 选项限制要显示的条目数： 

karaf@root()> log:display -n 5
2015-07-01 06:53:24,143 | INFO  | JMX OSGi Agent   | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Registering org.osgi.jmx.framework.BundleStateMBean to MBeanServer com.sun.jmx.mbeanserver.JmxMBeanServer@27cc75cb with name osgi.core:type=bundleState,version=1.7,framework=org.apache.felix.framework,uuid=5335370f-9dee-449f-9b1c-cabe74432ed1
2015-07-01 06:53:24,150 | INFO  | JMX OSGi Agent   | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Registering org.osgi.jmx.framework.PackageStateMBean to MBeanServer com.sun.jmx.mbeanserver.JmxMBeanServer@27cc75cb with name osgi.core:type=packageState,version=1.5,framework=org.apache.felix.framework,uuid=5335370f-9dee-449f-9b1c-cabe74432ed1
2015-07-01 06:53:24,150 | INFO  | JMX OSGi Agent   | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Registering org.osgi.jmx.framework.ServiceStateMBean to MBeanServer com.sun.jmx.mbeanserver.JmxMBeanServer@27cc75cb with name osgi.core:type=serviceState,version=1.7,framework=org.apache.felix.framework,uuid=5335370f-9dee-449f-9b1c-cabe74432ed1
2015-07-01 06:53:24,152 | INFO  | JMX OSGi Agent   | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Registering org.osgi.jmx.framework.wiring.BundleWiringStateMBean to MBeanServer com.sun.jmx.mbeanserver.JmxMBeanServer@27cc75cb with name osgi.core:type=wiringState,version=1.1,framework=org.apache.felix.framework,uuid=5335370f-9dee-449f-9b1c-cabe74432ed1
2015-07-01 06:53:24,501 | INFO  | FelixStartLevel  | RegionsPersistenceImpl           | 78 - org.apache.karaf.region.persist - 4.0.0 | Loading region digraph persistence
Copy to Clipboard Toggle word wrap

您还可以使用 etc/org.apache.karaf.log.cfg 文件中的 size 属性限制存储和保留的条目数量： 

#
# The number of log statements to be displayed using log:display. It also defines the number
# of lines searched for exceptions using log:display exception. You can override this value
# at runtime using -n in log:display.
#
size = 500
Copy to Clipboard Toggle word wrap

默认情况下，每个日志级别都显示不同的颜色： ERROR/FATAL are in red, DEBUG in purple, INFO in cyan 等。您可以使用 --no-color 选项禁用颜色。

日志条目格式模式不使用 etc/org.ops4j.pax.logging.cfg 文件中定义的转换模式。默认情况下，它使用 etc/org.apache.karaf.log.cfg 中定义的 pattern 属性。 

#
# The pattern used to format the log statement when using log:display. This pattern is according
# to the log4j2 layout. You can override this parameter at runtime using log:display with -p.
#
pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
Copy to Clipboard Toggle word wrap

您还可以使用 -p 选项动态更改模式（对于一个执行）： 

karaf@root()> log:display -p "\%d - \%c - \%m\%n"
2015-07-01 07:01:58,007 - org.apache.sshd.common.util.SecurityUtils - BouncyCastle not registered, using the default JCE provider
2015-07-01 07:01:58,725 - org.apache.aries.jmx.core - Starting JMX OSGi agent
2015-07-01 07:01:58,744 - org.apache.aries.jmx.core - Registering MBean with ObjectName [osgi.compendium:service=cm,version=1.3,framework=org.apache.felix.framework,uuid=6361fc65-8df4-4886-b0a6-479df2d61c83] for service with service.id [13]
2015-07-01 07:01:58,747 - org.apache.aries.jmx.core - Registering org.osgi.jmx.service.cm.ConfigurationAdminMBean to MBeanServer com.sun.jmx.mbeanserver.JmxMBeanServer@27cc75cb with name osgi.compendium:service=cm,version=1.3,framework=org.apache.felix.framework,uuid=6361fc65-8df4-4886-b0a6-479df2d61c83
Copy to Clipboard Toggle word wrap

模式是一个常规的 Log4j2 模式，您可以使用关键字，如 %d 作为日期，%c 用于类，%m 用于日志消息等。

20.2.3. log:exception-display
复制链接

log:exception-display 命令显示最后发生的异常。

对于 log:display 命令，log:exception-display 命令默认使用 rootLogger，但您可以使用 logger 参数指定 日志记录器。

20.2.4. log:get
复制链接

log:get 命令显示日志记录器的当前日志级别。

默认情况下，显示的日志级别是根日志记录器中的日志级别： 

karaf@root()> log:get
Logger                              │ Level
────────────────────────────────────┼──────
ROOT                                │ INFO
org.apache.aries.spifly             │ WARN
org.apache.karaf.jaas.modules.audit │ INFO
org.apache.sshd                     │ INFO
Copy to Clipboard Toggle word wrap

您可以使用 logger 参数指定特定的 日志记录器 ： 

karaf@root()> log:get ssh
INFO
Copy to Clipboard Toggle word wrap

logger 参数接受 ALL 关键字，以显示所有日志记录器的日志级别（作为列表）。

例如，如果您在 etc/org.ops4j.pax.logging.cfg 文件中定义了自己的日志记录器，如下所示： 

log4j2.logger.my.name = MyLogger
log4j2.logger.my.level = DEBUG
Copy to Clipboard Toggle word wrap

您可以查看带有对应日志级别的日志记录器列表： 

karaf@root()> log:get ALL
Logger                              │ Level
────────────────────────────────────┼──────
MyLogger                            │ DEBUG
ROOT                                │ INFO
org.apache.aries.spifly             │ WARN
org.apache.karaf.jaas.modules.audit │ INFO
org.apache.sshd                     │ INFO
Copy to Clipboard Toggle word wrap

log:list 命令是 log:get ALL 的别名。

20.2.5. log:log
复制链接

log:log 命令允许您在日志中手动添加消息。创建 Apache Karaf 脚本时很有趣： 

karaf@root()> log:log "Hello World"
karaf@root()> log:display
12:55:21.706 INFO [pipe-log:log "Hello World"] Hello World
Copy to Clipboard Toggle word wrap

默认情况下，日志级别为 INFO，但您可以使用 -l 选项指定不同的日志级别： 

karaf@root()> log:clear
karaf@root()> log:log -l ERROR "Hello World"
karaf@root()> log:display
12:55:41.460 ERROR [pipe-log:log "Hello World"] Hello World
Copy to Clipboard Toggle word wrap

20.2.6. log:set
复制链接

log:set 命令设置日志记录器的日志级别。

默认情况下，它会更改 rootLogger 的日志级别： 

karaf@root()> log:set DEBUG
karaf@root()> log:get
Logger                              │ Level
────────────────────────────────────┼──────
ROOT                                │ DEBUG
...
Copy to Clipboard Toggle word wrap

您可以在 级别 后面使用 logger 参数指定特定的日志记录器： 

karaf@root()> log:set INFO my.logger
karaf@root()> log:get my.logger
Logger    | Level
-----------------
my.logger | INFO
Copy to Clipboard Toggle word wrap

level 参数接受任何 Log4j2 日志级别：TRACE, DEBUG, INFO, WARN, ERROR, FATAL。

通过它，它还接受 DEFAULT 特殊关键字。

DEFAULT 关键字的目的是删除日志记录器的当前级别（并且仅级别，其他属性（如 appender ）不会被删除，以使用日志记录器父级级别（日志记录器是分级）。

例如，您定义了以下日志记录器（在 etc/org.ops4j.pax.logging.cfg 文件中）： 

rootLogger=INFO,out,osgi:*
my.logger=INFO,appender1
my.logger.custom=DEBUG,appender2
Copy to Clipboard Toggle word wrap

您可以更改 my.logger.custom 日志记录器的级别： 

karaf@root()> log:set INFO my.logger.custom
Copy to Clipboard Toggle word wrap

现在，我们有： 

rootLogger=INFO,out,osgi:*
my.logger=INFO,appender1
my.logger.custom=INFO,appender2
Copy to Clipboard Toggle word wrap

您可以使用 my.logger.custom 日志记录器上的 DEFAULT 关键字来删除级别： 

karaf@root()> log:set DEFAULT my.logger.custom
Copy to Clipboard Toggle word wrap

现在，我们有： 

rootLogger=INFO,out,osgi:*
my.logger=INFO,appender1
my.logger.custom=appender2
Copy to Clipboard Toggle word wrap

这意味着，在运行时，my.logger.custom 日志记录器使用其父 my.logger 的级别，因此 INFO。

现在，如果我们将 DEFAULT 关键字与 my.logger 日志记录器一起使用： 

karaf@root()> log:set DEFAULT my.logger
Copy to Clipboard Toggle word wrap

我们有： 

rootLogger=INFO,out,osgi:*
my.logger=appender1
my.logger.custom=appender2
Copy to Clipboard Toggle word wrap

因此，my.logger.custom 和 my.logger 使用父 rootLogger 的日志级别。

无法将 DEFAULT 关键字与 rootLogger 一起使用，且没有父项。

20.2.7. log:tail
复制链接

log:tail 与 log:display 完全相同，但它持续显示日志条目。

您可以使用与 log:display 命令相同的选项和参数。

默认情况下，它显示 rootLogger 中的条目： 

karaf@root()> log:tail
2015-07-01 07:40:28,152 | INFO  | FelixStartLevel  | SecurityUtils                    | 16 - org.apache.sshd.core - 0.9.0 | BouncyCastle not registered, using the default JCE provider
2015-07-01 07:40:28,909 | INFO  | FelixStartLevel  | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Starting JMX OSGi agent
2015-07-01 07:40:28,928 | INFO  | FelixStartLevel  | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Registering MBean with ObjectName [osgi.compendium:service=cm,version=1.3,framework=org.apache.felix.framework,uuid=b44a44b7-41cd-498f-936d-3b12d7aafa7b] for service with service.id [13]
2015-07-01 07:40:28,936 | INFO  | JMX OSGi Agent   | core                             | 68 - org.apache.aries.jmx.core - 1.1.1 | Registering org.osgi.jmx.service.cm.ConfigurationAdminMBean to MBeanServer com.sun.jmx.mbeanserver.JmxMBeanServer@27cc75cb with name osgi.compendium:service=cm,version=1.3,framework=org.apache.felix.framework,uuid=b44a44b7-41cd-498f-936d-3b12d7aafa7b
Copy to Clipboard Toggle word wrap

要从 log:tail 命令退出，只需键入 CTRL-C。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat