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

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

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

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

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

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

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

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

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

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

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

Кожна бібліотека інструментування розповсюджується як пакунок Hex. Щоб встановити бібліотеку інструментування, додайте залежність до вашого файлу mix.exs. Наприклад:

def deps do
  [
    {:opentelemetry_{package}, "~> 1.0"}
  ]
end

Де {package} — це назва бібліотеки інструментування.

Зверніть увагу, що деякі бібліотеки інструментування можуть мати попередні умови. Перевірте документацію кожної бібліотеки інструментування для подальших інструкцій.

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

Для повного списку бібліотек інструментування дивіться список пакунків Hex.

Ви також можете знайти більше інструментів у реєстрі.

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

Після налаштування бібліотек інструментування, ви можете додати своє власне інструментування до вашого коду, щоб збирати власні телеметричні дані.

Ви також можете налаштувати відповідний експортер для експорту ваших телеметричних даних до одного або більше бекендів телеметрії.