This product is not supported for your selected Datadog site. ().

概要

ターゲティング属性とは、アプリケーションが評価コンテキストで送信する値 (country やuser_role など) の再利用可能な定義です。属性を一度定義しておけば、オートコンプリートの候補やデータ型に応じた演算子を使用して、ルール間で属性を再利用できるようになり、ターゲティングルールを作成するたびに属性名を入力し直したり、互換性のある演算子を手動で選択したりする必要がなくなります。

各ターゲティング属性には次のものがあります。

  • 属性キー: ターゲティングルールで参照する識別子 (例: country や user.plan)。キーは組織内で一意であり、大文字と小文字が区別されます。
  • データ型:Boolean、String、Number、またはSemver。データ型によって、ターゲティングルールでその属性を使用するときに利用可能な演算子が決まります。
  • 配信チャネル: どの SDK が評価コンテキストでこの属性を報告するかを指定します ([Client and Server] (クライアントおよびサーバー)、[Client Only] (クライアントのみ)、または [Server Only] (サーバーのみ))。Semver 属性は、クライアント SDK でのみ利用可能です。
  • 説明 (任意): その属性が表す内容を他のユーザーに伝えるメモ。

ターゲティング属性は組織全体で共有されます。定義された属性は、すべてのフラグと環境においてターゲティングルールで使用可能になります。

ターゲティング属性の管理

組織のターゲティング属性を表示および管理するには:

  1. [Feature Flags] > [Settings] (設定) > [Targeting Attributes] (ターゲティング属性) に移動します。
  2. [Create Attribute] (属性を作成) をクリックして新しい属性を定義するか、既存の属性を選択して編集します。

各属性について以下を構成します。

  • 属性キー: 短くわかりやすい識別子。Datadog は、保存時にサポートされていない文字を自動的に削除します。
  • データ型: [Boolean]、[String] (文字列)、[Number] (数値)、または [Semver] のいずれかを選択します。
  • 配信チャネル (どの SDK が評価コンテキストでこの属性を報告するか): [Client and Server] (クライアントおよびサーバー)、[Client Only] (クライアントのみ)、または [Server Only] (サーバーのみ) を選択します。
  • 説明 (オプション): 他のユーザーがその属性の内容や設定方法を理解できるように、コンテキストを追加します。

組織内で同じキーを持つ属性を 2 つ作成することはできません。属性を (削除ではなく) アーカイブすると、今後のオートコンプリートの候補からは除外されますが、すでにその属性を参照しているターゲティングルールは変更されません。

ターゲティングルールでの属性のオートコンプリート

ターゲティングルールでフィルターを作成し、属性フィールドに入力し始めると、Datadog は 3 つのソースから属性を提案します。

  • 保存されているターゲティング属性: 組織のカタログの属性。データ型および説明とともに表示されます。
  • 評価データで観測された属性: 過去 7 日間に SDK が実際に送信した属性のうち、まだカタログに保存されていない属性です。これらはデータ型なしで表示されます。
  • 新しい属性を作成する: 既存の属性や観測された属性と一致しない名前を入力した場合、[Create a new attribute] (新しい属性を作成する) を選択して、ターゲティングルールエディターを離れることなく属性を定義できます。
オートコンプリートの候補と [Create a new attribute] (新しい属性を作成する) オプションが表示されているターゲティングルールの属性フィールド。

この方法で作成された属性は、[Client and Server] (クライアントおよびサーバー) 配信チャネルで、データ型なしで組織のカタログに保存されます。データ型は未設定のままにするか、後で [Settings] (設定) > [Targeting Attributes] (ターゲティング属性) から属性を編集して設定できます。

フィルターの上にある [View all attributes] (すべての属性を表示) をクリックして、ターゲティング属性の設定ページに移動します。

データ型が演算子に与える影響

ターゲティングルールで属性を選択すると、そのデータ型に合わせて提示される演算子が絞り込まれます。

データ型利用可能な演算子
Boolean: is、is null
文字列: is、matches、does not match、is one of、is null
数値: is、is one of、is not one of、less than、less than or equal to、greater than、greater than or equal to、is null
Semver: is, is one of、is not one of、is null、semver equals、semver not equals、semver less than、semver less than or equal to、semver greater than、semver greater than or equal to

Semver の比較は、Semantic Versioning 2.0.0 の値に対応しています。仕様では 3 つの数値構成要素 (例: 1.2.3) が必要ですが、Datadog は 1 つ以上の数値構成要素からなる値も受け入れます。欠落している構成要素はゼロとして比較され (18、18.0、18.0.0 は同等)、ゼロ以外の追加構成要素は順序に影響します (18.0.0.1は18.0.0 より大きい)。標準のプレリリース優先順位が適用され、ビルドメタデータは比較に影響しません。

条件の属性を互換性のないデータ型の属性に変更すると、Datadog は演算子と値を新しい型のデフォルト値にリセットします。カタログに保存されていない (評価データで観測されただけの) 属性は、利用可能な演算子を制限しません。

参考資料