Goメモ-416 (CPUの統計情報を取得, runtime/metrics)

関連記事

GitHub - devlights/blog-summary: ブログ「いろいろ備忘録日記」のまとめ

Goメモ-415 (ヒープメモリの統計情報を取得, runtime/metrics)

概要

以下、自分用のメモです。忘れないようにここにメモメモ。。。

Go 1.16 から、runtime/metrics というパッケージが追加されていたのを最近知りました。

Go 1.16 リリースノート には、以下のように記載されています。

The new runtime/metrics package introduces a stable interface for reading implementation-defined metrics from the Go runtime. It supersedes existing functions like runtime.ReadMemStats and debug.GCStats and is significantly more general and efficient. See the package documentation for more details.

(新しいruntime/metricsパッケージは、Goランタイムから実装定義のメトリクスを読み取るための安定したインターフェイスを導入します。これはruntime.ReadMemStatsやdebug.GCStatsのような既存の関数に取って代わり、より一般的で効率的です。)

なるほど。。とりあえず、呼び出してみたサンプルを未来の自分のために貼り付けておきます。

今回は、CPU関連の値を取得するサンプルです。ヒープメモリ関連の値については Goメモ-415 (ヒープメモリの統計情報を取得, runtime/metrics) を参照ください。

サンプル

package metricsop

import (
    "context"
    "math"
    "runtime"
    "runtime/metrics"
    "time"

    "github.com/devlights/gomy/output"
)

// Cpu は、runtime/metrics を利用してCPU関連の情報を取得するサンプルです.
//
// # REFERENCES
//   - https://pkg.go.dev/runtime/metrics@latest
func Cpu() error {
    var (
        items = []string{
            "/cgo/go-to-c-calls:calls",                   // 現在のプロセスによるGoからCへの呼び出し回数
            "/cpu/classes/gc/mark/assist:cpu-seconds",    // ゴルーチンがGCを実行するのに費やしたCPU時間の見積もり
            "/cpu/classes/gc/mark/dedicated:cpu-seconds", // GCタスクを実行するために費やされたCPU時間の合計の見積もり
            "/cpu/classes/gc/mark/idle:cpu-seconds",      // GCタスクの実行に費やされたCPU時間の合計の見積もり
            "/cpu/classes/gc/pause:cpu-seconds",          // GCによって一時停止されたアプリケーションに費やされた推定総CPU時間
            "/cpu/classes/gc/total:cpu-seconds",          // GCタスクの実行に費やされたCPU時間の見積もり
            "/cpu/classes/idle:cpu-seconds",              // GoまたはGoランタイムコードの実行に使用されないCPU時間の推定値
            "/cpu/classes/total:cpu-seconds",             // ユーザーGoコードまたはGoランタイムに使用可能なCPU時間の合計
            "/cpu/classes/user:cpu-seconds",              // ユーザーGoコードの実行に費やされたCPU時間の合計の見積もり
        }
        samples = make([]metrics.Sample, len(items))
        bigdata = make([]byte, 1<<28)
    )

    for i, name := range items {
        samples[i].Name = name
    }

    var (
        ctx, cxl = context.WithTimeout(context.Background(), 1*time.Second)
        ready    = make(chan bool)
        busyfn   = func(ctx context.Context, ready <-chan bool) {
            var i uint64

            <-ready
            for {
                select {
                case <-ctx.Done():
                    return
                default:
                    switch i {
                    case math.MaxUint64:
                        i = 0
                    default:
                        i += uint64(1)
                    }
                }
            }
        }
    )
    defer cxl()

    for range runtime.GOMAXPROCS(0) - 1 {
        go busyfn(ctx, ready)
    }
    close(ready)

    <-time.After(100 * time.Microsecond)

    runtime.GC()
    metrics.Read(samples)
    for _, s := range samples {
        output.Stdoutl("[Name ]", s.Name)

        switch s.Value.Kind() {
        case metrics.KindUint64:
            output.Stdoutf("[Value]", "%v\n", s.Value.Uint64())
        case metrics.KindFloat64:
            output.Stdoutf("[Value]", "%v\n", s.Value.Float64())
        case metrics.KindFloat64Histogram:
            output.Stdoutf("[Value]", "Bucket Count: %d\n", len(s.Value.Float64Histogram().Buckets)-2)
        default:
            output.Stdoutl("[Value]", "INVALID")
        }

        output.StdoutHr()
    }

    output.Stdoutl("[Buffer]", len(bigdata))

    <-ctx.Done()

    return nil
}

実行すると以下の様になります。

       $ task
        task: [build] go build .
        task: [run] ./try-golang -onetime

        ENTER EXAMPLE NAME: metrics_cpu

        [Name] "metrics_cpu"
        [Name ]              /cgo/go-to-c-calls:calls
        [Value]              1
        --------------------------------------------------
        [Name ]              /cpu/classes/gc/mark/assist:cpu-seconds
        [Value]              0.00011252
        --------------------------------------------------
        [Name ]              /cpu/classes/gc/mark/dedicated:cpu-seconds
        [Value]              0.001100349
        --------------------------------------------------
        [Name ]              /cpu/classes/gc/mark/idle:cpu-seconds
        [Value]              0
        --------------------------------------------------
        [Name ]              /cpu/classes/gc/pause:cpu-seconds
        [Value]              0.047052128
        --------------------------------------------------
        [Name ]              /cpu/classes/gc/total:cpu-seconds
        [Value]              0.048264997
        --------------------------------------------------
        [Name ]              /cpu/classes/idle:cpu-seconds
        [Value]              32.647871189
        --------------------------------------------------
        [Name ]              /cpu/classes/total:cpu-seconds
        [Value]              32.986254656
        --------------------------------------------------
        [Name ]              /cpu/classes/user:cpu-seconds
        [Value]              0.290117141
        --------------------------------------------------
        [Buffer]             268435456


        [Elapsed] 1.008436872s

確かにいろいろ取得出来ていますね。

取得するためのキー名を間違えて指定した場合はエラーとかにはならずに値が返ってきて、Kindの値が0となっています。

参考情報

metrics package - runtime/metrics - Go Packages

Goのおすすめ書籍

初めてのGo言語 ―他言語プログラマーのためのイディオマティックGo実践ガイド

実用 Go言語 ―システム開発の現場で知っておきたいアドバイス

Go言語による並行処理

Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ

Goならわかるシステムプログラミング 第2版

効率的なGo ―データ指向によるGoアプリケーションの性能最適化

---

過去の記事については、以下のページからご参照下さい。

• ブログ 「いろいろ備忘録日記」の記事まとめ | ブログ「いろいろ備忘録日記」のまとめ

サンプルコードは、以下の場所で公開しています。

• GitHub - devlights/try-golang: This is my TUTORIAL project for golang.
• GitHub - devlights/try-python: This is my TUTORIAL project for Python.
• GitHub - devlights/try-csharp: This is my TUTORIAL project for C#.