109 lines
5.1 KiB
Markdown
109 lines
5.1 KiB
Markdown
---
|
|
stage: Manage
|
|
group: Optimize
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
|
|
---
|
|
|
|
# Group DevOps Adoption **(ULTIMATE)**
|
|
|
|
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/321083) in GitLab 13.11 as a [Beta feature](https://about.gitlab.com/handbook/product/gitlab-the-product/#beta).
|
|
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/333556) in GitLab 14.1.
|
|
> - The Overview tab [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/330401) in GitLab 14.1.
|
|
> - DAST and SAST metrics [added](https://gitlab.com/gitlab-org/gitlab/-/issues/328033) in GitLab 14.1.
|
|
> - Fuzz Testing metrics [added](https://gitlab.com/gitlab-org/gitlab/-/issues/330398) in GitLab 14.2.
|
|
> - Dependency Scanning metrics [added](https://gitlab.com/gitlab-org/gitlab/-/issues/328034) in GitLab 14.2.
|
|
> - Multiselect [added](https://gitlab.com/gitlab-org/gitlab/-/issues/333586) in GitLab 14.2.
|
|
> - Overview table [added](https://gitlab.com/gitlab-org/gitlab/-/issues/335638) in GitLab 14.3.
|
|
> - Adoption over time chart [added](https://gitlab.com/gitlab-org/gitlab/-/issues/337561) in GitLab 14.4.
|
|
|
|
Prerequisites:
|
|
|
|
- You must have at least the [Reporter role](../../permissions.md) for the group.
|
|
|
|
To access Group DevOps Adoption, go to your group and select **Analytics > DevOps Adoption**.
|
|
|
|
Group DevOps Adoption shows you how individual groups and subgroups within your organization use the following features:
|
|
|
|
- Dev
|
|
- Approvals
|
|
- Code owners
|
|
- Issues
|
|
- Merge requests
|
|
- Sec
|
|
- DAST
|
|
- Dependency Scanning
|
|
- Fuzz Testing
|
|
- SAST
|
|
- Ops
|
|
- Deployments
|
|
- Pipelines
|
|
- Runners
|
|
|
|
When managing groups in the UI, you can add or remove your subgroups with the **Add or remove subgroups**
|
|
button, in the top right hand section of your Groups pages.
|
|
|
|
With DevOps Adoption you can:
|
|
|
|
- Verify whether you are getting the return on investment that you expected from GitLab.
|
|
- Identify specific subgroups that are lagging in their adoption of GitLab, so you can help them along in their DevOps journey.
|
|
- Find the subgroups that have adopted certain features, and can provide guidance to other subgroups on how to use those features.
|
|
|
|
|
|
|
|
Feature adoption is based on usage in the previous calendar month. Data is updated on the first day
|
|
of each month. If the monthly update fails, it tries again daily until successful.
|
|
|
|
## Enable data processing
|
|
|
|
Group DevOps Adoption relies on data that has been gathered by a weekly data processing task.
|
|
This task is disabled by default.
|
|
|
|
To begin using Group DevOps Adoption, access the feature for the first time. GitLab automatically
|
|
enables the data processing for that group. The group data doesn't appear immediately, because
|
|
GitLab requires around a minute to process it.
|
|
|
|
## What is displayed
|
|
|
|
DevOps Adoption displays feature adoption data for the given group
|
|
and any added subgroups for the current calendar month.
|
|
Each group appears as a separate row in the table.
|
|
For each row, a feature is considered "adopted" if it has been used in a project in the given group
|
|
during the time period (including projects in any subgroups of the given group).
|
|
|
|
## Adoption over time
|
|
|
|
The **Adoption over time** chart in the **Overview** tab displays DevOps Adoption over time. The chart displays the total number of adopted features from the previous twelve months,
|
|
from when you enabled DevOps Adoption for the group.
|
|
|
|
The tooltip displays information about the features tracked for individual months.
|
|
|
|
## When is a feature considered adopted
|
|
|
|
A feature is considered "adopted" if it has been used anywhere in the group in the specified time.
|
|
For example, if an issue was created in one project in a group, the group is considered to have
|
|
"adopted" issues in that time.
|
|
|
|
## No penalties for common adoption patterns
|
|
|
|
DevOps Adoption is designed not to penalize for any circumstances or practices that are common in DevOps.
|
|
Following this guideline, GitLab doesn't penalize for:
|
|
|
|
1. Having dormant projects. It's common for groups to have a mix of active and dormant projects,
|
|
so we should not consider adoption to be low if there are relatively many dormant projects.
|
|
This means we should not measure adoption by how many projects in the group have used a feature,
|
|
only by whether a feature was used anywhere in the group.
|
|
1. GitLab adding new features over time. It's common for group feature usage to be consistent
|
|
over time, so we should not consider adoption to have decreased if GitLab adds features.
|
|
This means we should not measure adoption by percentages, only total counts.
|
|
|
|
## Add a subgroup
|
|
|
|
DevOps Adoption can also display data for subgroups within the given group,
|
|
to show you differences in adoption across the group.
|
|
To add subgroups to your Group DevOps Adoption report:
|
|
|
|
1. Select **Add or remove subgroups**.
|
|
1. Select the subgroups you want to add and select **Save changes**.
|
|
|
|
The subgroup data might not appear immediately, because GitLab requires around a minute to collect
|
|
the data.
|