통계 대시보드¶

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

개요¶

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

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

통계 접근하기¶

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

대시보드 섹션¶

기간 선택기¶

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

• 오늘: 당일만
• 7일: 지난 1주일
• 30일: 지난 1개월
• 전체: 전체 기록
• 기간 지정: 원하는 시작일과 종료일. 누른 뒤 달력에서 시작일과 종료일을 차례로 누르고 적용을 누르면, 버튼에 해당 기간이 표시됩니다.

모든 카드와 차트, 모델 사용량 테이블은 선택한 기간을 따릅니다.

개요 카드¶

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

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

보조 지표 (표준 카드):

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

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

시간별 사용량 차트¶

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

인터랙티브 기능:

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

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

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

모델별 토큰 분포¶

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

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

성능 추세¶

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

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

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

모델 사용량 테이블¶

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

열 헤더를 클릭하여 테이블을 정렬할 수 있습니다. 모델 이름 아래의 측정값 보기를 누르면 설정 > 성능에서 해당 모델의 이 컴퓨터 기준 속도가 열리고, 정책으로 해당 탭을 숨기면 나타나지 않습니다.

데이터 수집¶

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

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

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

저장 위치¶

통계 데이터는 로컬 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):

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

팁¶

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