> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Генерация синтетических данных OpenTelemetry с помощью otelgen > Используйте otelgen для отправки синтетических журналов, трассировок и метрик в коллектор ClickStack OpenTelemetry [`otelgen`](https://github.com/krzko/otelgen) — небольшая CLI-утилита на Go, которая генерирует синтетические журналы, трассировки и метрики OTLP. Используйте её, чтобы проверить, что существующий коллектор ClickStack OpenTelemetry принимает данные, а события появляются в интерфейсе ClickStack. В этом руководстве предполагается, что коллектор уже запущен и использует конечные точки OTLP на `4317` (gRPC) и `4318` (HTTP). ### Предварительные требования В этом руководстве предполагается, что вы выполнили [руководство Getting Started для Управляемого ClickStack](/ru/clickstack/deployment/managed) и что у вас запущен OpenTelemetry Collector с конечными точками OTLP gRPC (`4317`) и HTTP (`4318`), доступными с машины, на которой вы запускаете `otelgen`. Если вы [защитили коллектор](/ru/clickstack/ingesting-data/collector#securing-the-collector) с помощью `OTLP_AUTH_TOKEN`, держите это значение под рукой. ### Установите otelgen Установите с помощью Homebrew: ```shell theme={null} brew install krzko/tap/otelgen ``` Или установите с помощью Go: ```shell theme={null} go install github.com/krzko/otelgen@latest ``` ### Задайте переменные окружения Экспортируйте конечную точку коллектора и, если коллектор защищён, токен аутентификации: ```shell theme={null} export OTEL_ENDPOINT=:4317 export OTLP_AUTH_TOKEN= ``` Используйте хост и порт вашего коллектора. Для коллектора, запущенного на той же машине, это `localhost:4317`. **Незащищённый коллектор** Коллектор ClickStack OpenTelemetry по умолчанию не требует аутентификации. Если вы не выполнили инструкции из [Securing the collector](/ru/clickstack/ingesting-data/collector#securing-the-collector), чтобы задать `OTLP_AUTH_TOKEN`, пропустите здесь `OTLP_AUTH_TOKEN` и уберите флаг `--header` из команд ниже. ### Сгенерируйте traces Отправьте короткую серию трассировок с несколькими span: ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${OTLP_AUTH_TOKEN}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ traces multi ``` `--rate` — это число traces в секунду, а `--duration` — длительность выполнения в секундах. `--insecure` отключает TLS для gRPC-соединения, что требуется при подключении `otelgen` к незашифрованному порту OTLP коллектора. ### Сгенерируйте логи ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${OTLP_AUTH_TOKEN}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ logs multi ``` ### Сгенерируйте метрики Подкоманды `metrics` не учитывают `--duration`. Запустите команду и через несколько секунд нажмите `Ctrl+C`, чтобы остановить её. ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${OTLP_AUTH_TOKEN}" \ --protocol grpc --insecure \ --rate 2 \ metrics sum ``` `otelgen` также поддерживает подкоманды `gauge`, `histogram`, `up-down-counter` и `exponential-histogram` в разделе `metrics`. ### Проверьте в ClickStack Откройте интерфейс ClickStack из консоли ClickHouse Cloud. В представлении `Search` переключайте источник между `Logs` и `Traces`, чтобы убедиться, что новые события появились. Установите временной диапазон `Last 15 minutes`. Откройте `Chart Explorer`, выберите `Metrics` и постройте график по одному из имён метрик, созданных `otelgen` (например, `otelgen.metrics.sum`), чтобы проверить ингестию метрик. ### Предварительные требования В этом руководстве предполагается, что вы уже запустили Open Source ClickStack, следуя [инструкциям для all-in-one image](/ru/clickstack/getting-started/oss), и что конечные точки OTLP (`4317` gRPC и `4318` HTTP) доступны. Также вам потребуется ключ API для приёма данных из интерфейса HyperDX, в разделе `Team Settings > API Keys`. ### Установка otelgen Установите с помощью Homebrew: ```shell theme={null} brew install krzko/tap/otelgen ``` Или установите с помощью Go: ```shell theme={null} go install github.com/krzko/otelgen@latest ``` ### Задайте переменные окружения Экспортируйте конечную точку коллектора и ключ API для приёма данных: ```shell theme={null} export OTEL_ENDPOINT=localhost:4317 export CLICKSTACK_API_KEY= ``` ### Сгенерируйте трассировки Отправьте короткую серию трассировок с несколькими span: ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${CLICKSTACK_API_KEY}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ traces multi ``` `--rate` — это количество трассировок в секунду, а `--duration` — длительность выполнения в секундах. `--insecure` включает plaintext gRPC для локального коллектора. ### Сгенерируйте журналы ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${CLICKSTACK_API_KEY}" \ --protocol grpc --insecure \ --rate 2 --duration 10 \ logs multi ``` ### Сгенерируйте метрики Подкоманды metrics не учитывают `--duration`. Запустите команду и через несколько секунд нажмите `Ctrl+C`, чтобы остановить её. ```shell theme={null} otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \ --header "authorization=${CLICKSTACK_API_KEY}" \ --protocol grpc --insecure \ --rate 2 \ metrics sum ``` `otelgen` также поддерживает подкоманды `gauge`, `histogram`, `up-down-counter` и `exponential-histogram` в разделе `metrics`. ### Проверьте в ClickStack Перейдите по адресу [http://localhost:8080](http://localhost:8080), чтобы открыть интерфейс ClickStack. В представлении `Search` переключайте источник между `Logs` и `Traces`, чтобы убедиться, что появились новые события. Установите диапазон времени `Last 15 minutes`. Откройте `Chart Explorer`, выберите `Metrics` и постройте график по одному из имён метрик, созданных `otelgen` (например, `otelgen.metrics.sum`), чтобы проверить ингестию метрик.