Apigee Edge 문서입니다.
Go to the
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 객체 및 클래스에 대한 정보가 포함되어 있습니다. 일반적으로 크기가 매우 크며 100MB에서 몇 GB에 이릅니다.
힙 덤프는 메시지 프로세서와 같은 Java 프로세스에서 다음을 표시할 때 매우 유용합니다.
- 메모리 사용량이 높음
- OutofMemoryError
Java 프로세스의 힙 덤프 생성
Java는 실행 중인 Java 프로세스의 메모리 통계 또는 힙 덤프를 생성할 수 있는 jmap이라는 유틸리티를 제공합니다.
다음 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 (Memory Analyzer Tool)를 사용하여 분석하여 잠재적인 메모리 누수 또는 메모리 사용량이 높은 Java 객체를 확인할 수 있습니다.
참조
스레드 덤프
스레드 덤프는 실행 중인 Java 프로세스의 모든 스레드 상태에 대한 스냅샷입니다. 각 스레드의 상태는 스택 트레이스라고 하는 스택의 콘텐츠와 함께 표시됩니다. 일부 스레드는 실행 중인 Java 애플리케이션의 일부이고 다른 스레드는 JVM 내부 스레드입니다.
스레드 덤프는 각 애플리케이션 스레드 활동에 대한 정보를 보여줍니다. 이 정보는 다음 작업에 매우 유용합니다.
- CPU 급증, 느린 응답 시간, 응답하지 않는 Java 애플리케이션과 같은 문제 진단
- 애플리케이션 및 JVM 성능 최적화
스레드 덤프 생성
Java 프로세스의 스레드 덤프는 아래와 같이 jstack 유틸리티를 사용하여 생성할 수 있습니다.
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)과 같은 텍스트 편집기에서 스레드 덤프를 볼 수 있습니다. 스레드 덤프의 여러 섹션과 정보를 해석하는 방법에 관한 자세한 내용은 스레드 덤프를 참고하세요.