Overview
Use projects to organize repositories, integrations, metrics, and reporting for your engineering teams.Key Capabilities
- Create and manage projects
- Connect integrations
- View engineering insights
- Configure project settings
What is Projects?
The Projects section is the central hub of the Engineering Metrics Dashboard. It allows administrators to create, configure, and manage projects that track engineering activity across connected tools and platforms. Each project acts as a container that links your data sources, such as GitHub repositories, CI/CD pipelines, or issue trackers, and collects metrics from them on a scheduled basis.Navigating to the Projects Page
To access the Projects section:- Log in to the Engineering Metrics Dashboard.
- In the left-hand navigation sidebar, click Projects at the top of the menu.
- The Projects list page will load, displaying all existing projects.
The Projects List Page
The Projects list page gives you a bird’s-eye view of all projects set up in your workspace. Each row in the list represents one project.Understanding the Projects Table
| Column | Field | Description | Example |
|---|---|---|---|
| Project Identity | Name & Icon | The name given to the project during setup | GithubTesting |
| Type | Project Type Badge | The category of metrics being tracked | Engineering Metrics |
| Sync Details | Status & Frequency | Shows current sync status and how often data is collected | Not Started · Daily |
| Last Run | Timestamp | The date and time the last data sync was run | — (not yet run) |
| Configure | Action Button | Opens the configuration settings for that project | Click to Edit |
Sync Status Indicators
The coloured badge in the Sync Details column tells you the current state of a project’s data collection.Not Started
Data collection has not been initiated yet for this project.Note: A project showing Not Started will not collect any data until it is fully configured and a sync is triggered.
Page Controls
- Use the Search bar at the top of the list to find a project by name.
- Use the Refresh button (circular arrow icon) next to the search bar to reload the latest project data.
- Use the All Projects dropdown (top right) to filter or change how many projects are displayed per page.
Creating a New Project
Projects are the foundation of everything in the dashboard. You need to create a project before you can connect data sources or view any metrics.Note: Before creating a project, it is recommended (but not required) to set up your tool integrations first via the Integrations section in the left sidebar. You can also add data sources during the project creation flow.
Step 1 — Open the Create Project Dialog
Click the + Add Project button in the top-right corner of the Projects page. A dialog box titled Create New Project will appear.Step 2 — Enter Project Details
Project Name (Required) Enter a clear, descriptive name for your project. This name will appear across dashboards and reports. Example:Team Portal – Core Engineering
Description (Optional)
Add a short description of what this project is tracking.
Maximum length: 200 characters.
Step 3 — Select a Project Type
Choose the type of metrics this project will track.| Project Type | What It Tracks | When to Use It |
|---|---|---|
| Engineering Metrics Project | Repositories, CI/CD pipelines, and developer workflow tools | For tracking code, deployments, and pull requests |
| LLM Metrics Project | LLM usage and model performance via a provider connection | For teams using AI and LLM tools |
| AI Coding Metrics Project | AI coding tool usage via a provider connection | For tracking tools such as GitHub Copilot |
Note: Select Engineering Metrics Project if you are tracking pull requests, code reviews, or CI/CD pipelines. This is the most commonly used project type.
Step 4 — Add a Data Source
After clicking Create & Setup, you will be taken to the data source configuration step. Here you connect the tool or platform from which data will be collected, such as a GitHub repository or Azure DevOps project. You can either:- Connect a new integration directly from this step if one has not been set up yet.
- Select an existing integration that was previously configured under the Integrations section.
Step 5 — Configure Sync Behaviour
The final step lets you control how and when data is collected.- Data Collection Frequency: Choose how often the project syncs, for example Daily.
- Historical Data Range: Select how many months of past data should be collected on the first sync.
Note: After setup, the project will appear in the Projects list with a Not Started status until the first sync runs.