분석 워크스페이스

분석 워크스페이스는 서로 관련된 여러 리소스의 메트릭 패널을 한 화면에 구성하고, 같은 시간 구간에서 운영 상태를 비교하거나 장애 분석 근거를 검토하는 Enterprise 기능입니다. 구성한 화면은 일반 조회, 시간 탐색, 프레젠테이션에 공통으로 사용됩니다.

분석 워크스페이스는 Enterprise 제품에 포함되며 별도 기능 라이선스를 요구하지 않습니다. 다만 워크스페이스와 각 원본 리소스에 대한 사용자 권한은 모든 조회와 저장 시점에 다시 확인됩니다.

워크스페이스 찾기

상단 탐색 메뉴에서 분석 워크스페이스를 선택하면 현재 사용자가 볼 수 있는 워크스페이스가 표시됩니다. 각 카드에는 설명, 페이지 수, 패널 수, 읽을 수 있는 연관 리소스 수와 일부 리소스 이름이 요약됩니다.

리소스의 모니터링, 관리 또는 편집 화면에서 관련 워크스페이스를 선택하면 해당 리소스의 패널을 직접 포함한 워크스페이스만 필터링해 볼 수 있습니다. 이 필터는 관계 그래프를 따라 다른 워크스페이스까지 확장하지 않습니다. 필터를 해제하면 전체 목록으로 돌아갑니다.

새 워크스페이스

1. 새 워크스페이스를 선택합니다.
2. 구분하기 쉬운 이름과 목적, 장애 맥락 또는 담당 범위를 설명하는 문장을 입력합니다.
3. 워크스페이스를 만든 뒤 페이지, 섹션, 패널을 구성합니다.

이름만으로 구분하기 어려운 워크스페이스가 많아질 수 있으므로 설명을 함께 작성하는 것이 좋습니다.

워크스페이스 공유

새 워크스페이스는 소유자와 전역 관리자만 접근할 수 있는 비공개 상태로 생성됩니다. 워크스페이스 상단의 공유 설정에서 사용자 또는 그룹을 검색해 추가하면 공유됨 상태로 변경됩니다. 공유됨은 전체 사용자나 익명 사용자에게 공개한다는 뜻이 아니라 목록에 추가한 대상만 접근할 수 있다는 의미입니다.

공유 대상은 기본적으로 워크스페이스를 조회할 수 있습니다. 각 대상에 편집 권한과 프레젠테이션 권한을 별도로 부여할 수 있습니다. 모든 공유 대상을 제거하고 저장하면 워크스페이스가 다시 비공개 상태가 됩니다.

공유 설정은 워크스페이스 소유자와 전역 관리자만 변경할 수 있습니다. 레이아웃 편집을 마치고 저장하지 않은 변경 사항을 먼저 저장해야 공유 설정을 열 수 있습니다.

페이지와 섹션 구성

워크스페이스는 여러 페이지를 가질 수 있고, 각 페이지는 순서가 있는 여러 섹션으로 구성됩니다. 섹션 제목과 설명을 사용해 예를 들어 서비스 상태, 데이터베이스 지연, 호스트 자원처럼 차트의 해석 맥락을 명시할 수 있습니다.

레이아웃 편집을 선택하면 다음 작업을 할 수 있습니다.

• 페이지 추가, 복제, 이름 변경, 순서 변경 및 삭제
• 섹션 추가, 제목과 설명 변경, 순서 변경 및 삭제
• 패널 추가, 이동, 크기 조절 및 삭제
• 끌어서 패널 순서나 섹션을 변경

레이아웃은 12열 기준으로 저장되며 화면 폭에 맞게 자동으로 조정됩니다. 패널의 오른쪽 아래 크기 조절점을 대각선으로 끌면 폭과 차트 높이를 함께 바꿀 수 있습니다. 키보드 조작 안내가 표시되는 컨트롤은 끌기 동작 대신 사용할 수 있습니다.

편집 중에는 저장하지 않은 구성이 운영 데이터 갱신으로 흔들리지 않도록 시간 범위 컨트롤과 자동 새로고침이 일시 정지됩니다. 변경 후 저장을 선택하십시오. 다른 사용자가 먼저 같은 워크스페이스를 저장했다면 충돌 안내에 따라 최신 내용을 다시 불러오거나 현재 변경을 다시 적용해야 합니다.

관련 리소스 패널 추가

편집 모드에서 섹션 끝의 빈 패널 자리를 선택하면 관련 위젯 카탈로그가 열립니다.

1. 기준이 될 플러그인 리소스를 선택합니다.
2. 필요할 때만 관련 리소스 포함을 활성화합니다.
3. 검색어, 패널 유형, 지원 상태 또는 원본 섹션으로 목록을 좁힙니다.
4. 하나 이상의 패널을 선택한 뒤 적용합니다.

기본 목록은 선택한 플러그인 리소스의 패널만 보여 줍니다. 관련 리소스 포함을 켜면 승인된 리소스 관계와 메트릭·로그 소스 연결을 따라 읽을 수 있는 리소스의 패널이 추가됩니다.

현재 로드되지 않은 플러그인, 비활성 리소스 인터페이스, 읽을 수 없는 설정은 목록에서 제외됩니다. 일시적으로 상태가 좋지 않은 리소스는 과거 메트릭과 장애 근거를 검토할 수 있도록 목록에 남을 수 있습니다. 이미 같은 페이지에 있는 패널은 중복으로 추가되지 않습니다.

시간 구간 탐색

워크스페이스는 플러그인 메트릭 대시보드와 같은 시간 범위 컨트롤을 사용합니다.

• from ~ now 실시간 구간에서는 설정한 주기로 현재 페이지의 메트릭을 자동 갱신합니다.
• from ~ to 고정 구간에서는 조사 중인 데이터가 움직이지 않도록 자동 새로고침을 일시 정지합니다.
• 이전·다음 구간 이동, 확대·축소, 달력 범위 선택, 실시간 복귀를 사용할 수 있습니다.
• 시계열 차트에서 원하는 구간을 끌어 고정 시간 범위로 확대할 수 있습니다.
• 개인 차트 설정의 호버 동기화, 시리즈 요약, 포인트 표시, 최신 값 강조, 조회 간격과 시스템 차트 표시 정책이 워크스페이스에도 적용됩니다.

고정 구간에서 자동 새로고침이 멈춘 것은 오류가 아닙니다. 최신 데이터를 다시 보려면 실시간 구간으로 돌아가십시오.

프레젠테이션

프레젠테이션은 저장된 페이지와 레이아웃을 별도 복제하지 않고 그대로 사용합니다.

1. 상단 페이지 영역에서 프레젠테이션에 포함할 페이지를 켜거나 끕니다. 새 페이지는 기본적으로 포함되며, 프레젠테이션은 페이지 순서대로 재생됩니다.
2. 페이지 전환을 수동, 30초, 1분, 1분 30초 중에서 선택합니다.
3. 변경을 저장한 뒤 프레젠테이션을 선택합니다.

프레젠테이션은 워크스페이스에서 보고 있던 시간 구간을 유지합니다. 실시간 구간에서는 메트릭 갱신과 페이지 전환이 각각 동작합니다. 고정 구간을 선택하거나 차트를 끌어 확대하면 조사 내용을 유지하기 위해 자동 새로고침과 페이지 전환이 일시 정지됩니다. 패널 확대 또는 시간 컨트롤 조작 중에는 페이지 전환만 일시 정지되고, 실시간 메트릭 갱신은 계속됩니다.

브라우저가 전체 화면을 허용하지 않으면 현재 창에서 프레젠테이션이 계속됩니다. 상단 컨트롤은 일정 시간 뒤 자동으로 숨겨지며 화면 위쪽을 차트 영역으로 사용합니다. 마우스를 움직이거나 키보드로 포커스를 이동하면 이전·다음 페이지, 일시 정지, 새로고침, 종료 컨트롤을 다시 사용할 수 있습니다.

RCA 증거 조회

RCA 도구는 현재 페이지의 리소스와 시간 범위를 기준으로 장애 분석에 사용할 근거를 모읍니다. 차트에서 특정 시점을 선택했다면 해당 시점을 기준으로 사용할 수 있고, 그렇지 않으면 현재 조회 구간을 사용합니다.

증거 조회는 다음 소스를 함께 확인합니다.

• 저장된 알림과 이상 징후 이벤트
• 플러그인의 진단 이력
• 허용된 범위의 리소스 로그
• 현재 페이지 리소스에서 한 단계 관계로 연결된 읽기 가능한 리소스

조회 결과에는 리소스, 수집 방식, 관측 시각, 관계 경로, 오래된 자료 여부와 비밀 값을 제거한 상세 내용이 표시됩니다. 일부 수집기만 실패하면 성공한 근거와 실패 원인을 함께 보여 주는 일부 수집 상태가 됩니다. 수집 결과 없음은 선택한 범위에서 근거를 찾지 못했다는 뜻이며 시스템이 정상이라고 판정한 결과는 아닙니다.

한 번의 조회는 최대 24시간, 리소스 12개, 증거 100건으로 제한됩니다. 로그는 리소스당 최대 20건을 사용합니다. 이 제한을 넘거나 플러그인·진단·로그 소스를 사용할 수 없으면 실패 원인이 결과에 표시됩니다.

RCA 도구는 자동으로 근본 원인을 판정하거나 원인 후보의 순위와 신뢰도를 계산하지 않습니다. 수집한 메트릭, 알림, 이상 징후, 진단, 로그를 운영자가 함께 검토하도록 돕는 근거 탐색 기능입니다.

연결 진단 실행

현재 페이지에 준비된 리소스 패널이 하나 이상 있으면 워크스페이스 상단에서 연결 진단을 실행할 수 있습니다. 연결 진단 화면은 현재 페이지의 읽기 가능한 리소스를 시작 리소스로 채우고, 현재 시간 구간을 허용 범위 안에서 분석 기간으로 사용합니다.

연결 진단은 시작 리소스에서 승인된 관계를 따라 범위를 확장하고 진단 항목을 수집한 뒤 운영 위험도, 수집률, 근거 신뢰도, 영향 범위와 긴급도를 계산합니다. 결과에서 진단 항목을 선택해 워크스페이스에 고정하면 현재 페이지의 분석 메모로 남길 수 있습니다. 진단 실행 결과 자체는 저장되지 않으므로 필요한 항목은 화면을 떠나기 전에 고정하십시오.

RCA 도구는 선택한 시간 구간의 알림, 이상 징후, 진단 이력과 로그를 모아 운영자가 검토하도록 돕습니다. 연결 진단은 현재 접근 가능한 토폴로지를 한 번에 점검하고 설명 가능한 위험 순위를 계산합니다. 과거 근거를 넓게 조사하려면 RCA 도구를, 연결된 리소스의 현재 운영 위험을 빠르게 점검하려면 연결 진단을 사용하십시오.

자세한 범위 설정, 점수 해석과 일회성 결과 정책은 연결 진단 매뉴얼을 참고하십시오.

분석 메모 저장과 다시 보기

증거를 검토한 뒤 필요한 항목을 선택하고 분석 메모를 저장할 수 있습니다. 저장된 분석은 현재 워크스페이스 페이지에 연결되며 다음 정보를 보관합니다.

• 분석 메모
• 분석에 사용한 고정 시간 구간
• 저장 시각과 작성자
• 선택한 증거 식별 정보

RCA 도구의 저장된 분석 탭은 증거를 다시 수집하지 않고도 이전 메모를 최신순으로 보여 줍니다. 이 시간 구간 보기를 선택하면 워크스페이스가 해당 분석의 고정 시간 범위로 이동합니다. 증거 원본은 현재 권한으로 다시 확인되므로 권한이 철회된 리소스의 정보는 노출되지 않습니다.

권한과 상태 해석

• 소유자는 워크스페이스 편집, 공유, 프레젠테이션, 삭제를 할 수 있습니다.
• 편집 권한을 받은 사용자는 페이지, 섹션과 패널을 편집할 수 있지만 공유 대상이나 워크스페이스 소유권을 변경할 수 없습니다.
• 보기 권한을 받은 사용자는 읽기만 할 수 있습니다. 프레젠테이션은 별도의 허용 여부를 따릅니다.
• 전역 관리자는 관리 목적으로 워크스페이스를 읽고 편집할 수 있습니다.
• 워크스페이스 권한은 원본 리소스 권한을 대신하지 않습니다.

리소스가 삭제되거나 비활성화되거나 읽기 권한이 사라지면 해당 패널만 리소스 없음, 리소스 비활성 또는 접근 불가 상태로 표시됩니다. 다른 패널과 페이지는 계속 사용할 수 있습니다.

문제 해결

추가할 패널이 보이지 않음

플러그인이 로드되어 있고 리소스가 활성 상태인지, 현재 계정에 리소스 읽기 권한이 있는지 확인합니다. 기본 목록은 선택한 리소스만 표시하므로 다른 리소스의 패널이 필요하면 관련 리소스 포함을 켜십시오.

메트릭이 자동으로 갱신되지 않음

시간 범위가 고정 구간인지, 레이아웃 편집 중인지 확인합니다. 고정 구간과 편집 모드에서는 자동 새로고침이 의도적으로 일시 정지됩니다.

페이지가 자동으로 전환되지 않음

프레젠테이션에 포함된 읽을 수 있는 페이지가 두 개 이상인지, 전환 설정이 수동인지 확인합니다. 고정 시간 구간, 확대된 패널, 시간 컨트롤 조작, 숨겨진 브라우저 탭 또는 오프라인 상태에서도 전환이 일시 정지됩니다.

RCA 결과가 비어 있거나 일부만 수집됨

조회 시간 범위와 각 리소스 권한을 확인하고 실패 원인을 펼쳐 봅니다. 관련 시간에 알림, 이상 징후, 진단 또는 로그가 실제로 없을 수도 있습니다. 결과 없음만으로 정상 상태나 근본 원인을 결론 내리지 마십시오.

관련 문서

• enterprise/docs/analysis-workspace-contract.md
• enterprise/backend/docs/openapi-analysis-workspace.yaml
• enterprise/docs/instance-relations-contract.md
• enterprise/docs/connected-diagnostics-contract.md