hengyoush/kyanosKyanos is a networking analysis tool using eBPF. It can visualize the time packets spend in the kernel, capture requests/responses, makes troubleshooting more efficient.
简体中文 | English
Kyanos는 eBPF 기반 네트워크 문제 분석 도구로, HTTP, Redis, MySQL, Kafka, MongoDB, RocketMQ, DNS 요청과 같은 네트워크 요청을 캡처할 수 있습니다. 또한 비정상적인 네트워크 문제를 분석하고 패킷 캡처, 다운로드, 분석의 복잡한 단계 없이 신속하게 문제를 해결할 수 있도록 도와줍니다.
# PID로 필터링
./kyanos watch --pids 1234
# 컨테이너 ID로 필터링
./kyanos watch --container-id abc
# Redis 키로 필터링
./kyanos watch redis --keys my-key1,my-key2
# 응답 바이트 크기로 필터링
./kyanos watch --resp-size 10000
고급 분석 기능: tcpdump가 세분화된 패킷 캡처만 제공하는 것과 달리, Kyanos는 캡처된 패킷 메트릭을 다양한 차원으로 집계하여 문제 해결에 가장 유용한 핵심 데이터를 신속하게 제공합니다.
HTTP 서비스의 대역폭이 갑자기 최대치에 도달했다고 상상해보세요. 어떤 IP와 어떤 요청이 원인인지 어떻게 빨리 분석할 수 있을까요?
Kyanos를 사용하면 단 하나의 명령어인 kyanos stat http --bigresp 만으로 원격 IP로 전송된 가장 큰 응답 바이트 크기를 찾고, 요청 및 응답 메트릭에 대한 구체적인 데이터를 확인할 수 있습니다.
심층 커널 수준 지연 상세 정보: 실제 환경에서는 Redis와 같은 원격 서비스에 대한 느린 쿼리를 정확히 진단하기 어려운 경우가 많습니다. Kyanos는 요청/응답이 네트워크 카드에 도착하여 커널 소켓 버퍼에 도달할 때까지의 커널 추적 지점을 제공하며, 이러한 세부 정보를 시각적 형식으로 표시합니다. 이를 통해 지연을 유발하는 정확한 단계를 식별할 수 있습니다.
가볍고 의존성 없음: 거의 제로 의존성으로 단일 바이너리 파일과 하나의 명령어만 있으면 되며, 모든 결과가 명령줄에 표시됩니다.
자동 SSL 트래픽 복호화: 캡처된 모든 요청과 응답이 평문으로 표시됩니다.
지연 상세 정보와 함께 HTTP 트래픽 캡처
명령어 실행:
./kyanos watch http
결과는 다음과 같습니다:
지연 상세 정보와 함께 Redis 트래픽 캡처
명령어 실행:
./kyanos watch redis
결과는 다음과 같습니다:
지난 5초 동안 가장 느린 요청 식별
명령어 실행:
./kyanos stat --slow --time 5
결과는 다음과 같습니다:
Kyanos는 현재 커널 버전 3.10(3.10.0-957부터) 및 4.14 이상을 지원합니다 (향후 4.7에서 4.14 사이 버전도 지원할 예정입니다).
커널 버전은
uname -r명령어로 확인할 수 있습니다.
릴리즈 페이지에서 amd64 및 arm64 아키텍처와 호환되는 정적으로 링크된 바이너리를 다운로드할 수 있습니다:
tar xvf kyanos_vx.x.x_linux_amd64.tar.gz
그런 다음 루트 권한으로 kyanos를 실행합니다:
sudo ./kyanos watch
다음과 같은 테이블이 나타나면:
🎉
축하합니다! Kyanos가 성공적으로 시작되었습니다.
가장 간단한 사용법은 Kyanos가 현재 지원하는 모든 프로토콜을 캡처하는 것입니다:
sudo ./kyanos watch
각 요청-응답 레코드는 테이블의 행으로 저장되며, 각 열은 해당 요청의 기본 정보를 캡처합니다. 화살표 키나 j/k를 사용하여 레코드를 위아래로 이동할 수 있습니다:
Enter 키를 눌러 상세 보기에 액세스합니다:
상세 보기에서 첫 번째 섹션은 지연 상세 정보를 보여줍니다. 각 블록은 데이터 패킷이 통과하는 "노드"(예: 프로세스, 네트워크 카드, 소켓 버퍼)를 나타냅니다.
각 블록에는 이전 노드에서 현재 노드까지의 경과 시간을 나타내는 시간 값이 포함되어 있으며, 프로세스가 요청을 전송하여 네트워크 카드에 도달하고, 응답이 소켓 버퍼에 복사된 후 프로세스가 읽을 때까지의 각 단계 지속 시간을 보여줍니다.
두 번째 섹션은 요청 및 응답 상세 내용을 제공하며, 요청과 응답 부분으로 나뉘고 1024바이트가 넘는 내용은 잘립니다.
특정 트래픽을 캡처하려면(예: HTTP 트래픽):
./kyanos watch http
특정 HTTP 경로의 트래픽으로 더 좁힐 수도 있습니다:
./kyanos watch http --path /abc
더 알아보기: Kyanos Docs
[!IMPORTANT]
도구 사용 중 문제나 버그가 발생하면 이슈 트래커에 자유롭게 질문해 주세요.
kyanos 개발 과정에서 다음 프로젝트의 코드 일부를 참고하였습니다:
더 자세한 문의는 다음 연락 방법을 사용하실 수 있습니다: