ターゲットについて

IBM Cloud Logs Routing UI、CLI、REST API V3、Terraformスクリプトを使用して、 アカウント内の IBM Cloud Logs ターゲットを管理できます。 ターゲットは、 IBM Cloud アカウント生成されたプラットフォームログをルーティングできるリソースです。

アカウントでターゲットがどのように機能するかを理解する

ターゲットに関する以下の情報に注意してください。

  • 各アカウントには、最大 16 個のターゲットを定義できます。 各アカウントは、最大 2 つのデフォルト・ターゲットを持つことができます。

  • ターゲットはプラットフォームログを収集するリソースを定義する。 ルートは、 アカウント生成されたプラットフォームログが、設定したターゲットにどのようにルーティングされるかを定義します。

  • IBM Cloud Logs Routing が利用できる場所であれば、どの場所でもターゲットを定義できます。 詳しくは、ロケーションを参照してください。

  • ターゲットは 1 つの領域内に作成されますが、複数の領域にまたがって表示されます。 つまり、すべてのターゲットはどの IBM Cloud Logs APIエンドポイントからもアクセスできる。

  • プライベート・エンドポイントとパブリック・エンドポイントを使用してターゲットを管理することができます。 使用可能な ENDPOINTS のリストについて詳しくは、エンドポイントを参照してください。

    • https://api.private.REGION.logs-router.cloud.ibm.comという形式の API エンドポイントを使用して、プライベート・ネットワークからターゲットを管理できます。

    • https://api.REGION.logs-router.cloud.ibm.comという形式の API エンドポイントを使用して、パブリック・ネットワークからターゲットを管理できます。

    • アカウント設定を更新することで、パブリック・エンドポイントを無効にすることができます。 詳細については、 プライベート・エンドポイントの強制を 参照のこと。

ターゲット・タイプ

以下のいずれかのターゲットタイプを設定できる：

ターゲットリスト
ターゲット タイプ 詳細情報
IBM Cloud Logs cloud_logs IBM Cloud Logs 目標の管理

IAM アクセス権限

ターゲットを管理するには、ユーザーにIAM権限を付与する必要があります。 詳細については、 リソースへのアクセス権の割り当てを 参照してください。

ポリシーを定義するとき、権限の範囲を指定することができます。 特定の地域またはアカウント全体に対して権限を付与するかどうかを選択できます。

ポリシーと権限を作成するIAM権限を持っている場合、対象サービスのユーザーとして持っているレベルのアクセスのみを付与することができます。 例えば、対象サービスのビューアアクセスがある場合、ビューアロールのみを権限に割り当てることができます。 Administratorなどの上位の権限を割り当てようとすると、権限が付与されているように見えるかもしれませんが、対象のサービスに対して持っている最上位の権限（ビューア）しか割り当てられません。

地域スコープを持つユーザーは、許可された地域内のターゲットへのアクセスに制限される。

IAMアクションとそれを含むIAMロール。
IAM アクション IAMポリシーの範囲 IAM 役割 説明
logs-router.target.read リージョン Administrator
Editor
Viewer
Operator		 ターゲットに関する情報の読み取り (表示)
logs-router.target.create リージョン Administrator
Editor		 ターゲットの作成
logs-router.target.update リージョン Administrator
Editor		 ターゲットの更新
logs-router.target.delete リージョン Administrator
Editor		 ターゲットの削除
logs-router.target.list アカウント Administrator
Editor
Viewer
Operator		 すべてのターゲットのリスト

認証

IBM Cloud Logs ターゲットに書き込む場合、 IBM Cloud Logs Routing と IBM Cloud Logs の間にサービス間（ S2S ）認可を設定する必要があります。

次のオプションのいずれかを選択してください。

ターゲットの検証

ターゲットを検証するとき、ターゲットに設定されているクレデンシャルが有効であることをチェックする。 これらの認証情報は、 IBM Cloud Logs Routing、デスティネーション・ターゲットとの認証に使用される。

IBM Cloud Metrics Routing CLI、 IBM Cloud Metrics Routing REST API、Terraformスクリプトを使ってターゲットを検証できます。

CLI の前提条件

CLI を使用してターゲットを管理する前に、以下の手順を実行します。

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

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

CLI コマンド

次の表は、ターゲットを管理するために実行できるアクションのリストです。

IBM Cloud Logs Routing イベントルーティング CLI を使用したターゲットアクション
アクション コマンド
ターゲットの作成 ibmcloud logs-router target create
ターゲットの更新 ibmcloud logs-router target update
ターゲットの削除 ibmcloud logs-router target delete
ターゲットの読み取り ibmcloud logs-router target get
すべてのターゲットのリスト ibmcloud logs-router target list

詳しくは、IBM Cloud Logs Routing CLI を参照してください。

API のターゲットとアクション

ターゲットを管理するための API 呼び出しを行うには、以下のステップを実行します。

  1. IAM アクセス・トークンを取得します。 詳しくは、IAM アクセス・トークンの取得を参照してください。
  2. ターゲットを構成または管理する予定のリージョン内の API エンドポイントを特定します。 詳しくは、API エンドポイントを参照してください。
IBM Cloud Logs Routing REST APIを使用したターゲットアクション
アクション REST API メソッド API_URL
ターゲットの作成 POST <ENDPOINT>/v3/targets
ターゲットの更新 PATCH <ENDPOINT>/v3/targets/<TARGET_ID>
ターゲットの削除 DELETE <ENDPOINT>/v3/targets/<TARGET_ID>
ターゲットの読み取り GET <ENDPOINT>/v3/targets/<TARGET_ID>
すべてのターゲットのリスト GET <ENDPOINT>/v3/targets

プライベート・エンドポイントとパブリック・エンドポイントを使用してターゲットを管理することができます。 使用可能な ENDPOINTS のリストについて詳しくは、エンドポイントを参照してください。

  • https://api.private.REGION.logs-router.cloud.ibm.comという形式の API エンドポイントを使用して、プライベート・ネットワークからターゲットを管理できます。

  • https://api.REGION.logs-router.cloud.ibm.comという形式の API エンドポイントを使用して、パブリック・ネットワークからターゲットを管理できます。

  • アカウント設定を更新することで、パブリック・エンドポイントを無効にすることができます。 詳しくは、ターゲットとリージョンの設定の構成を参照してください。

REST API の詳細については、 IBM Cloud Logs Routing REST API v3 を参照してください。

HTTP 応答コード

IBM Cloud Logs Routing REST API を使用すると、メソッドが正常に完了したかどうかを示す標準 HTTP 応答コードを取得できます。

  • 200 応答は、どのような場合でも成功を示しています。
  • 4xx 応答は、失敗を示しています。
  • 5xx 応答は通常、内部システム・エラーを示しています。

いくつかの HTTP 応答コードについては、以下の表を参照してください。

HTTP 応答コード一覧
状況コード ステータス 説明
200 OK ターゲットのリストが正常に取得された。
201 OK 要求は正常に終了しました。 リソースが作成されます。
400 誤った要求 要求は失敗しました。 必要なパラメーターが欠落している可能性があります。
401 無許可 API 要求で使用されている IAM トークンは無効であるか、有効期限が切れています。
403 禁止 権限が不十分なため、操作は禁止されました。
404 見つかりません 要求されたリソースは存在しないか、既に削除されています。
409 競合 リクエストデータとシステム内のリソースの状態に矛盾がある。
429 要求が多すぎる API に到達する要求の数が多すぎるうえに各要求の間隔が短すぎます。
500 内部サーバー・エラー 何らかの問題が発生しました。 要求を処理できませんでした。 後でもう一度試してください。 問題が解決しない場合は、レスポンスヘッダのトランザクションIDを記録し、 IBM Cloud サポートに 連絡する。

UIを使ったターゲットの管理

IBM コンソールを使用して、 IBM Cloud Logs Routing ターゲット、ルート、および設定を管理できます。

  1. IBM Cloud アカウントログイン.
  2. 「メニュー」 アイコン 「メニュー」アイコン > **「可観測性」**をクリックします。
  3. Logging > Routing を選択する。

詳しくは、 IBM Cloud Logs ターゲットの管理を 参照。