1. 導入：なぜプログラムのボトルネック特定が重要なのか
Goで開発をしていると、「なぜかAPIのレスポンスが遅い」「CPU使用率が異常に高い」といった問題に直面することがあります。そんな時、勘に頼って修正するのは非常に非効率です。Goには標準で強力なプロファイリングツール「pprof」が用意されています。今回は、CLI上で手軽にボトルネックを特定できる「go tool pprof -text」の使い方を解説します。これを使えば、プログラムのどこで時間がかかっているのかを数値で明確に把握できるようになります。
2. 基礎知識：pprofとは何か
pprofは、Goプログラムの実行状況（CPU使用率、メモリ確保量など）を記録・分析するためのツールです。
「プロファイリング」とは、プログラムの実行中にどの関数がどれだけ呼び出され、どれだけの時間を消費したかを計測することを指します。
今回紹介する「-text」オプションは、その計測結果を「テキスト形式（リスト）」で出力するものです。グラフを描画するような複雑な手順を踏まなくても、ターミナル上で迅速に「犯人（遅い関数）」を特定できるのが最大の魅力です。
3. 実装/解決策：pprofで計測する手順
pprofを使うには、大きく分けて2つのステップが必要です。
1. プログラムに計測用のコードを埋め込み、プロファイルデータ（.outファイル）を生成する。
2. 「go tool pprof」コマンドを使用して、そのデータを解析する。
まずは、コード内で「どこを計測するか」を指定し、実行後に生成されたファイルをコマンドラインで読み込むのが基本的な流れとなります。
4. サンプルプログラム
以下のコードは、CPUの計測を開始し、適当な負荷をかけた後に結果を出力する準備をする例です。
＜main.go＞
package main
import (
“os”
“runtime/pprof”
“time”
)
// 重い処理をシミュレートする関数
func heavyTask() {
time.Sleep(2 time.Second)
}
func main() {
// 1. CPUプロファイル用のファイルを作成
f, _ := os.Create(“cpu.prof”)
defer f.Close()
// 2. CPUプロファイリングを開始
pprof.StartCPUProfile(f)
defer pprof.StopCPUProfile()
// 計測対象の処理
heavyTask()
}
実行手順:
1. プログラムを実行: `go run main.go`
2. 解析コマンドを実行: `go tool pprof -text cpu.prof`
このコマンドを実行すると、ターミナル上に実行時間の長い順に関数がリストアップされます。「flat（その関数自体での消費時間）」と「cum（その関数と呼び出し先を含めた累積時間）」を確認することで、どの処理がボトルネックか一目で分かります。
5. 応用・注意点：現場で陥りやすい罠
pprofを使用する際に注意すべき点がいくつかあります。
・計測によるオーバーヘッド: プロファイリング自体もプログラムの実行速度に影響を与えます。本番環境で実行する場合は、短時間だけサンプリングを行うようにしてください。
・サンプリングの重要性: pprofは一定間隔でプログラムの状態を「サンプリング」しています。そのため、非常に短時間で終わる処理は正確に計測できない場合があります。
・「-text」以外の活用: もしテキストで特定しづらい複雑な呼び出し関係がある場合は、`-http=:8080` オプションを使うとブラウザ上で視覚的に呼び出しツリー（グラフ）を確認できます。状況に応じて使い分けるのが「Goエンジニアのたしなみ」です。
まずは手元のコードで試して、自分の書いたコードの「どこが一番頑張っているのか」を覗いてみてください。これだけで、パフォーマンスチューニングの精度が劇的に向上します。
コメント