Go-Expvar

Supported OS Linux Mac OS Windows

インテグレーションバージョン4.1.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

Go グラフ

概要

Go サービスのメモリ使用量を追跡し、Go の expvar パッケージから計測されたメトリクスを収集します。

dogstats-go のみを使用して Go コードを計測する場合でも、このインテグレーションを使用して、メモリ関連のメトリクスを収集できます。

セットアップ

インストール

Go Expvar チェックは Agent にパッケージ化されているため、メトリクスを収集するには、Go サービスを実行している場所に Agent をインストールします。

構成

サービスの準備

Go サービスで expvar パッケージをまだ使用していない場合は、これをインポートします (import "expvar")。expvar を使用して独自のメトリクスを計測しない場合 (サービスのメモリメトリクスのみを収集する場合) は、空の識別子を使用してパッケージをインポートします (import _ "expvar")。サービスがまだ (http パッケージを使用して) HTTP リクエストをリスニングしていない場合は、ローカルで Datadog Agent のみをリスニングするように設定します。

    ホスト

    ホストで実行中の Agent に対してこのチェックを構成するには

    Agent の接続

    1. Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの go_expvar.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル go_expvar.d/conf.yaml を参照してください。

      注: metrics リストが構成されていない場合でも、Agent は memstat メトリクスを収集します。metrics を使用すると、収集する expvar 変数を Agent に指示できます。

    2. Agent を再起動します。

    注: Go Expvar インテグレーションではカスタムメトリクスを送信することができますが、これはお客様の課金に影響します。デフォルトでは、メトリクス数は 350 に制限されています。メトリクスの追加が必要な場合は、Datadog のサポートチームにお問い合わせください。

    コンテナ化

    コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。

    パラメーター値
    <INTEGRATION_NAME>go_expvar
    <INIT_CONFIG>空白または {}
    <INSTANCE_CONFIG>{"expvar_url": "http://%%host%%:8080"}

    検証

    Agent の status サブコマンドを実行し、Checks セクションの go_expvar を探します。

    収集データ

    メトリクス

    go_expvar.memstats.alloc
    (gauge)    		Bytes allocated and not yet freed
    Shown as byte
    go_expvar.memstats.frees
    (gauge)    		Number of frees
    Shown as operation
    go_expvar.memstats.heap_alloc
    (gauge)    		Bytes allocated and not yet freed
    Shown as byte
    go_expvar.memstats.heap_idle
    (gauge)    		Bytes in idle spans
    Shown as byte
    go_expvar.memstats.heap_inuse
    (gauge)    		Bytes in non-idle spans
    Shown as byte
    go_expvar.memstats.heap_objects
    (gauge)    		Total number of allocated objects
    Shown as item
    go_expvar.memstats.heap_released
    (gauge)    		Bytes released to the OS
    Shown as byte
    go_expvar.memstats.heap_sys
    (gauge)    		Bytes obtained from system
    Shown as byte
    go_expvar.memstats.lookups
    (gauge)    		Number of pointer lookups
    Shown as operation
    go_expvar.memstats.mallocs
    (gauge)    		Number of mallocs
    Shown as operation
    go_expvar.memstats.num_gc
    (gauge)    		Number of garbage collections
    Shown as garbage collection
    go_expvar.memstats.pause_ns.95percentile
    (gauge)    		95th percentile of recent GC pause durations
    Shown as nanosecond
    go_expvar.memstats.pause_ns.avg
    (gauge)    		Average of recent GC pause durations
    Shown as nanosecond
    go_expvar.memstats.pause_ns.count
    (rate)    		Number of submitted GC pause durations
    Shown as sample
    go_expvar.memstats.pause_ns.max
    (gauge)    		Max GC pause duration
    Shown as nanosecond
    go_expvar.memstats.pause_ns.median
    (gauge)    		Median GC pause duration
    Shown as nanosecond
    go_expvar.memstats.pause_total_ns
    (gauge)    		Total GC pause duration over lifetime of process
    Shown as nanosecond
    go_expvar.memstats.total_alloc
    (gauge)    		Bytes allocated (even if freed)
    Shown as byte
    go_expvar.memstats.total_alloc.count
    (count)    		Bytes allocated (even if freed) as monotonic count
    Shown as byte

    イベント

    Go-Expvar チェックには、イベントは含まれません。

    サービスチェック

    Go-Expvar チェックには、サービスのチェック機能は含まれません。

    トラブルシューティング

    ご不明な点は、Datadog のサポートチームまでお問い合わせください。

    その他の参考資料