Slide 1

Slide 1 text

OpenTelemetry SDKを使って PHPでAPMを自作する 2026/03/21 PHPerKaigi 2026

Slide 2

Slide 2 text

2 自己紹介 氏名: 遠藤太徳 (Endo Futoshi) 所属: NewRelic株式会社(New Relic, K.K.) 役職: Technical Account Manager Webアプリケーションエンジニアとして API開発、既存サービスのリファクタリ ング、CREとしてユーザー体験改善、チームビルディングを経験。現職では New Relic のTechnical Account Manager として活用支援や、勉強会 を行っています。 PHP歴は9年程🐘 趣味: 音楽、料理、ゲーム、個人開発、どんちゃん (豆柴)と散歩

Slide 3

Slide 3 text

3 https://speakerdeck.com/fendo181/learn-laravels-archi tecture-while-creating-a-framework https://speakerdeck.com/fendo181/php8noji-neng-woshi-tutejian-lao- nikotowoshu-ku

Slide 4

Slide 4 text

4 ref: https://nrug.connpass.com/event/383731/

Slide 5

Slide 5 text

はじめに 5

Slide 6

Slide 6 text

6 ✅ 今日お話すること ✓ APMが内部で何をしているかの仕組み ✓ Trace・Metrics・Logsの3シグナルの役割 ✓ OTel PHP SDKを使った計装コードの書き方 ✓ 「計装を手で書く」ことで商用 APMの 動作原理を理解すること ✓ DockerでJaeger・Prometheusに データを送って可視化すること ❌ 今日お話しないこと ✕ New RelicやDatadogのような APMツールをゼロから作ること ✕ JaegerやPrometheusの 内部実装の詳細 ✕ 本番運用レベルの パフォーマンスチューニング ✕ OpenTelemetry Collectorの 高度な設定・運用 ✕ PHP以外の言語での OTel実装

Slide 7

Slide 7 text

Agenda 7

Slide 8

Slide 8 text

8 (1) APMとはなにか (2) OpenTelemetryの概要 (3) PHP+OTel SDK でAPMの裏側を理解する (4) まとめ

Slide 9

Slide 9 text

APMとは なにか 9

Slide 10

Slide 10 text

10 APMとはなにか 😰 APIのレスポンスが急に遅くなった。でもエラーは一切出ていない… 🔍 ログをgrepしまくったが、どのコードが遅いのか特定できない 📊 DBのスロークエリかもしれないが証拠がなく、再現もしない 💦 本番環境だけ遅い。手元では問題が再現しない。お手上げ… 「本番でのサービスが遅い…」あなたはどう調べますか?

Slide 11

Slide 11 text

11 “APM(Application Performance Monitoring)とはアプ リケーションを中核としてシステム性能を監視し、その改 善に向けた原因の特定・改修の迅速化を実現するプロ セスやツール のこと” ref: https://newrelic.com/jp/blog/apm/what-is-application-performance-monitoring ※APMをApplication Performance Managerという場合もありますが、ここではMonitoringのAPMを指しています。 APMとはなにか

Slide 12

Slide 12 text

12 ref: https://docs.newrelic.com/jp/docs/apm/new-relic-apm/getting-started/introduction-apm/ APMとはなにか

Slide 13

Slide 13 text

13 ref: https://newrelic.com/jp/platform/application-monitoring ①本番デプロイ APMとはなにか

Slide 14

Slide 14 text

14 ref: https://newrelic.com/jp/platform/application-monitoring ①本番デプロイ ②APMでパフォーマンスをモニタリ ングする APMとはなにか

Slide 15

Slide 15 text

15 ref: https://newrelic.com/jp/platform/application-monitoring ①本番デプロイ ②APMでパフォーマンスをモニタリ ングする ③APMを見て、原因を調査し て、改善すべき所をチームメ ンバーで議論する APMとはなにか

Slide 16

Slide 16 text

16 ref: https://newrelic.com/jp/platform/application-monitoring ①本番デプロイ ②APMでパフォーマンスをモニタリ ングする ③APMを見て、原因を調査し て、改善すべき所をチームメ ンバーで議論する ④決定内容を元にコーディング APMとはなにか

Slide 17

Slide 17 text

17 APMを導入する事による主なメリット アプリケーションの状態をリアルタイムに確認 レスポンスタイム・スループット・エラー率・依存サービスの状態などを継続的に計測する 問題の発見 異常なレスポンスやエラーをアラートで検知し、根本原因の特定まで素早く導く 継続的改善 蓄積されたパフォーマンスデータでボトルネックを特定し、改善サイクルを回す APMとはなにか

Slide 18

Slide 18 text

18 ref: https://newrelic.com/jp/platform/application-monitoring ①本番デプロイ ②APMでパフォーマンスをモニタリ ングする ③APMを見て、原因を調査し て、改善すべき所をチームメ ンバーで議論する ④決定内容を元にコーディング Observability (可観測性) APMとはなにか

Slide 19

Slide 19 text

19

Slide 20

Slide 20 text

20 “システム上で何らかの異常が起こった際に、それを通知するだけでなく、どこで何が起こったの か、なぜ起こったのかを把握する能力を表す指標、あるいは仕組みを指します。 ” APM(Application Performance Monitoring) Observability を実現するための「手段の一つ」。アプリケーション層のパフォーマンス監視 に特化したツール・手法で、Traces、Metrics、Logs などの テレメトリデータデータをもとに 「なぜそれが起きているか」を調査・推測できる性質を指す。 APMはObservabilityを実現するための重要な手法の一つ Observability(可観測性) APMとはなにか

Slide 21

Slide 21 text

21 APMでモニタリングするために必要な 3つのテレメトリデータ Traces 「リクエストの足跡」 リクエストの処理過程をSpan単位 (処理の単位)で記録。どの処理で時 間がかかったかを可視化。 Metrics 「アプリのバイタル」 リクエスト数・レイテンシ・エラー率な ど時系列で集計する定量データ。 orders.total{status="success"} = 1,024 orders.total{status="failed"} = 12 order.duration_p50 = 95ms order.duration_p99 = 430ms order.duration_max = 812ms Logs 「何が起きたか」の記録 タイムスタンプ付きの構造化テキス ト。 Trace IDと紐付けてコンテキストを持 たせる。 { "level": "INFO", "message": "Order started", "trace_id": "a1b2c3d4e5f6", "user_id": 1001, "product_id": 88, "amount": 5800, "timestamp": "2025-03-20T12:34:56Z" } TraceID: a1b2c3d4e5f6 POST /orders ─────────────────────── 150 ms ├─ stock.check ──── 12ms ├─ db.insert ─────────────── 40ms └─ http.payment-api ──────────────120ms ⚠ APMとはなにか

Slide 22

Slide 22 text

22 🤖自動計装 🔧手動計装 仕組み 自動計装用のAPMエージェントをアプ リケーションにインストール。 コード変更なしに計装する。 ライブラリをimportし、計装ポイントを 明示的に記述する。 メリット: コード変更不要。すぐにテレメトリデー タを収集して、計測が開始できる。 細かい制御が可能。業務データを Spanに含められる。 デメリット 言語・フレームワーク依存。細かい制 御が難しい。 コード変更が必要。初期実装コストが かかる。 代表例: New Relic Agent , Datadog APM Open Telemetry ゼロコード計装 Open Telemetry SDK、カスタム計 装コード 計装方法の比較

Slide 23

Slide 23 text

23 計装方法の比較 ref: https://opentelemetry.io/ja/docs/concepts/instrumentation/zero-code/

Slide 24

Slide 24 text

24 🤖自動計装 🔧手動計装 仕組み 自動計装用のAPMエージェントをアプ リケーションにインストール。 コード変更なしに計装する。 ライブラリをimportし、計装ポイントを 明示的に記述する。 メリット: コード変更不要。すぐにテレメトリデー タを収集して、計測が開始できる。 細かい制御が可能。業務データを Spanに含められる。 デメリット 言語・フレームワーク依存。細かい制 御が難しい。 コード変更が必要。初期実装コストが かかる。 代表例: New Relic Agent , Datadog APM Open Telemetry ゼロコード計装 Open Telemetry SDK、カスタム計 装コード 計装方法の比較 今回は手動計装で挑戦!

Slide 25

Slide 25 text

OpenTelemetry の概要 25

Slide 26

Slide 26 text

26 🏗 CNCF プロジェクト Cloud Native Computing Foundation 傘下。KubernetesやPrometheusと同じコミュニティが管理 する本格的なOSS。 🌐 ベンダー非依存 一度計装すれば、New Relic・Datadog・Jaegerなど任意のObservability Backendへデータ を送信できる。 🔌 多言語対応 Java・Go・Python・JavaScript・PHPなど20以上の言語向けSDKが提供されている。 📡 業界標準化 Google・Microsoft・AWS・Splunkなど主要クラウドベンダーが積極的にコントリビュートしている。 OpenTelemetryの概要 オブザーバビリティフレームワークでありツールキット。 Traces・Metrics・Logsのようなテレメトリーデータ を生成、エクスポート、収集などを容易 にするために設計されてる

Slide 27

Slide 27 text

27 “システムの規模が拡大し、異常性が増すに つれて、問題を分析するために必要なデータ を見つけることはさらに難しくなっています。... OPenTelemetryはこの問題を解決します。 個々のログやメトリクスやトレースを、首尾 一貫し、統一された情報のグラフにする 事 で、OPenTelemetryは次世代のオブザーバビ リティツールの舞台を用意します。 OpenTelemetryの概要

Slide 28

Slide 28 text

28 OpenTelemetryの概要 アプリケーション側で、リクエストを受け 取ったタイミングで、OTel SDKで書かれ た計装コードが動き、テレメトリシグナル (Traces・Metrics・Logs)を集計しま す。 集計したデータは OTLP(OpenTelemetry Protocol)で Collectorへ送信。

Slide 29

Slide 29 text

29 OpenTelemetryの概要 PHP App+SDKから受け取ったデータを Otel Collectorで受け取り編集する ○ Receiver(受信) ■ OTLP形式でSDKから Traces・Metrics・Logsを 受け取る ○ Processor(加工) ■ 不要な属性を削除したり、タ グを追加したりしてデータを 整形 ■ 追加のSamplingフィルタ リング ○ Exporter(転送) ■ 送り先の形式に変換して送 信

Slide 30

Slide 30 text

30 OpenTelemetryの概要 Otel CollectorからデータをOTLPで受 け取り、Observability Backend(Jaeger、Grafana)でテレメト リデータを確認する ここで初めて、可視化されたデータを元に 調査したり、アラートを設定したり等で Observabilityに取り組む

Slide 31

Slide 31 text

PHP+OTel SDK でAPMの裏側を 理解する 31

Slide 32

Slide 32 text

32 Todo アプリ (PHP) OTelで手動計装 Observability Backend Open Telemetry Collector Obeservabiltiy Backendまでの処理を実装して APMの裏側を理解 ● OTel SDK で Traces・Metrics・Logs を取得する為の処理を手動計装 ● OTel Collector でデータを受け取り、Observability Backendへ転送する ● Jaeger・Grafana でトレースとメトリクスを可視化する PHP+OTel SDK でAPMの裏側を理解する OTELP OTELP

Slide 33

Slide 33 text

33 PHPでAPMを自作する ref:https://github.com/Fendo181/OpenTelemetryPractice/tree/main/simple-php-amp

Slide 34

Slide 34 text

34 PHPでAPMを自作する ref: https://github.com/open-telemetry/opentelemetry-php ● open-telemetry/api ○ 計装する為のインターフェース定 義 ● open-telemetry/sdk ○ 実際に処理を動かす為のパッ ケージ(エンジン) ● open-telemetry/exporter-otlp ○ SDKで収集したデータをOTLP 形式でCollectorに送る

Slide 35

Slide 35 text

35 PHPでAPMを自作する GuzzleをOTelが使える形に変換するアダプター

Slide 36

Slide 36 text

36

Slide 37

Slide 37 text

37

Slide 38

Slide 38 text

38

Slide 39

Slide 39 text

39 ● otel-collector-config .yml ○ receivers、processors、 exportersの設定を定義 ○ Observability Backend事に送 るデータを定義する

Slide 40

Slide 40 text

40 ● Todoを作成時のテレメトリシグナル をFactoryパターンでProveiderを実 装 ● 全HTTPリクエストを受け取ったタイミ ングでTelemetryInitializerが3つ のProviderを初期化し Traces・Metrics・Logsの3つのテレ メトリシグナルを収集して、OTel Collectorに送信する

Slide 41

Slide 41 text

41 ● 初期化しない場合テレメトリデータを受け 取る為の土台がない為、なにも記録され ない ○ https://opentelemetry.io/docs/la nguages/php/instrumentation/ ● したがって、手動計装の場合はOTelの TracerProvider・MeterProvider・Logg erProviderも毎回初期化が必要です ○ 自動計装であればPHPプロセス起 動時に自動で初期化されるため開 発者が意識しなくて良い

Slide 42

Slide 42 text

42 ref:https://github.com/Fendo181/OpenTelemetryPractice/blob/main/simple-php-amp/docs/tele metry-initializer.md

Slide 43

Slide 43 text

43 ● TelemetryMiddleware.php ○ HTTPリクエスト全体を1つの「HTTP SERVER Span」でラップするクラス。リク エスト受信時にSpanを開始し、処理完了 後はレスポンスのステータスコードやメ ソッドをSpanに記録し計測します。 ● TodoHandler.php ○ Todo APIのビジネスロジックを担うクラ ス、GET/POST/PUT/DELETEの各操作 を実装し、処理の開始・完了・エラーを構 造化ログとして出力します。

Slide 44

Slide 44 text

44

Slide 45

Slide 45 text

DEMOタイム!

Slide 46

Slide 46 text

46 DEMOがうまく行かなかった場合 ver

Slide 47

Slide 47 text

47

Slide 48

Slide 48 text

48

Slide 49

Slide 49 text

49

Slide 50

Slide 50 text

50

Slide 51

Slide 51 text

51

Slide 52

Slide 52 text

52

Slide 53

Slide 53 text

まとめ 53

Slide 54

Slide 54 text

54 ● OpenTelemetry SDKを使った「手動計装」をやってみてAPMの 裏側でどんな事が行われているか理解ができた! ● 正直、最初に覚える事は沢山あります! ● 今日の発表で OpenTelemetryに興味が出た方は公式のドキュ メントだったり、僕が作成したリポジトリや、書籍「入門 OpenTelemetry」わかりやすいので、ぜひ手にとってみて、手を 動かしてみてください!

Slide 55

Slide 55 text

55 ご清聴ありがとうございました ! 🍺

Slide 56

Slide 56 text

参考文献 56

Slide 57

Slide 57 text

57 ● 入門 Open Telemetry ● 実践 OpenTelemetry ● https://speakerdeck.com/ymotongpoo/intro-of-opentelemetry-book ● https://dev.classmethod.jp/articles/otel-sdk-php-export-performance-degra dation/ ● PHP アプリケーションのトレース計装ではじめる OpenTelemetry 入門 ● https://speakerdeck.com/oracle4engineer/zero-code-observability-with-ope ntelemetry-and-oci-apm