在資訊主頁中新增文字和群組

本文說明如何在資訊主頁中新增實用資訊，以及如何將資訊主頁上的小工具分組。舉例來說，您可能想新增有關資訊主頁的資訊、加入相關資源的連結，或說明在不同情況下該怎麼做。如果資訊主頁包含許多小工具，您可以將小工具分組，提升資訊主頁的實用性。

如要瞭解 Cloud Monitoring API，請參閱「使用 API 建立及管理資訊主頁」。

這項功能僅支援 Google Cloud 專案。 如要進行 App Hub 設定，請選取 App Hub 主專案或啟用應用程式的資料夾管理專案。

事前準備

在要建立及修改自訂資訊主頁的 Google Cloud 專案中，完成下列步驟：

• 如要取得必要權限，以便使用 Google Cloud 控制台建立及修改自訂資訊主頁，請要求管理員授予專案的「Monitoring 編輯者」 (roles/monitoring.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

  您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

  如要進一步瞭解角色，請參閱「使用身分與存取權管理功能控管存取權」一文。

• 每個資訊主頁最多可放置 100 個小工具。

在資訊主頁中新增文字

以下螢幕截圖說明文字小工具：

本節資訊適用於 Google Cloud 控制台。 如要瞭解如何使用 Cloud Monitoring API，請參閱「含有 Text 小工具的資訊主頁」。

如要在資訊主頁中新增文字小工具，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁)  頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如為「App Hub」設定，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
3. 選取資訊主頁或按一下「建立資訊主頁」。
4. 按一下工具列中的「新增小工具」圖示 add。
5. 在「新增小工具」對話方塊中，前往「版面配置」部分，然後選取「文字」。
6. 新增標題。

7. 在「內容」窗格中，輸入要顯示的文字。

   如需格式設定資訊，請參閱「支援的 Markdown 指令」。

8. 選項：使用「顯示」窗格中的欄位自訂內容。

   舉例來說，您可能想設定小工具的顯示設定。

9. 如要將變更套用至資訊主頁，請在工具列中按一下「套用」。如要捨棄變更，請按一下「取消」。

10. 如要儲存修改後的資訊主頁，請按一下工具列中的「儲存」。

支援的 Markdown 指令

本節說明文字小工具支援的 Markdown 指令：

• 標頭

  以井字號 # 開頭的行表示標題。你可以使用多個井號，代表不同層級的標題。 舉例來說，頂層標題使用單一井號 # Header。如要建立第二層標題，請使用兩個井號 ## Second-level header。

• 字型

  • 斜體：使用 *italic* 或 _italic_。
  • 粗體：使用 **bold** 或 __bold__。

• 連結：格式為 [link text](path)。

  您可以為 link text 使用任何值。path 的值必須參照資訊主頁中的 HTML 錨點，或是外部網頁的網址。

  • 如要連結至資訊主頁的其他部分，章節的錨點是章節標題，轉換為小寫後，字詞之間會以連字號分隔。舉例來說，如要連結至標題為「使用變數的圖表」的部分，請將 path 設為 #charts-using-variables。

  • 如要連結至外部資源，請將 path 設為網址。舉例來說，如要連結至 example.com，請將 path 設為 https://example.com/。

• 變數：格式為 ${VARIABLE_NAME}。

  文字小工具只會算繪變數的值。舉例來說，如果您有以標籤為準的變數，其中鍵為 zone，值為 us-west1，則文字小工具會顯示 us-west1。

  如果變數值是萬用字元 (*)，文字小工具會顯示 all。

  系統會照原樣顯示無法辨識的變數，不會進行轉譯。

整理資訊主頁小工具

自訂資訊主頁可讓您指定圖表、快訊政策和其他小工具的位置。不過，您可以建立資訊主頁的區隔或將小工具分組，藉此提升資訊主頁的實用性：

• 如要在資訊主頁中建立索引區塊，請使用 section-header 小工具。將這個小工具新增至資訊主頁時，系統會建立目錄，並在資訊主頁中新增水平分隔線。目錄可讓您前往資訊主頁的特定部分。每個區段小工具都包含錨點。進行疑難排解時，您可能需要與隊友分享該部分的網址。如要複製章節網址，請在「連結至標題」上按一下滑鼠右鍵，然後選取「複製連結網址」。link

• 如要縮短資訊主頁的載入時間，請使用群組小工具。群組小工具分為三種：可收合、下拉式和分頁。群組小工具包含一系列小工具，並使用較低優先順序的資料來擷取未顯示的集合成員，藉此提升效能。可收合的群組小工具展開時會顯示集合中的所有成員，否則會隱藏所有成員。相較之下，下拉式群組和分頁群組小工具只會顯示集合中的一個成員。這兩種小工具的差異在於您是使用選單還是分頁標籤選取要顯示的成員。

如要使用本節所述的小工具，自訂資訊主頁必須使用馬賽克模式，這是預設的版面配置。如果將版面配置變更為格線，就無法使用這些小工具。

大多數小工具都可以設定顯示狀態。不過，機構小工具一律會顯示在畫面上。

本節其餘內容說明如何新增及設定可用來整理資訊主頁的小工具。如要瞭解如何修改這些小工具，請參閱「修改小工具的設定」。

新增小節標題小工具

如要瞭解如何使用 Cloud Monitoring API 建立區段標題小工具，請參閱「含有 SectionHeader 小工具的資訊主頁」。

如要使用 Google Cloud 控制台新增區段標題小工具，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁)  頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如為「App Hub」設定，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
3. 在「新增小工具」對話方塊中，前往「版面配置」部分，然後選取「區段標題」小工具。

4. 在小工具上，按一下「編輯版面」圖示 edit，然後完成對話方塊：

   • 「章節名稱」欄位的值會顯示在目錄中。
   • 資訊主頁會顯示「副標題」欄位的值。
   • 如果選取「在目錄中加入分隔線」，系統會在目錄中的項目後方加入水平線。

新增可收合的群組小工具

如要瞭解如何使用 Cloud Monitoring API 建立可收合的群組小工具，請參閱含有 CollapsibleGroup 小工具的資訊主頁。

如要使用 Google Cloud 控制台新增可收合群組小工具，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁)  頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如為「App Hub」設定，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
3. 在「新增小工具」對話方塊中，前往「版面配置」部分，然後選取「可收合群組」。

4. 如要將小工具加入群組，請將小工具拖曳至群組。

   將小工具新增至群組後，即可使用指標調整大小和重新放置小工具。

5. 如要為群組新增描述性標題，請將指標放在小工具上，啟動工具列，然後按一下「編輯群組」edit。

6. 選用：如要確保群組預設為收合狀態，請將指標放在小工具上以啟用工具列，然後按一下「收合群組」expand_less。

   如果可收合的群組小工具已收合，Monitoring 會以低於其他小工具的優先順序，擷取群組中小工具的資料。因此，資訊主頁的載入速度會更快。

新增下拉式群組或分頁群組小工具

下拉式群組和分頁群組小工具包含其他小工具的集合，但只會顯示集合中的一個成員。這兩種小工具的差異在於選取要顯示的集合成員方式。下拉式群組會提供選單，分頁群組則會在工具列上提供分頁。

如要瞭解如何使用 Cloud Monitoring API 建立這些小工具，請參閱「含有 SingleViewGroup 小工具的資訊主頁」。

如要將這些小工具新增至資訊主頁，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁)  頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如為「App Hub」設定，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
3. 視需要建立要加入群組小工具的小工具。

4. 在「新增小工具」對話方塊中，前往「版面配置」部分，然後選取「下拉式群組」或「分頁群組」。

   所選類型的小工具會新增至資訊主頁。

5. 如要將折線圖等小工具新增至群組小工具，請將小工具拖曳至群組小工具，或編輯群組小工具並執行新增作業。

   舉例來說，如要透過編輯群組，將小工具新增至分頁群組小工具，請按照下列步驟操作：

   1. 在小工具的工具列中，依序選取 list「編輯分頁群組」和 edit「編輯群組」。
   2. 輸入群組標題 (選用)。

   3. 按一下「新增小工具」，然後從「新增小工具」選單中選取項目。

      「新增小工具」選單會列出可加入群組的小工具。

   4. 針對要新增至分頁群組小工具的每個小工具，重複上一個步驟。

   5. 使用「降低」expand_more和「提高」expand_less按鈕，即可在群組小工具中排序小工具。

   6. 按一下 [套用]。

   資訊主頁會重新整理，且只會顯示新增至群組小工具的小工具。顯示的小工具工具列可讓你編輯顯示的小工具或執行其他動作。

6. 如要儲存修改後的資訊主頁，請按一下工具列中的「儲存」。

後續步驟

您也可以在自訂資訊主頁中新增下列小工具：

• 圖表、表格和指標
• 記錄項目
• 快訊圖表和事件

如要瞭解如何探索圖表資料及篩選資訊主頁，請參閱下列文件：

• 探索圖表資料
• 在自訂資訊主頁中新增臨時篩選器
• 建立及管理變數和已釘選的篩選器