Code suggestions

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

Code suggestions is a data source that provides aggregated metrics about GitLab Duo Code Suggestions usage across your project or group.

Allowed modes

Allowed scopes

Scope Description
project Query code suggestions in a specific project.
group Query code suggestions across all projects in a group, including subgroups.

Query fields

Field Name (and alias) Operators
IDE name ideName =, in
Language language =, in
Timestamp timestamp =, >, <, >=, <=
User user =, in

IDE name

Description: Filter by the IDE used to generate suggestions.

Allowed value types:

  • String
  • List (use in operator for multiple values)

Language

Description: Filter by the programming language of the suggestion.

Allowed value types:

  • String
  • List (use in operator for multiple values)

Timestamp

Description: Filter by when the suggestion was generated. Use range operators to define a time window.

Allowed value types:

  • AbsoluteDate (in the format YYYY-MM-DD)
  • RelativeDate (in the format <sign><digit><unit>, where sign is +, -, or omitted, digit is an integer, and unit is one of d (days), w (weeks), m (months) or y (years))

User

Description: Filter by the user who received the suggestion.

Allowed value types:

  • Number (user ID)
  • List (use in operator for multiple user IDs)

Support for username filtering is being tracked in issue 599750.

Dimensions

The following dimensions are supported:

Dimension Name (and alias) Description
IDE name ideName Group by IDE used (for example, VSCode, JetBrains).
Language language Group by programming language.
Timestamp timestamp Group by date.
User user Group by user (displays avatar, name, and username).

Metrics

The following metrics are supported:

Metric Name (and alias) Description
Acceptance rate acceptanceRate Ratio of accepted to shown suggestions.
Accepted count acceptedCount Number of accepted suggestions.
Rejected count rejectedCount Number of rejected suggestions.
Shown count shownCount Number of suggestions shown to users.
Suggestion size sum suggestionSizeSum Total volume of suggestions.
Total count totalCount Total number of suggestions.
Users count usersCount Number of unique users.

Examples

  • Acceptance rate by language for the last 30 days:

    ```glql
display: table
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language as "Language"
metrics: totalCount as "Total", acceptanceRate as "Acceptance Rate"
sort: acceptanceRate desc
```

  • Usage by IDE:

    ```glql
display: table
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: ideName as "IDE"
metrics: totalCount as "Total Suggestions", usersCount as "Active Users"
sort: totalCount desc
```

  • Overall metrics without grouping:

    ```glql
display: table
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
metrics: totalCount as "Total", acceptedCount as "Accepted", rejectedCount as "Rejected", shownCount as "Shown", acceptanceRate as "Acceptance Rate"
```

  • Suggestions per user for a specific project, filtered to Ruby:

    ```glql
display: table
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d and language = "ruby"
dimensions: user as "User"
metrics: totalCount as "Total", acceptanceRate as "Acceptance Rate"
sort: totalCount desc
limit: 10
```

  • Suggestions over time by language in a date range:

    ```glql
display: table
mode: analytics
query: type = CodeSuggestion and timestamp >= "2026-01-01" and timestamp <= "2026-03-31"
dimensions: timestamp as "Date", language as "Language"
metrics: totalCount as "Total", acceptanceRate as "Acceptance Rate"
sort: timestamp desc
```

  • Filter to specific IDEs and languages:

    ```glql
display: table
mode: analytics
query: type = CodeSuggestion and timestamp >= -7d and ideName in ("Visual Studio Code", "RubyMine") and language in ("ruby", "python")
dimensions: ideName as "IDE", language as "Language"
metrics: totalCount as "Total", acceptanceRate as "Rate"
sort: totalCount desc
```