IKuznetsov: Новая страница: «В этом пошаговом руководстве показано, как добавить возможность наблюдения в ваше '''PHP-п...»

2025-10-09T17:50:16Z

Новая страница: «В этом пошаговом руководстве показано, как добавить возможность наблюдения в ваше '''PHP-п...»

Новая страница

В этом пошаговом руководстве показано, как добавить возможность наблюдения в ваше '''PHP-приложение''' с помощью '''PHP-библиотек''' и инструментов '''OpenTelemetry'''.
{| class="wikitable"
|Расширение с помощью ЕдиногоАгента

В настоящее время невозможно автоматически дополнять сервисы информацией, относящейся к хосту. Для этого потребуется перейти на ручное инструментирование.
|}

== Получение данных для доступа к Ключ-АСТРОМ ==

=== Определить базовый URL API ===
Подробную информацию о сборке базового '''URL-адреса''' конечной точки '''OTLP''' см. в разделе [[Экспорт с помощью OTLP]]. '''URL-адрес''' должен заканчиваться на <code>/api/v2/otlp</code>.

=== Получение токена доступа API ===
Токен доступа для сбора трассировок, логов и метрик можно создать в разделе [[Токен доступа|Токены доступа]] .

Экспорт с помощью '''OTLP''' содержит более подробную информацию о формате и необходимых областях доступа.

== Инструментирование своего приложения ==
1. Убедитесь, что у вас есть соответствующая среда сборки для вашей системы, состоящая из '''GCC''', '''Make''' и '''Autoconfig'''.

2. Соберите и установите библиотеку инструментов с помощью [https://github.com/FriendsOfPHP/pickle pickle].
{| class="wikitable"
|php pickle.phar install opentelemetry
|}
3. Добавьте вновь скомпилированную библиотеку как расширение к вашему <code>php.ini</code>.
{| class="wikitable"
|extension=opentelemetry.so
|}
4. Перезапустите PHP и убедитесь, что расширение загружено.

* Из командной строки, с помощью <code>php -m</code>
* В рамках веб-сервера, путем вызова <code>phpinfo()</code>

5. Установите '''SDK''' и другие зависимости.

* <code>необходимо</code> [https://packagist.org/packages/open-telemetry/sdk Установите SDK для OpenTelemetry PHP].
* <code>необязательно</code> В зависимости от библиотек, используемых вашим приложением, вам может потребоваться добавить другие библиотеки инструментирования в зависимости. Список поддерживаемых библиотек можно найти в [https://opentelemetry.io/ecosystem/registry/?component=instrumentation&language=php реестре OpenTelemetry] .
* <code>необходимо</code> Вам необходимо использовать [https://getcomposer.org/doc/01-basic-usage.md#autoloading автозагрузку композитора] , поскольку это механизм, который все пакеты автоинструментации используют для своей регистрации.

6. Настройте следующие переменные среды.
{| class="wikitable"
|OTEL_PHP_AUTOLOAD_ENABLED=true

OTEL_SERVICE_NAME=php-quickstart

OTEL_PROPAGATORS=baggage,tracecontext

OTEL_EXPORTER=otlp

OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

OTEL_EXPORTER_OTLP_ENDPOINT=[URL]

OTEL_EXPORTER_OTLP_HEADERS="Authorization=Api-Token [TOKEN]"

OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta
|}
Замените <code>[URL]</code> и <code>[TOKEN]</code> соответствующими значениями.

== Обеспечение распространение контекста ==
Распространение контекста особенно важно, когда задействованы сетевые вызовы (например, '''REST''').

При автоматическом инструментировании это должно быть автоматически реализовано библиотеками инструментирования. Если используемые сетевые библиотеки не покрываются этим инструментированием, вам придётся перейти на ручное инструментирование и управлять распространением вручную.

== Настройка сбора данных в соответствии с требованиями конфиденциальности (необязательно) ==
Хотя Ключ-АСТРОМ автоматически собирает все атрибуты '''OpenTelemetry''', в веб-интерфейсе Ключ-АСТРОМ сохраняются и отображаются только значения атрибутов, указанные в списке разрешенных. Это предотвращает случайное сохранение персональных данных, позволяя вам соблюдать требования к конфиденциальности и контролировать объем хранимых данных мониторинга.

Чтобы просматривать пользовательские атрибуты, необходимо сначала разрешить их использование в веб-интерфейсе Ключ-АСТРОМ.

== Проверка загрузки данных в Ключ-АСТРОМ ==
После завершения инструментирования вашего приложения выполните несколько тестовых действий для создания и отправки демонстрационных трассировок, метрик и логов, а также проверьте, что они были правильно загружены в Ключ-АСТРОМ.

Чтобы сделать это для трассировок, перейдите в раздел '''Трассировки''' и выберите вкладку '''Распределенные трассировки'''. Если вы используете ЕдиныйАгент, выберите '''PurePaths''' .

Для просмотра метрик и логов перейдите в раздел '''Метрики''' или '''Логов''' или '''Логи и события'''.

Автоматическое внедрение OpenTelemetry в PHP-приложение - История изменений

IKuznetsov: Новая страница: «В этом пошаговом руководстве показано, как добавить возможность наблюдения в ваше '''PHP-п...»