IBM® Cloud Logs Routing V3

IBM Cloud Logs Routing サービスを使用して、 IBM Cloud アカウント選択したターゲット宛先にプラットフォームログをルーティングします。

ルーティングされたログの流れ
ルーティングされたログの流れ

IBM® Cloud Logs Routing の使用を開始するには、以下の手順を完了します：

開始前に

  1. IBM Cloud アカウントお持ちでない場合は、 IBM Cloud アカウント登録。 IBM Cloud で作業するには、IBMid が必要です。

  2. IBM Cloud Logs Routing サービスが使用可能なリージョンを確認します。

  3. IBM Cloud® アカウント IBM Cloud Logs Routing を設定するユーザーが、 IBM Cloud Logs Routing サービスを管理するのに十分な権限を持っていることを確認する。 詳細については、 IBM Cloud Logs Routing の IAM アクセスの管理を 参照してください。

    リソースを管理するには、プラットフォームのロール Adminsitratorが必要です。

  4. 以下のツールをインストールする：

  5. IBM Cloud Logs。 詳しくは、インスタンスのプロビジョニングを参照してください。

サービス間認証の作成

IBM Cloud® Identity and Access Management (IAM)を使用して、 IBM Cloud Logs Routing に IBM Cloud Logs へのアクセスを許可する権限を作成し、 IBM Cloud Logs Routing サービスが IBM Cloud Logs インスタンスの宛先（ターゲット）にログを送信できるようにする必要があります。

認証サービスを設定する前に、 IBM Cloud Logs の送信者ロールが必要です。

以下のステップを実行します。

  1. IBM Cloud コンソールで、「管理」 > **「アクセス (IAM)」をクリックし、「許可」**を選択します。

  2. 「作成」 をクリックします。

  3. ソースアカウント設定する。 このアカウント を選択する。

  4. ソースサービスとしてログルーティングを選択する。 次に、アクセス範囲を「 すべてのリソース 」に設定する。

  5. 対象サービスとして Cloud Logsを選択します。 次に、アクセス範囲を「 All resources（すべてのリソース） 」に設定し、すべての IBM Cloud Logs インスタンスへのアクセスを許可するか、 「Resources based on selected attributes（選択した属性に基づくリソース ）」 > 「 Service Instance（サービスインスタンス ）」を構成して単一のインスタンスへのアクセスを許可する。

    その他の属性は、このタイプの認可ではサポートされていない。

  6. Service Access セクションで、 Senderを選択して、ターゲット・サービスにアクセスするソース・サービスへのアクセスを割り当てます。

  7. 「許可」 をクリックします。

詳細については、 IBM Cloud Logs にログを送信するためのアクセス権を付与するための S2S 権限の作成 を参照してください。

プライマリ・メタデータの場所とAPIバージョンを設定する

以下のステップを実行します。

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

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

  3. Logging >Routing をクリックします。

  4. **「Settings」**タブをクリックします。

  5. 変更する設定の横にある Editをクリックします。

    プライマリ・メタデータの場所を入力します。

    API バージョンを 3 に設定する。

ターゲットの作成

以下の手順でターゲットを作成する：

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

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

  3. Logging > Routingを選択する。

  4. Targets セクションで、 Createをクリックして作成パネルを開く。

  5. Choose destination ]で、 [Search by instance] または[ Specify CRN ]を選択します。

    インスタンスで検索を選択し、 アカウント利用可能なテーブルから IBM Cloud Logs インスタンスを選択する

    別のアカウント にあ る イ ン ス タ ン ス の IBM Cloud Logs インスタンス CRN を追加するには、 Specify CRN を選択します。

  6. ターゲットの詳細セクションで、以下のタスクを完了する：

    ターゲット名を入力する。

    IBM Cloud Logs Routing の設定で、新しいターゲットをデフォルトターゲットとして自動的に設定するには、 Not set からトグルを有効にします。

  7. Create targetをクリックする。

ルートを設定する

以下の手順でターゲットを作成する：

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

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

  3. Logging > Routingをクリックする。

  4. Routes］ タブで［ Create ］をクリックする。

  5. Routing rules セクションで、 Rule 1の Actionを変更する：

    ルール1の アクションを選択する：

    • プラットフォームログを関連するターゲットにルーティングするルールの ［Send logs from ］を選択します。

    • このルールに一致するプラットフォームログをドロップするために、ルールの ［Drop logs from ］を選択します。

    包含フィルタを 追加して、ルールで指定されたターゲットにルーティングされるプラットフォームログを決定する。

    • 条件を選択し、包含フィルタでマッチさせる場所の値を指定する。

    • 複数の包含フィルタを追加するには、 フィルタの追加をクリックします。

    リストからターゲットを選択して、ルールに関連付ける ターゲットを 追加する。 ターゲットが定義されていない場合は、 Add targetをクリックして新しいターゲットを作成する。

  6. ルートに追加のルールを追加するには、 ルールを追加する をクリックします。

    ルートルールの順番はルーティングの動作に影響する。 ルールは順番に処理され、あるルールにマッチすると、それ以降のルールは処理されない。

    ルーティングルールの順序は、各ルール定義の右側にある上下の矢印をクリックすることで変更できる。

    ルールまたはフィルタを削除する必要がある場合は、ルールまたはフィルタに関連する ［削除］ アイコンをクリックします。

    ルートごとに最大10個のルールを構成できます。

  7. 次へ をクリックします。

  8. ルートの名前を入力します。

  9. ルートの定義を見直して、ルールの順序が意図した通りであることを確認してください。

    詳細については、 ルーティングの優先順位を理解するを 参照してください。

  10. 「作成」 をクリックします。

ログが宛先ターゲットに送信されることの確認

ログが IBM Cloud Logs インスタンスにルーティングされていることを確認する。

以下のステップを実行します。

  1. リージョン内のプラットフォームログを収集する対象として設定されている IBM Cloud Logs インスタンスの IBM Cloud Logs Web UI を起動する。 これは、ターゲットをセットアップするステップで選択したインスタンスです。

  2. カスタムビューでログを見る 詳しくは、ログの表示を参照してください。

    すべてのプラットフォームログはJSONで生成される。 ibm - platform-logsの値を applicationName 、またはLuceneクエリを実行することで、インスタンス内のプラットフォームログをフィルタリングできます： coralogix.metadata.applicationName:"ibm-platform-logs"