Використання бібліотек інструментування

Під час розробки застосунку ви можете використовувати сторонні бібліотеки та фреймворки для прискорення роботи. Якщо ви потім інструментуєте свій застосунок за допомогою OpenTelemetry, ви можете не витрачати додатковий час на ручне додавання трейсів, логів та метрик до сторонніх бібліотек та фреймворків, які ви використовуєте.

Багато бібліотек та фреймворків вже підтримують OpenTelemetry або підтримуються через інструментування OpenTelemetry, тому вони можуть генерувати телеметричні дані, які ви можете експортувати до бекенду спостереження.

Якщо ви інструментуєте застосунок або сервіс, який використовує сторонні бібліотеки або фреймворки, дотримуйтесь цих інструкцій, щоб дізнатися, як використовувати вбудовані бібліотеки інструментування та бібліотеки інструментування для ваших залежностей.

Використання вбудованих бібліотек

Якщо бібліотека стандартно постачається з підтримкою OpenTelemetry, ви можете отримувати трейси, метрики та логи, що генеруються цією бібліотекою, додавши та налаштувавши OpenTelemetry SDK у вашому застосунку.

Бібліотека може вимагати додаткової конфігурації інструментування. Перейдіть до документації для цієї бібліотеки, щоб дізнатися більше.

Використання бібліотек інструментування

Якщо бібліотека не підтримує OpenTelemetry з коробки, ви можете використовувати бібліотеки інструментування для генерації телеметричних даних для бібліотеки або фреймворку.

Наприклад, бібліотека інструментування для net/http автоматично створює відрізки та метрики на основі HTTP-запитів.

Налаштування

Кожна бібліотека інструментування є пакунком. Загалом, це означає, що вам потрібно виконати go get для відповідного пакету. Наприклад, щоб отримати бібліотеки інструментування, які підтримуються в Contrib репозиторії, виконайте наступне:

go get go.opentelemetry.io/contrib/instrumentation/{import-path}/otel{package-name}

Потім налаштуйте її у вашому коді відповідно до вимог бібліотеки для активації.

Початок роботи надає приклад налаштування інструментування для сервера net/http.

Доступні пакети

Повний список доступних бібліотек інструментування можна знайти в реєстрі OpenTelemetry.

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

Бібліотеки інструментування можуть генерувати телеметричні дані для вхідних та вихідних HTTP-запитів, але вони не інструментують ваш застосунок.

Збагачуйте свої телеметричні дані, інтегруючи власне інструментування у ваш код. Це доповнює телеметрію стандартної бібліотеки та може надати глибші відомості про роботу вашого застосунку.