Установка Jaeger over YDB Backend

Jaeger — платформа для распределенной трассировки с открытым исходным кодом. Jaeger позволяет выполнять мониторинг состояния запросов и отладку после сбоев в распределенных системах микросервисных приложений.

В качестве хранилища данных Jaeger может использовать:

• Yandex Managed Service for YDB при установке через Yandex Cloud Marketplace.
• Другие системы хранения данных при установке через Helm-чарт.

Установка с помощью Cloud MarketplaceУстановка с помощью Cloud Marketplace

Перед началом работыПеред началом работы

1. Убедитесь, что группы безопасности для кластера Managed Service for Kubernetes и его групп узлов настроены корректно. Если отсутствует какое-либо из правил — добавьте его.

   Важно

   От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений.

2. Установите kubectl и настройте его на работу с созданным кластером.

3. Для потоковой обработки JSON-файлов установите утилиту jq:

   sudo apt update && sudo apt install jq
   

4. Чтобы разрешить подам кластера Kubernetes подключаться к Managed Service for YDB, настройте группы безопасности. Добавьте правило для входящего трафика:

   • Диапазон портов — 2135.
   • Протокол — TCP.
   • Источник — Группа безопасности.
   • Группа безопасности — Текущая (Self).

Подготовка Managed Service for YDBПодготовка Managed Service for YDB

1. Создайте базу данных подходящей вам конфигурации с типом БД Dedicated.

   Важно

   БД в режиме Dedicated — обязательное условие корректной работы сервиса Jaeger.

2. Создайте директорию с именем jaeger.

Создание сервисного аккаунтаСоздание сервисного аккаунта

Чтобы Jaeger мог взаимодействовать с Managed Service for YDB, создайте сервисный аккаунт и получите для него ключ.

1. Создайте сервисный аккаунт с подходящей вам ролью в кластере Kubernetes.

2. Создайте ключ для сервисного аккаунта и сохраните его на локальный компьютер:

   yc iam key create \
     --service-account-id <идентификатор_сервисного_аккаунта> \
     --folder-id <идентификатор_каталога> \
     --cloud-id <идентификатор_облака> \
     --description jaeger-over-ydb \
     --format json \
     -o key.json
   

   Результат:

   {
     "id": "<идентификатор_ключа_сервисного_аккаунта>",
     "service_account_id": "<идентификатор_сервисного_аккаунта>",
     "created_at": "2022-01-27T03:29:45.139311367Z",
     "description": "jaeger-over-ydb",
     "key_algorithm": "RSA_2048"
   }
   

   Примечание

   Сохраните идентификаторы сервисного аккаунта и его ключа — они понадобятся при дальнейшей установке.

3. Сохраните ключ сервисного аккаунта в формате Base64:

   jq -r .private_key key.json > key.pem
   

Установка JaegerУстановка Jaeger

1. Перейдите на страницу каталога и выберите сервис Managed Service for Kubernetes.

2. Нажмите на имя нужного кластера и выберите вкладку Marketplace.

3. В разделе Доступные для установки приложения выберите Jaeger over Managed Service for YDB Backend и нажмите кнопку Перейти к установке.

4. Задайте настройки приложения:

   • Пространство имен — создайте новое пространство имен (например, jaeger-space). Если вы оставите пространство имен по умолчанию, Jaeger может работать некорректно.
   • Название приложения — укажите название приложения.
   • Managed Service for YDB эндпоинт — укажите имя эндпоинта Managed Service for YDB, например lb.etnk1hv0jol3********.ydb.mdb.yandexcloud.net:2135.
   • База данных — укажите имя БД, например /ru-central1/b1gkgm9daf46********/etnk2hv0jol5********.
   • Директория в базе данных — jaeger.
   • Использовать сервис метаданных для аутентификации изнутри ВМ — выберите эту опцию, если требуется аутентификация внутри виртуальной машины.
   • ID ключа сервисного аккаунта — укажите идентификатор ключа сервисного аккаунта.
   • Ключ сервисного аккаунта — укажите идентификатор сервисного аккаунта.
   • Приватный ключ сервисного аккаунта — скопируйте в это поле содержимое файла key.pem.
   • Установить jaeger-agent — выберите эту опцию, чтобы установить jaeger-agent.

   Имя эндпоинта и БД были получены при подготовке БД Managed Service for YDB, настройки для сервисного аккаунта — в предыдущем подразделе.

5. Нажмите кнопку Установить.

6. Дождитесь перехода приложения в статус Deployed.

Установка с помощью Helm-чартаУстановка с помощью Helm-чарта

1. Установите менеджер пакетов Helm версии не ниже 3.8.0.

2. Убедитесь, что группы безопасности для кластера Managed Service for Kubernetes и его групп узлов настроены корректно. Если отсутствует какое-либо из правил — добавьте его.

   Важно

   От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений.

3. Установите kubectl и настройте его на работу с созданным кластером.

4. Добавьте репозиторий jaegertracing:

   helm repo add jaegertracing https://jaegertracing.github.io/helm-charts
   

5. Установите Jaeger:

   helm install jaeger jaegertracing/jaeger
   

6. При необходимости установите Kubernetes-оператор jaeger-operator:

   helm install jaegertracing/jaeger-operator
   

   Подробнее о таком типе установки см. в документации платформы Jaeger.

Примеры использованияПримеры использования

• Использование Jaeger для трассировки запросов в Managed Service for YDB.

См. такжеСм. также

• Документация Jaeger.