Sessions
- Tier: Premium, Ultimate
- Add-on: GitLab Duo Core, Pro, or Enterprise
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
- Status: Beta
Sessions show the status of the agents and flows you’ve run in GitLab.
Which actions create sessions
In the Agent Platform, sessions are created when you:
- Run an agent or flow in the GitLab UI. This includes:
- Flows like the Fix your CI/CD Pipeline Flow.
- Any flow invoked with a trigger.
Sessions are not created when:
- You use GitLab Duo Chat (Agentic) in VS Code or the GitLab UI.
- You invoke a custom flow from the GitLab Duo Chat UI.
View the sessions for your project
Prerequisites:
- You must have the Developer, Maintainer, or Owner role for the project.
To view the sessions for your project:
- On the left sidebar, select Search or go to and find your project. If you’ve turned on the new navigation, this field is on the top bar.
- Select Automate > Sessions.
- Select any session to view more details.
View sessions you’ve triggered
To view a list of sessions you’ve triggered:
- On the right sidebar, select GitLab Duo sessions.
- Select any session to view more details.
- Optional. Filter the details to show all logs or a concise subset only.
Session retention
Sessions are automatically deleted 30 days after the last activity. The retention period resets each time you interact with the session. For example, if you interact with a session every 20 days, it will never be automatically deleted.
In the IDE, you can also manually delete sessions before the 30-day retention period expires.