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

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

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

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

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

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

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

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

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

Розширення OpenTelemetry PHP включає бібліотеки інструментування для багатьох поширених PHP фреймворків. Наприклад, інструментування Laravel автоматично створює відрізки на основі активності застосунку.

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

Кожна бібліотека інструментування є пакунком Composer. Щоб встановити її, виконайте наступну команду:

php composer.phar install {name-of-instrumentation}:{version-number}

Де {name-of-instrumentation} є посиланням на Packagist для конкретного інструментування, яке ви хочете використовувати.

Ви можете вимкнути будь-яке інструментування, додавши його ідентифікатор до змінної середовища OTEL_PHP_DISABLED_INSTRUMENTATIONS.

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

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

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

Після налаштування бібліотек інструментування, ви можете додати додаткове інструментування для збору власних даних телеметрії.

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