サーバー SDK 構成ソース

このドキュメントは最新ではありません。最新版はこちらをクリックして英語版をご覧ください。
This product is not supported for your selected Datadog site. ().

Datadog Feature Flags サーバーサイド SDK は、フラグ構成からローカルでフラグを評価します。_構成ソース_は、SDK がその構成をどのように受信するかを決定します。OpenFeature の評価セマンティクスは変更されません。

構成ソースを選択する

サポートされているサーバー SDK では、以下の構成ソースオプションを利用できます。

agentless
SDK は、Datadog が管理する CDN から HTTPS 経由で定期的にフラグ構成をフェッチします。
  • ポーリングは、アプリケーションコードが Datadog OpenFeature プロバイダーを初期化またはアクセスしたときに開始されます。
  • フラグ構成に Datadog Agent は不要です。
remote_config
Datadog Agent は、Remote Configuration を通じてフラグ構成を受信し、それを SDK に配信します。
  • remote_config を選択すると、Feature Flags Remote Configuration サブスクリプションが有効になります。
  • Remote Configuration が有効な Datadog Agent が必要です。

Agentless 配信は、サポートされている SDK バージョンのデフォルトです。その他のサーバー SDK は、フラグ配信に Agent Remote Configuration を使用します。

ソースを明示的に選択する場合にのみ、DD_FEATURE_FLAGS_CONFIGURATION_SOURCE を設定してください。

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE=agentless

SDK は、初期化中に一度ソースを解決します。ソースを変更するには、アプリケーションを再起動してください。

Agentless 配信を使用する

Agentless 配信を開始するには、以下のいずれかの最小バージョンを使用してください。

SDK最小バージョン
Java dd-openfeature および dd-java-agent1.65.0
Node.js dd-trace v55.116.0
Node.js dd-trace v66.5.0
Python ddtrace4.14.0

Java CDN 配信には dd-openfeature および dd-java-agent が必要です。フラグ構成に Datadog Agent は必要ありません。

アプリケーションプロセスで API キー、Datadog サイト、および環境を構成してください。

DD_API_KEY=<DATADOG_API_KEY>
DD_SITE=<code class="js-region-param region-param" data-region-param="dd_site"></code>
DD_ENV=<YOUR_ENVIRONMENT>

次に、アプリケーションコードで Datadog OpenFeature プロバイダーを初期化するか、アクセスしてください。Java、Node.js、または Python のセットアップ手順を参照してください。

configuration-source や provider-enable の設定は不要です。ポーリングが開始されるのは、アプリケーションコードがプロバイダーを初期化またはアクセスした場合のみ開始です。トレーサーのインストールや初期化だけでは、Feature Flags CDN トラフィックは発生しません。

初期の Node.js Agentless リリースでは、構成配信とローカルフラグ評価のみがサポートされています。評価メトリクスやエクスポージャーイベントはエクスポートされません。Java および Python の Agentless 配信では、構成ソースのみが変更されます。サポートされている Datadog Agent またはサーバーレステレメトリパスがない場合、Java および Python はこれらのシグナルをエクスポートしません。

Agentless 配信を構成する

DD_SITE を組織の Datadog サイトに設定してください。このドキュメントページで選択したサイトについては、以下を使用してください。 Agentless ソースは、以下の運用設定もサポートしています。

環境変数デフォルト説明
DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_BASE_URLDatadog 管理エンドポイントAgentless フラグ構成エンドポイントまたはベース URL を上書きします。『カスタム Agentless エンドポイントを使用する』を参照してください。
DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_POLL_INTERVAL_SECONDS30完了したポーリング試行間の時間を設定する正の整数。Java は試行を制限しませんが、Node.js と Python は値を 3600 秒に制限します。
DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_REQUEST_TIMEOUT_SECONDS5個別の構成リクエストのタイムアウトを設定する正の整数。

SDK はバックグラウンドで構成を取得し、フラグをローカルで評価します。個別のフラグ評価では、ネットワークリクエストは行われません。Agentless ソースは、以下の処理を行います。

  • デフォルトで 30 秒ごとにポーリングします
  • デフォルトで 5 秒のリクエストタイムアウトを使用します
  • ETag を使用して、変更されていない構成のダウンロードを回避します
  • 一時的なネットワークエラーやペイロードエラーが発生した場合でも、最後に受け取った構成を保持します
  • ポーリングの重複の防止

Datadog 管理 CDN は、世界中に分散した拠点、ネットワークピアリング、および冗長ルーティングを使用します。そのため、サービスを提供する場所は、ほとんどのアプリケーションワークロードに対して地理的に近くなる可能性が高いです。

DD_API_KEY はシークレットマネージャーに保管し、フラグ設定を読み込むアプリケーションプロセスにのみ公開してください。Agentless 構成配信では、API キーがアプリケーションから Datadog へ HTTPS 経由で直接送信されます。

カスタム Agentless エンドポイントを使用する

標準的なデプロイメントには、Datadog 管理エンドポイントが推奨されます。高度なテスト、ローカル開発、またはオペレーター管理のプロキシの場合は、DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_BASE_URL で上書きします。

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_BASE_URL=http://localhost:8080

カスタム URL は、HTTP または HTTPS を使用する必要があります。オリジンまたはルートパスしか含まれていない場合、SDK は標準のフラグ構成パスを追加します。ルート以外のパスが含まれている場合、SDK はそのパスを完全なエンドポイントとして使用します。

SDK は、DD_API_KEY を HTTPS 経由でのみ、デフォルトの Datadog 管理エンドポイントに送信します。Datadog API キーをカスタムエンドポイントに転送することはありません。カスタムエンドポイントは、制御されたローカル開発環境では HTTP を使用できますが、ローカル開発環境外のエンドポイントには HTTPS を使用してください。

カスタムエンドポイントの設定が無効な場合、SDK はプロバイダーを無効のままにし、構成エラーをログに記録し、評価は呼び出し元が提供したデフォルト値を返します。

サポートされている SDK バージョンの Datadog for Government では、Datadog 管理 Agentless 配信は利用できません。そのサイト上のアプリケーションは、Agent Remote Configuration を使用しない限り、呼び出し元が提供したデフォルト値を使用し続けます。

既存の Remote Configuration セットアップを移行する

DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED=trueを設定した既存のお客様は、移行期間中、Remote Configuration のままとなります。この非推奨の設定は互換性のためのブリッジであり、長期的な構成ではありません。

Agentless 配信を使用する準備ができた場合、以下の手順に従います。

  1. DD_FEATURE_FLAGS_CONFIGURATION_SOURCE=agentless を設定してください。
  2. Datadog 管理エンドポイントについては、アプリケーションで DD_API_KEY、DD_SITE、およびDD_ENV を設定してください。
  3. プロバイダーを初期化し、フラグの更新を受信していることを確認してください。
  4. DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED を削除してください。移行が完了した後は、非推奨の設定が有効なままにしないでください。

一時的に Agent Remote Configuration のままにするには、DD_FEATURE_FLAGS_CONFIGURATION_SOURCE=remote_config を設定してから DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED を削除してください。API キーは Agent 上に残ります。

DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED=false を設定している場合は、DD_FEATURE_FLAGS_ENABLED=false に置き換えてください。

明示的な DD_FEATURE_FLAGS_CONFIGURATION_SOURCE 値は、レガシー設定よりも優先されます。レガシー設定が削除された後、明示的なソースを持たないアプリケーションは Agentless 配信を使用します。Agent 配信を継続したい場合は、非推奨のレガシー設定が削除される前に remote_config を明示的に設定してください。

Agent Remote Configuration を使用する

Agent 管理配信を使用するには、ソースを remote_config に設定します。

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE=remote_config

Java の場合、Remote Configuration には互換性のある dd-openfeature および dd-java-agent バージョンが必要です。両方のコンポーネントでバージョン 1.65.0 以降を使用してください。

API キーはアプリケーションプロセス内ではなく、Agent 上で設定してください。Agent で Remote Configuration が無効になっている場合は、再度有効にしてください。Agent のセットアップとネットワーク要件については、Remote Configuration を参照してください。

高度な構成

Feature Flags の有効化または無効化

DD_FEATURE_FLAGS_ENABLED はデフォルトで true に設定されているため、新規セットアップで設定する必要はありません。false に設定すると、プロバイダーと両方の構成配信パスが無効になります。

DD_FEATURE_FLAGS_ENABLED=false

アクティベーションと課金

Server Feature Flags の課金は、Remote Configuration または CDN を介して行われた構成リクエストに基づきます。トレーサーのインストールのみでは、どちらの配信パスもアクティブになりません。

  • デフォルトの Agentless ソースの場合、アプリケーションコードが Datadog OpenFeature プロバイダーを初期化またはアクセスしないと、CDN ポーリングは開始されません。
  • remote_config を明示的に選択すると、Agent Feature Flags サブスクリプションが開始されます。プロバイダーを初期化するためにアプリケーションコードは必要ありません。

構成の優先順位

構成結果
DD_FEATURE_FLAGS_ENABLED=false他の設定に関係なく、プロバイダーと両方の配信パスが無効になります。
明示的な DD_FEATURE_FLAGS_CONFIGURATION_SOURCE=agentlessCDN 配信を選択します。アプリケーションコードがプロバイダーを初期化またはアクセスすると、ポーリングが開始されます。
明示的な DD_FEATURE_FLAGS_CONFIGURATION_SOURCE=remote_configAgent 配信が選択され、Feature Flags Remote Configuration サブスクリプションが有効になります。
空白の、または空白文字のみの DD_FEATURE_FLAGS_CONFIGURATION_SOURCEソースが未設定として扱われるため、レガシー移行設定または Agentless のデフォルトが適用されます。
明示的な DD_FEATURE_FLAGS_CONFIGURATION_SOURCE=offline またはその他のサポートされていない空白以外の値アプリケーションコードがプロバイダーにアクセスしたときに、フェイルクローズします。SDK は CDN または Remote Configuration 配信を選択しません。
ソースなし、かつ DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED=true移行期間中は Remote Configuration を保持します。
ソースなし、かつ DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED=falseプロバイダーと両方の配信パスを無効のままにします。
DD_FEATURE_FLAGS_CONFIGURATION_SOURCE も DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED も設定されていないAgentless 配信が選択されます。アプリケーションコードがプロバイダーを初期化またはアクセスすると、ポーリングが開始されます。

参考資料

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

サーバーサイドの Feature Flags をセットアップするドキュメント more more サーバーレス環境で Feature Flags を使用するドキュメント more more Remote Configuration について学習するドキュメント more more