빠른 시작¶
Guance는 클라우드, 클라우드 네이티브, 애플리케이션 및 비즈니스 전반을 아우르는 원스톱 관측 가능성 솔루션을 제공합니다. 서버 상태, 애플리케이션 성능 병목, 실제 사용자 액세스 경험까지 하나의 플랫폼에서 통합 수집, 연관 분석, 실시간 인사이트를 제공합니다. Obsy Copilot, Obsy Agent Teams를 함께 사용하면 이상 발견부터 근본 원인 파악까지 AI 기반 의사 결정 지원을 받아 관측에서 실행까지의 완전한 클로즈드 루프를 구현할 수 있습니다.
Guance는 무료 플랜, 상용 플랜, 배포 플랜의 세 가지 제품 버전을 제공합니다.
무료 플랜: 개인 개발자와 소규모 팀을 대상으로 하며 기본 데이터 수집과 핵심 기능 체험을 지원합니다.
상용 플랜: 실제 운영 환경을 대상으로 하며 전체 기능 스택과 종량제 과금을 제공합니다.
배포 플랜: 프라이빗 환경을 대상으로 하며 로컬 인프라에 Guance 시스템 소프트웨어를 설치해야 합니다.
이 문서는 SaaS 버전(무료 플랜/상용 플랜) 사용자를 대상으로, 수집기 설치부터 첫 번째 모니터링 데이터 확인까지 전체 클로즈드 루프를 빠르게 완료하도록 안내합니다.
배포 플랜을 사용하는 경우 프라이빗 배포 문서를 참조하여 설치 및 구성을 진행하시기 바랍니다.
사전 준비: 가입 및 로그인¶
Guance 계정이 아직 없다면 먼저 Guance 계정 등록을 진행하시기 바랍니다. 가입이 완료되면 계정이 속한 사이트를 선택하여 Guance 콘솔 워크스페이스로 접속합니다.
1단계: DataKit 설치¶
DataKit은 Guance 공식 오픈소스 데이터 수집 클라이언트로, 사용자 서버에 배포되어 호스트 메트릭, 컨테이너 상태, 애플리케이션 로그 등의 데이터를 Guance로 실시간 전송합니다. 설치가 완료되면 DataKit은 기본적으로 여러 기본 수집기를 활성화하므로 별도의 설정 없이 수집을 시작할 수 있습니다.
Guance는 다양한 설치 방식을 지원하며, 실제 환경에 따라 선택할 수 있습니다.
- 호스트 설치: Linux, Windows, macOS 등 운영 체제에서 사용할 수 있습니다.
- 컨테이너 설치: Docker 환경에서 사용할 수 있습니다.
- Kubernetes 설치: K8s 클러스터에서 사용할 수 있으며, Helm 배포를 지원합니다.
- 기타 방법: AWS ECS Fargate, AWS EKS, 오프라인 설치 등이 있습니다.
Guance 콘솔로 이동하여 왼쪽 탐색 모음에서 통합 > DataKit을 클릭하고 운영 체제 유형을 선택한 뒤, 페이지에 제공된 설치 명령을 복사하여 대상 호스트에서 실행합니다. 설치가 성공하면 터미널에 설치 성공 메시지가 표시됩니다.
설치 세부 사항 및 고급 설정은 DataKit 설치 문서를 참조하시기 바랍니다.
2단계: 데이터 전송 확인¶
설치가 완료되면 DataKit은 기본적으로 Linux 호스트에서 자주 사용하는 여러 수집기를 활성화하므로 수동 설정 없이 기본 메트릭 수집을 시작할 수 있습니다. 데이터는 각 수집기의 기본 주기에 따라 워크스페이스로 자동 전송되며, 보통 잠시 후 콘솔에서 확인할 수 있습니다.
수집이 성공했는지 확인하려면 콘솔 > 인프라로 이동하여 호스트 목록에 서버가 나타나는지 확인합니다. 호스트 이름, IP 주소, 상태가 정상적으로 표시되면 DataKit이 성공적으로 연결되어 작동하고 있음을 의미합니다.
호스트 목록에 대상 머신이 나타나지 않으면 다음 사항을 확인하는 것이 좋습니다.
- DataKit 서비스 상태 확인: 호스트에서 DataKit 프로세스가 정상적으로 실행 중인지 확인합니다.
- 네트워크 연결 확인: 서버가 공용 네트워크에 접속할 수 있는지 확인합니다. DataKit은 Guance로 데이터를 전송해야 합니다.
- 워크스페이스 확인: 콘솔의 현재 워크스페이스가 DataKit 설치 시 사용한 token과 일치하는지 확인합니다.
여전히 해결되지 않으면 DataKit 데이터 없음 문제 해결 문서에서 전체 문제 해결 절차를 확인하시기 바랍니다.
3단계: 기본 제공 시각화 뷰 확인¶
데이터가 전송되면 시스템에는 호스트, 컨테이너, 데이터베이스 등 일반적인 사용 사례를 다루는 다양한 시각화 뷰 템플릿이 기본 제공됩니다. 대시보드를 처음부터 만들 필요 없이 템플릿을 선택하고 재사용하기만 하면 시스템 운영 상태를 빠르게 확인할 수 있습니다.
시나리오 > 기본 제공 뷰 > 시스템 뷰로 이동하여 호스트 분류의 뷰 템플릿을 선택하면 CPU 사용률, 메모리 사용량, 디스크 I/O, 네트워크 트래픽 등 핵심 메트릭의 실시간 차트를 확인할 수 있습니다. 해당 템플릿을 새 대시보드 또는 새 사용자 뷰로 직접 생성하여 워크스페이스에 적용할 수 있습니다.
Guance는 인프라, 미들웨어, 애플리케이션 성능, 클라우드 공급업체 등 다양한 영역을 아우르는 시스템 뷰 템플릿을 제공하며, 즉시 사용할 수 있습니다. 시스템 뷰는 직접 편집할 수 없으며, 수정이 필요한 경우 먼저 사용자 뷰로 복제하시기 바랍니다.
자세한 내용은 기본 제공 뷰 및 대시보드 빠른 생성 문서를 참조하시기 바랍니다.
4단계: 모니터링 및 알림 구성¶
데이터가 정상적으로 수집되고 시각화되는 것을 확인한 후에는 핵심 메트릭에 대한 알림 규칙을 구성하여 이상 발생 시 가장 먼저 알림을 받을 수 있도록 하는 것이 좋습니다.
Guance에는 호스트 리소스, 데이터베이스, 네트워크, 애플리케이션 성능 등 일반적인 사용 사례를 다루는 700개 이상의 즉시 사용 가능한 모니터 템플릿이 기본 제공됩니다. 모니터링 > 모니터 > 모니터 생성 > 공식 템플릿 라이브러리로 이동하여 왼쪽 탐지 라이브러리에서 “호스트 탐지 라이브러리”를 선택하고 원하는 탐지 규칙(예: 호스트 CPU 평균 부하 높음)을 선택하면 클릭 한 번으로 모니터를 생성할 수 있습니다.
모니터를 생성한 후에는 알림 정책과 알림 대상 등을 구성해야 합니다. Guance는 이메일, DingTalk, Lark, WeCom, SMS, Webhook 등 다양한 채널로 알림을 전송하여 이상 정보가 적시에 해당 담당자에게 전달되도록 합니다.
모니터 구성과 알림 정책에 대한 자세한 설명은 모니터 사용 시작 문서를 참조하시기 바랍니다.
5단계: 추가 데이터 유형 살펴보기¶
호스트 모니터링의 기본 클로즈드 루프를 완료한 후에는 비즈니스 요구에 따라 추가 데이터 유형을 단계적으로 연동하여 전체 스택 관측 가능성 역량을 구축할 수 있습니다.
| 데이터 유형 | 설명 | 권장 사용 사례 |
|---|---|---|
| 로그 | 애플리케이션 및 시스템 로그를 수집하며 전체 텍스트 검색과 패턴 분석을 지원합니다. | 장애 해결, 감사 추적 |
| 애플리케이션 성능 모니터링(APM) | 분산 애플리케이션 요청 트레이스를 추적하여 성능 병목을 파악합니다. | 마이크로서비스 아키텍처, API 성능 최적화 |
| 실제 사용자 모니터링(RUM) | 실제 사용자 액세스 경험 데이터를 수집합니다. | Web/미니프로그램 성능 최적화 |
| Agent 모니터링 | Agent 요청을 추적하고 전체 애플리케이션 트레이스와 연관 분석하며, 각 생성 작업에서 소비된 Token 수를 측정합니다. | AI 애플리케이션, 대규모 언어 모델 서비스 관리 |
| 보안 모니터링 | CSPM 및 SIEM 기능을 통합하여 자산-구성-동작을 아우르는 보안 모니터링 체계를 구축합니다. | 보안 이벤트 관리, 규정 준수 감사 |
| 클라우드 리소스 통합 | Alibaba Cloud, AWS, Huawei Cloud 등 클라우드 공급업체의 리소스 데이터를 동기화합니다. | 하이브리드 클라우드/멀티 클라우드 통합 모니터링 |
통합 모듈로 이동하면 Guance가 지원하는 모든 데이터 소스와 해당 연동 가이드 문서를 확인할 수 있습니다. 모든 데이터는 연동 후 동일한 워크스페이스에서 연관 분석할 수 있으므로 여러 도구를 번갈아 사용할 필요가 없습니다.
고급: 데이터 조회 및 분석¶
기본 시각화와 알림에 익숙해진 후 더 유연한 데이터 탐색이 필요하면 Guance가 자체 개발한 DQL(Data Query Language) 쿼리 언어를 사용할 수 있습니다. DQL은 시계열 데이터, 로그, 이벤트 등 관측 가능성 데이터를 위해 설계되었으며, 탐색기, 대시보드, 메트릭 분석, 쿼리 도구 등 여러 모듈에서 사용할 수 있습니다.
DQL 구문 및 사용 예시는 DQL 쿼리 언어 문서를 참조하시기 바랍니다.
위 단계를 모두 완료하면 Guance를 사용하여 기본 시스템 모니터링을 수행할 수 있습니다. 특정 기능 모듈을 더 자세히 알아보려면 왼쪽 탐색 모음에서 해당 주제 문서를 확인하거나, 콘솔의 페이지 내 도움말 진입점을 통해 상황에 맞는 안내를 받을 수 있습니다.
자주 묻는 질문¶
DataKit을 설치하면 서버 성능에 영향을 주나요?
DataKit은 기본적으로 리소스 보호 메커니즘을 활성화하여 호스트에 설치할 때 cgroup(Linux)을 통해 CPU 및 메모리 사용량을 제한합니다. 저부하 상황에서 메모리 사용량은 약 100MB이며 CPU 사용량이 낮아 비즈니스 시스템에 미치는 영향이 매우 적습니다. 수집 데이터 양이 많은 경우 datakit.conf에서 [resource_limit] 구성을 조정할 수 있습니다. 컨테이너 또는 Kubernetes 배포 시에는 리소스 제한을 수동으로 구성해야 합니다.
무료 플랜은 정말 영구적으로 무료인가요? 숨은 비용이 있나요?
무료 플랜은 비용이 들지 않지만 사용 할당량(사용자 수, 호스트 수, 모니터 수, 데이터 저장 용량 등)이 제한됩니다. 할당량을 초과하면 Guance는 상용 플랜으로 업그레이드하거나 사용량을 줄이기 전까지 서비스 사용 권한을 일시 중지하거나 제한할 수 있습니다. 무료 플랜은 상용 수준의 기술 지원과 세금 계산서 발행 서비스를 제공하지 않습니다.
특정 호스트 모니터링을 중단하고 싶은데 콘솔에서 어떻게 제거하나요?
해당 호스트에서 DataKit을 중지하거나 제거하면 호스트가 더 이상 데이터를 전송하지 않습니다. 24시간 이상 데이터가 전송되지 않으면 호스트는 목록에서 자동으로 제거됩니다. 호스트 목록은 기본적으로 최근 10분 동안 온라인 상태인 호스트만 표시하며, “온라인 호스트만 표시” 버튼을 클릭하여 현재 활성 호스트를 확인할 수도 있습니다.
호스트 목록에 표시되는 이름이 IP 주소인데 사용자 지정 이름으로 변경할 수 있나요?
네, 가능합니다. DataKit 설치 시 환경 변수 DK_GLOBAL_HOST_TAGS로 호스트 태그(예: host=my-server)를 설정하거나, 설치 후 datakit.conf의 전역 태그 설정을 수정하면 됩니다. 수정 후 콘솔은 설정한 태그에 따라 호스트 이름을 표시합니다.
모니터를 구성할 때 코드나 복잡한 쿼리문을 작성해야 하나요?
아니요, 필요하지 않습니다. Guance는 호스트, 데이터베이스, 네트워크 등 일반적인 사용 사례를 다루는 공식 템플릿 라이브러리를 제공하므로 템플릿을 선택하고 임계값, 알림 채널 등의 파라미터만 조정하면 됩니다. 더 유연한 구성이 필요한 경우에도 시각화 인터페이스에서 탐지 규칙을 직접 지정할 수 있으며 코드를 작성할 필요가 없습니다.
집에 있는 컴퓨터, 가상 머신 또는 Raspberry Pi도 Guance로 모니터링할 수 있나요?
네, 가능합니다. DataKit은 Linux, Windows, macOS 등 다양한 운영 체제를 지원하며, 기기가 공용 네트워크에 접속할 수 있으면 DataKit을 설치하여 Guance에 연결할 수 있습니다. 가상 머신, 클라우드 서버, 물리 서버, 개인 PC 등 모든 환경에 적용할 수 있습니다.
내 데이터는 어디에 저장되나요? 안전한가요?
SaaS 버전(무료 플랜/상용 플랜)의 데이터는 Guance 클라우드 데이터 센터에 업로드되어 저장되며, Guance는 데이터 암호화 전송 및 저장 메커니즘을 제공합니다. 데이터 주권에 대한 엄격한 요구사항이 있는 경우 배포 플랜을 선택하여 데이터를 로컬 인프라에 완전히 보존할 수 있습니다.
무료 플랜 데이터는 얼마나 오래 보존되나요?
무료 플랜의 데이터 보존 기간은 구독 계약에 따라 제한되며, 구체적인 기간은 콘솔 또는 공식 안내를 기준으로 합니다. 더 긴 데이터 보존 기간이나 더 큰 저장 용량이 필요하면 상용 플랜으로 업그레이드할 수 있습니다.






