Eng Intelligence
Last updated
Was this helpful?
Last updated
Was this helpful?
Eng Intelligence provides you with key metrics and high-level data to gain insights into services, bottlenecks in the pull request lifecycle, incident response, and more. These metrics can give context to cross-team activities and indicate areas that need deeper investigation, allowing you to quickly remediate and improve productivity across your teams.
Eng intelligence reports on metrics for , git (, , , and ), issue tracking (), and incident management (). See the available metrics under the header below.
Before using Eng Intelligence, make sure you have configured your Git providers and Jira with the proper permissions. See each integration's documentation page for required permissions and configuration instructions:
Bitbucket data in Eng Intelligence is in private beta. Please contact your Cortex Customer Success Manager for access.
When using Bitbucket in Eng Intelligence, it is highly recommended to use the .
Cortex users with the View Eng Intelligence can access Eng Intelligence. Users with the Configure Eng Intelligence permission can configure Eng Intelligence settings.
To view, click Eng Intelligence in the main nav:
These values are recalculated every hour. For count metrics (e.g., PRs opened) , 0 is displayed if no data is available. For average metrics (e.g., average PR open to close time), N/A is displayed if no data is available to calculate averages.
By default, Eng Intelligence displays data from the last 7 days.
To filter by team, group, or owner:
Click into Group, Owner, or Team, and select filter options.
Click Apply.
By default, Eng Intell displays Team data. In the upper left corner, click the Team dropdown to select a different entity type:
Click the Group by dropdown and select a label you want to group by. The grouping will be added as a row to the metrics table, along with separate rows for each member of the grouping.
To better understand the data behind a trend you see in Eng Intelligence, click an entity to open a side panel with more information:
Under the Related activity tab, see available metrics and recent activity.
Under the Trends tab, see a historical performance graph for each metric.
In the upper right corner of the panel, you can adjust the time range for the graphs to be anywhere between the last 7 days and 6 months. This will update the graph view and maps to the table, so all metrics will reflect the new timeframe.
In the upper right corner, click Display. In this drop-down, you can choose whether to display entities in their associated hierarchies and you can select a Scorecard.
When you select a Scorecard, Scorecard performance is overlayed in Eng Intelligence when grouped by team or service. This view is not available when grouping by group, user, or owner. The icon representing the Scorecard level achieved by each entity will appear next to the entity name:
Under Deploys, select the deploy environments you want to include in the calculation of deploy frequency and deploy failure rate. - If none are selected, all deploys will be included.
Under Pull requests, select the authors you want to exclude from the calculation of PR-related metrics.
If none are selected, PRs from all authors will be included.
By default, Cortex filters out pull requests opened by bots in GitHub but does not do this automatically for GitLab.
User labels in Eng Intelligence allow you to group users into cohorts to analyze metrics based on different factors. This can be useful for benchmarking one engineer’s metrics against the average within a cohort, comparing metrics between engineers who use different tools to complete their work, and understanding metrics by different variables: location (e.g., in office or remote), engineer level (staff vs. lead engineer), tech stack (frontend vs. backend), and more.
Users who have the Configure user labels permission can create and apply labels.
The instructions below describe how to use this feature in the Cortex UI. See the Cortex API documentation for instructions on creating and managing user labels programmatically.
Create a user label
Click your avatar in the lower left then click Settings.
Under Eng Intelligence, click User labeling.
In the upper right corner, click Create label.
Fill out the “Create label” form:
Name: Enter a descriptive name, e.g., Location.
Description: Optionally enter a description, such as "This label helps us understand metrics by location."
Values: Enter possible values for the label, e.g., New York, California, Remote.
Click Create label.
After saving, the label will appear under the Label management tab in the Eng Intelligence settings page.
View applied user labels
Assign a user label to a user
In the list, locate the user you want to add a label to. Under the "Labels" column for that user, click the pencil icon.
In the side panel, click into the dropdown to select a pre-existing label. To create a new label, type in a name then click +Create in the dropdown.
At the bottom of the side panel, click Set labels.
Assign user labels in bulk
In the bulk edit modal, enter the labels you want to add to the users, then click Set labels.
Review trends in Eng Intelligence and use that knowledge to inform your . While viewing an Eng Intelligence report, in the upper right corner of the page click Create Scorecard. You will be redirected to a configurable Scorecard template that measures performance, activity, and flow metrics that impact productivity.
Eng Intelligence aggregates data from your connected entities to calculate critical metrics based on your organization's priorities. The data is presented by team, group, or individual, and can be filtered by time range. Cortex provides a set of , but you can also create to track here.
To filter by time range: In the upper right corner of Eng Intelligence, click Last 7 days, then select a new time range for your metrics display:
Click Filter in the upper right corner.
By default, each Team entity in Cortex is displayed in its own dedicated row. To group by the you've created, click View as hierarchy.
After you have , you can group by labels in Eng Intelligence.
Users with the Configure custom metrics permission can create for Eng Intelligence, or you can use the built-in metrics listed below.
Eng intelligence reports on metrics for , git (Azure DevOps, Bitbucket, GitHub, and GitLab), Jira, and PagerDuty.
Pulls deploy data added via the .
Pulls deploy data added via the .
For information on using Jira metrics in Eng Intelligence, see .
From the , users with the Configure Eng Intelligence permission can also choose which columns to display and adjust the order of columns.
Under Settings > Eng Intelligence, in , users with the Configure Eng Intelligence permission can set filters for some pre-defined metrics:
In Cortex, navigate to the .
In the under the User labeling tab, you can view a list of users and their applied labels. Note that these labels are only displayed in Eng Intelligence, and not in other pages within Cortex.
In Cortex, navigate to the .
In Cortex, navigate to the .
Check the boxes next to the users you want to edit. As you check names, a banner will appear at the bottom of the page showing how many users are selected. In that banner, click Edit labels.
After applying labels to users, you can while viewing Eng Intelligence metrics.
