開始使用 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:

開始之前

  1. 如果您沒有IBM Cloud帳戶,請註冊一個IBM Cloud帳戶。 您需要一個IBMid才能在IBM Cloud中運作。

  2. 要設定平台日誌,您必須在您的IBM Cloud帳戶中設定租用戶和目標(目的地)。

    租用戶是在區域內執行的IBM Cloud Logs Routing的帳戶特定配置。 每個租戶每個區域最多可以定義 1 個目標目的地。 目標定義日誌的路由位置。

    有關更多信息,請參閱 了解有關IBM Cloud Logs Routing的更多資訊

  3. 檢查IBM Cloud Logs Routing服務可用的區域。 確定您在IBM Cloud中運作的區域,並檢查是否在支援的區域清單中。

  4. 檢查為IBM Cloud® IBM Cloud Logs Routing } 的使用者是否有足夠的權限來管理IBM Cloud Logs Routing服務。 有關更多信息,請參閱 管理IBM Cloud Logs Routing的 IAM 存取

    您需要服務角色閱讀器來查看租戶和目標。

    您需要服務角色管理器來建立、刪除、更新租用戶和目標。

  5. 安裝以下工具:

建立服務授權服務

您必須使用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. 選擇雲端日誌作為目標服務。 然後,將存取範圍設為 All resources,這將授予對所有IBM Cloud Logs實例的存取權限,或根據所選屬性> Service Instance 配置資源來授予對單一實例的存取權限。

    此類授權不支援其他屬性。

  6. 在*「服務存取權限」*部分中,選擇 「傳送者」 以指派對存取目標服務的來源服務的存取權限。

  7. 按一下授權

有關更多信息,請參閱 建立S2S授權以授予將日誌傳送到IBM Cloud Logs存取權限

建立租戶

首次顯示IBM Cloud Logs Routing控制台時,會顯示任何現有目標資訊。

如果某個區域沒有配置目標,則該區域將顯示 「設定目標」 選項。

在IBM Cloud Logs Routing控制台中,您可以透過為要設定的區域設定選項 「設定目標」 來建立租用戶和目標目的地。

請完成下列步驟:

  1. 登入您的IBM Cloud帳戶

  2. 點選選單圖示選單圖示>可觀察性

  3. 點選日誌記錄>路由

  4. 點選 “設定目標”

  5. 按一下 「Cloud Logs」 選項卡,然後從清單中選擇一個IBM Cloud Logs實例。 這是您希望接收由IBM Cloud Logs Routing所路由的日誌的實例。

    您可以從清單中選擇 IBM Cloud Logs 範例。

    IBM Cloud Logs 範例必須位於您要設定的同一帳戶中。

  6. 按一下儲存

驗證日誌是否傳送到目的地target

驗證叢集的日誌是否已路由到您的IBM Cloud Logs實例。

所有平台日誌均以 JSON 格式產生。 您可以透過選擇 ibm-platform-logs 的值作為 applicationName 來過濾實例中的平台日誌。

請完成下列步驟:

  1. 啟動配置為收集區域中平台日誌的目標的 {{site.data.keyword.logs_full_notm} {{site.data.keyword.logs_full_notm}} IBM Cloud Logs Web UI。 這是您在設定目標的步驟中所選擇的實例。
  2. 透過自訂檢視檢視記錄。 如需相關資訊,請參閱檢視日誌