Metrics API를 통해 제공되는, Kubernetes 자동 확장을 위한 확장 가능한 컨테이너 CPU 및 메모리 리소스 지표 소스입니다.
google/cadvisor
실행 중인 컨테이너의 리소스 사용량과 성능 데이터를 수집·집계·내보내고, 웹 UI와 REST API를 제공하는 Go 데몬입니다.
- 스타
- 19,498
- 포크
- 2,500
- 열린 이슈
- 76
- 마지막 커밋
- 12일 전
어떤 프로젝트인가요?
cAdvisor(Container Advisor)는 컨테이너 사용자가 실행 중인 컨테이너의 리소스 사용량과 성능을 파악할 수 있도록 합니다. 데몬으로 실행되며 각 컨테이너의 리소스 격리 설정, 과거 리소스 사용량, 사용량 히스토그램, 네트워크 통계를 추적합니다. 데이터는 컨테이너별로 또는 머신 전체를 기준으로 확인할 수 있습니다.
cAdvisor는 Docker 컨테이너를 기본 지원하며 다른 컨테이너 유형과도 함께 사용할 수 있도록 설계되었습니다. 컨테이너 추상화는 lmctfy의 모델을 따르기 때문에 컨테이너가 계층적으로 중첩됩니다. 독립 실행형 바이너리, Docker 컨테이너 또는 Kubernetes DaemonSet으로 실행할 수 있습니다.
프로젝트는 지정된 포트에서 웹 UI와 버전이 명시된 원격 REST API를 제공하며, client 디렉터리에는 공식 Go 클라이언트가 있습니다. 통계는 다양한 스토리지 플러그인으로 내보낼 수도 있습니다. 프로젝트에서 밝힌 로드맵에는 성능 조언, 자동 튜닝, 스케줄러를 위한 사용량 예측이 포함되어 있습니다.
핵심 기능
- 01컨테이너별 리소스 격리 설정, 과거 사용량, 네트워크 통계를 수집합니다.
- 02머신 전체 및 컨테이너별 리소스 사용량을 확인할 수 있습니다.
- 03웹 UI를 기본 제공합니다.
- 04버전이 명시된 원격 REST API와 공식 Go 클라이언트를 제공합니다.
- 05다양한 스토리지 플러그인으로 통계를 내보냅니다.
- 06독립 실행형, Docker 또는 Kubernetes DaemonSet으로 실행할 수 있습니다.
활용 사례
- 단일 호스트에서 Docker 컨테이너의 리소스 사용량을 모니터링합니다.
- Kubernetes 클러스터에서 노드별 모니터링 에이전트로 실행합니다.
- 컨테이너 메트릭을 외부 스토리지 또는 모니터링 파이프라인으로 전달합니다.
- 컨테이너의 과거 CPU, 메모리, 네트워크 사용량을 조사합니다.
빠른 시작
- 1
cAdvisor 버전을 최신 릴리스로 설정합니다
VERSION=0.55.1 - 2
Docker 컨테이너에서 cAdvisor를 실행합니다
sudo docker run --volume=/:/rootfs:ro --volume=/var/run:/var/run:ro --volume=/sys:/sys:ro --volume=/var/lib/docker/:/var/lib/docker:ro --volume=/dev/disk/:/dev/disk:ro --publish=8080:8080 --detach=true --name=cadvisor --privileged --device=/dev/kmsg ghcr.io/google/cadvisor:$VERSION - 3
http://localhost:8080에서 웹 UI를 엽니다
사용 전 알아둘 점
- 라이선스가 NOASSERTION으로 표시되어 있어 메타데이터만으로는 이용 조건을 확인할 수 없습니다.
- Docker 빠른 시작을 사용하려면 여러 호스트 디렉터리를 마운트한 권한이 높은 컨테이너가 필요합니다.
- CentOS, Fedora, RHEL 및 LXC 환경에서는 문서에 별도로 설명된 추가 단계가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- cadvisor은(는) 무엇인가요?
- 실행 중인 컨테이너의 리소스 사용량과 성능 데이터를 수집·집계·내보내고, 웹 UI와 REST API를 제공하는 Go 데몬입니다. cAdvisor(Container Advisor)는 컨테이너 사용자가 실행 중인 컨테이너의 리소스 사용량과 성능을 파악할 수 있도록 합니다. 데몬으로 실행되며 각 컨테이너의 리소스 격리 설정, 과거 리소스 사용량, 사용량 히스토그램, 네트워크 통계를 추적합니다. 데이터는 컨테이너별로 또는 머신 전체를 기준으로 확인할 수 있습니다.
- cadvisor은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- cadvisor은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- cadvisor은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. cadvisor의 마지막 커밋은 2026년 10월 12일입니다.
- cadvisor은(는) 어디에 사용할 수 있나요?
- 단일 호스트에서 Docker 컨테이너의 리소스 사용량을 모니터링합니다. Kubernetes 클러스터에서 노드별 모니터링 에이전트로 실행합니다. 컨테이너 메트릭을 외부 스토리지 또는 모니터링 파이프라인으로 전달합니다. 컨테이너의 과거 CPU, 메모리, 네트워크 사용량을 조사합니다.
- cadvisor는 어떻게 설치하나요?
- cAdvisor 버전을 최신 릴리스로 설정합니다: VERSION=0.55.1 Docker 컨테이너에서 cAdvisor를 실행합니다: sudo docker run --volume=/:/rootfs:ro --volume=/var/run:/var/run:ro --volume=/sys:/sys:ro --volume=/var/lib/docker/:/var/lib/docker:ro --volume=/dev/disk/:/dev/disk:ro --publish=8080:8080 --detach=true --name=cadvisor --privileged --device=/dev/kmsg ghcr.io/google/cadvisor:$VERSION http://localhost:8080에서 웹 UI를 엽니다
- cadvisor은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/google/cadvisor
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
초당 메트릭 수집, 자동 탐지, 내장 ML 이상 감지 및 알림 기능을 제공하는 오픈소스 실시간 인프라 모니터링 에이전트입니다.
API 서버를 감시하고 파드, 디플로이먼트, 노드 같은 객체의 상태를 설명하는 Prometheus 메트릭을 제공하는 Kubernetes 애드온 서비스입니다.
Prometheus 통합을 염두에 두고 메트릭, 로그, 트레이스, 프로파일용 프로그래밍 가능한 표현식 기반 파이프라인을 제공하는 OpenTelemetry Collector 배포판입니다.
웹 대시보드, Docker 컨테이너 통계, 과거 데이터와 알림을 제공하는 경량 셀프 호스팅 서버 모니터링 도구입니다.
다양한 데이터 소스의 메트릭, 로그, 트레이스를 조회하고 시각화하며 알림을 설정하고 탐색할 수 있는 오픈소스 플랫폼입니다.