Installing Jaeger over YDB Backend

Written by

Improved by

Updated at January 26, 2026

Installation from Cloud Marketplace
Installation using a Helm chart
Use cases
See also

Jaeger is an open-source distributed tracing platform. Jaeger enables you to monitor request status and debug distributed microservice application systems after faults.

Jaeger uses the following types of data storage:

Yandex Managed Service for YDB when installed from Yandex Cloud Marketplace.
Other data storage systems when installed via a Helm chart.

Installation from Cloud Marketplace

Getting started

Make sure the security groups for the Managed Service for Kubernetes cluster and its node groups are configured correctly. If a rule is missing, add it.

Warning

The configuration of security groups determines performance and availability of the cluster and the services and applications running in it.
Install kubect and configure it to work with the new cluster.
Install the jq JSON stream processor.
```
sudo apt update && sudo apt install jq
```
To enable pods in the Kubernetes cluster to connect to Managed Service for YDB, configure security groups. Add a rule for incoming traffic:
- Port range: 2135.
- Protocol: TCP.
- Source: Security group.
- Security group: Current (Self).

Preparing Managed Service for YDB

Create a database of the Dedicated type with a suitable configuration.

Warning

Jaeger requires a Dedicated database to work properly.
Create a directory named jaeger.

Creating a service account

To enable Jaeger to communicate with Managed Service for YDB, create a service account and get a key for it.

Create a service account with a suitable role in the Kubernetes cluster.

Create a service account key and save it to your local machine:

yc iam key create \
  --service-account-id <service_account_ID> \
  --folder-id <folder_ID> \
  --cloud-id <cloud_ID> \
  --description jaeger-over-ydb \
  --format json \
  -o key.json

Result:

{
  "id": "<service_account_key_ID>",
  "service_account_id": "<service_account_ID>",
  "created_at": "2022-01-27T03:29:45.139311367Z",
  "description": "jaeger-over-ydb",
  "key_algorithm": "RSA_2048"
}

Note

Save the IDs of your service account and service account key: you will use them in subsequent installation steps.

Save the service account key in Base64 format:
```
jq -r .private_key key.json > key.pem
```