노트¶

노트는 Guance에 내장된 구조화된 지식 저장소로, 관측 가능성 시나리오에 특화되어 장애 분석, 성능 조사 과정에서 발생하는 핵심 정보를 축적하도록 설계되었습니다. 노트는 본문에 실시간 데이터 차트를 직접 삽입할 수 있어 기록된 내용이 항상 시스템의 실제 상태와 연동되도록 하며, 워크스페이스 멤버와 공유할 수 있어 문제의 회고, 위치 파악 및 협업 처리에 도움을 줍니다.

노트 생성¶

노트로 이동하여 노트 생성을 클릭하고 노트 제목을 정의한 후 편집을 시작합니다. 노트 본문은 Markdown 형식을 지원하며, 필요에 따라 텍스트 또는 Chart Block 차트를 삽입할 수 있습니다. 편집이 완료되면 오른쪽 상단의 미리보기를 클릭하여 미리보기 모드로 전환하면 Chart Block이 실시간으로 대화형 차트로 렌더링됩니다.

자세한 내용은 노트 생성/편집을 참조하세요.

핵심 기능¶

구조화된 기록¶

각 노트는 제목, 가시성, 태그 및 비즈니스 태그(KV 형식) 등의 속성 구성을 지원합니다. 비즈니스 태그는 특정 비즈니스 객체를 연결하는 데 사용되며, AI 검색의 핵심 경로입니다. 예를 들어 service:checkout, host:prod-node-01과 같습니다.

Chart Block¶

노트 본문은 Chart Block 구문 확장을 지원하며, 미리보기 모드에서 실시간으로 대화형 차트로 렌더링됩니다. 시계열 꺾은선 차트, 숫자 개요, 테이블, 막대 차트, 알림 이벤트 타임라인, 파이 차트, 히트맵 등 총 7가지 차트 유형을 지원하며, 데이터는 워크스페이스의 실시간 쿼리에서 가져옵니다.

편집 모드에서는 Chart Block 구성 설명의 구문에 따라 차트 유형, 쿼리문 및 표시 매개변수를 직접 입력할 수 있으며, 미리보기 시 플랫폼 차트 컴포넌트가 쿼리를 실행하여 렌더링한 차트를 확인할 수 있습니다.

다중 탭¶

노트 편집 영역은 여러 노트를 동시에 열어 탭 형태로 나란히 표시할 수 있어, 장애 처리 시 여러 과거 기록을 동시에 참조하기에 적합합니다. 노트 모듈에 다시 진입하면 이전에 열었던 탭 상태가 자동으로 유지됩니다.

다중 모듈 연동¶

노트에 비즈니스 태그(KV 형식)를 구성하면 노트가 Guance의 다른 모듈 객체와 자동으로 연결됩니다. 호스트, 서비스, 대시보드, 트레이스 등 객체의 상세 페이지에서 해당 객체와 연결된 노트 목록에 직접 접근할 수 있어, 노트 모듈로 이동할 필요 없이 컨텍스트 내에서 지식을 축적하고 조회할 수 있습니다.

예를 들어, 노트에 host:prod-node-01 태그를 추가하면 해당 노트가 자동으로 해당 호스트 상세 페이지의 '노트' 탭에 나타납니다.

노트 관리¶

노트 목록 작업¶

• 검색: 키워드로 노트 검색
• 즐겨찾기: 노트 오른쪽의 즐겨찾기 아이콘을 클릭하면 즐겨찾기에 등록되며, '내 즐겨찾기' 바로가기에서 확인할 수 있습니다.
• 삭제: 노트 오른쪽 상단의 작업 메뉴를 클릭하고 삭제를 선택한 후 재확인하면 현재 노트가 삭제됩니다.

필터 및 검색¶

왼쪽 디렉토리 바에서는 태그, 비즈니스 태그를 통해 노트를 필터링할 수 있으며, 다음 바로가기를 제공합니다.

• 전체 노트: 워크스페이스 내 모든 노트
• 내 즐겨찾기: 현재 사용자가 즐겨찾기한 노트
• 내가 생성한: 현재 사용자가 생성한 모든 노트
• 비공개 노트: 생성자本人만 볼 수 있는 노트

가시성¶

노트는 다음 두 가지 가시성 구성을 지원합니다.

• 공개: 워크스페이스 모든 멤버가 볼 수 있음
• 비공개: 생성자 본인만 보고 편집할 수 있음

시작하기¶