2.12. 통계 대시보드¶

통계 페이지는 AI 사용에 대한 종합적인 분석과 시각화를 제공하여 사용 패턴, 성능 지표 및 리소스 소비를 이해하는 데 도움을 줍니다.

개요¶

통계 대시보드는 AI 모델과의 상호작용에 대한 데이터를 수집하고 표시합니다:

• 총 API 호출 수
• 토큰 소비량 (입력 및 출력)
• 성능 지표 (초당 토큰, 지연 시간)
• 모델별 사용량 분석
• 과거 추세

통계 접근하기¶

사이드바에서 통계 아이콘(막대 차트 모양)을 클릭하여 대시보드를 엽니다.

대시보드 섹션¶

기간 선택기¶

페이지 우측 상단에서 통계 기간을 선택합니다:

• 오늘: 당일만
• 7일: 지난 1주일
• 30일: 지난 1개월
• 전체 기간: 전체 기록

개요 카드¶

대시보드는 가장 중요한 지표를 강조하기 위해 시각적 계층 구조를 사용합니다:

주요 지표 (스파크라인 추세가 있는 큰 카드):

보조 지표 (표준 카드):

삼차 지표 (컴팩트 카드):

• 평균 지연 시간: 첫 토큰까지의 평균 시간
• 성공률: 성공한 요청의 비율

시간별 사용량 차트¶

요청(왼쪽)과 토큰(오른쪽)에 대한 이중 Y축이 있는 인터랙티브 영역 차트입니다.

인터랙티브 기능:

• 호버 툴팁: 각 날짜의 상세 값 확인
• 범례 토글: 범례 항목을 클릭하여 개별 시리즈 표시/숨기기
• 브러시 줌: 10일 이상의 데이터셋에서 하단의 브러시를 사용하여 특정 날짜 범위로 확대

이 시각화는 다음에 도움이 됩니다:

• 사용 패턴 파악
• 사용량 증가 또는 감소 추적
• 비정상적인 활동 급증 발견

모델별 토큰 분포¶

다른 모델 간 토큰 사용량 분포를 보여주는 파이 또는 도넛 차트입니다. 다음을 이해하는 데 도움이 됩니다:

• 가장 자주 사용하는 모델
• 모델별 토큰 소비 패턴
• 다른 모델 유형 간의 균형

성능 추세¶

시간에 따른 성능 지표를 추적하는 다중 라인 차트:

• 초당 토큰: 생성 속도 추세
• 지연 시간: 응답 시간 추세

시스템 성능이 일관되는지 또는 저하되고 있는지 모니터링하는 데 사용합니다.

모델 사용량 테이블¶

모델별 사용량을 분석하는 상세 테이블:

열 헤더를 클릭하여 테이블을 정렬할 수 있습니다.

데이터 수집¶

다음 작업 시 통계가 자동으로 수집됩니다:

• 채팅 인터페이스 사용
• Continuum Router를 통한 API 호출
• Cowork 사용

모든 데이터는 로컬 컴퓨터에 저장됩니다. 외부 서버로 사용량 데이터가 전송되지 않습니다.

저장 위치¶

통계 데이터는 로컬 SQLite 데이터베이스에 저장됩니다:

데이터 내보내기¶

우측 상단의 내보내기 버튼을 사용하여 통계 데이터를 내보낼 수 있습니다:

• CSV로 내보내기: 스프레드시트 애플리케이션에 적합한 CSV 형식으로 일별 통계 다운로드
• JSON으로 내보내기: 개요, 일별, 모델 데이터를 포함한 전체 통계를 JSON 형식으로 다운로드
• 클립보드에 복사: 빠른 붙여넣기를 위해 JSON 데이터를 클립보드에 복사

보안 참고: CSV 내보내기는 스프레드시트 애플리케이션에서 수식 주입 공격을 방지하기 위해 정제됩니다.

접근성 기능¶

Backend.AI GO 차트는 시각 장애인 또는 색각 이상이 있는 사용자를 포함한 모든 사용자가 접근할 수 있도록 설계되었습니다.

보기 전환 (차트/테이블)¶

각 차트 컴포넌트 우측 상단에 보기 전환 버튼이 있어 다음 모드 간 전환이 가능합니다:

• 차트 보기: 그래프와 플롯을 사용한 시각적 표현
• 테이블 보기: 다음과 같은 특성을 가진 표 형식 데이터:
  • 키보드로 완전히 탐색 가능
  • 스크린 리더와 호환
  • 텍스트 기반 데이터를 선호하는 사용자에게 읽기 쉬움

색맹 사용자를 위한 패턴¶

차트는 데이터 시리즈를 구분하기 위해 색상 외에 SVG 패턴을 사용합니다:

• 첫 번째 시리즈는 단색 채우기
• 이후 시리즈는 대각선 줄무늬, 점, 가로선, 격자 무늬, 세로선 등 사용
• 색상을 인식하지 못해도 데이터를 구분할 수 있음

스크린 리더 지원¶

모든 차트에 포괄적인 ARIA 속성이 포함됩니다:

• 차트 컨테이너에 설명적인 aria-label과 함께 role="img" 적용
• 시각화되는 데이터를 설명하는 의미 있는 레이블
• 테이블 보기는 <caption>, <th>, scope 속성을 통한 적절한 시맨틱 구조 제공

고대비 모드¶

시스템의 고대비 모드가 활성화된 경우 (prefers-contrast: high):

• 차트 테두리가 더 뚜렷해짐
• 텍스트 대비가 증가
• 포커스 표시기가 더 잘 보임

동작 줄이기¶

동작 줄이기를 선호하는 사용자의 경우 (prefers-reduced-motion: reduce):

• 차트 애니메이션 비활성화
• 전환 효과 최소화
• 데이터 업데이트가 애니메이션 효과 없이 즉시 표시

팁¶

• 사용 패턴을 이해하기 위해 정기적으로 통계 확인
• 모델 분석을 사용하여 어떤 모델을 사용할지 최적화
• 성능 추세를 모니터링하여 잠재적 문제 감지
• 다른 기간을 비교하여 개선 사항 추적
• 백업이나 외부 분석을 위해 정기적으로 데이터 내보내기
• 스크린 리더 사용 시 또는 정확한 값이 필요할 때 테이블 보기 사용