IAMベアラートークンの取得

IBM Cloud® Identity and Access Management (IAM) アクセストークンを取得して、IBM® Cloud Logs Routing サービスへのリクエストを認証する必要があります。 詳細については、アクセス・トークンのリトリーブを参照してください。

例えば、以下のCLIコマンドを実行することで、IAMベアラートークンを取得し、環境変数としてエクスポートすることができます：

export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`

管理エンドポイントの選択

テナントは、リージョン内で実行されているIBM Cloud Logs Routingのアカウント固有の構成です。

リージョン内のテナントの詳細を取得するには、テナントが構成されているリージョンの管理エンドポイント URL を使用する必要があります。

プライベートまたはパブリックのエンドポイントを使うことができる。

詳細については、管理エンドポイントURL を参照してください。

UIによるテナントとターゲットの作成

IBM Cloud Logs Routingコンソールが最初に表示されると、既存のターゲット情報が表示されます。

リージョンにターゲットが設定されていない場合、リージョンは Set target オプションを表示する。 ターゲットが初めて設定されると、IBM Cloud Logs Routingテナントが 作成され（オンボード）、ターゲットが設定されます。

リージョンのテナントとターゲットを作成するには、以下の手順を実行します：

1. IBM Cloudアカウントにログインする.

2. 「メニュー」 アイコン>「可観測性」 をクリックする。

3. ロギング > ルーティングをクリックします。

4. 目標設定をクリックします。

5. IBM Cloud Logs インスタンスを選択します。 これは、 IBM Cloud Logs Routing によってルーティングされたログを受信したいインスタンスです。

   リストから IBM Cloud Logs インスタンスを選択できます。 その前に、IBM Cloud Logs RoutingサービスとIBM Cloud Logsインスタンスの間で、サービス間の認証が定義されていることを確認してください。 詳細は S2S権限を作成し、IBM Cloud Logsにログを送信するアクセスを許可する を参照。

6. 保存 をクリックします。

UIでターゲットを設定すると、その地域にテナントが作成される。 テナントの名前は region-ID とし、地域はターゲット作成時にあなたがいる地域に設定します。

APIを使用したテナントとターゲットの作成

IBM Cloud Logs Routingサービスのテナントを作成するには、プライベート・エンドポイントを使用して、次のコマンドを実行します：

curl -X POST  https://management.private.${REGION}.logs-router.cloud.ibm.com/v1/tenants \
-H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H "IBM-API-Version: API_VERSION_DATE" \
--data '{TARGET_DATA}'

IBM Cloud Logs Routingサービスのテナントを作成するには、パブリック・エンドポイントを使用して、次のコマンドを実行します：

curl -X POST  https://management.${REGION}.logs-router.cloud.ibm.com/v1/tenants \
--H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H "IBM-API-Version: API_VERSION_DATE" \
--data '{TARGET_DATA}'

説明

• REGION は、テナントが設定される場所を定義します。
• IAM_TOKEN はリクエストの認証に使うクレデンシャルを定義します。
• API_VERSION_DATE は、テナント定義のクエリに使用するAPIバージョンの日付を定義します。 書式は次のようにしなければならない：YYYY-MM-DD
• TARGET_DATA はターゲット先の情報を定義します。

{
    "name": "TENANT_NAME",
    "targets": [
        {
            "log_sink_crn": "CLOUD_LOGS_INSTANCE_CRN",
            "name": "TARGET_NAME",
            "parameters": {
                "host": "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT",
                "port": CLOUD_LOGS_INSTANCE_TARGET_PORT
            }
        }
    ]
}

Terraformを使ったテナントとターゲットの作成

provider "ibm" {
  ibmcloud_api_key = "IBMCLOUD_API_KEY"
  region = "some-region"
}

resource "ibm_logs_router_tenant" "logs_router_tenant_instance_1" {
	name = "TENANT_NAME"
  region = "TENANT_REGION"
	targets {
	  log_sink_crn = "CLOUD_LOGS_INSTANCE_CRN"
	  name = "TARGET_NAME"
	  parameters {
		host = "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT"
		port = CLOUD_LOGS_INSTANCE_TARGET_PORT
	  }
	}
  }