IBM® Cloud Logs Routing 概説
IBM Cloud Logs Routing サービスを使用して、 IBM Cloud アカウント選択したターゲット宛先にプラットフォームログをルーティングします。
IBM Cloud Logs Routing REST API V3 のリリースにより、 V3 API を使用するようにアカウント移行することができます。これにより、プラットフォームのログを複数の宛先にルーティングし、エンタープライズ IAM アクションコントロールを使用してアカウントサービスを管理することができます。 移行の詳細については、 IBM Cloud Logs Routing REST API V3 を使用するための移行を 参照してください。 新しいアカウントお持ちの場合は、「 複数の宛先で始める 」の手順に従ってください。
IBM® Cloud Logs Routingの使用を開始するには、以下の手順を実行します:
開始前に
-
IBM Cloud アカウントお持ちでない場合は、 IBM Cloud アカウント登録。 IBM Cloud で作業するには、IBMid が必要です。
-
プラットフォームログを構成するには、IBM Cloudアカウントでテナントとターゲット(宛先)を構成する必要があります。
テナントは、リージョン内で実行されているIBM Cloud Logs Routingのアカウント固有の構成です。 1テナントあたり、1リージョンあたり、最大1つのターゲットデスティネーションを定義できます。 ターゲットはログのルーティング先を定義する。
詳細は、IBM Cloud Logs Routing を参照してください。
-
IBM Cloud Logs Routing サービスが使用可能なリージョンを確認します。 IBM Cloudで運営している地域を特定し、サポートされている地域のリストにあるか確認します。
-
IBM Cloud®アカウントのIBM Cloud Logs Routingを設定しているユーザが、IBM Cloud Logs Routingサービスを管理するのに十分な権限を持っていることを確認してください。 詳細は IBM Cloud Logs RoutingのIAMアクセス管理 を参照。
テナントとターゲットを表示するには、サービス・ロール reader が必要です。
テナントとターゲットを作成、削除、更新するには、サービス・ロールマネージャが必要です。
-
以下のツールをインストールする:
-
IBM Cloud® CLI をダウンロードしてインストールします。
-
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 の送信者ロールが必要です。
以下のステップを実行します。
-
IBM Cloud コンソールで、「管理」 > **「アクセス (IAM)」をクリックし、「許可」**を選択します。
-
「作成」 をクリックします。
-
ソースアカウントを設定する。 このアカウントを選択します。
-
ソース・サービスとしてログ・ルーティングを選択します。 そして、アクセスのスコープをすべてのリソースに設定する。
-
対象サービスとしてクラウドログを選択します。 すべてのリソースに設定すると、すべてのIBM Cloud Logsインスタンス、または選択した属性に基づくリソース > サービスインスタンスに設定することで単一のインスタンスへのアクセスが許可されます。
その他の属性は、このタイプの認証ではサポートされていない。
-
Service Accessセクションで、Sender を選択して、ターゲット・サービスにアクセスするソース・サービスへのアクセスを割り当てます。
-
「許可」 をクリックします。
テナントの作成
IBM Cloud Logs Routingコンソールが最初に表示されると、既存のターゲット情報が表示されます。
リージョンにターゲットが設定されていない場合、リージョンは Set target オプションを表示する。
IBM Cloud Logs Routingコンソールから、構成したいリージョンのターゲット設定オプションを構成することで、テナントとターゲット宛先を作成できます。
以下のステップを実行します。
-
「メニュー」 アイコン
>「可観測性」 をクリックする。
-
ロギング > ルーティングをクリックします。
-
ターゲットを設定をクリックします。
-
タブクラウドログをクリックし、リストからIBM Cloud Logsインスタンスを選択します。 これは、IBM Cloud Logs Routingによってルーティングされたログを受け取りたいインスタンスです。
リストから IBM Cloud Logs インスタンスを選択できます。
IBM Cloud Logs インスタンスは、設定するのと同じアカウントなければなりません。
-
保存 をクリックします。
ログが宛先ターゲットに送信されることの確認
クラスタのログがIBM Cloud Logsインスタンスにルーティングされていることを確認します。
すべてのプラットフォームログはJSONで生成される。 インスタンスのプラットフォームログをフィルタリングするには、ibm-platform-logs の値を applicationName として選択します。
以下のステップを実行します。
- リージョン内のプラットフォームログを収集する対象として設定されているIBM Cloud Logs インスタンスのIBM Cloud Logs Web UI を起動します。 これは、ターゲットをセットアップするステップで選択したインスタンスです。
- カスタムビューでログを見る 詳しくは、ログの表示を参照してください。