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

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

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

# config/initializers/datadog.rb
require 'datadog/statsd'
require 'ddtrace'

Datadog.configure do |c|
  # ランタイムメトリクス収集を有効にするには、`true` を設定します。デフォルトは `false` です。
  # DD_RUNTIME_METRICS_ENABLED=true に設定して構成することもできます。
  c.runtime_metrics.enabled = true

  # 必要に応じて、ランタイムメトリクスの送信に使用される DogStatsD インスタンスを構成できます。
  # `dogstatsd-ruby` が利用可能な場合、DogStatsD は自動的にデフォルト設定になります。
  # Datadog Agent のホストとポートを使用して構成できます。デフォルトは '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 ではタスク定義で適切なフラグを設定します。

収集データ

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

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

その他の参考資料

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

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