PHP 7.4でもOpenTelemetryゼロコード計装がしたい！ / PHPerKaigi 2026

PHP 7.4でもOpenTelemetry ゼロコード計装がしたい！ id:arthur-1 株式会社はてな 2026-03-21 PHPerKaigi 2026 [Day 0,
Track C]

前置き本セッションでは、タイトル通りすでにEoLを迎えたPHPについての話題が出てきますが、それらの使用を奨励する意図はありません 2

Arthurと申します株式会社はてな Mackerel開発チームサブディレクター・テックリード 𝕏: @Arthur1__ 好きなPHPの関数：array_column() 次はPHPカンファレンス小田原2026でお会いしましょう（コアスタッフ） 3

まずはアンケート 4

オブザーバビリティ知ってますか？ 5

OpenTelemetry 知ってますか？ 6

PHPのOTel計装やったことありますか？ 7

おしながき • 導入：OpenTelemetry • PHP 8.0から利用できるOTel公式のゼロコード計装の仕組み • PHP 7.4でどうゼロコード計装を実現するか
8

持ち帰ることができる知識 • PHPのOpenTelemetryゼロコード計装を実現している仕組みがわかる • PHPの拡張モジュールの実装のコードが少しだけ読めるようになる • PHP 7.4でもOpenTelemetryゼロコード計装を頑張
りたい人への解決策が提示される 9

導入：OpenTelemetry 10

オブザーバビリティ Observability（可観測性）システムの出力から、その内部の状態を測定できる度合い内部構造が既知でなくても良い・未知の未知への対処 11 🔥 🔥

アプリケーションにおけるO11y テレメトリー：システムから出力されるデータメトリクス・トレース・ログ・プロファイルなどアプリケーションに計装してテレメトリーを生成・送出 12 🔥 🔥 ログトレースメトリクス
計装されたシステムオブザーバビリティバックエンド

OpenTelemetry OpenTelemetryは、メトリックやログなどのテレメトリーデータの生成・投稿を、ベンダーの違いを超えて標準化するオブザーバビリティフレームワーク・ツールキット 13 https://opentelemetry.io/ https://www.oreilly.co.jp/books/9784814401024/ https://www.oreilly.co.jp/books/9784814401031/

OpenTelemetryによる標準化 14 OpenTelemetryのエージェント OpenTelemetryのプロトコル name: system.cpu.time sum: dataPoints:
- asInt: 12345678 OpenTelemetryのデータ形式収集先のバックエンドの違いによらず同じものが使えるオブザーバビリティバックエンド

OTelの計装って大変？疑問や懸念 • 既存のコードベースを大きく変えなければならない？ • 運用だけ任されていて、コードを書ける人がいない…… • 面倒抜きで手っ取り早く始めたい！！ 15

計装には大きく3パターンある • コードベース計装公式のAPI・SDKをインポートして、マニュアルでテレメトリーの生成・エクスポートを実装する • ライブラリ計装既存のライブラリに計装ライブラリを外付けする • ゼロコード計装（自動計装）
ソースコードを編集しなくても計装できる 16

ゼロコード計装コードを編集しなくても、OTel SDKや計装ライブラリをアプリケーションに自動で注入アプリケーションのエッジ（リクエスト・レスポンス・データベースの呼び出しなど）を中心に観測可能にできる以下のケースで向いている： • 最初のステップ •
アプリケーションコードを修正できない 17

ゼロコード計装に対応している言語ゼロコード計装は全ての言語に対して提供されているわけではない 2026年3月現在、以下のものが公式で用意されている： 18 • .NET • Go •
Java • JavaScript • PHP • Python

PHPにおけるOTelゼロコード計装ドキュメント： https://opentelemetry.io/ja/docs/zero-code/php/ 主なステップは3つ • OpenTelemetry拡張モジュールをインストール • OpenTelemetry SDK・Exporter・フレームワークやライブラリに合わせた計装ライブラリをインストール
• エクスポートするための設定を記述（送り先など） 19

PHPゼロコード計装導入デモ PHP 8.5・Laravel 13のアプリケーションに、実際にゼロコード計装を入れるデモをお見せします 20

PHPのゼロコード計装の仕組み 22

ゼロコード計装導入でやったこと ① PECL (The PHP Extension Community Library) リポジトリに存在するOpenTelemetry拡張をインストールしていた
$ pecl install opentelemetry Dockerの場合は： RUN install-php-extensions opentelemetry 23

PHP拡張モジュール PHP拡張モジュールを使用すると、PHPのインタプリタであるZend Engineを拡張できる： • 新しい関数・クラスを追加したり • PHP単体では触れられない低レイヤに触れられたり • 関数呼び出しの前後にフックを仕掛けられたり
24

フックとゼロコード計装の関係例）HTTPリクエストにかかった時間が知りたい HTTPリクエストに相当する関数の開始時： 🕛 現在時刻を記録 HTTPリクエストに相当する関数の終了時： 🕑 すでに記録された時刻と現在時刻の差分を取る 25

拡張モジュールはC言語で書く Zend EngineはC言語で作られており、Zend Engine が公開するAPIもまたC言語のものそこで、拡張モジュールもC言語で書くことになる予告：この後C言語のコードが出てきます 26

PHP 7以前でフックさせる方法拡張モジュールロード時に、zend_execute_ex関数ポインタを差し替えることで、PHPで作られた関数の呼び出しの前後にフックを仕込める PHPの組み込み関数やPHP拡張で追加された関数の場合は、同様にzend_execute_internal関数ポインタを差し替えればよい 27

28 static void (*original_execute_ex)(zend_execute_data *execute_data) = NULL; static void my_excute_ex(zend_execute_data
*execute_data) { // ここで前処理 original_execute_ex(execute_data); // ここで後処理 } PHP_MINIT_FUNCTION(my_ext) { original_execute_ex = zend_execute_ex; zend_execute_ex = my_execute_ex; return SUCCESS; }

*execute_data) { // ここで前処理 original_execute_ex(execute_data); // ここで後処理 } PHP_MINIT_FUNCTION(my_ext) { original_execute_ex = zend_execute_ex; zend_execute_ex = my_execute_ex; return SUCCESS; } 拡張モジュールロード時に PHP_MINIT_FUNCTION が呼ばれるイメージ（マクロ）

*execute_data) { // ここで前処理 original_execute_ex(execute_data); // ここで後処理 } PHP_MINIT_FUNCTION(my_ext) { original_execute_ex = zend_execute_ex; zend_execute_ex = my_execute_ex; return SUCCESS; } 元々のzend_execute_ex 関数ポインタを退避しておく

*execute_data) { // ここで前処理 original_execute_ex(execute_data); // ここで後処理 } PHP_MINIT_FUNCTION(my_ext) { original_execute_ex = zend_execute_ex; zend_execute_ex = my_execute_ex; return SUCCESS; } 元々のzend_execute_ex をwrapした関数を定義上で定義した関数ポインタで zend_execute_exを上書き

zend_execute_exの問題点 • 各関数呼び出しがサイズ制限されたスタックに乗るので、スタックオーバーフローによりPHPがクラッシュすることがある • 全ての関数呼び出しに対してフックさせることになるので、処理時間のオーバーヘッドが大きい • PHP
8の新しいJITの仕組みにより、このフックが動作しないことがある 32

PHP 8: Observer API 先ほどの問題点を解決するため、PHP 8からZend EngineにObserver APIが導入された • スタック制限なし
• PHP 8+のJIT下でもちゃんと動く • 特定の関数のみにフックを仕掛ける仕組みがあるなど、これまでの手法の多くの問題を解決している 33

34 static void my_observer_begin(zend_execute_data *execute_data) { // ここで前処理 } static
void my_observer_end(zend_execute_data *execute_data, zval *return_value) { // ここで後処理 } static zend_observer_fcall_handlers my_observer_init(zend_execute_data *execute_data) { zend_observer_fcall_handlers handlers = {NULL, NULL}; if (execute_data->func->type == ZEND_USER_FUNCTION) { handlers.begin = my_observer_begin; handlers.end = my_observer_end; } return handlers; } PHP_MINIT_FUNCTION(my_ext) { zend_observer_fcall_register(my_observer_init); return SUCCESS; }

36 PHP_MINIT_FUNCTION(my_ext) { zend_observer_fcall_register(my_observer_init); return SUCCESS; }

37 PHP_MINIT_FUNCTION(my_ext) { zend_observer_fcall_register(my_observer_init); return SUCCESS; } 拡張モジュールロード時に PHP_MINIT_FUNCTION が呼ばれるイメージ（マクロ）

38 PHP_MINIT_FUNCTION(my_ext) { zend_observer_fcall_register(my_observer_init); return SUCCESS; } 関数オブザーバーを登録

40 static zend_observer_fcall_handlers my_observer_init( zend_execute_data *execute_data ) { zend_observer_fcall_handlers handlers
= {NULL, NULL}; if (execute_data->func->type == ZEND_USER_FUNCTION) { handlers.begin = my_observer_begin; handlers.end = my_observer_end; } return handlers; }

= {NULL, NULL}; if (execute_data->func->type == ZEND_USER_FUNCTION) { handlers.begin = my_observer_begin; handlers.end = my_observer_end; } return handlers; } 登録した関数オブザーバーの定義（zend_observer_fcall_registerの引数）

= {NULL, NULL}; if (execute_data->func->type == ZEND_USER_FUNCTION) { handlers.begin = my_observer_begin; handlers.end = my_observer_end; } return handlers; } ユーザーランド関数ならフックハンドラを追加（zend_execute_exに合わせた条件にした）

43 static zend_observer_fcall_handlers my_observer_init(zend_execute_data *execute_data) { zend_observer_fcall_handlers handlers = {NULL,
NULL}; if (execute_data->func->type == ZEND_USER_FUNCTION) { handlers.begin = my_observer_begin; handlers.end = my_observer_end; } return handlers; } ユーザーランド関数でなければハンドラはなし

45 static void my_observer_begin( zend_execute_data *execute_data ) { // ここで前処理
} static void my_observer_end( zend_execute_data *execute_data, zval *return_value ) { // ここで後処理 }

} static void my_observer_end( zend_execute_data *execute_data, zval *return_value ) { // ここで後処理 } handlers.beginに設定した前処理のハンドラ zend_execute_exと同じシグネチャなので、同等のことができる

} static void my_observer_end( zend_execute_data *execute_data, zval *return_value ) { // ここで後処理 } handlers.endに設定した後処理のハンドラ zend_execute_exと同じ引数＋関数の返却値が受け取れる

【補足】Observer APIの進化 PHP 8でObserver APIが導入された当初は、ユーザーランドの関数だけにしかフックできなかった PHP 8.2からは内部関数にも対応 > Registered
zend_observer_fcall_init handlers are now also called for internal functions. https://github.com/php/php-src/blob/php-8.2.0/UPGRADING.INTE RNALS#L54 48

PHPのOTelゼロコード計装は8.0から https://opentelemetry.io/ja/d ocs/zero-code/php/ には、PHP のゼロコード計装はPHP 8.0以降でなければいけないと書いてあるその理由の1つが、ゼロコード計装の仕組みがObserver APIに依
存していること 49

OpenTelemetry\Instrumentation\hook OpenTelemetry拡張は、任意の関数・メソッドにフックを仕掛けられる関数 OpenTelemetry\Instrumentation\hook を提供している。この関数により、Observer APIでフックさせたい関数を拡張に登録する 50 OpenTelemetry\Instrumentation\hook(
DemoClass::class, 'run', pre: static function (DemoClass $demo, array $params, string $class, string $function, ?string $filename, ?int $lineno) { … }, post: static function (DemoClass #demo, array $params, $returnValue, ?Throwable $exception) { … }, )

51 PHP_FUNCTION(OpenTelemetry_Instrumentation_hook) { zend_string *class_name; zend_string *function_name; zval *pre =
NULL; zval *post = NULL; ZEND_PARSE_PARAMETERS_START(2, 4) Z_PARAM_STR_OR_NULL(class_name) Z_PARAM_STR(function_name) Z_PARAM_OPTIONAL Z_PARAM_OBJECT_OF_CLASS_OR_NULL(pre, zend_ce_closure) Z_PARAM_OBJECT_OF_CLASS_OR_NULL(post, zend_ce_closure) ZEND_PARSE_PARAMETERS_END(); RETURN_BOOL(add_observer(class_name, function_name, pre, post)); } https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/opentelemetry.c#L107-L122

NULL; zval *post = NULL; ZEND_PARSE_PARAMETERS_START(2, 4) Z_PARAM_STR_OR_NULL(class_name) Z_PARAM_STR(function_name) Z_PARAM_OPTIONAL Z_PARAM_OBJECT_OF_CLASS_OR_NULL(pre, zend_ce_closure) Z_PARAM_OBJECT_OF_CLASS_OR_NULL(post, zend_ce_closure) ZEND_PARSE_PARAMETERS_END(); RETURN_BOOL(add_observer(class_name, function_name, pre, post)); } OpenTelemetry_Intrumentation_hook という名前の関数を定義 https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/opentelemetry.c#L107-L122

NULL; zval *post = NULL; ZEND_PARSE_PARAMETERS_START(2, 4) Z_PARAM_STR_OR_NULL(class_name) Z_PARAM_STR(function_name) Z_PARAM_OPTIONAL Z_PARAM_OBJECT_OF_CLASS_OR_NULL(pre, zend_ce_closure) Z_PARAM_OBJECT_OF_CLASS_OR_NULL(post, zend_ce_closure) ZEND_PARSE_PARAMETERS_END(); RETURN_BOOL(add_observer(class_name, function_name, pre, post)); } hook()の引数定義とparse https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/opentelemetry.c#L107-L122

NULL; zval *post = NULL; ZEND_PARSE_PARAMETERS_START(2, 4) Z_PARAM_STR_OR_NULL(class_name) Z_PARAM_STR(function_name) Z_PARAM_OPTIONAL Z_PARAM_OBJECT_OF_CLASS_OR_NULL(pre, zend_ce_closure) Z_PARAM_OBJECT_OF_CLASS_OR_NULL(post, zend_ce_closure) ZEND_PARSE_PARAMETERS_END(); RETURN_BOOL(add_observer(class_name, function_name, pre, post)); } add_observerが、ハッシュテーブルにフックの情報を保持しておく https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/opentelemetry.c#L107-L122

55 PHP_MINIT_FUNCTION(opentelemetry) { #if defined(ZTS) && defined(COMPILE_DL_OPENTELEMETRY) ZEND_TSRMLS_CACHE_UPDATE(); #endif REGISTER_INI_ENTRIES();
check_conflicts(); if (!OTEL_G(disabled)) { opentelemetry_observer_init(INIT_FUNC_ARGS_PASSTHRU); } return SUCCESS; } https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/opentelemetry.c#L140-L154

check_conflicts(); if (!OTEL_G(disabled)) { opentelemetry_observer_init(INIT_FUNC_ARGS_PASSTHRU); } return SUCCESS; } https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/opentelemetry.c#L140-L154 拡張モジュールロード時に PHP_MINIT_FUNCTION が呼ばれるイメージ（マクロ）

check_conflicts(); if (!OTEL_G(disabled)) { opentelemetry_observer_init(INIT_FUNC_ARGS_PASSTHRU); } return SUCCESS; } https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/opentelemetry.c#L140-L154 オブザーバー初期化（フックの登録）をこの中でやっている

58 void opentelemetry_observer_init(INIT_FUNC_ARGS) { if (type != MODULE_TEMPORARY) { zend_observer_fcall_register(observer_fcall_init);
op_array_extension = zend_get_op_array_extension_handle("opentelemetry"); #if PHP_VERSION_ID >= 80400 zend_get_internal_function_extension_handle("opentelemetry"); #endif } } https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/otel_observer.c#L1183-L1192

59 void opentelemetry_observer_init(INIT_FUNC_ARGS) { if (type != MODULE_TEMPORARY) { zend_observer_fcall_register(observer_fcall_init);
op_array_extension = zend_get_op_array_extension_handle("opentelemetry"); #if PHP_VERSION_ID >= 80400 zend_get_internal_function_extension_handle("opentelemetry"); #endif } } https://github.com/open-telemetry/opentelemetry-php-instrumentation/blob/ad826b91 686dfd72fa01e2b3e360d563ab3b6343/ext/otel_observer.c#L1183-L1192 Observer APIの関数フックを登録する関数 observer_fcall_init内で、 OpenTelemetry\Intrumentation\hookにより記録したフック情報をObserver APIの形式に変換

ゼロコード計装導入でやったこと ② composerを使って、OpenTelemetryのSDKや Exporterだけでなく、使用しているフレームワーク・ライブラリに対応するゼロコード計装ライブラリをインストールしていた $ composer install open-telemetry/opentelemetry-auto-laravel
60

ゼロコード計装ライブラリは何をする？ライブラリ・フレームワークに合わせて、テレメトリーを計装する関数フックを登録する例えば、Laravelであれば、Eloquent ORMの呼び出しに対してトレースを生成するフックを仕掛けるよう、 OpenTelemetry\Instrumentation\hookを呼んでいる 61

62 hook( \Illuminate\Database\Eloquent\Builder::class, 'find', pre: function ($builder, array $params, string
$class, string $function, ?string $filename, ?int $lineno) { $model = $builder->getModel(); $builder = $this->instrumentation->tracer() ->spanBuilder($model::class . '::find') ->setSpanKind(SpanKind::KIND_INTERNAL) ->setAttribute(TraceAttributes::CODE_FUNCTION_NAME, sprintf('%s::%s', $class, $function)) …; $parent = Context::getCurrent(); $span = $builder->startSpan(); Context::storage()->attach($span->storeInContext($parent)); return $params; }, post: function ($builder, array $params, $result, ?Throwable $exception) { $this->endSpan($exception); } ) https://github.com/open-telemetry/opentelemetry-php-contrib/blob/2b6a02f67d85f7f9 4ebc285d2c08c3523d26e093/src/Instrumentation/Laravel/src/Hooks/Illuminate/Databas e/Eloquent/Model.php#L36-L60

63 hook( \Illuminate\Database\Eloquent\Builder::class, 'find', pre: function ($builder, array $params, string
$class, string $function, ?string $filename, ?int $lineno) { // トレーススパンの開始 }, post: function ($builder, array $params, $result, ?Throwable $exception) { // トレーススパンの終了 } ) https://github.com/open-telemetry/opentelemetry-php-contrib/blob/2b6a02f67d85f7f9 4ebc285d2c08c3523d26e093/src/Instrumentation/Laravel/src/Hooks/Illuminate/Databas e/Eloquent/Model.php#L36-L60

PHPゼロコード計装の仕組みまとめ • OpenTelemetry拡張モジュールは、任意の関数・メソッドに対してフックを仕掛けられる機能を提供する ◦ この仕組みの裏側には、PHP 8で導入されたZend Engineの Observer APIがあり、これまでのハックで起こる問題を解
消している • ユーザーはフレームワーク・ライブラリごと用意された自動計装ライブラリをインストールするだけで、テレメトリーを計装するフックをいい感じに登録してもらえる 64

PHP 7.4でどうゼロコード計装を実現するか 65

PHP 7系の現状 PHP 7の最後のバージョンである7.4が2022年11月で EoL。現在は、脆弱性があってもセキュリティパッチが提供されない状態とはいえ、W3Techsによると、2026年3月現在でPHP7 系は33.6%のシェアがある 66 https://w3techs.com/technologies/details/pl-php

PHP 7でもゼロコード計装したい！レガシーなPHPアプリケーションではコードベースを弄るのは相対的に大変オブザーバビリティを獲得する手段として、ゼロコード計装が選べるなら選びたいはず 67

OBIでもゼロコード計装できる！選択肢の1つとしてOpenTelemetry eBPF計装（OBI）がある eBPFという、Linuxカーネルの挙動を動的に書き換えられる仕組みを応用し、実行しているプロセスや通信に割り込んでゼロコード計装する https://opentelemetry.io/ja/docs/zero-code/obi/ 68

OBIは銀の弾丸ではない • PHPの通常のゼロコード計装と比較して、計装できる対象や情報量がより限定的になる • Linux OSでない環境（BSD、Windowsなど）では使用できない • AWS FargateやGoogle
Cloud Runなどのマネージドなコンテナコンピューティング環境では使用できない • トレースが繋がらず断片的になることがある 69

そこをなんとかそもそも、オブザーバビリティベンダーが提供する固有のツールではPHP 7でもゼロコード計装できていることが多いなんとかOpenTelemetryでもPHP 7.4のアプリケーションのゼロコード計装ができないだろうか 70

自作しよう 71

PHP 7.4でのゼロコード計装作戦 • ゼロコード計装ライブラリはrequire php ^8.0 ◦ よって、ゼロコード計装ライブラリは自分で作る必要がある •
フック登録にあたって、PHP 8+のObserver APIは使えない ◦ よって、OpenTelemetry拡張は自分で作る必要がある ◦ zend_execute_exの仕組みで同じようなフック機構は実現できるはず 72

PHP 7.4でのゼロコード計装作戦 • OpenTelemetry SDKはrequire php ^8.1 ◦ ただし、過去のバージョン（v1.0.8）であればPHP 7.4
にも対応している。今回はこれを使えば良さそう ◦ RectorというツールでPHPのダウングレードができるので、最新のSDKのコードを変換するという手もある（それだけで済むならそうしたかった） 73

できたもの https://github.com/Arthur1/openytelemetry-php74-i nstrumentation/ 74

PHPゼロコード計装の導入デモ2 PHP 7.4・Laravel 8のアプリケーションに、今回作ったゼロコード計装を導入するデモをお見せします完成系のコードは↓ https://github.com/Arthur1/opentelemetry-php74-instr umentation/tree/main/examples/laravel8/src 75

やることは3ステップ • 今回作ったPHP拡張を有効化 • open-telemetry/exporter-otlp（一般のもの）や Laravel向けの自動計装ライブラリ（今回作ったもの）を Composerでインストール • Docker Composeで一緒にJaegerに対してトレースを送
るような環境変数を設定する 76

作ったもの • PHP 7.4でも動くような、関数呼び出しにフックをつけるPHP拡張モジュール • 上記拡張を用いた、Laravelの関数呼び出し起因でOTelのトレースを自動計装するライブラリ Claude Opus
4.6に37ドル分仕事してもらった 78

PHP 7.4向けの関数フック拡張本家のOpenTelemetry拡張モジュールと同じように関数やメソッドにフックを登録できる拡張を、Observer APIを使用せず、zend_execute_exの仕組みで作った可能な限り本家のhook()にシグネチャを合わせているが、名前付き引数はPHP 8〜なのでそこだけ断念 hook($className,
$funcName, $preFunc, $postFunc); 79

Laravel向けの自動計装ライブラリ OpenTelemetry Laravel auto-instrumentationライブラリのコードを参考に、先ほど作った関数フック拡張を用いる形で自動計装ライブラリを作成 https://github.com/open-telemetry/opentelemetry- php-contrib/tree/main/src/Instrumentation/Laravel 80

81 - use function OpenTelemetry\Instrumentation\hook; + use function OpenTelemetryPHP74\Instrumentation\hook; return
hook( KernelContract::class, 'handle', - pre: function (...) { ⬛ }, + function (...) { ⬛ }, - post: function (...) { • } + function (...) { • } ) 書き換えは基本これだけ

SDK, API部分は古いものを参照 composer.jsonにこのように書いておくと、APIはv1.0.3、 SDKはv1.0.8が勝手に入る（それぞれPHP 7.4に対応している中では最新のもの） 82 "require":
{ "php": "^7.4", "ext-opentelemetry_php74": "*", "open-telemetry/api": "^1.0", "open-telemetry/sdk": "^1.0", ... }

83 フックを自動でロードさせる仕組み composer.jsonのautoloadにエントリーポイントとなるファイルを指定して登録しておく。指定したファイルは自動でrequireされるこのエントリーポイント経由で、拡張が提供する OpenTelemetryPHP74\Instrumentation\hookを呼ぶ実装になっていれば良い

まとめ 84

PHPのゼロコード計装に必要なもの • ゼロコード計装は、コードベースを書き換えなくてもテレメトリーを送出可能にする手法 • PHPのゼロコード計装に必要なものは以下の2つ： ◦ 関数にフックを仕掛ける機能を持つPHP拡張 ◦ フレームワークやライブラリの関数呼び出し時にトレー
スを計装するようフックを仕掛けた自動計装ライブラリ 85

PHP 8+におけるゼロコード計装 • PHP 8ではZend EngineにObserver APIが追加され、関数の呼び出しに対して、より堅牢な仕組みで割り込めるようになった •
このおかげでPHP 8からは手軽に、そしてアプリケーションの負荷やクラッシュリスクを抑えてOpenTelemetryのゼロコード計装ができるようになった 86

PHP 7.4におけるゼロコード計装 • OpenTelemetryが提供するゼロコード計装はObserver APIに依存しており、PHP 7以前では使えない • 「必要なもの」が揃っていれば理屈上ゼロコード計装できるので、以下の2つを自作してみた： ◦
Observer APIを使わずに関数にフックを仕掛ける拡張 ◦ 上記拡張を用いて、かつPHP 7.4に対応した、フレームワーク向け自動計装ライブラリ 87

最後に EoLの切れたPHPはアップデートしよう！！ PHP 8系にバージョンアップできた暁には、 OpenTelemetryのゼロコード計装を利用して、手軽にオブザーバビリティを手に入れよう！！ 88

参考文献 • Sammy Powers and Levi Morrison, “PHP 8: Observability
baked right in,” Datadog, Feb 2, 2021. [Online]. Available: https://www.datadoghq.com/blog/engineering/php-8-observability-baked -right-in/ • Michihide Hotta, “PHP Extension 開発入門,” ネットワーク管理者（の卵）養成講座, 2017. [Online]. Available: https://net-newbie.com/phpext/index.html • Benjamin Eberlei, “Hooks provided by PHP,” PHP Internal Books, Jul 30, 2019. [Online]. Available: https://www.phpinternalsbook.com/php7/extensions_design/hooks.html • OpenTelemetry Authors, “Documentation,” OpenTelemetry, 2019. [Online]. Avaibale: https://opentelemetry.io/docs/ 89

ご静聴いただきありがとうございました 90

PHP 7.4でもOpenTelemetryゼロコード計装がしたい！ / PHPerKaig...

PHP 7.4でもOpenTelemetryゼロコード計装がしたい！ / PHPerKaigi 2026

More Decks by Arthur

Other Decks in Programming

Featured

Transcript