建立自訂儀表板以進行監控 Code Engine

使用 IBM Cloud Monitoring 來掌握 Code Engine 工作負載的運作狀態與效能。 您可以針對 Code Engine 工作負載自訂 Monitoring 儀表板，設定一套量身打造的指標，以協助您找出瓶頸或預測可能的生產環境問題。

建立自訂儀表板以進行監控 Code Engine

您可以針對 Code Engine 工作負載建立自訂的 Monitoring 儀表板，以顯示一套量身打造的指標。

在 Monitoring 中建立自訂儀表板之前，您必須先為 Code Engine 工作負載設定監控。 請設定您的 Monitoring 服務執行個體，並在您要監控的 Code Engine 專案所在的同一區域中啟用「Platform Metrics」。 若您的部署橫跨多個區域，則必須為每個區域配置「Monitoring」，並啟用平台指標。 如需進一步了解如何設定 IBM Cloud Monitoring 服務執行個體，以及如何存取 IBM Cloud Monitoring 指標儀表板以監控 Code Engine 工作負載，請參閱 《 Code Engine 監控指南》。

Code Engine 提供「IBM Code Engine Project Overview」儀表板，該儀表板由預先定義的面板組成，用於監控 Code Engine 工作負載的各個方面。 您可能希望針對 Code Engine 工作負載建立一個自訂的 Monitoring 儀表板，以顯示一套量身打造的指標。

  1. 設定 IBM Cloud Monitoring 服務實例。 若要檢查是否存在正在運行的 IBM Cloud Monitoring 執行個體，請參閱「可觀察性」儀表板。

  2. 請確保有監測資料可供使用。 由於在有數據可供監控的情況下，設計自訂儀表板會更加容易，因此擁有一個正在運行的 應用程式 或 工作 至關重要。 某些 Code Engine 指標僅在該環境中提供時才會存在。

  3. 檢視 Code Engine 提供的各項 指標。

  4. 檢視您的 IBM Cloud Monitoring 指標。

    1. 從「IBM Cloud」的導覽選單中，選取 「可觀察性」。
    2. 選取監視。
    3. 請在監控實例的「檢視」欄位中點選「儀表板」，以開啟該監控實例的儀表板。
    4. 從導覽選單中，依序選取 「儀表板」→「IBM」→「IBM」→「Code Engine」→「專案概覽」。 若您在選單中未看到「Code Engine」儀表板，可透過您的 Code Engine 應用程式或工作，選取「新增監控」來開始進行監控。

  5. 點擊「複製到我的儀表板」，即可建立「IBM Code Engine Project Overview」儀表板的副本。 為您的自訂儀表板輸入名稱，然後點擊「建立並開啟」。 例如，將您的儀表板命名為「My custom IBM Code Engine Project Overview」。

  6. 您可以透過新增或移除儀表板區塊，來自訂您的儀表板。 若要了解如何自訂儀表板以監控 Code Engine 應用程式及工作執行工作負載，請參閱 「情境 1」 和「情境 2」。 如需有關使用 IBM Cloud Monitoring 儀表板的更多資訊，請參閱 《使用儀表板》。

    每當您變更儀表板的佈局時，請務必點擊「儲存佈局」以儲存您的變更。 在繼續自訂儀表板之前，您必須先儲存佈局變更或取消操作。

  7. 儲存自訂儀表板。 自訂儀表板可透過儀表板導覽選單中的「儀表板→我的儀表板」存取。

情境 1：聚焦於 Code Engine 的應用程式執行個體與工作執行

假設您希望縮小 Code Engine 工作負載的監控範圍，以專注於正在執行的應用程式實例及工作執行。 監控這項資訊可能很有幫助，因為如果您的應用程式擴展至零，或者您的工作或建置並未執行，那麼您就不會消耗資源。 此情境以您先前根據現有的「IBM Code Engine Project Overview」儀表板所建立的「My custom IBM Code Engine Project Overview」儀表板為基礎，透過修改和移除面板來簡化此自訂儀表板。 在此情境下，必須在您的專案中定義一個工作與一個應用程式。

  1. 開啟您的自訂儀表板。 此情境假設您是從「IBM Code Engine Project Overview」儀表板的副本開始操作。 自訂儀表板可透過儀表板導覽選單中的「儀表板→我的儀表板」存取。

  2. 修改「Total number of Applications」數值面板，並透過使用 ibm_codeengine_application_actual_instances 指標來顯示實際的執行個體數量。

    1. 點擊鉛筆圖示以編輯該面板。
    2. 在「查詢」索引標籤中，按一下「ibm_codeengine_application_service_count」指標以修改該指標。 輸入 ibm_codeengine_ ，即可查看適用於您專案的 Code Engine 指標清單。 在此範例中，請選取「ibm_codeengine_application_actual_instances」指標，並指定「Maximum」的時間彙總方式，以及「Maximum」的群組彙總方式。
    3. 在「面板」索引標籤中，將此面板重新命名為「Total number of Application Instances」。
    4. 按一下「儲存」以儲存此面板的變更。

  3. 修改「Total number of Application revisions」數字面板，並將查詢修改為使用 ibm_codeengine_jobruns 指標來顯示工作執行次數。

    1. 點擊鉛筆圖示以編輯該面板。
    2. 在「查詢」索引標籤中，按一下「ibm_codeengine_application_revision_count」指標以修改該指標。 輸入 ibm_codeengine_ ，即可查看適用於您專案的 Code Engine 指標清單。 在此範例中，請選取「ibm_codeengine_jobruns」指標，並指定「Maximum」的時間彙總方式，以及「Maximum」的群組彙總方式。
    3. 在「面板」索引標籤中，將此面板重新命名為「Total number of Job Runs」。
    4. 按一下「儲存」以儲存此面板的變更。

  4. 請使用動作選單刪除「Total number of Application routes」的數字面板。

  5. 修改「Applications overview」時間圖表面板，並透過以下方式變更查詢，以顯示有關您的應用程式及工作執行實例的監控資訊：ibm_codeengine_application_actual_instances 以及 ibm_codeengine_jobruns 指標來顯示應用程式及工作執行個體的監控資訊。

    1. 點擊鉛筆圖示以編輯該面板。
    2. 在「查詢」索引標籤中，保留「ibm_codeengine_application_actual_instances」指標，並透過這些指標的動作選單移除其餘的指標列。
    3. 在「查詢」索引標籤中，找到「ibm_codeengine_application_actual_instances」指標，並修改區隔設定，以納入應用程式修訂版本資訊。 請點擊 ibm_codeengine_application_name，並將 ibm_codeengine_revision_name 加入清單中。 請務必取消勾選「Apply to All Queries」的選項。
    4. 在「查詢」索引標籤中，按一下「新增查詢」以新增用於工作執行之的查詢。 在「指標」欄位中，輸入「ibm_codeengine_」，即可查看適用於您專案的「Code Engine」指標清單。 選取「ibm_codeengine_jobruns」指標，並指定「Maximum」時間彙總方式及「Maximum」群組彙總方式。 請為此指標指定「ibm_codeengine_jobrun_condition」分段。
    5. 請確認您僅為此面板設定了「ibm_codeengine_application_actual_instances」和「ibm_codeengine_jobruns」這兩項指標。
    6. 在「面板」索引標籤中，將此面板的名稱變更為「Application and Job Run Instances」。
    7. 按一下「儲存」以儲存此面板的變更

  6. 請保留在此情境中於前幾個步驟已更新的面板，但請使用「動作」選單刪除其餘的面板。 移除不需要的面板後，您可以根據需求調整各面板的大小與佈局。

    每當您變更儀表板的佈局時，請務必點擊「儲存佈局」以儲存您的變更。 在繼續對儀表板進行變更之前，您必須先儲存佈局變更或取消操作。

完成情境 1 後，您的自訂儀表板將包含三個面板：Total number of Application Instances、Total number of Job Runs 以及 Application and Job Run Instances。

情境 2：在 Code Engine 工作負載中使用 PromQL 查詢

假設您想利用在「情境 1」中建立的自訂儀表板，透過 IBM Cloud Monitoring 的「Prometheus」查詢語言（ PromQL ）查詢功能，將「應用程式」與「工作執行」指標的數量彙總至單一面板中。 在此情境中，讓我們使用「PromQL」將應用程式執行個體的數量與工作執行次數匯總至單一數字面板中。

  1. 開啟您使用「情境 1」所自訂的儀表板。 自訂儀表板可透過儀表板導覽選單中的「儀表板→我的儀表板」存取。

  2. 修改「Total number of Applications」數值面板，並將查詢內容調整為將應用程式執行個體數與工作執行次數相加。

    1. 點擊鉛筆圖示以編輯該面板。
    2. 在「查詢」索引標籤中，按一下「PromQL」，即可使用 PromQL 上的查詢。
    3. 在「查詢」索引標籤中，將查詢內容替換為 sum(max(ibm_codeengine_application_actual_instances) + max(ibm_codeengine_jobruns))。 更新選項，將單位設定為 number。 按一下執行查詢。
    4. 在「面板」索引標籤中，將此面板重新命名為「Total number of Application instances and Job Runs」。
    5. 按一下「儲存」以儲存此面板的變更。

  3. 請使用「動作」選單刪除「Total number of Job Runs」數值面板，因為我們已在前一步驟將「應用程式總數」與「工作執行次數」合併為單一數值面板。

  4. 您可以根據需求調整各個面板的大小與佈局。

    每當您變更儀表板的佈局時，請務必點擊「儲存佈局」以儲存您的變更。 在繼續自訂您的儀表板之前，您必須先儲存佈局變更或取消操作。

完成情境 2 後，您的自訂儀表板將包含兩個面板：Total number of Application instances and Job Runs 以及 Application and Job Run Instances。