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. 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.
Get your API key
- In the top bar, select Search or go to and find your group.
- In the left sidebar, select Observability > 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.comReplace <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>:8080Make 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/healthReplace <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.