Help us learn about your current experience with the documentation. Take the survey.

Access the Observability API

Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed
Status: Experiment

Use the GitLab Observability API to query traces, metrics, and logs, and to manage dashboards and alerts programmatically.

Prerequisites

Observability must be enabled for your group or personal project. For setup instructions, see Set up Observability on GitLab.com or Set up Observability on GitLab Self-Managed.

You must have the Developer, Maintainer, or Owner role for the group.

You must have the Owner role for the project.

Get your API key

In the top bar, select Search or go to and find your group.
In the left sidebar, select Observe > API Keys.
Copy your API key.

In the top bar, select Search or go to and find your project.
In the left sidebar, select Observe > API Keys.
Copy your API key.

Use this key in the SIGNOZ-API-KEY header when you make API requests.

API endpoint

The API endpoint depends on your GitLab offering.

GitLab.com

Your API base URL follows this pattern:

https://<group_id>.gitlab-o11y.com

Replace <group_id> with your GitLab group ID.

GitLab Self-Managed

Your API base URL is the same URL you configured as the o11y_service_url for your group. For example:

http://<your-instance-ip>:8080

Make API requests

Include your API key in the SIGNOZ-API-KEY header with every request.

The following example queries the health endpoint:

curl --header "SIGNOZ-API-KEY: <your_api_key>" \
  https://<group_id>.gitlab-o11y.com/api/v1/health

Replace <your_api_key> with the key from the API Keys page, and <group_id> with your GitLab group ID (or your self-managed instance URL).

Available API endpoints

GitLab Observability uses the SigNoz API. For the complete list of available endpoints, request and response formats, and usage examples, see the SigNoz API reference.