Installing Jaeger over YDB Backend

Written by

Improved by

Updated at October 9, 2024

Installation using 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 is able to use 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 using Cloud Marketplace

Getting started

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

Warning

The configuration of security groups determines the performance and availability of the cluster and the services and applications running in it.
Install kubectl and configure it to work with the created cluster.
Install the jq utility for JSON filtering:
```
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)

Managed Service for YDB setup

Create a database with a suitable configuration, selecting Dedicated as your DB type.

Warning

A Dedicated database is required for Jaeger 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 obtain 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 service account and the service account key IDs: you will use them for subsequent installation steps.

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