GitHub Integration

Track your team's development activity and presence through GitHub repositories, commits, and pull requests.

§Features

• •Commit activity tracking - Monitor development velocity and patterns
• •Pull request monitoring - Track review and merge activity
• •Repository insights - See which projects are most active
• •Developer productivity - Understand coding patterns and work sessions

§Setup Instructions

1. Install GitHub App

1. •Go to your StatsAware dashboard
2. •Navigate to Integrations > Add Integration
3. •Click "Connect GitHub"
4. •Choose to install for your personal account or organization
5. •Select repositories to monitor (or grant access to all)

2. Configure Repositories

After installation:

• •Select repositories - Choose which repos to track
• •Branch preferences - Monitor specific branches (default: main/master)
• •Team mapping - Map GitHub users to StatsAware team members
• •Notification settings - Configure alerts for activity

3. Webhook Setup

StatsAware automatically creates webhooks for:

• •Push events
• •Pull request events
• •Issue events
• •Release events

§What We Track

Commit Activity

• •Commit timestamps - When code was committed
• •Commit frequency - Number of commits per day/hour
• •File changes - Number of files modified (not content)
• •Branch activity - Which branches are being worked on

Pull Requests

• •Creation and merge times
• •Review activity - When reviews are requested/completed
• •Merge patterns - How quickly PRs are merged
• •Collaboration metrics - Cross-team review activity

Issues & Projects

• •Issue creation and closure
• •Assignment patterns
• •Label usage
• •Project board activity

§What We Don't Track

• •Code content - We never read or store your source code
• •Commit messages - Only metadata like timestamps and file counts
• •Personal repositories - Only work-related repos you explicitly connect
• •Private data - No access to private issues or confidential information

§Privacy & Security

• •GitHub App permissions - Minimal required permissions only
• •Repository-level control - You choose exactly which repos to connect
• •Webhook security - Signed payloads to verify authenticity
• •Data retention - Activity data stored according to your plan limits

§Advanced Configuration

Custom Webhooks

For advanced users, you can set up custom webhooks:

# Example webhook payload for commits
{
  "event_type": "push",
  "repository": "myorg/myrepo",
  "commits": 3,
  "timestamp": "2025-07-10T14:30:00Z",
  "author": "developer@company.com"
}

API Integration

You can also push custom events via our API:

curl -X POST https://api.statsaware.com/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "commit",
    "timestamp": "2025-07-10T14:30:00Z",
    "metadata": {
      "repository": "myorg/myrepo",
      "commits": 1
    }
  }'

§Troubleshooting

Common Issues

No commit activity showing up

• •Verify the GitHub app is installed on the correct repositories
• •Check that team members are mapped to their GitHub usernames
• •Ensure commits are being pushed to monitored branches

Webhook events not received

• •Check webhook configuration in repository settings
• •Verify webhook URL is accessible from GitHub
• •Look for failed deliveries in GitHub's webhook logs

Permission errors

• •Confirm the GitHub app has necessary repository permissions
• •Check if organization settings block third-party apps
• •Verify admin approval for organization installations

Performance Optimization

For large repositories:

• •Selective monitoring - Only track active development branches
• •File filtering - Exclude generated files and vendor directories
• •Rate limiting - We automatically respect GitHub's API limits
• •Batch processing - Historical data is processed in batches

§Supported GitHub Features

• •✅ GitHub.com - Full support for cloud GitHub
• •✅ GitHub Enterprise Server - Contact us for enterprise setup
• •✅ GitHub Actions - Track CI/CD activity
• •✅ GitHub Projects - Monitor project board activity
• •⏳ GitHub Codespaces - Coming soon
• •⏳ GitHub Copilot - Integration planned

§Getting Help

• •Review our GitHub integration FAQ
• •Check GitHub's webhook documentation
• •Contact our technical team at dev@statsaware.com