통합 카탈로그¶
통합 카탈로그(Unified Catalog)는 Guance의 자산 관리 센터로, 기업 내 시스템 서비스, 클라우드 리소스 및 인프라 엔터티를 중앙에서 관리합니다. 자동화된 자산 수집, 유연한 유형 확장 및 시각화된 관계 토폴로지를 통해 사용자가 완전한 자산 라이프사이클 관리 체계를 구축하고, 자산과 관측 가능성 데이터의 심층적인 연동을 실현할 수 있도록 지원합니다.
핵심 기능¶
1. 다중 채널 자산 연동
자동 발견, DataKit 보고, 클라우드 자산 수집, YAML 선언의 네 가지 데이터 소스를 지원하며, 서비스, 호스트, 데이터베이스, 클라우드 리소스 등 다양한 유형의 엔터티를 포괄합니다.
2. 유연한 유형 확장
시스템, 서비스, 호스트, 데이터베이스, 클라우드 리소스의 다섯 가지 표준 엔터티 유형이 사전 설정되어 있으며, 사용자 정의 확장을 지원하여 기업의 개별화된 자산 관리 요구에 적응합니다.
3. 동적 자산 관리
엔터티 목록은 유형에 따라 동적으로 열 정의를 렌더링하고, 표시 필드를 사용자 정의하며, CSV 파일로 일괄 내보내기를 지원합니다. 또한 엔터티 수 통계 및 빠른 추가 기능을 제공합니다.
4. 관계 토폴로지 분석
호출 체인 및 종속 관계를 기반으로 엔터티 토폴로지를 구축하며, 종속 뷰(호출 및 포함 관계 표시)와 계층 뷰(귀속 관계 표시)의 이중 관점 분석 및 전체 아키텍처 토폴로지의 시각화를 지원합니다.
5. 자산과 관측 연동
엔터티 상세 페이지는 로그, 트레이스, 이벤트, 메트릭 등 관측 가능성 데이터를 자동으로 연결하여 자산 정보에서 운영 데이터로의 빠른 이동 및 장애 위치 파악을 실현합니다.
데이터 소스¶
통합 카탈로그는 네 가지 엔터티 데이터 소스를 지원하며, 자동화된 수집과 수동 입력 시나리오를 포괄합니다:
| 소스 방식 | 수집 메커니즘 | 적용 사례 |
|---|---|---|
| 자동 발견 | APM 트레이스 Span을 통해 Service 및 호출 관계 자동 추론 | 마이크로서비스 아키텍처의 서비스 발견 |
| DataKit 보고 | 호스트 또는 K8s에 배포된 DataKit Agent가 직접 수집하여 보고 | 인프라 관리 |
| 클라우드 자산 수집 | AWS, Alibaba Cloud 등 클라우드 제공업체 API를 정기적으로 동기화하여 RDS, S3, ECS 등의 메타데이터 획득 | 멀티 클라우드 리소스 통합 관리 |
| YAML 선언 | 코드 저장소의 catalog-info.yaml 파일을 통해 선언(GitOps) |
개발 프로세스 통합 자산 관리 |
기능¶
통합 카탈로그는 자산 등록부터 관계 분석까지의 전체 라이프사이클 관리를 지원하는 다음 기능으로 구성됩니다:
| 모듈 | 기능 설명 |
|---|---|
| 엔터티 목록 | 자산 메인 목록, 동적 열 표시, 사용자 정의 표시 항목, CSV 내보내기, 엔터티 CRUD 및 빠른 추가 지원 |
| 엔터티 유형 관리 | 사전 설정 유형 및 사용자 정의 유형 관리, 연결된 뷰(내장 뷰 및 탐색기) 및 아이콘 표시 연동 |
| 토폴로지 뷰 | 워크스페이스 내 엔터티 전체 아키텍처 맵 자동 생성, 필터링, 그룹 표시, 검색 하이라이트 및 뷰 저장 지원 |
| 엔터티 상세 | 슬라이드 패널로 엔터티 메타데이터, 연락처, 외부 링크, 관계 토폴로지(종속/계층) 및 연관된 관측 데이터 표시 |
핵심 개념¶
엔터티(Entity)¶
통합 카탈로그의 최소 관리 단위로, 특정 시스템, 서비스, 호스트, 데이터베이스 또는 클라우드 리소스 인스턴스를 나타냅니다. 각 엔터티는 고유한 유형 식별자와 이름을 가지며, 상세 페이지를 통해 전체 메타데이터, 관계 그래프 및 연관된 관측 데이터를 확인할 수 있습니다.
엔터티 간에는 두 가지 연결 방식을 지원합니다:
-
호출 관계: 서비스 간의 호출 종속성을 나타내며, 업스트림 엔터티가 다운스트림 엔터티를 호출합니다.
-
포함 관계: 계층적 귀속을 나타내며, 하위 엔터티가 상위 엔터티에 속합니다.
엔터티 유형(Entity Type)¶
엔터티를 분류하기 위한 정의 템플릿으로, 엔터티의 속성 필드와 표시 방식을 결정합니다. 시스템, 서비스, 호스트, 데이터베이스 등 표준 유형이 사전 설정되어 있으며, 사용자 정의 확장을 지원합니다. 각 유형은 로그, 트레이스, 이벤트 등의 탐색기를 포함한 내장 뷰 등 통합된 연결 뷰를 구성할 수 있습니다.