您正在查看 Apigee Edge 文档。
转到
Apigee X 文档。 info
本主题讨论了您可用于 排查 Apigee Edge 上的网络和 JVM 相关问题的网络工具、JVM 工具和诊断日志。
TCP/IP 数据包嗅探器 (tcpdump) 实用程序
tcpdump 工具是一款命令行数据包嗅探器工具，可让您 捕获或过滤通过网络接收或传输的 TCP/IP 数据包。它适用于基于 Linux/Unix 的操作系统。 您可以使用 yum 安装此实用程序，如下所示：
yum install tcpdump
tcpdump 工具对于排查网络或 SSL 相关问题非常有用。 例如：
- 502 网关无效错误（由 EOF 异常引起）
- 503 服务不可用错误
- SSL 握手失败
如需排查上述任何问题，您必须先确定发生错误的组件对 。对于 Edge，它可以是以下组件对之一：
- 客户端应用和路由器
- 路由器和消息处理器
- 消息处理器和后端服务器
确定有问题的组件对后，您可以在其中一个或两个组件上使用 tcpdump 捕获网络数据包 。
使用 tcpdump 捕获发送到/接收自特定主机的数据包
使用以下 tcpdump 命令捕获发送到或接收自 指定主机（IP 地址）的所有数据包，并将信息保存在指定文件中：
tcpdump -i any -s 0 host <IP address> -w <File name>
其中：
| 参数 | 说明 |
| -i | （接口）指定应从中捕获数据包的接口。使用 “any”值可以捕获来自所有接口的数据包。 |
| -s | （snarf/snaplen）指定要捕获的每个数据包的数量。使用值 0 （零）可以捕获整个数据包。 |
| IP 地址 | 是要捕获数据包的主机的 IP 地址 |
| 文件名 | 是 tcpdump 必须写入的文件名 |
示例
假设您要捕获消息处理器和后端 服务器之间的数据包：
- 登录消息处理器机器。
- 确定要捕获数据包的后端服务器的 IP 地址（假设为 22.22.22.22） 。
使用以下命令捕获具有特定 IP 地址的主机的网络数据包：
tcpdump -i any -s 0 host 22.22.22.22 -w rmp-123.pcap
如果后端服务器解析为多个 IP 地址，请在 tcpdump 命令中使用后端 服务器的主机名，如下所示：
tcpdump -i any -s 0 host <Hostname> -w rmp-123.pcap
如果有多个后端服务器具有不同的 IP 地址（22.22.22.22、33.33.33.33 和 44.44.44.44），请使用以下 tcpdump 命令：
tcpdump -i any -s 0 host 22.22.22.22 or host 33.33.33.33 or host 44.44.44.44 -w rmp-123.pcap
分析 tcpdump
您可以使用 tcpdump 命令或基于 GUI 的工具 Wireshark 查看或分析 tcpdump。
参考
堆转储
堆转储是 Java 进程内存的快照。 它们包含有关收集堆转储时堆中的 Java 对象和类的信息。它们的大小通常非常大，范围从几百 MB 到几 GB 不等。
当 Java 进程（例如消息处理器）显示以下内容时，堆转储非常有用：
- 内存用量较高
- OutofMemoryError
为 Java 进程生成堆转储
Java 提供了一个名为 jmap 的实用程序，可让您生成正在运行的 Java 进程的内存 统计信息或堆转储。
使用以下 jmap 命令生成 Java 进程的堆转储：
sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>
其中：
| 参数 | 说明 |
| JAVA_HOME | 是 Java 的安装目录 |
| filename | 是将写入堆转储的文件名 |
| pid | 是要捕获其堆转储的 Java 应用的进程 ID |
示例
假设消息处理器 mp-east 的内存用量较高或抛出 OutOfMemory 错误。在 Unix 操作系统上使用 ps 命令确定消息处理器的进程 ID。假设为 24569。
运行 jmap 实用程序，如下所示，以生成堆转储：
sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=mp-east-heapdump.bin 24569
分析堆转储
可以使用 Eclipse MAT（内存分析器工具）分析堆转储，以确定 潜在的内存泄漏或哪些 Java 对象导致内存用量较高。
参考
线程转储
线程转储是正在运行的 Java 进程的所有线程状态的快照。每个线程的状态都通过其堆栈的内容（称为堆栈轨迹）呈现。某些线程将是正在运行的 Java 应用的一部分，而其他线程将是 JVM 内部线程。
线程转储会显示有关每个应用线程活动的信息。 此信息对于以下方面非常有用：
- 诊断问题，例如 CPU 峰值、响应时间缓慢或 Java 应用无响应
- 优化应用和 JVM 性能
生成线程转储
可以使用 jstack 实用程序生成 Java 进程的线程转储，如下所示 ：
sudo -u apigee <JAVA_HOME>/bin/jstack -l <pid> > <filename>
其中：
| 参数 | 说明 |
| JAVA_HOME | 是 Java 的安装目录。 |
| pid | 是要捕获其线程转储的 Java 应用的进程 ID。 |
| filename | 是将写入线程转储的文件名。 |
示例
如需为消息处理器 mp-east 上的进程 ID 37320 生成线程转储，请使用以下命令：
sudo -u apigee <JAVA_HOME>/bin/jstack -l 37320 > /opt/apigee/edge-message-processor/mp-east-threadDump.txt
根据以上示例，进程的线程转储将保存到 /opt/apigee/edge-message-processor/mp-east-threadDump.txt 文件中。
分析线程转储
您可以在任何文本编辑器（例如 vi (Linux)、记事本 (Windows)）中查看线程转储。 如需详细了解线程转储的不同部分以及如何解读 信息，请参阅 线程转储。