自動コンフィギュレーション

ランタイムメトリクスの収集は dogstatsd-ruby gemを使用し、DogStatsD を介して Agent にメトリクスを送信します。ランタイムメトリクスを収集するには、この gem を Ruby アプリケーションに追加し、DogStatsD が Agent に対して有効になっていることを確認する必要があります。

メトリクス収集は初期設定では無効になっています。DD_RUNTIME_METRICS_ENABLED 環境変数を true に設定するか、Ruby アプリケーションで次のコンフィギュレーションを行うと有効にできます。

# config/initializers/datadog.rb
require 'datadog/statsd'
require 'datadog' # Use 'ddtrace' if you're using v1.x

Datadog.configure do |c|
  # To enable runtime metrics collection, set `true`. Defaults to `false`
  # You can also set DD_RUNTIME_METRICS_ENABLED=true to configure this.
  c.runtime_metrics.enabled = true

  # Optionally, you can configure the DogStatsD instance used for sending runtime metrics.
  # DogStatsD is automatically configured with default settings if `dogstatsd-ruby` is available.
  # You can configure with host and port of Datadog agent; defaults to 'localhost:8125'.
  c.runtime_metrics.statsd = Datadog::Statsd.new
end

ランタイムメトリクスは、Ruby サービスと相関して表示できます。Datadog のサービス詳細画面を参照してください。

初期設定では、アプリケーションからのランタイムメトリクスは DogStatsD のポート 8125 から Datadog Agent に送信されます。DogStatsD が Agent に対して有効になっていることを確認してください。 Agent をコンテナとして実行している場合は、DD_DOGSTATSD_NON_LOCAL_TRAFFIC が true に設定されていること、また Agent 上でポート 8125 が開いていることを確認してください。 Kubernetes では、DogstatsD ポートをホストポートにバインドし、ECS ではタスク定義で適切なフラグを設定します。

Alternatively, the Agent can ingest metrics with a Unix Domain Socket (UDS) as an alternative to UDP transport. For more information, read DogStatsD over Unix Domain Socket.

収集データ

以下のメトリクスはランタイムメトリクスを有効にした後、デフォルトで収集されます。

APM サービス詳細画面にこれらのメトリクスを表示するだけでなく、Datadog はデフォルトの Ruby ランタイムダッシュボードを提供します。

その他の参考資料

お役に立つドキュメント、リンクや記事:

ログとトレースの接続DOCUMENTATION アプリケーションを手動でインストルメントしてトレースを作成します。DOCUMENTATION サービス、リソース、トレースの詳細DOCUMENTATION