빠른 시작¶

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 설치 시 사용한 토큰과 일치하는지 확인합니다.

문제가 지속되면 DataKit 데이터 없음 문제 해결에서 전체 문제 해결 절차를 확인하십시오.

3단계: 내장 시각화 뷰 확인¶

데이터가 업로드되면 시스템이 호스트, 컨테이너, 데이터베이스 등 일반적인 시나리오를 포괄하는 일련의 내장 시각화 뷰 템플릿을 제공합니다. 대시보드를 처음부터 구축할 필요 없이 이러한 템플릿을 선택하여 재사용하면 시스템 실행 상태를 빠르게 확인할 수 있습니다.

시나리오 > 내장 뷰 > 시스템 뷰로 이동하여 호스트 카테고리 아래의 뷰 템플릿을 선택하면 CPU 사용률, 메모리 점유율, 디스크 I/O, 네트워크 트래픽 등 주요 메트릭의 실시간 차트를 볼 수 있습니다. 새 대시보드 또는 새 사용자 뷰로 직접 생성하여 템플릿을 워크스페이스에 적용할 수 있습니다.

Guance는 인프라, 미들웨어, 애플리케이션 성능, 클라우드 공급업체 등 여러 영역을 포괄하는 시스템 뷰 템플릿을 즉시 사용 가능한 형태로 제공합니다. 시스템 뷰는 직접 편집할 수 없으며, 수정이 필요하면 먼저 사용자 뷰로 복제하십시오.

자세한 내용은 내장 뷰 및 대시보드 빠른 생성을 참조하십시오.

4단계: 모니터링 및 알림 설정¶

데이터가 정상적으로 수집되고 시각화된 것을 확인한 후에는 주요 메트릭에 대한 알림 규칙을 구성하여 이상 징후 발생 시 즉시 알림을 받을 수 있도록 하는 것이 좋습니다.

Guance는 호스트 리소스, 데이터베이스, 네트워크, 애플리케이션 성능 등 일반적인 시나리오를 포괄하는 700개 이상의 즉시 사용 가능한 모니터 템플릿을 내장하고 있습니다. 모니터링 > 모니터 > 새 모니터 > 공식 템플릿 라이브러리로 이동하여 왼쪽 검사 라이브러리에서 "호스트 검사 라이브러리"를 선택하고 원하는 검사 규칙(예: 호스트 CPU 평균 부하 과다)을 선택하면 원클릭으로 모니터를 생성할 수 있습니다.

모니터를 생성한 후에는 알림 정책 및 알림 대상 등을 구성해야 합니다. Guance는 이메일, DingTalk, Lark, WeCom, SMS, Webhook 등 다양한 채널을 통한 알림 발송을 지원하여 이상 정보가 적시에 해당 담당자에게 전달되도록 합니다.

모니터 구성 및 알림 정책에 대한 자세한 설명은 모니터 시작하기를 참조하십시오.

5단계: 더 많은 데이터 유형 탐색¶

호스트 모니터링의 기본 사이클을 완료한 후에는 비즈니스 요구에 따라 점진적으로 더 많은 데이터 유형을 통합하여 전체 스택 관측 가능성을 구축할 수 있습니다:

데이터 유형	설명	권장 시나리오
로그	애플리케이션 및 시스템 로그 수집, 전체 텍스트 검색 및 패턴 분석 지원	장애 해결, 감사 추적
애플리케이션 성능 모니터링(APM)	분산 애플리케이션 요청 링크 추적, 성능 병목 지점 파악	마이크로서비스 아키텍처, API 성능 최적화
실제 사용자 모니터링(RUM)	실제 사용자 경험 데이터 수집	웹/미니 프로그램 성능 최적화
Agent 모니터링	Agent 요청과 전체 애플리케이션 링크를 연관 추적, 각 생성 작업에서 소비된 토큰 수 계량	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는 공식 템플릿 라이브러리를 제공하여 호스트, 데이터베이스, 네트워크 등 일반적인 시나리오를 포괄합니다. 템플릿을 선택하고 임계값, 알림 채널 등의 매개변수만 조정하면 됩니다. 더 유연한 구성이 필요하다면 시각적 인터페이스를 통해 사용자 정의 검사 규칙을 설정할 수 있으며, 코드를 작성할 필요가 없습니다.

집에 있는 PC, 가상 머신 또는 라즈베리 파이를 Guance로 모니터링할 수 있나요?

네. DataKit은 Linux, Windows, macOS 등 다양한 운영 체제를 지원하며, 기기가 퍼블릭 네트워크에 액세스할 수만 있으면 DataKit을 설치하여 Guance에 연결할 수 있습니다. 가상 머신, 클라우드 서버, 물리 서버, 개인 PC 등 모든 환경에서 사용 가능합니다.

내 데이터는 어디에 저장되며 안전한가요?

SaaS 버전(무료 플랜/상용 플랜)의 데이터는 Guance 클라우드 데이터 센터에 업로드 및 저장되며, Guance는 데이터 암호화 전송 및 저장 메커니즘을 제공합니다. 데이터 주권에 대한 엄격한 요구 사항이 있는 경우 배포 플랜을 선택하여 데이터를 로컬 인프라에 완전히 보관할 수 있습니다.

무료 플랜의 데이터는 얼마나 오래 보존되나요?

무료 플랜의 데이터 보존 기간은 구독 계약에 따라 제한되며, 구체적인 기간은 콘솔 또는 공식 설명을 참조하십시오. 더 긴 데이터 보존 기간이나 더 큰 저장 용량이 필요한 경우 상용 플랜으로 업그레이드할 수 있습니다.