我該如何開始使用 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. 選擇雲端日誌作為目標服務。 接著,將存取範圍設定為 所有資源,此設定可授予對所有 IBM Cloud Logs 實例的存取權限;或者,透過設定 根據選定屬性篩選的資源 來指定單一實例 > 服務實例。

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

  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. 透過自訂檢視瀏覽日誌。 如需相關資訊,請參閱檢視日誌。