概要

フラグ評価メトリクスを使用すると、サーバーサイドのアプリケーションが機能フラグの各バリアントを返す頻度を測定できます。これらのメトリクスを使用して、フラグの採用状況を長期的に追跡し、ターゲティングルールが期待どおりに機能していることを確認し、フラグ評価データをダッシュボードでグラフ化します。

前提条件

フラグ評価メトリクスを設定する前に、以下を確認してください。

• サーバーサイドの機能フラグ がすでに構成されていること。
• Agent ベースのデプロイメントの場合、Datadog Agent 7.32.0 以降が実行されており、OTLP メトリクスを受信できること。
• 非 Agent サーバーレスデプロイメントの場合、プラットフォームでサポートされているサーバーレステレメトリパスが構成されていること。
• Java、Node.js、Python のサーバーレス環境については、フィーチャーフラグテレメトリの送信 を参照してください。
• レガシーアクティベーションパスを使用する Agent 対応の構成の場合、アプリケーションで DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED=true が設定されていること。
• サーバーサイドのトレーサーが、フラグ評価メトリクスをサポートする最小バージョンを満たしていること。

Agentless 構成の配信とこのメトリクスは、独立したパスを使用します。サポートされている Agent 対応テレメトリまたはサーバーレステレメトリの設定で必要な OTLP パスを構成すると、Agentless SDK がメトリクスを出力できます。

ステップ 1: OTLP レシーバーを構成する

フラグ評価メトリクスは OpenTelemetry (OTLP) 経由で出力されます。Agent 対応のデプロイメントでは、デフォルトでオフになっている Datadog Agent OTLP レシーバーを有効にします。セットアップ手順については、Datadog Agent による OTLP の取り込み を参照してください。非 Agent サーバーレスデプロイメントの場合、Serverless Monitoring 設定でサポートされている OTLP またはカスタムメトリクスのパスを使用してください。

アプリケーションが使用するプロトコル (ポート 4317 での gRPC、またはポート 4318 での HTTP) のみを有効にする必要があります。

ステップ 2: アプリケーションを構成する

Java 以外のサポートされているトレーサーと配信モードの組み合わせについては、標準の サーバーサイド機能フラグの構成 に加えて、次の環境変数を設定してください。Java の場合、DD_METRICS_OTEL_ENABLED は効果がありません。代わりに Java: OpenTelemetry SDK 依存関係の追加セクションを参照してください。

# Enable flag evaluation metrics
DD_METRICS_OTEL_ENABLED=true

Java: OpenTelemetry SDK の依存関係の

Java プロバイダーは OpenTelemetry SDK を介して feature_flag.evaluations を記録し、OTLP 経由でエクスポートするため、opentelemetry-sdk-metrics 依存関係と opentelemetry-exporter-otlp 依存関係がアプリケーションのクラスパスに存在している必要があります。Java 機能フラグの依存関係 とともにそれらを追加してください。OpenTelemetry API と SDK のバージョンが同一であるようにするため、OpenTelemetry BOM をインポートします。

dependencies {
    implementation platform('io.opentelemetry:opentelemetry-bom:1.47.0')
    implementation 'io.opentelemetry:opentelemetry-sdk-metrics'
    implementation 'io.opentelemetry:opentelemetry-exporter-otlp'
}

dependencies {
    implementation(platform("io.opentelemetry:opentelemetry-bom:1.47.0"))
    implementation("io.opentelemetry:opentelemetry-sdk-metrics")
    implementation("io.opentelemetry:opentelemetry-exporter-otlp")
}

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.opentelemetry</groupId>
            <artifactId>opentelemetry-bom</artifactId>
            <version>1.47.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>io.opentelemetry</groupId>
        <artifactId>opentelemetry-sdk-metrics</artifactId>
    </dependency>
    <dependency>
        <groupId>io.opentelemetry</groupId>
        <artifactId>opentelemetry-exporter-otlp</artifactId>
    </dependency>
</dependencies>

Java トレーサーでは、OpenTelemetry SDK がクラスパスに存在する場合、プロバイダーは OTLP メトリクスエクスポーターを自動的に開始します。依存関係がない場合、メトリクスは出力されず、トレーサーは OpenTelemetry SDK is not on the classpath をログに記録します。

Ruby: OpenTelemetry メトリクス gem の追加

Ruby アプリケーションでは、OpenTelemetry メトリクス SDK gem と OTLP メトリクスエクスポーター gem をアプリケーションバンドルに追加します。

gem "opentelemetry-metrics-sdk", ">= 0.8"
gem "opentelemetry-exporter-otlp-metrics", ">= 0.4"

bundle install を使用して gem をインストールします。これらの gem は、OpenTelemetry メトリクスプロバイダーと OTLP メトリクスエクスポーターを提供します。DD_METRICS_OTEL_ENABLED=true が設定されている場合に Ruby トレーサーはこれらを使用します。gem がない場合、Ruby トレーサーは feature_flag.evaluations メトリクスを出力せず、Failed to load OpenTelemetry metrics gems をログに記録します。

エンドポイントの構成

DD_TRACE_AGENT_URL およびポート 8126 の標準 serverless-init リスナーは、OTLP メトリクスエンドポイントを構成しません。次のセクションで説明するように、OTLP エンドポイントを個別に構成してください。非 Agent サーバーレスデプロイメントの場合、このメトリクスを構成する前に、プラットフォームの Serverless Monitoring 設定に従ってください。

デフォルトでは、ほとんどのトレーサーは DD_AGENT_HOST のポート4318 (HTTP) で Agent に OTLP メトリクスを送信します。Agent に到達するためにアプリケーションで DD_AGENT_HOST がすでに設定されている場合、エンドポイントの構成は不要です。

以下の場合は、OTLP エンドポイントを明示的に設定してください。

• Agent が DD_AGENT_HOST のデフォルトの OTLP ポートに到達できない場合 (リモート Agent やデフォルト以外のポートなど)。
• Java トレーサーを使用している場合。そのフラグ評価メトリクスエクスポーターは、ポート 4318 で OTLP/HTTP のみをサポートしています (gRPC はサポートされていません)。Java トレーサーは DD_AGENT_HOST からエンドポイントを導出せず、デフォルトで http://localhost:4318 を使用します。Agent が OTEL_EXPORTER_OTLP_ENDPOINT にない場合は、localhost を Agent の HTTP エンドポイントに設定します。
• Python トレーサーを使用している場合。Python トレーサーはデフォルトでポート 4317 で gRPC を使用し、HTTP は使用しません。Agent で gRPC OTLP レシーバーを有効にするか、プロトコルをオーバーライドして代わりに HTTP を使用するように設定します。

OTEL_EXPORTER_OTLP_ENDPOINT=http://<AGENT_HOST>:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

エンドポイントを設定するには、標準の OpenTelemetry 変数を使用します。

# Point OTLP data at the Datadog Agent (HTTP, port 4318)
OTEL_EXPORTER_OTLP_ENDPOINT=http://<AGENT_HOST>:4318

# Or use gRPC (port 4317). For most tracers, the default protocol is http/protobuf,
# so set the protocol explicitly when switching to gRPC:
# OTEL_EXPORTER_OTLP_ENDPOINT=http://<AGENT_HOST>:4317
# OTEL_EXPORTER_OTLP_PROTOCOL=grpc

<AGENT_HOST> を Datadog Agent のホスト名または IP アドレスに置き換えます。

Docker Compose の例:

services:
  datadog-agent:
    environment:
      - DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_GRPC_ENDPOINT=0.0.0.0:4317
      - DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT=0.0.0.0:4318
      - HOST_PROC=/proc  # If running Agent v7.61.0+ in Docker

  app-go:
    environment:
      - DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED=true
      - DD_METRICS_OTEL_ENABLED=true
      - OTEL_EXPORTER_OTLP_ENDPOINT=http://datadog-agent:4318
    depends_on:
      datadog-agent:
        condition: service_healthy

ステップ 3: メトリクスが送信されていることを確認する

デプロイ後に、メトリクスが Datadog に到達していることを確認します。

1. Metrics Explorer に移動し、feature_flag.evaluations を検索します。
2. アプリケーションでフラグを評価してから数分以内にメトリクスが表示されない場合は、以下を確認してください。
   • Agent の OTLP レシーバーが有効になっており、正しいポートが公開されている。
   • OTEL_EXPORTER_OTLP_ENDPOINT が別のコレクターではなく、Agent を指している。
   • アプリケーションが実行時にサーバー SDK を使用してフラグをアクティブに評価している (コードパスが実行されている)。

ステップ 4: メトリクスの保持を有効にする

デフォルトでは、feature_flag.evaluations は 1 時間分のデータのみを保持します。より長い履歴を保持するには、次のようにします。

1. Metrics Summary に移動し、feature_flag.evaluations を検索します。
2. メトリクスを選択し、[Historical Metrics] (過去のメトリクス) を有効にします。

これはオプトイン設定であり、OTLP メトリクスに対して自動的に有効になることはありません。

ダッシュボードでのフラグ評価のグラフ化

次のクエリを使用して、ダッシュボード でフラグキーとバリアントごとにフラグ評価をグラフ化します。

sum:feature_flag.evaluations{*} by {feature_flag.key,feature_flag.result.variant}

メトリクス feature_flag.evaluations は、次のタグを持つカウンターです。

参考資料

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

サーバーサイドの Feature Flagsドキュメント Feature Flag グラフドキュメント メトリクスドキュメント ダッシュボードドキュメント