CI/CD Monitoring
The Control Center integrates with the GitHub API to provide real-time visibility into pull requests, GitHub Actions workflow runs, build performance, and deployment history.
GitHub Integration
github.service.ts connects to GitHub via the REST API using a personal access token:
| Function | Description | GitHub API |
|---|---|---|
| Pull request tracking | Open PRs with review status | GET /repos/{owner}/{repo}/pulls |
| Workflow run monitoring | GitHub Actions run history | GET /repos/{owner}/{repo}/actions/runs |
| CI statistics | Success/failure rates, average build times | Computed from workflow runs |
| Deployment tracking | Identify deploy-related runs | Filtered by workflow name |
Dashboard Views
PR Board
| Column | Data | Update Frequency |
|---|---|---|
| Title | PR title + link | On page load + polling |
| Author | PR creator avatar + name | Static |
| Status | Open, Draft, Ready for Review | Live |
| Reviews | Approved, Changes Requested, Pending | Live |
| CI Status | Passing, Failing, Pending | Live |
| Age | Time since creation | Computed |
| Merge Conflicts | Has conflicts | Live |
CI Health Dashboard
| Chart | Metric | Time Range |
|---|---|---|
| Success Rate | % of passing workflow runs | Last 7/30/90 days |
| Average Build Time | Mean duration of completed runs | Last 7/30/90 days |
| Failure Rate by Workflow | Which workflows fail most | Last 30 days |
| Build Time Trend | Build duration over time | Last 30 days |
Recent Workflow Runs
| Column | Data |
|---|---|
| Workflow | Workflow name (e.g., "CI", "Deploy") |
| Branch | Trigger branch |
| Status | Success, Failure, In Progress, Cancelled |
| Duration | Run time |
| Triggered By | Push, PR, Schedule, Manual |
| Timestamp | When the run started |
Deployment Log
| Column | Data |
|---|---|
| Version | Commit SHA or tag |
| Environment | Production, Staging |
| Status | Deployed, Rolled Back, Failed |
| Duration | Deploy time |
| Deployer | Who triggered the deploy |
| Timestamp | When deployed |
Configuration
Set these in the Control Center settings page or environment:
| Setting | Description |
|---|---|
GITHUB_TOKEN | Personal access token with repo scope |
| Monitored repositories | List of owner/repo pairs to track |
| Deploy workflow names | Workflow names that represent deployments |
# Environment variable
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Data Flow
Notifications
The CI/CD monitor generates notifications for:
| Event | Notification |
|---|---|
| Workflow run failure | CI failed on <branch>: <workflow name> |
| PR approved and ready to merge | <PR title> is ready to merge |
| Deploy completed | Deployed <commit> to production |
| Deploy failed | Deployment failed: <error> |
Cross-Reference
- Control Center Architecture -- overall architecture
- Deployment -- production deployment workflow
- PR Process -- PR workflow for contributors