📊 Git Metrics Dashboard
Comprehensive Git Repository Analytics and Metrics Dashboard for VS Code
A powerful VS Code extension that provides comprehensive Git repository analytics with beautiful visualizations and multi-format report exports.
English | 한국어 | 日本語 | 简体中文
✨ Key Features
📈 Dashboard Analytics
- Real-time Git Statistics: Total commits, file changes, contributor metrics
- Real-time Change Detection: Auto-refresh dashboard on Git changes (commits, branch switches, file staging)
- Interactive Charts: Interactive visualization powered by Chart.js
- Contributor Analysis: Rankings, contribution metrics, activity patterns
- File Analysis: Support for 70+ programming languages
- Time-based Analysis: Hourly and daily activity patterns
- Achievement Badges: Gamification system to track development achievements
- Smart Themes: Full support for dark/light themes
📄 Report Export
- Multiple Formats: HTML, JSON, CSV, Markdown
- Theme Integration: VS Code theme automatically applied to HTML reports
- Customizable: Select analysis period and report sections
- Badge Integration: Include achievement badges in reports
- Professional Quality: Perfect for company reports and documentation
- Automation-friendly: JSON/CSV formats for programmatic analysis
🚀 Installation
- Search for "Git Metrics Dashboard" in VS Code Marketplace
- Click Install
- Open a Git repository in your workspace
📋 Usage
Open Dashboard
- Status Bar: Click the
📊 Git Stats button
- Command Palette:
Ctrl+Shift+P → "Git Metrics Dashboard: Open"
- Keyboard Shortcut:
Ctrl+Shift+G → Ctrl+Shift+D (Windows/Linux) or Cmd+Shift+G → Cmd+Shift+D (Mac)
Switch Theme
- Status Bar Button: Click theme button (🔄 Auto / ☀️ Light / 🌙 Dark)
- Keyboard Shortcut:
Ctrl+Shift+G → Ctrl+Shift+T
Export Reports
Quick Export:
- Click
📄 Export button in status bar
- Or use
Ctrl+Shift+G → Ctrl+Shift+E
Custom Export:
- Command Palette → "Git Metrics Dashboard: Custom Export"
- Choose analysis period, format, and sections
Dashboard Export:
- Click "📄 Export Report" button in dashboard
HTML Report
- Interactive report viewable in web browsers
- Theme Integration: VS Code theme automatically applied
- 프린트 친화적 디자인
- 회사 프레젠테이션이나 문서화에 적합
JSON 리포트
- 프로그래밍적 처리를 위한 구조화된 데이터
- API 연동이나 추가 분석 도구와 연계 가능
- 자동화된 리포팅 시스템에 적합
CSV 리포트
- Excel이나 Google Sheets에서 열기 가능
- 표 형식의 데이터 분석에 적합
- 통계 소프트웨어와 연동 가능
Markdown 리포트
- GitHub README 스타일 문서
- 프로젝트 문서화에 적합
- 버전 관리 시스템에 포함 가능
⚙️ 설정 옵션
{
"gitMetrics.defaultPeriod": 30, // 기본 분석 기간 (일)
"gitMetrics.maxTopFiles": 10, // 상위 파일 표시 개수
"gitMetrics.theme": "auto", // 테마 설정 (auto/light/dark)
"gitMetrics.autoRefresh": false, // Git 변경 시 자동 새로고침 (0.0.9+)
"gitMetrics.autoRefreshInterval": 5000, // 변경 감지 간격 (밀리초, 100-30000)
"gitMetrics.showChangeNotification": false, // Git 변경 감지 알림 표시
"gitMetrics.export.defaultFormat": "html", // 기본 내보내기 형식
"gitMetrics.export.useThemeInReports": true, // 리포트에 테마 적용
"gitMetrics.export.autoOpenAfterExport": false, // 내보내기 후 자동 열기
"gitMetrics.export.customReportsPath": "" // 사용자 정의 저장 경로
}
📁 리포트 저장 위치
리포트는 기본적으로 다음 위치에 저장됩니다:
프로젝트루트/
├── git-metrics-reports/
│ ├── git-metrics-report-2025-01-15-30days.html
│ ├── git-metrics-report-2025-01-15-30days.json
│ └── ...
🎯 사용 사례
팀 리더/매니저
- 팀원별 기여도 분석
- 프로젝트 진행 상황 모니터링
- 월별/분기별 리포트 생성
개발자
- 개인 개발 활동 추적
- 기술 스택 분석
- 작업 패턴 최적화
프로젝트 관리
- 코드베이스 건강도 체크
- 기술 부채 파악
- 리소스 배분 최적화
🔧 명령어
| 명령어 |
단축키 |
설명 |
gitMetrics.showDashboard |
Ctrl+Shift+G D |
대시보드 열기 |
gitMetrics.quickExport |
Ctrl+Shift+G E |
빠른 리포트 내보내기 |
gitMetrics.customExport |
- |
사용자 정의 리포트 내보내기 |
gitMetrics.openReportsFolder |
- |
리포트 폴더 열기 |
📸 스크린샷
대시보드
HTML 리포트
🤝 기여하기
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
🛠️ 문제 해결
일반적인 문제
리포트 내보내기가 작동하지 않는 경우:
- Git 저장소인지 확인 (
git status 명령어 실행)
- 폴더 쓰기 권한 확인
- VS Code를 관리자/sudo 권한으로 재시작
- 설정에서 다른 저장 경로로 변경 시도
자주 묻는 질문
- Git 저장소인지 확인
- 분석 기간에 커밋이 있는지 확인
- 파일 쓰기 권한 확인
차트가 표시되지 않을 때
- 브라우저에서 JavaScript 활성화 확인
- VS Code 재시작
📄 라이선스
MIT License - 자세한 내용은 LICENSE 파일을 확인하세요.
🙋♂️ 지원
⭐ 이 확장 프로그램이 유용하다면 GitHub에서 스타를 눌러주세요!
