Exporting metrics in Prometheus format

To export metrics in the Prometheus format, use the prometheusMetrics method. Before uploading metrics to Prometheus, set up metric collection in Prometheus.

An example of metric collection setup from Monitoring in Prometheus:

1. Select the folder you want to collect data from.

2. Select a service from the following list:

   • application-load-balancer: Application Load Balancer
   • audit-trails: Audit Trails
   • cdn: Cloud CDN.
   • certificate-manager: Certificate Manager
   • compute: Compute Cloud
   • container-registry: Container Registry
   • data-proc: Yandex Data Processing
   • data-streams: Data Streams
   • data-transfer: Data Transfer
   • iam: Identity and Access Management
   • interconnect: Cloud Interconnect
   • kms: Key Management Service
   • logging: Cloud Logging
   • managed-clickhouse: Managed Service for ClickHouse®
   • managed-elasticsearch: Managed Service for Elasticsearch
     managed-greenplum: Managed Service for Greenplum®
   • managed-kafka: Managed Service for Apache Kafka®
   • managed-kubernetes: Managed Service for Kubernetes
   • managed-mongodb: Managed Service for MongoDB
   • managed-mysql: Managed Service for MySQL®
   • managed-opensearch: Managed Service for OpenSearch
   • managed-postgresql: Managed Service for PostgreSQL
   • managed-redis: Yandex Managed Service for Valkey™
   • managed-sqlserver: Managed Service for SQL Server
   • message-queue: Message Queue
   • monitoring: Monitoring
   • network-load-balancer: Network Load Balancer
   • serverless-apigateway: API Gateway
   • serverless-containers: Serverless Containers
   • serverless-functions: Cloud Functions
   • speechkit: SpeechKit
   • storage: Object Storage
   • translate: Translate
   • vision: Vision OCR
   • ydb: Managed Service for YDB

3. Create a static API key for the service account.

4. Assign the service account the monitoring.viewer role for the selected folder.

5. Add a new job to the data collection section of the Prometheus configuration.

   ...
   scrape_configs:
     ...
     - job_name: 'yc-monitoring-export'
       metrics_path: '/monitoring/v2/prometheusMetrics'
       scheme: 'https'
       params:
         folderId:
         - '<folder_ID>' # e.g., aoeng2krmasi********
         service:
         - '<service>' # e.g., managed-mongodb
       bearer_token: '<API_key>'
       # Or via a file (recommended):
       # bearer_token_file: '<name_of_the_file_with_the_API_key>'
       static_configs:
       - targets: ['monitoring.api.cloud.yandex.net']
         labels:
           folderId: '<folder_ID>'
           service: '<service_ID>'
   

6. Restart Prometheus.

7. Check the data collection in the Prometheus user interface: http://localhost:9090/targets (replace localhost with the name of the host running Prometheus).

8. If you need to change label names, use relabeling.

ClickHouse® is a registered trademark of ClickHouse, Inc.