workers-profiling

Workers のプロファイリング

デプロイ済みコードの負荷が大きい関数やメモリ割り当てを見つけ、改善方法を提案します。

ドキュメントを確認する

まず、本番環境でのプロファイリングガイドを確認し、Workers と Durable Objects のプロファイリングの仕組みを理解します。

プロファイリングの手順

1. 症状と影響を受けているワークロードを特定します。CPU 使用率、レイテンシ、割り当ての負荷、メモリの増加などを確認します。
2. アカウント、Worker、環境、デプロイ済みのバージョンをユーザーに確認します。
3. Durable Object の場合は、その所有元の Worker、名前空間、インスタンスも確認します。
4. 現行ガイドでサポートされている種類とその意味に基づいて、CPU プロファイリングまたはヒーププロファイリングを選択します。

可能な場合は、cf CLIを使ってプロファイルを取得します。ユーザーが cf を希望する場合は、インストール済みバージョンのコマンドヘルプとスキーマが利用できるか確認します。

cf が利用できない場合は、インストールするかどうかをユーザーに尋ねることを検討します。

プロファイリング API は pprof ファイルを返します。このファイルは直接分析するか、Go の pprof ユーティリティなどの適切なツールを使って分析できます。

証拠を調べる

• pprof ファイルを読み込み、ホットスポットを分析します。
• 証拠で裏付けられる場合は、ホットスポットを関数やソースコードの位置に対応付けます。シンボルやソースマッピングが見つからない場合は、その旨を報告します。
• ファイル名や関数名が生成された JavaScript を指している場合は、ソースマップを有効にしてプロファイリングをやり直すよう提案することを検討します。

最適化する

取得したデータで裏付けられる、問題を解決するための最小限のコード変更を提案します。

調査結果を報告する

以下を含む簡潔なレポートを返します。

• 各調査結果の証拠：ファイル、関数、ソースコードの位置、利用可能な場合は単位付きのメトリクス。
• 実施可能な最小限の変更と、その効果を確認する方法。