前提条件

1. IBM Cloud CLI をインストールします。

2. IBM Cloud Metrics Routing CLI をインストールします。

3. IBM Cloud Metrics Routing 経路を構成するための正しい IAM 許可があることを確認します。

4. IBM Cloud にログインします。 コマンド ibmcloud loginを実行します。

ターゲットの詳細を取得します

以下のステップを実行します。

1. 以下のコマンドを実行して、すべてのターゲットをリストします。 メトリックを経路指定するターゲットのターゲット ID をコピーします。

   ibmcloud metrics-router target ls
   

2. 以下のコマンドを実行して、ターゲットの詳細を取得します。

   ibmcloud metrics-router target get --target <TARGET_ID>
   

包含フィルターの定義

包含フィルターは、ターゲットにルーティングされるメトリックを決定します。

包含フィルターは、 operand、 operator、および valuesで構成されます。

operand

オペランドは、 operator テストが実行されるプロパティーの名前です。 サポートされるオペランドは、 location、service_name、service_instance、resource_type、および resourceです。

operator

in と isの 2 つの演算子がサポートされています。

in

オペランド・プロパティーの値は、値のリストと比較されます。

最大 20 個の値を定義できます。

is

オペランド・プロパティーの値は、単一値と比較されます。

isを使用する場合、指定できる値は 1 つのみです。

value

メトリックが経路指定されるかどうかを決定するために operand プロパティーと比較されるストリングまたはストリングの配列。 is operator を使用する場合、 value には単一ストリングを含める必要があります。 in operator を使用する場合、 value は配列に複数のストリングを含めることができます。

有効な値は、 operandによって異なります。

location

IBM Cloud Metrics Routing が使用可能な任意のロケーション。

service_name

IBM Cloud Metrics Routing を介して管理されるメトリックを生成する [IBM Cloud サービスの CRN サービス名

service_instance、resource_type、およびresource

IBM Cloud Metrics Routing で管理されるメトリックを生成する [IBM Cloud サービスに該当する値

例えば、米国南部地域で生成されたメトリックのみがルーティングされる条件を定義する包含フィルターを定義するには、以下のようにします。

{"operand": "location","operator": "is","values": "us-south"}

経路の構成

以下のコマンドを実行して、us-south から、前のステップで特定したターゲットにメトリックをルーティングします。

ibmcloud metrics-router route create --name new-route --rules '[{"action": "send", "targets":[{"id":"11111111-1111-1111-1111-1111111111111"}], "inclusion_filters":[{"operand": "location","operator": "is","values": "us-south"}]}]'

ここで、 targets はターゲット ID のリストを表し、 inclusion_filters はフィルターを指定します。