Швидкий старт

OpenTelemetry Collector отримує трейси, метрики та логи, обробляє телеметрію та експортує її до широкого спектру бекендів спостереження за допомогою своїх компонентів. Концептуальний огляд Collector дивіться у розділі Collector.

Ви навчитеся робити наступне менш ніж за пʼять хвилин:

• Налаштовувати та запускати OpenTelemetry Collector.
• Надсилати телеметрію та побачити її обробку Collector.

Передумови

Переконайтеся, що ваше середовище розробника має наступне. Ця сторінка передбачає, що ви використовуєте bash. Адаптуйте конфігурацію та команди відповідно до вашої улюбленої оболонки.

• Docker або будь-яке сумісне середовище виконання контейнерів.

• Go 1.20 або вище

• GOBIN змінна середовища встановлена; якщо не встановлена, ініціалізуйте її відповідним чином, наприклад¹:

  export GOBIN=${GOBIN:-$(go env GOPATH)/bin}
  

Налаштування середовища

1. Завантажте базовий Docker-образ OpenTelemetry Collector:

   docker pull otel/opentelemetry-collector:0.146.1
   

2. Встановіть утиліту telemetrygen:

   go install github.com/open-telemetry/opentelemetry-collector-contrib/cmd/telemetrygen@latest
   

   Ця утиліта може імітувати клієнта, що генерує трейси, метрики та логи.

Генерація та збір телеметрії

3. Запустіть Collector, який слухає на портах 4317 (для OTLP gRPC), 4318 (для OTLP HTTP) та 55679 (для ZPages):

   docker run \
     -p 127.0.0.1:4317:4317 \
     -p 127.0.0.1:4318:4318 \
     -p 127.0.0.1:55679:55679 \
     otel/opentelemetry-collector:0.146.1 \
     2>&1 | tee collector-output.txt # Опціонально tee вивід для полегшення пошуку пізніше
   

4. В окремому вікні термінала згенеруйте кілька зразків трейсів:

   $GOBIN/telemetrygen traces --otlp-insecure --traces 3
   

   Серед виводу, згенерованого утилітою, ви повинні побачити підтвердження, що трейси були згенеровані:

   2024-01-16T14:33:15.692-0500  INFO  traces/worker.go:99  traces generated  {"worker": 0, "traces": 3}
   2024-01-16T14:33:15.692-0500  INFO  traces/traces.go:58  stop the batch span processor
   

   Для полегшення перегляду відповідного виводу ви можете відфільтрувати його:

   $GOBIN/telemetrygen traces --otlp-insecure \
     --traces 3 2>&1 | grep -E 'start|traces|stop'
   

5. У вікні термінала, де запущено контейнер Collector, ви повинні побачити активність отримувача трейсів, подібну до показаної у наступному прикладі:

   $ grep -E '^Span|(ID|Name|Kind|time|Status \w+)\s+:' ./collector-output.txt
   Span #0
       Trace ID       : f30faffbde5fcf71432f89da1bf7bc14
       Parent ID      : 6f1ff7f9cf4ec1c7
       ID             : 8d1e820c1ac57337
       Name           : okey-dokey
       Kind           : Server
       Start time     : 2024-01-16 14:13:54.585877 +0000 UTC
       End time       : 2024-01-16 14:13:54.586 +0000 UTC
       Status code    : Unset
       Status message :
   Span #1
       Trace ID       : f30faffbde5fcf71432f89da1bf7bc14
       Parent ID      :
       ID             : 6f1ff7f9cf4ec1c7
       Name           : lets-go
       Kind           : Client
       Start time     : 2024-01-16 14:13:54.585877 +0000 UTC
       End time       : 2024-01-16 14:13:54.586 +0000 UTC
       Status code    : Unset
       Status message :
   ...
   

6. Відкрийте http://localhost:55679/debug/tracez та виберіть один зі зразків в таблиці, щоб побачити згенеровані трейси.

7. Після завершення роботи вимкніть контейнер Collector, наприклад, використовуючи Control-C.

Наступні кроки

У цьому навчальному посібнику ви запустили OpenTelemetry Collector та надіслали телеметрію до нього. Як наступні кроки, розгляньте можливість зробити наступне:

• Досліджуйте різні способи встановлення Collector.
• Дізнайтеся про різні режими Collector у Методах розгортання.
• Ознайомтеся з файлами та структурою конфігурації Collector.
• Дивіться доступні компоненти у реєстрі.
• Дізнайтеся, як створити власний Collector за допомогою OpenTelemetry Collector Builder (OCB).