현재 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 주소)에서 보내거나 받은 모든 패킷을 캡처하고 정보를 지정된 파일에 저장합니다.
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
tcpdumps 분석
tcpdump 명령어 또는 GUI 기반 도구인 Wireshark를 사용하여 tcpdump를 확인하거나 분석할 수 있습니다.
참조
힙 덤프
힙 덤프는 Java 프로세스의 메모리에 대한 스냅샷입니다. 여기에는 힙 덤프가 수집되는 시점의 힙에 있는 자바 객체 및 클래스에 관한 정보가 포함됩니다. 일반적으로 크기는 몇 100MB에서 몇 GB까지 매우 큽니다.
힙 덤프는 메시지 프로세서와 같은 Java 프로세스가 다음을 표시할 때 매우 유용합니다.
- 높은 메모리 사용량
- OutofMemoryError
Java 프로세스의 힙 덤프 생성
Java는 실행 중인 Java 프로세스의 메모리 통계 또는 힙 덤프를 생성할 수 있는 jmap이라는 유틸리티를 제공합니다.
다음 jmap 명령어를 사용하여 자바 프로세스의 힙 덤프를 생성합니다.
sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>
각 항목의 의미는 다음과 같습니다.
| 매개변수 | 설명 |
| JAVA_HOME | 이 디렉터리는 자바의 설치 디렉터리 |
| 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 프로세스의 모든 스레드 상태에 대한 스냅샷입니다. 각 스레드의 상태에는 스택 트레이스라고 하는 스택의 콘텐츠가 표시됩니다. 일부 스레드는 실행 중인 자바 애플리케이션의 일부가 되고 다른 스레드는 JVM 내부 스레드가 됩니다.
스레드 덤프는 애플리케이션의 각 스레드 활동에 관한 정보를 표시합니다. 이 정보는 다음과 같은 작업에 매우 유용할 수 있습니다.
- CPU 급증, 느린 응답 시간 또는 응답하지 않는 Java 애플리케이션과 같은 문제를 진단합니다.
- 애플리케이션 및 JVM 성능 최적화
스레드 덤프 생성
Java 프로세스의 스레드 덤프는 아래와 같이 jstack 유틸리티를 사용하여 생성할 수 있습니다.
sudo -u apigee <JAVA_HOME>/bin/jstack -l <pid> > <filename>
각 항목의 의미는 다음과 같습니다.
| 매개변수 | 설명 |
| JAVA_HOME | 자바의 설치 디렉터리입니다. |
| 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)과 같은 텍스트 편집기에서 스레드 덤프를 볼 수 있습니다. 스레드 덤프의 여러 섹션과 정보를 해석하는 방법은 Thread Dump를 참조하세요.