您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
本主题讨论了可用于在 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 地址）或从指定主机（IP 地址）接收的所有数据包，并将信息保存在指定的文件中：
tcpdump -i any -s 0 host <IP address> -w <File name>
其中：
| 参数 | 说明 |
| -i | （接口）指定应从哪个接口捕获数据包。使用“any”的值可捕获所有接口的数据包。 |
| -s | (snarf/snaplen) 指定要捕获的每个数据包的数量。使用值 0（零）可让您捕获整个数据包。 |
| IP 地址 | 是我们想要捕获其数据包的主机的 IP 地址 |
| 文件名 | 是 tcpdump 必须写入到的文件的名称 |
示例
假设您想要捕获消息处理器和后端服务器之间的数据包：
- 登录 Message Processor 计算机。
- 确定后端服务器的 IP 地址（假设 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 对象和类的信息。它们通常非常大，介于几个 100 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)）中查看线程转储。 如需详细了解线程转储的不同部分以及如何解读这些信息，请参阅 线程转储。