IBM Cloud Logs Routingについて学ぶ
IBM Cloud Logs Routingサービスを使用すると、選択したIBM Cloudサービス インスタンスによって生成されたプラットフォーム ログを、選択した宛先 (ターゲット) にルーティングできます。
詳細については、 「プラットフォーム ログについて」 を参照してください。
プラットフォーム ログを構成するには、 IBM Cloudアカウントでテナントとターゲット (宛先) を構成する必要があります。
テナントは、リージョン内で実行されているIBM Cloud Logs Routingのアカウント固有の構成です。 1テナントあたり、1リージョンあたり、最大1つのターゲットデスティネーションを定義できます。 ターゲットはログのルーティング先を定義する。
テナント
テナントを管理する際には、以下の情報を考慮すること:
-
IBM Cloud Logs Routingを使用してプラットフォーム ログを収集およびルーティングする各リージョンで、アカウントにテナントを作成する必要があります。
各地域は独立しています。
地域間でデータは共有されません。
-
テナントを作成するときは、ターゲット宛先を 1 つ定義する必要があります。 詳細については、 「テナントの作成」 を参照してください。
-
テナントを更新する場合、変更できるのはテナント名のみです。
-
テナントを削除すると、ターゲット定義も削除されます。 ターゲットの宛先インスタンスを削除する場合は、インスタンスを個別に削除する必要があります。
-
GET /tenantsAPI メソッドを使用すると、アカウント内のすべてのテナントを一覧表示できます。 -
テナントの詳細を取得するには、アカウント内のテナントを一覧表示する際に返されるテナント ID を指定する
GET /tenants/{tenant_id}API メソッドを使用できます。
また、 ルーティング設定UIを 使用して、設定されたテナントとターゲット宛先を確認することもできます。
ターゲット
IBM Cloud Logs Routing は、 インスタンスのターゲットをサポートしています。 IBM Cloud Logs
IBM Cloud Logsインスタンスへのターゲットを構成する場合は、パブリック Ingress エンドポイントのみがサポートされます。
IBM Cloud Logs Routingターゲット インスタンスはIBM Cloud Logs Routingテナントと同じアカウント、別のアカウント、同じリージョンまたは別のリージョンに配置できます。
目標を管理する際には、以下の情報を考慮すること:
-
ターゲット ホスト、ターゲット ポート、ターゲット名、ターゲット インスタンス CRN などのターゲット構成の詳細を更新できます。
-
GET /tenants/{tenant_id}/targetsAPIメソッドを使用すると、テナント内のすべてのターゲットを一覧表示できます。 -
GET /tenants/{tenant_id}/targets/{target_id}APIメソッドを使用してターゲットの詳細を取得する。
また、 ルーティング設定UIを 使用して、設定されたテナントとターゲット宛先を確認することもできます。
IBM Cloud Logs Routing ・サービスとターゲット・デスティネーション・インスタンス間の認可は、IAMを通じて行われる。
IBM Cloud Logs Routing への接続
IBM® Cloud Logs Routingは、テナント構成の作成や管理などの管理機能のためのAPIエンドポイントを提供します。 これらのAPIエンドポイントは、地域固有のURLを使ってアクセスするエンドポイントである。 サポートされている各リージョンのエンドポイントについては、こちら をご覧ください。
管理 API を使用してIBM Cloud Logs Routingを管理できます。 管理 API は、パブリック エンドポイントまたはプライベート エンドポイントのいずれかをサポートします。 パブリック エンドポイントはインターネット経由でアクセスできますが、プライベート エンドポイントにはIBM Cloudプライベート ネットワーク内からのみアクセスできます。
IBM Cloud Logs Routing UI を通じて、パブリック ネットワークを使用してリージョン内にテナントを作成できます。
IBM® Cloud Logs Routingは、 IBM Cloud Logs Routingにプライベートに接続するための次のタイプのエンドポイントをサポートしています。
- IBM Cloudクラウド サービス エンドポイント (CSE)
- Virtual Private Endpoint (VPE) for VPC.
IBM Cloud VPCから接続する場合は、CSE またはVPE for VPCのいずれかを使用して接続できます。 詳しくは、VPC の仮想プライベート・エンドポイント (VPE) を使用した IBM Cloud Logs Routing へのプライベート接続を参照してください。
IBM Cloud VPCに含まれていないシステムから接続する場合、プライベート エンドポイントの唯一のオプションは、CSE を使用して接続することです。 CSE を使用してIBM Cloud Logs Routingに接続する場合、ユーザー側で追加の作業が必要になることはありません。 CSE へのアクセスはIBM Cloudプライベート ネットワーク内からのみ可能です。 詳しくは、サービス・エンドポイントを使用した IBM Cloud Logs Routing へのプライベート接続を参照してください。
IBM Cloud Logs Routing UIには パブリック・ネットワークからのみアクセスできます。
管理 API を使用してIBM Cloud Logs Routingを管理できます。 管理 API は、パブリック エンドポイントまたはプライベート エンドポイントのいずれかをサポートします。 パブリック エンドポイントはインターネット経由でアクセスできますが、プライベート エンドポイントにはIBM Cloudプライベート ネットワーク内からのみアクセスできます。
- 設定を作成、更新、または削除するには、 IBM Cloud Logs Routing 管理 API または IBM Cloud Logs Routing UI を 使用できます。
- 管理エンドポイントのリストを表示するには、 「エンドポイント」 を参照してください。
パブリック エンドポイントを使用する場合、追加の作業は必要ありません。