eBPF 옵저버빌리티: 수집 원리와 실습
Linux eBPF의 훅과 검증기, 권한 및 커널 요구 사항을 설명합니다. DataKit의 네트워크 신호와 OpenTelemetry 계측을 함께 보는 방법도 다룹니다.
API가 느려져도 애플리케이션 로그에는 별다른 이상이 없을 수 있습니다. TCP 재전송, 연결 실패, 왕복 시간을 보면 조사 범위를 좁힐 수 있습니다. 요청을 처리하는 어느 구간에서 시간이 걸렸는지 알려면 애플리케이션의 스팬도 살펴봅니다.
Linux의 eBPF를 사용하면 커널 검사를 통과한 프로그램을 선택한 훅에서 실행할 수 있습니다. 애플리케이션 코드와 바이너리를 그대로 두고 필요한 이벤트를 관찰하는 데 쓸 수 있습니다. eBPF는 패킷 필터였던 기존 BPF(Berkeley Packet Filter)에서 출발했습니다. 이 글에서는 프로브 선택과 신호 해석, 애플리케이션 텔레메트리와 함께 보는 방법을 설명합니다. Linux BPF 시스템 호출(영문)
먼저 알아둘 내용
- 선택한 훅이 실행될 때 eBPF 프로그램이 동작합니다. 로드하기 전에 커널 검증기가 제어 흐름과 메모리 접근 등의 제약을 확인합니다.
- 시스템과 네트워크 프로브는 여러 애플리케이션 언어의 공통 신호를 수집할 수 있습니다. 사용자 공간 프로브는 대상 바이너리와 런타임, 훅에 의존하며 수집에는 자원이 듭니다.
- 애플리케이션 계측은 작업 이름과 비즈니스 컨텍스트를 더할 수 있습니다. OpenTelemetry에도 eBPF 기반 자동 계측 도구인 OBI가 있습니다.
eBPF가 Linux 이벤트를 관찰하는 방식
Linux는 트레이스포인트 같은 기능으로 런타임 이벤트를 노출합니다. eBPF로 이벤트 발생 시점에 필터링하거나 집계하고 필요한 데이터를 내보낼 수 있습니다. 검증기는 프로그램 경로, 레지스터 사용, 메모리 접근을 확인합니다. 유한 루프를 지원하는 커널은 검증기가 종료를 증명할 수 있는 루프를 허용할 수 있습니다. JIT 컴파일 여부는 커널 설정과 아키텍처에 따라 달라집니다. 커널 검증기(영문) · 유한 루프를 추가한 커널 변경(영문) · Linux BPF(영문)
시스템 호출 진입과 종료, 커널 함수의 kprobe, 사용자 공간 함수의 uprobe, 정적 트레이스포인트, 네트워크 경로의 XDP와 TC가 대표적인 훅입니다. 훅마다 얻을 수 있는 정보가 다릅니다. 컨테이너는 노드의 Linux 커널을 사용하고, 권한과 보안 정책이 연결 가능한 범위를 제한합니다. libbpf 개요(영문) · kprobe(영문) · uprobe(영문)
커널 신호가 유용한 경우
- 애플리케이션 변경을 줄입니다. 다시 빌드하기 어려운 서비스라도 필요한 신호가 시스템이나 네트워크 훅에 있으면 수집할 수 있습니다.
- 언어가 달라도 공통 신호를 비교합니다. Java, Go, C++, Rust 서비스는 같은 커널 인터페이스를 사용할 수 있습니다. 사용자 공간 함수나 프로토콜을 분석하려면 런타임, 심볼, 프로토콜에 맞는 수집이 필요합니다.
- 내보내기 전에 집계합니다. BPF 맵에 연결별 바이트를 누적하고 사용자 공간에서 주기적으로 읽을 수 있습니다. 훅이 호출되는 빈도와 프로그램 처리량, 내보내는 데이터가 비용에 영향을 줍니다.
- 요청 처리 바깥을 살핍니다. 적절한 프로브로 TCP 재전송이나 파일 I/O를 관찰할 수 있습니다. 훅이 TLS 암호문만 보는 위치에 있어도 연결 동작은 볼 수 있습니다. HTTP 메서드와 경로를 읽으려면 해당 애플리케이션 계층 데이터에 접근할 수 있어야 합니다.
프로브 하나부터 확인하기
- 도구와 권한을 확인합니다. 승인된 Linux 테스트 호스트를 사용합니다.
bpftool feature probe kernel로 프로그램과 맵 유형, 헬퍼 지원을 확인할 수 있습니다. BCC는 프로브 개발에 쓸 Python 인터페이스를 제공합니다. 로드와 연결에 필요한 추적, 네트워크 등의 권한은 프로그램과 환경에 따라 달라집니다. bpftool 기능 검사(영문) - BCC 튜토리얼의 kprobe를 살펴봅니다.
hello_fields.py는get_syscall_fnname("clone")으로 아키텍처에 맞는 시스템 호출 심볼을 찾고 kprobe를 연결합니다. 심볼이 있는지 확인하고 통제된 작업에서 결과를 관찰합니다. 기록은 실행이 해당 훅에 도달했음을 뜻합니다. 성공한 프로세스 생성 수를 세려면 스레드, 실패한 호출, 다른 생성 경로를 고려해 이벤트를 선택합니다. BCC Python 튜토리얼(영문) - 카운터를 맵에 둡니다. 커널 프로그램과 사용자 공간은 각각의 인터페이스로 BPF 맵에 접근합니다. 연결별 트래픽 합계와 주기적인 읽기부터 시작하고, 수집 범위를 넓히기 전에 맵 용량과 이벤트 손실을 확인합니다.
예시는 공개 문서에 근거합니다. 더 실습하려면 BCC(영문), libbpf-bootstrap(영문), Go용 cilium/ebpf(영문)를 참고할 수 있습니다.
Guance에서는 DataKit의 ebpf-net으로 TCP 연결 통계, RTT, 재전송부터 확인하고 필요에 따라 UDP와 프로토콜 수집을 켭니다. Linux 노드 아키텍처, DataKit 버전, eBPF·kprobe·perf 지원, 문서에 명시된 root 권한을 확인합니다. Kubernetes에서는 지원되는 배포 매니페스트에 따라 호스트 경로 마운트와 권한도 확인합니다. 네트워크 통계와 트레이싱은 설정이 다릅니다. 실험 기능인 ebpf-trace는 별도로 켜고, eBPF 스팬은 ebpftrace 수신기를 켠 DataKit 또는 DataKit ELinker에 보냅니다. 노드 간 스팬을 연결하려면 해당 노드의 스팬을 같은 수신기로 모읍니다. 지원 프로토콜과 관측 범위는 플러그인 및 환경에 따라 달라집니다. DataKit eBPF(영문) · eBPF 트레이싱(영문) · DataKit 배포와 권한(영문)
OpenTelemetry와 함께 쓰기
eBPF는 이벤트를 수집하고 처리하는 기술입니다. OpenTelemetry는 계측과 텔레메트리 규약, 전송 체계를 제공합니다. 두 범위가 겹치는 예가 OpenTelemetry OBI(영문)입니다. OBI는 eBPF를 사용해 지원되는 Linux 워크로드에서 애플리케이션 신호를 수집합니다.
| 항목 | eBPF 수집 | OpenTelemetry 애플리케이션 계측 |
|---|---|---|
| 배포 | 애플리케이션 코드를 그대로 둘 수 있는 경우가 많습니다. Linux 훅과 권한이 필요합니다. | 언어와 도구에 따라 SDK 또는 코드 변경 없는 계측을 선택합니다. |
| 신호 | 시스템 및 네트워크 동작을 관찰합니다. 지원 범위에서 프로토콜도 분석할 수 있습니다. | 설정과 계측에 따라 프레임워크 작업과 사용자 정의 비즈니스 속성을 기록합니다. |
| 언어 범위 | 커널 신호는 여러 언어에서 볼 수 있습니다. 사용자 공간 프로브는 런타임과 심볼에 의존할 수 있습니다. | SDK와 자동 계측마다 지원 언어와 프레임워크가 다릅니다. |
| 활용 | 연결 통계, 네트워크 진단, 런타임 보안입니다. | 요청 트레이스, 비즈니스 컨텍스트, 사용자 정의 메트릭입니다. |
OpenTelemetry로 작업 이름과 비즈니스 컨텍스트를 기록하고, 같은 시간대의 RTT와 재전송, 연결 실패를 eBPF로 확인합니다. 시간대가 겹치면 조사 단서를 얻을 수 있습니다. 개별 요청을 연결하려면 전파되는 트레이스 컨텍스트나 다른 신뢰할 수 있는 식별자가 필요합니다. OpenTelemetry 코드 변경 없는 계측(영문) · 컨텍스트 전파(영문)
자주 묻는 질문
어떤 커널 버전이 필요한가요? 수집기에 필요한 프로그램 유형, 헬퍼, 훅을 실제 커널과 배포판의 백포트에 맞춰 확인합니다. BTF는 타입의 메타데이터입니다. CO-RE는 대상 커널의 타입 정보를 사용해 구조 차이에 대응합니다. 프로그램이 쓰는 기능도 대상 환경에서 지원해야 합니다. BTF(영문) · libbpf와 CO-RE(영문)
오버헤드는 얼마나 되나요? 훅 호출 빈도, 프로그램 처리 내용, 출력량에 따라 달라집니다. 자주 발생하는 이벤트는 필요에 따라 필터링하거나 집계합니다. 대표 부하에서 수집기의 CPU와 메모리, 이벤트 손실, 애플리케이션 지연을 비교합니다.
APM 프로브를 대체할 수 있나요? 일부 eBPF 도구는 지원되는 프로토콜과 런타임에서 애플리케이션 스팬을 만듭니다. 필요한 비즈니스 속성이나 메서드별 시간, 서비스 간 컨텍스트가 부족하면 SDK, Agent 또는 다른 계측을 추가합니다.
보안 모니터링에도 쓸 수 있나요? Tetragon은 eBPF로 런타임을 관찰하고 정책을 적용합니다. Falco는 최신 eBPF 프로브로 커널 이벤트를 수집할 수 있으며 커널 모듈 드라이버도 지원합니다. 배포 조건은 도구와 드라이버에 따라 다릅니다. Tetragon(영문) · Falco 커널 이벤트(영문)
함께 읽기
문서 확인일 2026년 11월 6일.
