経路の管理
IBM Cloud Logs Routing UI、 IBM Cloud Logs Routing CLI、 IBM Cloud Logs Routing REST API、 V3、 IBM Cloud Logs Routing Terraformプロバイダーを使って、 アカウント内のルートを管理できます。 ルートは、リージョン内でどのプラットフォームログがルーティングされ、どこにルーティングされるかを示すルールを定義する。
IBM Cloud Logs Routing ルートについての詳細は、 ルートを 参照のこと。
IAM アクセス権限
ルートを管理するには、正しいIAM権限が必要です。 詳しくは IAMアクセスの管理
UI を使用した経路の作成
UIを使用してルートを作成するには、以下の手順を実行します。
-
「メニュー」 アイコン
> **「可観測性」**をクリックします。
-
Logging > Routingをクリックする。
-
Routes] タブで[ Create ]をクリックする。
-
Routing rules セクションで、 Rule 1の Actionを変更する:
ルール1の アクションを選択します:
-
プラットフォームログを関連するターゲットにルーティングするルールの [Send logs from ]を選択します。
-
このルールに一致するプラットフォームログをドロップするために、ルールの [Drop logs from ]を選択します。
包含フィルタを 追加して、ルールで指定されたターゲットにルーティングされるプラットフォームログを決定する。
-
条件を選択し、包含フィルターでマッチさせる場所の値を指定する。
-
複数の包含フィルタを追加するには、 フィルタの追加をクリックします。
リストからターゲットを選択して、ルールに関連付ける ターゲットを 追加する。 ターゲットが定義されていない場合は、 Add targetをクリックして新しいターゲットを作成する。
-
-
ルートに追加のルールを追加するには、 ルールを追加する をクリックします。
ルートルールの順番はルーティングの動作に影響する。 ルールは順番に処理され、あるルールにマッチすると、それ以降のルールは処理されない。
ルーティングルールの順序は、各ルール定義の右側にある上下の矢印をクリックすることで変更できる。
ルールまたはフィルタを削除する必要がある場合は、ルールまたはフィルタに関連する [削除] アイコンをクリックします。
ルートごとに最大10個のルールを構成できます。
-
次へ をクリックします。
-
ルートの名前を入力します。
-
ルートの定義を見直して、ルールの順序が意図した通りであることを確認してください。
詳細については、 ルーティングの優先順位を理解するを 参照してください。
-
「作成」 をクリックします。
UIを使ってルートを更新する
UIを使用してルートを更新するには、次の手順を実行します。
-
「メニュー」 アイコン
> **「可観測性」**をクリックします。
-
Logging > Routingをクリックする。
-
Routes タブで、更新するルートを決定し、
Actionsをクリックします。
-
ルートの名前を変更するには、 名前の変更をクリックします。
-
編集] をクリックして、ルートルールを更新します。
ルーティングルールで、ルールのアクションを変更する:
-
プラットフォームログを関連するターゲットにルーティングするルールに、
Sendを選択する。 -
このルールに一致するプラットフォームログをドロップするルールに
Dropを選択します。
包含フィルタを 追加または修正して、ルールで指定されたターゲットにルーティングされるプラットフォームログを決定する。
必要なフィルタと条件を選択し、包含フィルタで一致させる値を指定する。
複数の包含フィルタを追加するには、 フィルタの追加をクリックします。
-
-
リストからターゲットを選択して、ルールに関連付ける ターゲットを 修正する。 ターゲットが定義されていない場合は、 Add targetをクリックして新しいターゲットを作成します。
-
ルートに追加のルールを追加するには、 ルールを追加する をクリックします。
ルートルールの順番はルーティングの動作に影響する。 ルールは順番に処理され、あるルールにマッチすると、それ以降のルールは処理されない。
ルーティングルールの順序は、各ルール定義の右側にある上下の矢印をクリックすることで変更できる。
ルールまたはフィルタを削除する必要がある場合は、ルールまたはフィルタに関連する [削除] アイコンをクリックします。
ルートごとに最大10個のルールを構成できます。
-
ルートを変更するには、[ 更新] をクリックします。
UIを使用してルートを表示する
UI を使用してルートを表示するには、次の手順を実行します。
-
「メニュー」 アイコン
> **「可観測性」**をクリックします。
-
Logging > Routingをクリックする。
-
Routes タブでは、設定されたルートのリストを見ることができます。
経路は独立して処理されるので、経路の順番はルーティングの動作に影響しない。
各ルートにはルート名とルールが表示されます。
routesページには、ルーティングの設定に関する追加情報が記載されたルーティングガイダンスも表示されます。
UI を使用した経路の削除
UI を使用してルートを削除するには、次の手順を実行します。
-
「メニュー」 アイコン
> **「可観測性」**をクリックします。
-
Logging > Routingをクリックする。
-
Routes] タブで、削除するルートを決定し、
Actions)をクリックします。
-
ルート全体を削除するには、 [削除]をクリックします。 ルートが削除される前に、ルート名を入力する必要があります。
CLI の前提条件
CLI を使用してルートを管理する前に、次の手順を完了してください:
-
IBM Cloud にログインします。 次のコマンドを実行します。 ibmcloud login
CLI を使用した経路の作成
ルートを作成するにはこのコマンドを使う。
ルート名はアカウント内で一意です。
ibmcloud logs-router route create --name NAME --rules RULES | @RULES-FILE [--output FORMAT] [--force]
コマンド・オプション
--name ROUTE_NAME-
経路に付ける名前。
最大文字数は1000文字です。
最小長は1文字です。
名前には、空白、
-、.、_、:以外の特殊文字を含めることはできません。リソース名に個人識別情報 (PII) を含めないでください。
--rules RULES-
JSON文字列、またはJSONファイルのプレフィックスへのパス。
@、プラットフォームのログがどのようにルーティングされるかを定義します。ルールは設定された順に評価される。
最大長は10ルール。
詳細については、 ルーティングルールの定義を 参照してください。
--output FORMAT-
現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。
JSONを指定しない場合は、出力が表形式で返されます。 help|--help|-h-
コマンドで使用できるオプションがリストされます。
例
以下は、 ibmcloud logs-router route create コマンドを使った例である。
ibmcloud logs-router route create --name route3 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]}]'
出力は以下のようになります。
Id cfa2be32-979d-4e99-a2a2-e68e65e9b8cc
Name route3
Rules
action send
inclusion_filters
operand location
operator in
values [us-south, eu-de]
targets
id 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
name cl-target2
target_type cloud-logs
id 6f9137b3-2bb9-4724-851b-153e23c82d80
name cl-platform-logs-sydney-113
target_type cloud-logs
Created At 2026-04-29T12:59:25.764Z
Updated At 2026-04-29T12:59:25.764Z
Managed By account
別の例:
ibmcloud logs-router route create --name route4 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]},{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "is", "values": ["us-east"]}]}]'
出力は以下のようになります。
Id 6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name route4
Rules
action send
inclusion_filters
operand location
operator in
values [us-south, eu-de]
targets
id 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
name cl-target2
target_type cloud-logs
id 6f9137b3-2bb9-4724-851b-153e23c82d80
name cl-platform-logs-sydney-113
target_type cloud-logs
action send
inclusion_filters
operand location
operator is
values [us-east]
targets
id 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
name cl-target2
target_type cloud-logs
id 6f9137b3-2bb9-4724-851b-153e23c82d80
name cl-platform-logs-sydney-113
target_type cloud-logs
Created At 2026-04-29T13:01:11.685Z
Updated At 2026-04-29T13:01:11.685Z
Managed By account
CLI を使用した経路の更新
ルートを更新するにはこのコマンドを使う。 経路が最初に作成された時の値とは異なる値をコマンドで指定すると、その値がコマンドの指定値に更新されます。
ibmcloud logs-router route update --id ROUTE [--name NAME] [--rules RULES | @RULES-FILE] [--output FORMAT] [--force]
コマンド・オプション
--id ROUTE-
ルートのID。
--name ROUTE_NAME-
経路に付ける名前。
最大文字数は1000文字です。
最小長は1文字です。
名前には、空白、
-、.、_、:以外の特殊文字を含めることはできません。リソース名に個人識別情報 (PII) を含めないでください。
--rules RULES-
JSON文字列、またはJSONファイルのプレフィックスへのパス。
@、プラットフォームのログがどのようにルーティングされるかを定義します。ルールは設定された順に評価される。
最大長は10ルール。
詳細については、 ルーティングルールの定義を 参照してください。
--output FORMAT-
現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。
JSONを指定しない場合は、出力が表形式で返されます。 help|--help|-h-
コマンドで使用できるオプションがリストされます。
例
以下は、 ibmcloud logs-router route update --id 6bb85c44-7187-4e45-b850-c912ddd2d0bf --name my-new-route-name コマンドを使った例である。
出力は以下のようになります。
Id 6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name my-new-route-name
Rules
action send
inclusion_filters
operand location
operator in
values [us-south, eu-de]
targets
id 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
name cl-target2
target_type cloud-logs
id 6f9137b3-2bb9-4724-851b-153e23c82d80
name cl-platform-logs-sydney-113
target_type cloud-logs
action send
inclusion_filters
operand location
operator is
values [us-east]
targets
id 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
name cl-target2
target_type cloud-logs
id 6f9137b3-2bb9-4724-851b-153e23c82d80
name cl-platform-logs-sydney-113
target_type cloud-logs
Created At 2026-04-29T13:01:11.685Z
Updated At 2026-04-29T13:07:32.677Z
Managed By account
CLI を使用した経路の削除
ルートを削除するには、このコマンドを使用します。
ibmcloud logs-router route delete --id route [--force]
コマンド・オプション
--id ROUTE- ルートのID。
--force|-f- ユーザーに追加のプロンプトを出さずに経路を削除します。
help|--help|-h- コマンドで使用できるオプションがリストされます。
例
以下は、 ibmcloud logs-router route delete --id 6bb85c44-7187-4e45-b850-c912ddd2d0bf コマンドを使った例である。
ルートの削除を確認するよう求められます。 以下は、deleteコマンドを実行したときの出力である:
Are you sure you want to delete? [y/n]> y
OK
CLIを使用してルートに関する情報を取得する
このコマンドを使用して、IBM Cloud Logs Routing リージョンの経路に関する情報を取得します。
ibmcloud logs-router route get --id route [--output FORMAT]
コマンド・オプション
--route ROUTE- ルートのID。
--output FORMAT- 現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。
JSONを指定しない場合は、出力が表形式で返されます。 help|--help|-h- コマンドで使用できるオプションがリストされます。
例
以下は、 ibmcloud logs-router route get --id 2a4739ee-7cd6-4e05-b60d-9b2e7b0b7981 コマンドでルートを表示した例である。
出力は以下のようになります。
Id 2a4739ee-7cd6-4e05-b60d-9b2e7b0b7981
Name route2
Rules
action send
targets
id 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
name cl-target2
target_type cloud-logs
id 6f9137b3-2bb9-4724-851b-153e23c82d80
name cl-platform-logs-sydney-113
target_type cloud-logs
Created At 2026-04-29T12:55:23.106Z
Updated At 2026-04-29T12:55:23.106Z
Managed By account
リージョン内のすべての経路のリスト
IBM Cloud Logs Routing リージョンに設定されたルートをリストするには、このコマンドを使う。
ibmcloud logs-router route list [--output FORMAT]
コマンド・オプション
--output FORMAT- 現在サポートされている形式は JSON です。 指定すると、出力が JSON 形式で返されます。
JSONを指定しない場合は、出力が表形式で返されます。 help|--help|-h- コマンドで使用できるオプションがリストされます。
例
以下は、 ibmcloud logs-router route list コマンドを使った例である。
API の経路とアクション
次の表は、経路を管理するために実行できるアクションのリストです。
| アクション | REST API メソッド | API_URL |
|---|---|---|
| 経路の作成 | POST |
<ENDPOINT>/v3/routes |
| 経路の更新 | PATCH |
<ENDPOINT>/v3/routes/<route_ID> |
| 経路の削除 | DELETE |
<ENDPOINT>/v3/routes/<route_ID> |
| 経路の読み取り | GET |
<ENDPOINT>/v3/routes/<route_ID> |
| すべての経路をリストします | GET |
<ENDPOINT>/v3/routes |
プライベート・エンドポイントとパブリック・エンドポイントを使用して経路を管理することができます。 使用可能な ENDPOINTS のリストについて詳しくは、エンドポイントを参照してください。
- プライベートネットワークからのルート管理には、以下の形式のAPIエンドポイントを使用します:
https://api.private.REGION.logs-router.cloud.ibm.com - 以下の形式のAPIエンドポイントを使用して、パブリックネットワークからルートを管理できます:
https://api.REGION.logs-router.cloud.ibm.com
アカウント設定を更新することで、パブリック・エンドポイントを無効にすることができます。 詳しくは、 ルートと地域の設定を 参照してください。
REST APIの詳細については、 routesを参照してください。
API の前提条件
経路を管理するための API 呼び出しを行うには、以下のステップを実行します。
- IAM アクセス・トークンを取得します。 詳しくは、IAM アクセス・トークンの取得を参照してください。
- 経路を構成または管理する予定の地域の API エンドポイントを識別します。 詳しくは、エンドポイントを参照してください。
API を使用した経路の作成
次の cURL コマンドを使用して、経路を作成できます。
ルート名はアカウント内で一意です。 ルート名を再利用して複数の宛先を設定することはできません。
curl -X POST <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
"name": "ROUTE_NAME",
"rules": [
{
"action": "send",
"targets": [
{
"id": "50375218-7cff-4234-bbb4-171bebab8408"
},
{
"id": "c7519d8a-5f97-498b-a229-8542f60955cd"
}
],
"inclusion_filters": [
{
"operand": "location",
"operator": "is",
"values": ["us-east"]
}
]
}
]
}'
説明
<ENDPOINT>-
ルートを設定または管理する予定の地域のAPIエンドポイント。 詳しくは、エンドポイントを参照してください。
ROUTE_NAME-
経路に付ける名前。
経路に付ける名前。
最大文字数は1000文字です。
最小長は1文字です。
名前には、空白、
-、.、_、:以外の特殊文字を含めることはできません。リソース名に個人識別情報 (PII) を含めないでください。
RULES-
JSON文字列、またはJSONファイルのプレフィックスへのパス。
@、プラットフォームのログがどのようにルーティングされるかを定義します。ルールは設定された順に評価される。
最大長は10ルール。
詳細については、 ルーティングルールの定義を 参照してください。
例えば、次の cURL リクエストを使ってルートを作ることができます:
curl -X POST https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
"name": "My-route",
"rules": [
{
"action": "send",
"targets": [
{
"id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
},
{
"id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
}
],
"inclusion_filters": [
{
"operand": "location",
"operator": "is",
"values": ["us-east"]
},
{
"operand": "service_name",
"operator": "in",
"values": ["codeengine","container-registry"]
}
]
}
]
}'
出力は以下のようになります。
{"id":"c7673f63-1260-4f86-bc1a-aaedb89391d8","name":"route5","crn":"crn:v1:bluemix:public:logs-router:global:a/xxxxxxx::route:c7673f63-1260-4f86-bc1a-aaedb89391d8","rules":[{"action":"send","targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","name":"cl-target2","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","target_type":"cloud-logs"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80","name":"cl-platform-logs-sydney-113","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:6f9137b3-2bb9-4724-851b-153e23c82d80","target_type":"cloud-logs"}],"inclusion_filters":[{"operand":"location","operator":"is","values":["us-east"]}]}],"managed_by":"account","created_at":"2026-04-29T13:26:34.237Z","updated_at":"2026-04-29T13:26:34.237Z"}
API を使用した経路の更新
ルートとルールの名前を変更できます。 ルートが最初に作成されたときと異なる指定された値は、リクエストで指定された値に更新されます。
経路を更新する場合は、要求のデータ・セクションに経路情報を含める必要があります。
- すべてのフィールドを渡す必要があります。
- 変更する必要があるフィールドを更新します。
ルート名はアカウント内で一意です。 ルート名を再利用して複数の宛先を設定することはできません。
次の cURL コマンドを使用して、経路を更新できます。
curl -X PATCH <ENDPOINT>/v3/routes/ROUTE_ID -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
"name": "ROUTE_NAME",
"rules": [
{
"action": "send",
"targets": [
{
"id": "d3ebcda8-953d-45ea-a4a7-b47f8c4a9742"
}
],
"inclusion_filters": [
{
"operand": "location",
"operator": "is",
"values": ["eu-de"]
}
]
}
]
}'
説明
<ENDPOINT>-
ルートを設定または管理する予定の地域のAPIエンドポイント。 詳しくは、エンドポイントを参照してください。
ROUTE_ID-
経路ID。
ROUTE_NAME-
経路に付ける名前。
経路に付ける名前。
最大文字数は1000文字です。
最小長は1文字です。
名前には、空白、
-、.、_、:以外の特殊文字を含めることはできません。リソース名に個人識別情報 (PII) を含めないでください。
RULES-
JSON文字列、またはJSONファイルのプレフィックスへのパス。
@、プラットフォームのログがどのようにルーティングされるかを定義します。ルールは設定された順に評価される。
最大長は10ルール。
詳細については、 ルーティングルールの定義を 参照してください。
例えば、次の cURL リクエストを使って、ダラスにルートを作ることができます:
curl -X PATCH https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
"name": "My new route name",
"rules": [
{
"action": "send",
"targets": [
{
"id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
},
{
"id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
}
],
"inclusion_filters": [
{
"operand": "location",
"operator": "is",
"values": ["us-east"]
}
]
}
]
}
}'
API を使用した経路の削除
次の cURL コマンドを使用して、経路を削除できます。
curl -X DELETE <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"
説明
<ENDPOINT>- ルートを設定または管理する予定の地域のAPIエンドポイント。 詳しくは、エンドポイントを参照してください。
<route_ID>- 経路ID。
例えば、以下の cURL リクエストを使って、ID c7673f63-1260-4f86-bc1a-aaedb89391d8 :
curl -X DELETE https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"
API を使用した経路の表示
次の cURL コマンドを使用して、1 ルートのコンフィギュレーションの詳細を表示できます:
curl -X GET <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"
説明
<ENDPOINT>- ルートを設定または管理する予定の地域のAPIエンドポイント。 詳しくは、エンドポイントを参照してください。
<route_ID>- 経路ID。
例えば、以下の cURL 要求を実行して、ID 00000000-0000-0000-0000-000000000000の経路に関する情報を取得できます。
curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"
APIを使用するすべてのルートをリストする
次の cURL コマンドを使用して、すべての経路を表示できます。
curl -X GET <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"
説明
<ENDPOINT>は、経路を構成または管理する予定の地域の API エンドポイントです。 詳しくは、エンドポイントを参照してください。
例えば、Dallasで定義されたルートに関する情報を得るために、次の cURL リクエストを実行できます:
curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"
HTTP 応答コード
IBM Cloud Logs Routing REST API を使用すると、メソッドが正常に完了したかどうかを示す標準 HTTP 応答コードを取得できます。
- 200 応答は、どのような場合でも成功を示しています。
- 4xx 応答は、失敗を示しています。
- 5xx レスポンスは内部システムエラーを示す。
いくつかの HTTP 応答コードについては、以下の表を参照してください。
| 状況コード | ステータス | 説明 |
|---|---|---|
200 |
OK | 要求は正常に終了しました。 |
201 |
OK | 要求は正常に終了しました。 リソースが作成されます。 |
400 |
誤った要求 | 要求は失敗しました。 必要なパラメーターが欠落している可能性があります。 |
401 |
無許可 | API 要求で使用されている IAM トークンは無効であるか、有効期限が切れています。 |
403 |
禁止 | 権限が不十分なため、操作は禁止されました。 |
404 |
見つかりません | 要求されたリソースは存在しないか、既に削除されています。 |
409 |
競合 | リクエストデータとシステム内のリソースの状態に矛盾がある。 |
429 |
要求が多すぎる | API に到達する要求の数が多すぎるうえに各要求の間隔が短すぎます。 |
500 |
内部サーバー・エラー | IBM Cloud Logs Routing の処理で何らかの問題が発生しました。 |