Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Reading and visualizing metrics with Grafana

Written by
Updated at October 29, 2025

Yandex Managed Service for Prometheus® supports the Prometheus data source and enables you to work with dashboards you or your community created in Grafana.

Connecting a data source

  1. In the management console, go to the folder that stores your data.
  2. Create a service account with the monitoring.viewer role for the selected folder.
  3. Create an API key for the service account.
  4. Open your Grafana homepage.
  5. In the main menu, select Configuration → Data Sources.
  6. Click Add data source.
  7. Under Time series databases, select Prometheus.
  8. In the Name field, enter the data source name.
  9. In the URL field under HTTP, specify the previously obtained endpoint.
  10. Under Custom HTTP headers, click Add Header and add an authorization header. In the Header field, enter Authorization and in the Value field, Bearer <API_key>.
  11. Click Save & test. You should see a message saying The data source is working.

Error examples

Error code Description Error message
404 Endpoint not found. Make sure the configuration specifies the correct url. not_found: workspace not found: monb1piptmdo********
401 Service account not found. Make sure the configuration specifies the correct API key. auth: cannot authenticate by either token or api-key, cause: UNAUTHENTICATED: The token is invalid
403 No read permissions. Make sure the service account has the monitoring.viewer role for the selected folder. auth: PERMISSION_DENIED: Permission denied
429 Number of HTTP API read requests per second quota exceeded execution: too many requests: monb1piptmdo********
400 Too many lines returned in the response. Try refining your query. bad_data: Too many metrics are loaded by selectors {job=='grafana'}, expected not more than: 10000

Current limitations

Yandex Managed Service for Prometheus® works on TCP port 443. Its public IP address is 158.160.59.216. This address may change over time. To avoid losing access to the service, we recommend using additional addresses from the list of available ones.

The Prometheus HTTP API only supports the following endpoints:

  • /api/v1/query
  • /api/v1/query_range
  • /api/v1/labels
  • /api/v1/<label_name>/values
  • /api/v1/series

The following limitations apply:

  • The timeout parameter is not supported and is ignored.
  • The start and end parameters are not supported and are ignored for the /api/v1/labels, /api/v1/<label_name>/values, and /api/v1/series requests.
  • The maximum number of selectors you can provide in the match[] parameter is 8.
  • The maximum number of time series you can get metadata for using the /api/v1/series query is 10,000.
  • The maximum number of time series you can read per one /api/v1/query or /api/v1/query_range query is 10,000.
  • --query.lookback-delta is set to 5m.

© 2025 Linux Foundation. All rights reserved. The Linux Foundation owns and uses registered trademarks. For a list of Linux Foundation trademarks, see Trademark Usage.

Previous
Visualization in Monitoring
Next
Recording rules