概要
Go サービスのメモリ使用量を追跡し、Go の expvar パッケージから計測されたメトリクスを収集します。
dogstats-go のみを使用して Go コードを計測する場合でも、このインテグレーションを使用して、メモリ関連のメトリクスを収集できます。
計画と使用
インフラストラクチャーリスト
Go Expvar チェックは Agent にパッケージ化されているため、メトリクスを収集するには、Go サービスを実行している場所に Agent をインストールします。
ブラウザトラブルシューティング
サービスの準備
Go サービスで expvar パッケージをまだ使用していない場合は、これをインポートします (import "expvar")。expvar を使用して独自のメトリクスを計測しない場合 (サービスのメモリメトリクスのみを収集する場合) は、空の識別子を使用してパッケージをインポートします (import _ "expvar")。サービスがまだ (http パッケージを使用して) HTTP リクエストをリスニングしていない場合は、ローカルで Datadog Agent のみをリスニングするように設定します。
メトリクスベース SLO
ホストで実行中の Agent に対してこのチェックを構成するには
Agent の接続
Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの go_expvar.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル go_expvar.d/conf.yaml を参照してください。
注: metrics リストが構成されていない場合でも、Agent は memstat メトリクスを収集します。metrics を使用すると、収集する expvar 変数を Agent に指示できます。
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 のサポートチームまでお問い合わせください。
その他の参考資料
