监控您的 Metabase
诊断与性能相关的问题可能是一个挑战。幸运的是,JVM 附带的工具可以帮助诊断许多常见问题。启用 JMX 并使用 VisualVM 等工具可以帮助诊断与内存不足、Metabase 停滞或响应时间慢相关的问题。
本指南假设您已在本地安装 VisualVM 工具。VisualVM 包含在 OpenJDK 和 Oracle JDK 中。您可以在 JDK 安装的 bin
目录中找到 VisualJVM。某些 Linux 发行版将 VisualVM 与 JDK 分开,在这种情况下,它是一个独立的 visualvm
包。
连接到本地 Metabase
如果您已在 Metabase 服务器上安装 VisualVM 并且能够在其中运行 VisualVM,这是最简单的方法,因为无需设置与 Metabase 实例的远程通信。在这种情况下,像往常一样启动 Metabase,然后单独启动 VisualVM。
连接到远程 Metabase
监控远程 Metabase 实例(或在 docker 容器中运行的本地实例)可能更常见,但需要更多设置。首先,我们需要指定一些系统属性,让 JVM 知道我们希望允许远程监控。假设我们使用 java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar
运行 Metabase,我们需要将调用更改为以下命令,其中包含这些属性:
java --add-to-start=jmx,jmx-remote \
-Dcom.sun.management.jmxremote \
-Dcom.sun.management.jmxremote.port=1099 \
-Dcom.sun.management.jmxremote.rmi.port=1099 \
-Dcom.sun.management.jmxremote.authenticate=false \
-Dcom.sun.management.jmxremote.ssl=false \
-Dcom.sun.management.jmxremote.local.only=false \
-Djava.rmi.server.hostname=<Metabase Hostname> \
-jar metabase.jar
端口 1099
是典型的 RMI/JMX 端口,但它可以是任何可访问的端口。
上述命令将您的应用程序开放给任何人进行监控,应仅在受信任的网络上短期使用。此连接的安全性是可行的,请参阅 Oracle 文档。
如果您在 docker
容器中运行 Metabase,您需要指定上述系统属性,并且还需要确保端口已打开。Docker 允许通过单独的文件指定环境变量,该文件可以传递到 docker run
调用中。您可以创建一个名为 metabase-vars.env
的文件,其中指定 JAVA_OPTS
:
JAVA_OPTS=-Dcom.sun.management.jmxremote.port=1099 -Dcom.sun.management.jmxremote.rmi.port=1099 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.local.only=false -Djava.rmi.server.hostname=<Metabase Hostname>
此文件要求每个环境变量独占一行,不能有换行符
docker run --env-file=metabase-vars.env -d -p 3000:3000 -p 1099:1099 -h <Metabase Hostname> --name metabase metabase/metabase
添加 -p 1099:1099
会打开 JMX 端口进行监控,而 --env-file=metabase-vars.env
会传入与 JMX 相关的额外环境变量。实例启动后,VisualVM 需要知道如何连接到正在运行的实例。首先添加一个新的远程实例
然后使用您上面指定的主机名
您的本地机器必须能够引用您指定的主机名(这可能需要一个 hosts 条目)
如果您正在使用 Docker,为 JMX 主机指定的端口需要与系统属性和暴露的端口匹配
接下来打开新的远程 JMX 进程
运行时信息
连接到运行中的 Metabase 并使用 VisualVM 可获得大量运行时信息。以下是一些亮点:
堆转储
当遇到内存相关问题时,通常第一个要问的问题是:什么占用了额外的内存?堆转储将拍摄该特定时间点内存中所有内容的快照。该内存快照可以稍后通过 Eclipse 内存分析器工具等工具进行分析。从“监控”选项卡创建堆转储
线程转储
正在运行的 Metabase 系统的另一个有用视图是线程转储。在 Metabase 似乎停滞或极其缓慢的情况下,线程转储将指示每个线程在该特定时间点正在执行(或被阻塞)什么。通过“线程”选项卡收集线程转储
延伸阅读
阅读其他版本的 Metabase 的文档。