PHP-FPMのダッシュボードとアラートをAI Agentと見直した話

Transcript

1. PHP-FPMのダッシュボードとアラート をAI Agentと⾒直した話 2026/03/25（⽔） PHP勉強会@東京 森脇⼤智
2. • 森脇 ⼤智 （ X: @daichi_164237 ） • サイボウズで中堅・⼤規模組織向けグループウェア Garoon（ガルーン）というWebサービスを作ってる • アボカド • PHP勉強会＠東京 初参加🔰 【 ⾃⼰紹介 🥑 】
3. 【 話すこと概要 】 PHP-FPMのダッシュボードとアラートをAI Agentと⾒直した話 1. どうして⾒直したいと思ったのか, という話 2. PHP-FPMのメトリクスにどんなデータがあるのか︖ や AI Agentにダッシュボードやアラートの情報を渡すためにどん なシステム構成にしたのか︖という話 3. 実際に⾒直した過程やその成果物, 成果物のレビューの話 4. ⾒直してみた感想
4. 【 ⽬次 📚 】 • はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
5. 【 ⽬次 📚 】 • 👉 はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
6. 普段, PHP で Webサービス（Garoon）を開発している （開発・運⽤でいうと, 開発側の⼈間）
7. ここ数年で, Garoonを動かしているインフラは VMベースの構成から, Kubernetesを⽤いたコンテナベースの構成へ移⾏した forteeリンク: https://fortee.jp/phperkaigi-2026/proposal/9dec43e0-0dd2-49cc-90b9-113d7749e153 ここら辺の話は, PHPerKaigi2026 で すぎやま@MASH弦楽団 が話していたので, 気になる⽅はチェックしてみてください︕︕
8. インフラ基盤の変更に伴い, 開発者も運⽤の⼀部を⾏うようになってきた （いわゆる, DevOps みたいな話）
9. その⼀環として例えば, • メトリクスを取って, ダッシュボードやアラートを作ってみたりとか… • 定期的にダッシュボードを確認して, Webサービスの 状態・傾向を把握 したりとか… も開発者がするようになっている
10. ということが, 少し気になっている そんな仕事をしていますが, ここ最近, ダッシュボードやアラートを作ったは良いものの 有効活⽤できていないものがいくつかあるなぁ... 🥑
11. 例えば, PHP-FPMのメトリクスのダッシュボードやアラートとか… インフラ基盤の移⾏のタイミングで メトリクスを取るようにして, アラートやダッシュボードを整備してみたけど, あんまり使われている印象がない
12. 使ってないなら消しちゃうのも良いけど, もしかしたら ちゃんと整備されてないから活⽤できてないだけかも︖ 🥑 と疑っている
13. そう思う理由 ① ⽤意したダッシュボードが⾒ずらい グラフのタイトルが⻑い どうなったら異常︖正常︖ 👇
14. そう思う理由 ② 元々, Garoonではログベースの調査を⾏っており, インフラ基盤の移⾏のタイミングで PHP-FPMのメトリクスを取得するようにした. 本当はメトリクスの⽅が良い使い⽅があるけれど, 誰も知らないだけなのかも…︖ 知⾒が溜まってない 👇
15. PHP-FPMのアラートやダッシュボードを 改善したいなぁ… 🥑 と思ってる
16. 普段のタスクでなかなか改善に⼿が回らない ので, どうしたものかぁ… 🥑 とも思ってる けど…
17. ところで…
18. 最近, AI Agent が使える 🙌
19. AI Agent を使って PHP-FPMのダッシュボードとアラートを⾒直せば 少ない労⼒で良いものになるのでは…︕︖
20. という訳で本発表では…
21. 【 話すこと 🗣 】 PHP-FPMのダッシュボードとアラート をAI Agentと⾒直した話
22. 【 対象 🎯 】 Webサービスの運⽤に関わっていて, メトリクスを取ってはいるが, 活⽤しきれていないと感じている⼈ 【 ゴール 🏁 】 AI Agent は, 監視やダッシュボード改善の役に⽴つ（かも） と伝えること
23. 【 ⽬次 📚 】 • 👍 はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
24. 【 ⽬次 📚 】 • はじめに • 👉 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
25. まずそもそも, PHP-FPMのメトリクスって 何が取れるの︖
26. PHP-FPMには, FPMの情報ページという, FPMの状態を出⼒できる仕組みがある 画像の引⽤元: https://www.php.net/manual/ja/fpm.status.php
27. 情報ページとして記載されているデータの⼀部を メトリクスとして取ることができる l phpfpm_up l PHP-FPM上で動的プロセス管理（dynamic PM）を使⽤したwwwプールに到達できますか？ l phpfpm_total_processes l アクティブプロセスとアイドルプロセスの数 l phpfpm_active_processes l アクティブプロセスの数 l phpfpm_idle_processes l アイドルプロセスの数 l phpfpm_max_active_processes l FPMの起動以降にアクティブになったプロセスの最⼤数 l phpfpm_max_children_reached l プロセス制限に達した回数（pmがさらに⼦プロセスを起動しようとする際に発⽣） l （pm 『dynamic』 および 『ondemand』 でのみ有効） l phpfpm_start_since l FPMが起動してから経過した秒数 l phpfpm_listen_queue l 待機接続キュー内のリクエスト数 l phpfpm_max_listen_queue l FPMの起動以降、保留中の接続キューに蓄積されたリクエストの最⼤数 l phpfpm_listen_queue_length l 待機接続のソケットキューのサイズ l phpfpm_slow_requests l 『request_slowlog_timeout』 値を超えたリクエストの数 l phpfpm_accepted_connections l プールが受け付けたリクエストの数 l phpfpm_memory_peak l FPMが開始されてからのメモリ使⽤量のピーク値
28. 情報ページとして記載されているデータの⼀部を メトリクスとして取ることができる l phpfpm_up l PHP-FPM上で動的プロセス管理（dynamic PM）を使⽤したwwwプールに到達できますか？ l phpfpm_total_processes l アクティブプロセスとアイドルプロセスの数 l phpfpm_active_processes l アクティブプロセスの数 l phpfpm_idle_processes l アイドルプロセスの数 l phpfpm_max_active_processes l FPMの起動以降にアクティブになったプロセスの最⼤数 l phpfpm_max_children_reached l プロセス制限に達した回数（pmがさらに⼦プロセスを起動しようとする際に発⽣） l （pm 『dynamic』 および 『ondemand』 でのみ有効） l phpfpm_start_since l FPMが起動してから経過した秒数 l phpfpm_listen_queue l 待機接続キュー内のリクエスト数 l phpfpm_max_listen_queue l FPMの起動以降、保留中の接続キューに蓄積されたリクエストの最⼤数 l phpfpm_listen_queue_length l 待機接続のソケットキューのサイズ l phpfpm_slow_requests l 『request_slowlog_timeout』 値を超えたリクエストの数 l phpfpm_accepted_connections l プールが受け付けたリクエストの数 l phpfpm_memory_peak l FPMが開始されてからのメモリ使⽤量のピーク値 プロセスの状態を⽰すメトリクス リクエストの状態を⽰すメトリクス
29. ここら辺の詳しい話（どのデータが取れるの︖どうやってメトリクスを取るの︖）は, 以前に発表したので, 気になる⽅はチェックしてみてください︕︕ 左図（ブログ記事）︓https://blog.cybozu.io/entry/2025/09/29/170000 右図（発表資料）︓https://speakerdeck.com/daichi_164237/php-fpmnomitemetorikusuwochu-li- sitemitanote-sonoshe-ding-li-toluo-tosixue-wai-bu-turuwoshi-uchang-he-tonowei-inituiteohua-sisimasu
30. PHP-FPMのメトリクスの種類はわかった 👍
31. んでもって, そのメトリクスを使って アラートやダッシュボードを作っている︕
32. じゃあ, AI Agent に PHP-FPMのアラートやダッシュボードを渡すの︖
33. ダッシュボードやアラートは設定ファイルに 設定を書いて定義している.
34. 🥑 なんとかして🙏 アラートとダッシュボードの設定ファイル なので, その設定ファイルを AI Agent（Claude Code）から 読み込み・書き込みできるようにした Claude Code （ Opus 4.6 ） AI Agent 🤖
35. また, ダッシュボードやメトリクスは, Grafanaから⾒ることができるようになっている PHP-FPM Webサーバー ⾊々ある Grafana 👀
36. Grafanaには, Grafana MCP serverというものがあり, AI Agentはこのサーバーを経由することで Grafanaのデータを取得することができる Grafana MCP server: https://github.com/grafana/mcp-grafana
37. Grafana Grafana MCP server モニタリングシステム MCP サーバー 🥑 なんとかして🙏 なので, 以下のようなシステム構成で, PHP-FPMのダッシュボードに表⽰されているデータ を AI Agent に渡すことを実現した Claude Code （ Opus 4.6 ） AI Agent 🤖 PHP-FPM Webサーバー ⾊々ある
38. 事前情報まとめ • PHP-FPMのメトリクスではプロセスに関する情報やリクエストに関す る情報を取得できる. • ダッシュボードとアラートはファイルで管理しているため, そのファイルをAI Agentから読み取り・書き込みができる. • ダッシュボードは, Grafana MCP server を 使って, AI Agentからも実際のデータを読み取れる.
39. 【 ⽬次 📚 】 • はじめに • 👍 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
40. 【 ⽬次 📚 】 • はじめに • 事前準備 • 👉 AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
41. AI Agent（Claude Code）にひとまず設計を依頼してみた
42. 🥑 PHP-FPMのメトリクス（アラート, ダッシュボード）を 有効活⽤するためにはどうすれば良い︖
43. 🤖 ダッシュボードの活⽤⽬的は︖ インシデント対応︖ キャパシティプランニング︖ 🥑 両⽅で︕ 🤖 アラートの改善もしたい︖ 🥑 お願い︕ そしたら, 質問が来たので… という感じで回答した
44. 🤖 こんな感じでどう︖
45. 良さそう︕👍 🥑 👉 ダッシュボードとアラートの改善してもらうことに
46. 【 ⽬次 📚 】 • はじめに • 事前準備 • 👍 AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
47. 【 ⽬次 📚 】 • はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • 👉 AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
48. できたダッシュボードがこれ 👉
49. できたアラートがこれ 👇 • PHP-FPMのワーカープロセスの使⽤率が80%を超えた状態が5分間続いている • PHP-FPMのワーカープロセスの使⽤率が95%を超えた状態が2分間続いている • PHP-FPMのプロセスプールが15分間に3回以上再起動している • PHP-FPMのワーカープロセス数が設定上限に達した • PHP-FPMのプロセスプールに1分以上接続できない状態が続いている 既存のアラート
50. 【 ⽬次 📚 】 • はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • 👍 AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
51. 【 ⽬次 📚 】 • はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • 👉 AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
52. 成果物の評価として, 実際に使ってみてどうなのかという話をしたかったが, まだ本番環境に適⽤できてないので, よくわからない…🙏
53. なので, ここでは実際に使いそうな状況を想定して, それら状況で使えそうかを評価する
54. PHP-FPMのアラートやダッシュボードを使うユースケースとしては, アプリケーションが応答していないというケースで, どのコンポーネント（PHP-FPM︖Webサーバ︖）が応答していないのか︖ を調べるために使うはず
55. 新規アラートでは, • ワーカープロセスの使⽤率が⼀定数を上回っていること • PHP-FPM⾃体が頻繁に再起動を繰り返していること の検知できるようになった. ので, これらが使えるかどうかを評価する.
56. 新規アラートでは, • 👉 ワーカープロセスの使⽤率が⼀定数を上回っていること • PHP-FPM⾃体が頻繁に再起動を繰り返していること の検知できるようになった. ので, これらが使えるかどうかを評価する.
57. 上限に達しそうなことが検知（事前検知）できると, 「ゆっくりとリクエスト数が増加している」という状況を検知して, 「事前にワーカープロセスの上限を増やしておく」 みたいな使い⽅ができるかもしれない （いわゆる, キャパシティプランニング） ただ, 閾値に関しては, この値で妥当かどうかの検討は できていないので, 別途, 検討する必要がありそう. ワーカープロセスの使⽤率が⼀定数を上回っていること の評価
58. 新規アラートでは, • ワーカープロセスの使⽤率が⼀定数を上回っていること • 👉 PHP-FPM⾃体が頻繁に再起動を繰り返していること の検知できるようになった. ので, これらが使えるかどうかを評価する.
59. pod/コンテナ/PHP-FPMプロセスが, OOMなどで頻繁に再起動していることが検知できるが, k8sのメトリクスで仕掛けているアラートと被るかもしれない. ノイズになりそうなので, ページ（即時対応のアラート）にはせず, ⼀部の環境だけのメールアラート（たまに確認する程度のアラート）に して, 本当に有⽤かどうか, ノイズにならないか, を 評価しても良いかもしれない. PHP-FPM⾃体が頻繁に再起動を繰り返していること の 評価
60. ⼀⽅, 新規ダッシュボードでは「Overviewセクション」で, アラートで検知した内容のグラフを⾒ることができる 👉 アラートが鳴ってから, さっと状況把握をする際に便利そう︕
61. 「Overviewセクション」下の, 各グラフでは, を調べることができる • どのpodが影響を受けているか︖（特定の環境︖全体環境︖） • いつから発⽣しているのか︖ 👉 影響範囲の調査の時間を短縮できそう!
62. 個⼈的な成果物の評価 まとめ • アラートに関しては, 今までに無かった視点のアラートが追加されていた. • ただ, ⼀部はまだ検討した⽅が良さそう, とも思った. • 閾値やノイズにならないか等 • ダッシュボードに関しては, アラートが鳴ってから, ⾒るべきグラフの動線ができていて, 障害調査の時間を短縮できそうに思えた
63. 【 ⽬次 📚 】 • はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • 👍 AI Agentと⾒直し 〜成果物レビュー 編〜 • 感想
64. 【 ⽬次 📚 】 • はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 👉 感想
65. AI Agentと⾒直してみた感想 個⼈的にはめっちゃすごいと思った︕ 👈 before after 👉
66. AI Agentと⾒直してみた感想 • アラートが鳴ってからダッシュボードを⾒るまでの動線を考えて作られていて, すごい︕ • アラートやダッシュボードの作り⽅（クエリの書き⽅）の勉強になる︕ • 実際に発⽣する問題を想定して, グラフやアラートを整備するとなると, それなりに時間がかかる • アラートやダッシュボードのユースケースを整理して, 本当にそのユースケースを満たしているのか, を軸としながら壁打ちをすると良いのかも. • とはいえ, 「ユースケースを考えて」, 「メトリクスの意味を理解して」, 「適したアラートを作って」, 「⾒やすいダッシュボードを作って」という作業のうち, 後ろ3つの作業はある程度お任せできそうな ので, 楽はできそう. • モデル次第の可能性もある. • PHP-FPMのメトリクスだから良かった可能性もある. • 取得できるメトリクスは公開されているので, 「メトリクスの意味の理解」しやすく, AI Agentも作りやすかった可能性がある. • 独⾃で作成したメトリクスの場合だと, もう少し事前に情報を提供しておく必要があるのかも
67. 結論 何を作りたいか, は ちゃんと⼈間が考える必要がありそう︕ （どういったケースでアラート・ダッシュボードを使⽤して…） ⼀⽅で, 実装が早かったり, 知らない視点を持っていたりするので, AI Agentは実装や壁打ちには適しているのかも︕
68. 【 ⽬次 📚 】 • はじめに • 事前準備 • AI Agentと⾒直し 〜実践 編〜 • AI Agentと⾒直し 〜成果物紹介 編〜 • AI Agentと⾒直し 〜成果物レビュー 編〜 • 👍 感想
69. 聞いていただき, ありがとうございました︕