移行ガイド： v1 から v3

このガイドでは、 IBM Cloud Logs Routing サービスをバージョン 1 ( v1 ) からバージョン 3 ( v3 ) に移行する手順を順を追って説明します。 v1 が地域的なコンセプトを提供するのに対して、 v3 はグローバルなアプローチを提供し、ルートやフィルターを用いてプラットフォームログのルーティングをニーズに合わせて調整することができる。 移行プロセスでは、新しい v3 環境を設定し、 v1 から v3 に切り替えます。

最後の移行ステップでは、プラットフォームのログが受信されないため、短時間のサービス中断（数分程度）が発生することに注意してください。

警告 ：この移行は不可逆的です。 一旦 v3 に移行すると、 v1 には戻れない。

一般的な移行シナリオ

移行を開始する前に、どのシナリオが現在のロギングアーキテクチャに最もマッチするかを理解することが重要です。 以下の3つのシナリオは、最も一般的なロギング構成を表しており、あなたの v3 環境に適切なセットアップを決定するのに役立ちます。

シナリオ1：集中ロギング

集中ログ設定では、 アカウント全体のすべてのプラットフォームログが単一の IBM Cloud Logs インスタンスに統合されます。

このアプローチでは、 アカウント全体のすべてのプラットフォーム活動の統一ビューを提供することにより、ログ管理を簡素化します。

このシナリオを v3 で実装するには、一元化された IBM Cloud Logs インスタンスを指すターゲットを1つ作成し、ソースリージョンに関係なくすべてのプラットフォームログをキャプチャする ワイルドカードルールを持つルートを1つ設定する 必要があります。

シナリオ2：地理的ロギング

地理的ロギングシナリオは、異なる地理的ロケーションに分散した複数のロギングインスタンスを保持する組織のために設計されています。

この構成では、様々な地域からのプラットフォームログは、地理的近接性またはデータレジデンシー要件に基づいて、最も近い、または指定された地域の IBM Cloud Logs インスタンスにルーティングされる。 このアプローチでは、一元的な可視性と地理的な分散のバランスがとれており、複数の地域からのログを、戦略的に配置された少数の IBM Cloud Logs インスタンスにルーティングすることができます。

このシナリオを実装するには、複数のターゲット（地理的な IBM Cloud Logs インスタンスごとに1つ）を作成し、適切な地域ベースのフィルタを使用してルートを構成し、ログを正しい地理的な宛先に誘導する必要があります。

シナリオ3：地域伐採

地域ロギングは、最も分散されたアプローチであり、 IBM Cloud 各地域は、それ専用の IBM Cloud Logs インスタンスを持っている。

この構成は、ログデータの完全な地域隔離を保証し、厳しいデータ残留性またはコンプライアンス要件を満たすためによく使用されます。 このシナリオでは、特定のリージョンで生成されたプラットフォームログは、同じリージョンに配備された IBM Cloud Logs インスタンスにのみルーティングされる。

このシナリオを v3 で実装するには、運用する各地域に個別のターゲットとルートを作成し、各地域のルートに、その地域の IBM Cloud Logs インスタンスだけにログルーティングを制限するフィルタが含まれていることを確認する必要があります。

マイグレーション・アプローチ

v1 から v3 への移行には2つのアプローチがある。 あなたのニーズに最も適したアプローチを選びましょう。

  1. 自動マイグレーション（推奨） ：

    自動化された移行アプローチは、移行プロセスを簡素化し、設定エラーのリスクを低減するため、ほとんどのユーザーに推奨されます。

    移行 API を使用して、既存の v1 テナントに基づいて v3 ターゲットとルートを自動生成します。

    詳細については、 自動移行を 参照してください。

  2. マニュアル設定 ：

    移行を完了する前に、 v3 環境を一から手動で設定します。

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

移民国家を理解する

移籍のプロセスはいくつかの状態を経て進行する：

  • BEFORE ：マイグレーション開始前の初期状態。 以前の移行が失敗した場合は、エラーメッセージが表示されます。
  • IN_PROGRESS ：移行プロセスがアクティブに実行されている。 設定によっては数分かかる場合があります。
  • PENDING_COMPLETION: v3 ルートとターゲットが正常に作成されました。 移行を完了する前に、設定を確認する必要があります。
  • COMPLETE: 移行が正常に完了し、 アカウント v3 設定を使用するようになりました。

移行のためのIAM権限

移行プロセスには、特定のIAM権限が必要です。 移行を管理するために、以下のグローバルアクションが利用可能です：

  • logs-router.migration.post:マイグレーションを設定し、開始します。 これは、 アカウントメタデータを設定し、すべてのリージョンの実際の更新を開始する2段階のプロセスである。 管理者ロールが必要です。
  • logs-router.migration.get:マイグレーションのステータスを取得します。 Administrator、Editor、Operator、Viewer の各ロールで使用できます。
  • logs-router.migration.delete:自動的に作成されたすべての v3 ターゲットとルートを含む、生成された移行プランを削除します。 管理者ロールが必要です。

V1 から V3 に移行するには、 管理者プラットフォームのロールが必要です。

IAMロールとパーミッションの詳細については、 IAMロールを 参照してください。