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

Коли ви розробляєте застосунок, ви можете використовувати сторонні бібліотеки та фреймворки, щоб прискорити свою роботу. Якщо ви потім інструментуєте свій застосунок за допомогою 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.

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

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

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