遷移指南：從 v1 過渡到 v3
本指南提供將 IBM Cloud Logs Routing 服務從版本 1 ( v1 ) 移轉到版本 3 ( v3 ) 的逐步說明。 v1 提供了區域概念，而 v3 則提供了全局方法，透過路由和篩選條件，可根據您的需求調整平台日誌的路由。 遷移過程包括設定新的 v3 環境，然後從 v1 切換到 v3。
請注意，在最後遷移步驟中會有短暫的服務中斷（約幾分鐘），無法接收平台日誌。
警告：此移轉是不可逆轉的。 一旦您遷移至 v3，就無法再遷移回 v1。
常見的遷移情境
在開始遷移之前，了解哪種方案最符合您目前的記錄架構非常重要。 以下三種情況代表最常見的日誌設定，可協助您決定適合您 v3 環境的設定。
方案 1：集中式記錄
在集中式日誌配置中，整個帳戶的所有平台日誌都會整合到單一 IBM Cloud Logs 範例中。
此方法可為您的帳戶提供所有平台活動的統一檢視，從而簡化日誌管理。
若要在 v3 中實現此情況，您需要建立一個指向集中式 IBM Cloud Logs 範例的目標，並 使用通配符規則設定一個路由，以擷取所有平台日誌，不論其來源區域為何。
方案 2：地理記錄
地理日誌情境專為維護分佈在不同地理位置的多個日誌實體的組織所設計。
在此組態中，來自不同區域的平台日誌會根據地理位置鄰近程度或資料駐留要求，路由至最近或指定的區域 IBM Cloud Logs 實例。 此方法平衡了集中式可視性與地理分佈，讓您可以將來自多個區域的日誌路由到數量較少且具策略性位置的 IBM Cloud Logs 實體。
要實現此方案，您需要建立多個目標 (每個地理 IBM Cloud Logs 範例一個)，並使用適當的區域篩選器設定路由，以將日誌導向正確的地理目的地。
方案 3：區域伐木
區域記錄代表最分散的方式，每個 IBM Cloud 區域都有自己專用的 IBM Cloud Logs 範例。
此配置可確保日誌資料的完全區域隔離，通常用於滿足嚴格的資料駐留或合規要求。 在此情況下，特定區域產生的平台日誌會被專門路由到部署在同一區域的 IBM Cloud Logs 實例。
若要在 v3 中實現此情況，您需要為您營運的每個區域建立單獨的目標和路由，確保每個區域路由都包含過濾器，可將日誌路由限制為僅指向該區域的 IBM Cloud Logs 範例。
遷移方法
從 v1 遷移到 v3 有兩種方法。 選擇最符合您需求的方法。
-
自動遷移（建議）：
由於自動化遷移方法可簡化遷移程序並降低配置錯誤的風險，因此建議大多數使用者採用此方法。
使用遷移 API，根據您現有的 v1 租戶自動產生 v3 目標和路由。
如需詳細資訊，請參閱 自動遷移。
-
手動設定：
在完成遷移之前，請從頭手動設定 v3 環境。
選擇下列其中一個選項：
瞭解移民國家
遷移過程會經過幾個狀態：
- BEFORE：開始移轉之前的初始狀態。 如果之前的遷移嘗試失敗，則會包含錯誤訊息。
- IN_PROGRESS：移轉程序正在執行中。 這可能需要幾分鐘，視您的設定而定。
- PENDING_COMPLETION: 您的 v3 路由和目標已成功建立。 您應該在完成遷移前驗證設定。
- 完成：遷移已成功完成，您的帳戶現在使用 v3 設定。
遷移的 IAM 權限
遷移過程需要特定的 IAM 權限。 下列全局動作可用於管理移轉：
- logs-router.migration.post:配置並啟動遷移。 這是一個分兩步進行的程序，先設定帳戶元資料，然後開始實際更新所有區域。 需要管理員角色。
- logs-router.migration.get:擷取移轉的狀態。 適用於管理員、編輯員、操作員和檢視員角色。
- logs-router.migration.delete:刪除已產生的移轉計劃，包括所有自動建立的 v3 目標和路由。 需要管理員角色。
您必須擁有管理員平台角色，才能從 V1 遷移到 V3。
如需 IAM 角色和權限的詳細資訊，請參閱 IAM 角色。