向信息中心添加文本和分组

本文档介绍了如何向信息中心添加实用信息，以及如何对信息中心上的微件进行分组。例如，您可能需要添加有关信息中心的信息、相关资源的链接，或者在不同情况下需要执行的操作。如果信息中心包含许多微件，您可以对这些微件进行分组，以提高信息中心的可用性。

如需了解 Cloud Monitoring API，请参阅使用 API 创建和管理信息中心。

只有 Google Cloud 项目支持此功能。对于 App Hub 配置，请选择 App Hub 主机项目或启用应用的文件夹的管理项目。

准备工作

在您要创建和修改自定义信息中心的 Google Cloud 项目中，完成以下操作：

将文本添加到信息中心

以下屏幕截图展示了文本微件：

包含文本微件的信息中心示例。

本部分中的信息适用于 Google Cloud 控制台。如需了解如何使用 Cloud Monitoring API，请参阅包含 Text 微件的信息中心。

如需向信息中心添加文本微件，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 信息中心页面：

    前往信息中心

    如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 主机项目或启用应用的文件夹的管理项目。
  3. 选择一个信息中心或点击创建信息中心。
  4. 在工具栏中，点击  Add widget（添加 widget）。
  5. 在添加 widget 对话框中，前往布局部分，然后选择文本。
  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} 格式。

    文本 widget 仅渲染变量的值。例如，如果您有一个基于标签的变量，其中键为 zone 且值为 us-west1，则文本 widget 会显示 us-west1。

    当变量的值为通配符 (*) 时，文本 widget 会显示 all。

    系统会按原样显示无法识别的变量，而不会进行呈现。

整理信息中心微件

借助自定义信息中心，您可以指定图表、提醒政策和其他微件的显示位置。不过，您可以通过在信息中心内创建部分或对微件进行分组，来提高包含许多微件的界面易用性：

  • 如需在信息中心内创建编入索引的部分，请使用“section-header”微件。将此微件添加到信息中心后，系统会创建目录并向信息中心添加水平分隔线。借助目录，您可以前往信息中心的特定部分。每个版块 widget 都包含一个锚点。在排查问题时，您可能需要与同事分享版块网址。如需复制部分网址，请右键点击 Link to heading（链接到标题），然后选择 Copy link address（复制链接地址）。

  • 如需缩短信息中心的加载时间，请使用分组 widget。分组 widget 有三种类型：可收起、下拉菜单和标签页。组微件包含一组微件，它们会使用优先级较低的数据来检索未显示的集合成员，从而提升性能。展开可收起的群组 widget 后，系统会显示该合集的每个成员，否则所有成员都会隐藏。相比之下，下拉菜单组和标签页组 widget 仅显示集合的一位成员。这两个微件的区别在于，您是使用菜单还是标签页来选择要显示的成员。

如需使用本部分介绍的微件，您的自定义信息中心必须使用拼接模式（即默认布局）。如果您将布局更改为网格布局，则这些微件将不可用。

对于大多数微件，您可以配置其可见性。不过，组织 widget 始终可见。

本部分的其余内容介绍了如何添加和配置可用于整理信息中心的微件。如需了解如何修改这些微件，请参阅修改微件的配置。

添加 section-header 微件

如需了解如何使用 Cloud Monitoring API 创建分区标题微件，请参阅包含 SectionHeader 微件的信息中心。

如需使用 Google Cloud 控制台添加 section-header 微件，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 信息中心页面：

    前往信息中心

    如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 主机项目或启用应用的文件夹的管理项目。
  3. 在添加 widget 对话框中，前往布局部分，然后选择版块标题 widget。

  4. 在 widget 上，点击 Edit section（修改版块），然后完成对话框：

    • Section name 字段的值会显示在目录中。
    • 信息中心会显示副标题字段的值。
    • 如果您选择 *在目录中添加分隔线，系统会在目录条目后面添加一条横线。

添加了可收起的组微件

如需了解如何使用 Cloud Monitoring API 创建可收起的组微件，请参阅包含 CollapsibleGroup 微件的信息中心。

如需使用 Google Cloud 控制台添加可收起的组 widget，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 信息中心页面：

    前往信息中心

    如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 主机项目或启用应用的文件夹的管理项目。
  3. 在添加微件对话框中，前往布局部分，然后选择可收起的组。

  4. 如需向群组添加微件，请将微件拖动到群组中。

    将 widget 添加到组后，您可以使用指针调整这些 widget 的大小和位置。

  5. 如需为组添加描述性标题，请将指针放在微件上以激活工具栏，然后点击 Edit group（修改组）。

  6. 可选：如需确保组默认处于收起状态，请将指针放在微件上以激活工具栏，然后点击 Collapse group（收起组）。

    当可收起的群组微件处于收起状态时，监控功能会以低于其他微件的优先级检索群组中微件的数据。这样，信息中心的加载速度就会更快。

添加下拉菜单组或标签页组微件

下拉菜单组和标签页组 widget 包含一组其他 widget，但它们只会显示该组中的一项 widget。这两个 widget 之间的区别在于您选择显示哪个合集成员的方式。下拉菜单组提供菜单，而标签页组则在工具栏上提供标签页。

如需了解如何使用 Cloud Monitoring API 创建这些微件，请参阅包含 SingleViewGroup 微件的信息中心。

如需将这些微件添加到信息中心，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 信息中心页面：

    前往信息中心

    如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 主机项目或启用应用的文件夹的管理项目。
  3. 如有必要，请创建要添加到组 widget 的 widget。

  4. 在添加微件对话框中，前往布局部分，然后选择下拉菜单组或标签页组。

    系统会在信息中心中添加所选类型的微件。

  5. 如需向组微件添加折线图等微件，请将它们拖动到组微件中，或修改组微件并执行添加操作。

    例如，如需通过修改标签页分组微件向其添加微件，请执行以下操作：

    1. 在微件的工具栏中，依次选择 修改标签页分组和 修改分组。
    2. 可选：为组输入标题。

    3. 点击添加微件，然后从添加微件菜单中进行选择。

      添加微件菜单列出了可添加到组中的微件。

    4. 对要添加到标签页分组微件的每个微件重复执行上述步骤。

    5. 使用 Lower 和 Higher 按钮对分组微件中的微件进行排序。

    6. 点击应用。

    信息中心会刷新，并且系统只会显示添加到组微件中的微件之一。借助显示的微件的工具栏，您可以修改显示的微件或执行其他操作。

  6. 如需保存修改后的信息中心，请点击工具栏中的保存。

后续步骤

您还可以将以下 widget 添加到自定义信息中心：

如需了解如何探索已绘制成图表的数据和过滤信息中心，请参阅以下文档：