PHPこそ OpenTelemetry が嬉しい

PHPこそ OpenTelemetry が嬉しいつよナレ #1 PHPにまつわる話 @sadnessOjisan

自己紹介 • 2019年の立ち上げ時期からTechTrainメンター • 2023年からTechBowlの技術アドバイザリー • 元々フロントエンドメインでのアドバイザリーだったが、サービス分割・認証基盤
・ETL整備などを通じ、全社を巻き込んだ設計が必要となりPHPも始める • PHPerKaigi2024登壇 https://speakerdeck.com/sadnessojisan/s ahatohahe-kawoli-jie-site-kontena1tutes hi-xing-siyou-phperkaigi2024

PHP、辛さとセットになりがち • 言語機能（特に守りの部分）そのものが不足しがち • 古くからある言語なので、古いシステムとも出会いがち • FWとその周辺プラグインに頼ることが多く、ブラックボックスな開発をしがちそのコードベース、自信を持って改修できますか？

テストを書けば解決だが... • そもそもテスト書いていますか？書けますか？ • DB接続や外部SaaSにアクセスするコードにテストを書けていますか？ • テストが書きやすい設計ですか？ • テストを書きやすくするための改善をCommitするためのテストはありますか？
後手でテストを追加するのは、簡単ではない

そんなあなたに OpenTelemetry • テストをせずに動作確認するには、動作しているシステムを目視で確認すればよい • 呼ばれるはずのコードが呼ばれていなければバグが起きたとみなせる • 本番環境での動作確認の精度をあげていこう

OpenTelemetry • 可観測性を担保するためのフレームワーク • トレースという機能で、「あるエンドポイントが呼ばれた時に、こういう関数と関数にこういう引数が渡って、こういう結果を返した」ということを出力できる • ビジュアルで確認もできるし、引数もわかる

どうやって設定するの？ • Laravel はライブラリを入れて SDK をエントリポイントで初期化するだけで勝手に計測される • 詳しくは公式のガイドをチェック: https://github.com/open-telemetry/opentelemetry-php/blob/main/docs/laravel
-quickstart.md

全てを勝手に自動で計測してくれるのですか？ • 答えはNO • 自動計装と手動計装があり、SDKで自動計装はセットされる • 自動計装ではあらかじめSDKが、有名ライブラリだけをフックして計装を挟み込んでくれる（例: HTTP、SQL) •
関数単位で計測ログを入れたければ、自分で計測コードを入れる https://opentelemetry.io/docs/languages/php/instrumentation/#trace

まとめ • Opentelemetryを使えば、複雑なAPIの内部処理をトレースしてログとして出力できる • 複雑なAPIに後手でテストを書くのは難しいが、トレースを出せれば内部を観察しながら動作確認ができ、コード編集時の動作確認に役に立てられる • OpenTelemetryは内部実装をあまり変えることなく、トレースを出せる •
PHPコードベースの品質改善も大事だけど、やらかしたときの回復力を身につけるのも、システム開発に効く

PHPこそ OpenTelemetry が嬉しい

PHPこそ OpenTelemetry が嬉しい

sadnessOjisan

More Decks by sadnessOjisan

Other Decks in Programming

Featured

Transcript

PHPこそ OpenTelemetry が嬉しいつよナレ #1 PHPにまつわる話 @sadnessOjisan

自己紹介 • 2019年の立ち上げ時期からTechTrainメンター • 2023年からTechBowlの技術アドバイザリー • 元々フロントエンドメインでのアドバイザリーだったが、サービス分割・認証基盤

どうやって設定するの？ • Laravel はライブラリを入れて SDK をエントリポイントで初期化するだけで勝手に計測される • 詳しくは公式のガイドをチェック: https://github.com/open-telemetry/opentelemetry-php/blob/main/docs/laravel