IBM Cloud Docs
新しくサポートされる地域で必要なアクション

新しくサポートされる地域で必要なアクション

IBM Cloud® Metrics Routing が現在サポートされていない地域でサポートされる予定である場合、既存のすべてのユーザーは、IBM Cloud Metrics Routing 構成を評価し、必要な変更を行う必要があります。 IBMは、新しいリージョンがサポートされるかどうかをアナウンスします。

適切な権限があるかどうかを確認してください

管理者権限 を持つ Cloud Identity and Access Management の ID を使用して、 IBM Cloud にログインします。

ルーティング・ルールが新規リージョンのメトリックをキャプチャーするかどうかを確認します

ルーティング・ルールを使用すると、メトリックの領域に基づいてメトリックが流れる宛先 (ターゲット) を変更できます。

ルーティング・ルールは、どのメトリックがルーティングに一致するかを決定します。 また、すべてのメトリックをルーティングするように経路を構成するとき、またはすべてのメトリックをドロップするときに、inclusion_filters 定義を除外することもできます。

コマンド ibmcloud mr route ls を実行します。

この例は、us-east からのメトリックがターゲットにルーティングされる経路を示しています。

$ ibmcloud mr route ls
OK
Name:         new-route
ID:           a4544cc3-e593-4b3b-a4ab-674d78ec3caa
CRN:          crn:v1:bluemix:public:metrics-router:global:a/81de6380e6232019c6567c9c8dexxxxx::route:a4544cc3-e593-4b3b-a4ab-674d78ec3caa
Rule 0:       [[15030278-9eeb-404e-b7aa-be1e8e8690d6(mon-std-secure)], [[location, is, [us-east]]]]
Created At:   2024-03-13T15:52:25.983Z
Updated At:   2024-03-13T15:52:25.983Z

この例のような構成で、メトリックのルーティング元のロケーションを指定する場合は、新しくサポートされるリージョンを構成に追加する必要があります。

この例は、すべてのメトリックがドロップされる経路を示しています。

Route
Name:         new-route2
ID:           d97f8358-f66d-48e0-9399-f15e090f4b44
CRN:          crn:v1:bluemix:public:metrics-router:global:a/81de6380e6232019c6567c9c8de6dece::route:d97f8358-f66d-48e0-9399-f15e090f4b44
Rule 0:       [drop, []]
Created At:   2024-03-13T16:40:47.394Z
Updated At:   2024-03-13T16:40:47.394Z

この例のような構成では、すべてのメトリックがドロップされ、新しいリージョンで生成されたメトリックもドロップされます。

以下の例は、すべてのメトリックが経路指定される経路を示しています。

$ ibmcloud at route ls
OK
Route
Name:         new-route1
ID:           98911386-9c06-4a2b-aa14-9ac41bd5f7e1
CRN:          crn:v1:bluemix:public:metrics-router:global:a/81de6380e6232019c6567c9c8dxxxxx::route:98911386-9c06-4a2b-aa14-9ac41bd5f7e1
Rule 0:       [[15030278-9eeb-404e-b7aa-be1e8e8690d6(mon-std-secure)], []]
Created At:   2024-03-13T16:38:21.417Z
Updated At:   2024-03-13T16:38:21.417Z

すべてのメトリックをルーティングする構成がある場合、新しい IBM Cloud Metrics Routing リージョンが有効になると、すべてのメトリックがそのターゲットにルーティングされます。

経路の構成について詳しくは、 経路の管理 を参照してください。

アカウントでデフォルト・ターゲットが構成されているかどうかの確認

ルートが構成されていない場合は、アカウントでデフォルトのターゲットが構成されているかどうかを確認してください。

IBM Cloud Metrics Routing 設定のデフォルト・ターゲットは、メトリックのリージョンに一致するルーティング・ルールがない場合にメトリックが送信される宛先です。

コマンド ibmcloud mr setting get を実行します。

ルーティング定義に一致がない場合、「デフォルト・ターゲット」配列には、メトリックを受信する最大 2 つの定義済みターゲットが表示されます。

例えば、これはデフォルト・ターゲットが構成されていないことを示しています。

$ ibmcloud at setting get
OK
IBM Cloud Metrics Routing settings
Primary metadata region:              us-east
Backup metadata region:               Not Initialized
Default targets:                      []
Permitted target regions:             []
Private api endpoint only:            false

この例は、デフォルト・ターゲットが構成されていることを示しています。

$ ibmcloud at setting get
OK
IBM Cloud Metrics Routing settings
Primary metadata region:              us-east
Backup metadata region:               Not Initialized
Default targets:                      [15030278-9eeb-404e-b7aa-be1e8e8690d6]
Permitted target regions:             []
Private api endpoint only:            false

ターゲットの定義について詳しくは、「 ターゲットの管理」を参照してください。

デフォルト・ターゲットが定義されている場合、アカウントのルーティング・ルールに一致しないメトリックはデフォルト・ターゲットにルーティングされ、この変更による影響を受けません。

デフォルトのターゲットが定義されていない場合は、次のステップに進みます。

デフォルト・ターゲットの定義

ご使用の構成に、各領域のメトリックのデフォルト・ターゲットも明示的ルールも含まれていない場合、欠落している領域のメトリックはサービスのデフォルト・ターゲットに配信されます。 ルーティング・ルールに一致しないメトリックがデフォルト・ターゲット (<target-id>) にルーティングされるように、コマンド ibmcloud mr setting update --default-target <target-id> を使用してデフォルト・ターゲットを構成できます。

以下に例を示します。

$ ibmcloud mr setting update --default-targets 15030278-9eeb-404e-b7aa-be1e8e8690d6
Are you sure you want to update the IBM Cloud Metrics Routing settings for your account? [y/N]> y
OK
IBM Cloud Metrics Routing settings
Primary metadata region:              us-east
Backup metadata region:               Not Initialized
Default targets:                      [15030278-9eeb-404e-b7aa-be1e8e8690d6(mon-std-secure)]
Permitted target regions:             []
Private api endpoint only:            false