Настройка демо-приложения и сбор телеметрии в Kubernetes

Вы настроите демо-приложение в кластере Kubernetes и передадите телеметрию приложения в Monium. В инструкции для разворачивания кластера используется сервис Managed Service for Kubernetes, но вы можете использовать любой ваш кластер Kubernetes.

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

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.

Подробнее об облаках и каталогах.

Необходимые платные ресурсыНеобходимые платные ресурсы

В стоимость ресурсов для работы с Monium входит:

• Плата за использование мастера Managed Service for Kubernetes (см. тарифы Managed Service for Kubernetes).
• Плата за вычислительные ресурсы и диски группы узлов Managed Service for Kubernetes (см. тарифы Yandex Compute Cloud).
• Плата за использование Monium (см. тарифы Monium).

Настройка кластераНастройка кластера

Поставка и просмотр телеметрииПоставка и просмотр телеметрии

1. Создайте файл со следующей конфигурацией otel-demo-monium.yml:

   # https://github.com/open-telemetry/opentelemetry-helm-charts/blob/main/charts/opentelemetry-demo/README.md
   opentelemetry-collector:
   extraEnvsFrom:
       - secretRef:
           name: monium-secrets
   
   config:
       receivers:
       # Сбор метрик grafana, по умолчанию не настроено в демо-приложении
       prometheus:
           config:
           scrape_configs:
               - job_name: "grafana"
               kubernetes_sd_configs:
                   - role: pod
               relabel_configs:
                   # Фильтр по метке (оставляем только grafana)
                   - source_labels: [__meta_kubernetes_pod_label_app_kubernetes_io_name]
                   action: keep
                   regex: grafana
   
                   # Заменяем адрес на IP пода и порт 3000
                   - source_labels: [__address__]
                   action: replace
                   regex: "([^:]+)(?::\\d+)?"
                   replacement: "$1:3000"
                   target_label: __address__
   
                   # Указываем путь к метрикам
                   - action: replace
                   target_label: __metrics_path__
                   replacement: /grafana/metrics
   
       exporters:
       debug:
           verbosity: detailed
   
       otlp/monium:
           compression: none
           endpoint: ingest.monium.yandex.cloud:443
           headers:
           Authorization: "Api-Key ${env:MONIUM_API_KEY}"
           x-monium-project: folder__<идентификатор_каталога>
   
       service:
       extensions: [health_check]
       pipelines:
           traces:
           receivers: [otlp]
           exporters: [otlp, spanmetrics, otlp/monium]
   
           logs:
           receivers: [otlp]
           exporters: [opensearch, otlp/monium]
   
           metrics:
           receivers: [httpcheck/frontend-proxy, otlp, prometheus, redis, spanmetrics]
           exporters: [otlphttp/prometheus, otlp/monium]
   
       telemetry:
           resource:
           service: otel-collector
           metrics:
           level: detailed
           readers:
               - periodic:
                   exporter:
                   otlp:
                       endpoint: ${env:MY_POD_IP}:4317
                       protocol: grpc
                   interval: 10000
                   timeout: 5000
   

2. Установите демо-приложение с поставкой логов, метрик и трейсов в Monium:

   helm uninstall otel-demo-monium -n $NS --ignore-not-found
   helm install otel-demo-monium open-telemetry/opentelemetry-demo \
   --version 0.37 \
   -n $NS \
   --values otel-demo-monium.yml
   

3. Создайте трафик, чтобы отправлять телеметрию.

   1. Настройте проброс портов для сервиса frontend-proxy:

      kubectl --namespace default port-forward svc/frontend-proxy 8080:8080
      

   2. В браузере откройте интернет-магазин по адресу http://localhost:8080/ и совершайте действия пользователя. Например, добавьте товар в корзину.

Посмотрите данные телеметрииПосмотрите данные телеметрии

Для использования данных телеметрии создайте дашборд и алерты.

Если телеметрия не отображается в MoniumЕсли телеметрия не отображается в Monium

• Убедитесь, что сервисный аккаунт и API-ключ имеют нужные роли и области действия.

• Проверьте, что в секретах указан верный API-ключ:

  kubectl get secret monium-secrets -n $NS -o jsonpath='{.data.MONIUM_API_KEY}' | base64 -d
  

• Проверьте логи OTel Collector:

  kubectl logs -l app.kubernetes.io/name=opentelemetry-collector -n $NS
  

• Убедитесь, что эндпоинт Monium доступен:

  kubectl run -it --rm debug --image=curlimages/curl --restart=Never -- \
  curl -v https://ingest.monium.yandex.cloud