管理合成监控工具

本文档介绍了如何管理合成监控工具。您可以查看合成监控工具列表，并且对于每个合成监控工具，您可以查看和修改配置、查看执行历史记录，以及查看每次执行的相关详细信息。您可以使用 Google Cloud 控制台或 Cloud Monitoring API 管理合成监控工具。

如需了解如何探索合成监控工具的执行结果以及指标和日志，请参阅探索合成监控工具结果。

此功能仅适用于 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

准备工作

在存储合成监控工具的 Google Cloud 项目中完成以下操作：

  • 如需获得使用 Google Cloud 控制台查看和修改合成监控工具所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

    如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

    您也可以通过自定义角色或其他预定义角色来获取所需的权限。

  • 本页面上的 API 说明适用于 APIs Explorer。不过，您也可以发出 curl 命令。APIs Explorer 提供了 curl 语法。

  • Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

      In the Google Cloud console, activate Cloud Shell.

      Activate Cloud Shell

      At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

      REST

      如需在本地开发环境中使用本页面上的 REST API 示例，请使用您提供给 gcloud CLI 的凭证。

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

列出合成监控工具

控制台

如需列出您的 Google Cloud 项目中的合成监控工具，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 合成监控页面：

    前往合成监控

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

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

  3. 可选：如需限制列出哪些合成监控工具，请添加过滤条件。

    每个过滤条件都由名称和值组成。 您可以将该值设置为与合成监控工具名称完全匹配或部分匹配。匹配不区分大小写。例如，如需列出名称包含 default 的所有合成监控工具，请执行以下操作：

    • 点击过滤表格，然后选择显示名称。
    • 输入 default，然后按回车键。

    如果您有多个过滤条件，则除非您插入 OR 过滤条件，否则这些过滤条件会由逻辑 AND 自动联接。前一示例使用 OR 过滤条件，以便在拨测名称与 default 或 Testing check 匹配时列出拨测。

合成监控工具页面会针对每个合成监控工具显示以下内容：

  • 最近一次执行的状态。
  • 指向该合成监控工具的详细信息的链接。
  • 成功率和平均执行时间。
  • 提醒政策的数量。
  • 如需修改、复制或删除合成监控工具，以及创建提醒政策，请使用 更多选项菜单。

gcloud

如需列出拨测和合成监控工具，请运行 gcloud monitoring uptime list-configs 命令：

gcloud monitoring uptime list-configs --project=PROJECT_ID

在运行上述命令之前，请替换以下内容：

  • PROJECT_ID：项目的标识符。 对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

返回的数据包括以下内容：

  • 名称和显示名称。
  • 拨测标识符。
  • 受监控的资源。
  • 拨测之间的间隔时长。

您可以配置 Google Cloud CLI 命令来对结果进行过滤和排序。

REST

如需列出 Google Cloud 项目中的合成监控工具（包括拨测），请调用 projects.uptimeCheckConfigs.list 方法：

  1. 点击 projects.uptimeCheckConfigs.list。

  2. 使用 APIs Explorer。

    将方法的父级设置为项目名称，并确保使用以下格式：

    projects/PROJECT_ID

    在上面的表达式中，PROJECT_ID 是您的 Google Cloud 项目 ID。 对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

对于合成监控工具，结果包含一个标记为 syntheticMonitor 的字段。

查看合成监控工具的详细信息

控制台

如需查看 Google Cloud 项目中合成监控工具的详细信息，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 合成监控页面：

    前往合成监控

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

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

  3. 如需打开合成监控工具详细信息页面，请找到要查看的合成监控工具，然后点击其名称。

    如果您想通过 Cloud Run functions 提供的函数详细信息页面查看 Cloud Run 函数，请选择代码标签页，然后点击函数的名称。函数详细信息页面将在新窗口中打开。借助本页面上的标签页，您可以查看指标和日志及配置信息。

gcloud

如需列出拨测或合成监控工具的详细信息，请运行 gcloud monitoring uptime describe 命令：

gcloud monitoring uptime describe CHECK_ID --project=PROJECT_ID

在运行上述命令之前，请替换以下内容：

  • PROJECT_ID：项目的标识符。 对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。
  • CHECK_ID：拨测或合成监控工具的标识符。您可以通过运行 gcloud monitoring uptime list-configs 命令并检查 name 字段来查找该标识符。如需了解详情，请参阅查找合成监控工具的唯一标识符。

针对拨测返回的数据包括以下内容：

  • 名称和显示名称。
  • 拨测标识符。
  • 受监控的资源。
  • 拨测之间的间隔时长。

REST

如需列出 Google Cloud 项目中特定合成监控工具的详细信息，请调用 projects.uptimeCheckConfigs.get 方法：

  1. 点击 projects.uptimeCheckConfigs.get。

  2. 使用 APIs Explorer。

    将方法的父级设置为合成监控工具的名称，并确保使用以下格式：

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    在上述表达式中：

    • PROJECT_ID 是您的 Google Cloud 项目 ID。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。
    • CHECK_ID 是合成监控工具的 ID。

    例如，父级字段的值可能为：

    projects/my-project/uptimeCheckConfigs/10863117100295372627

    如需查找 CHECK_ID 的值，您可以发出 projects.uptimeCheckConfigs.list 方法。 如需减少返回的结果数量，请添加过滤条件。 例如，添加过滤条件 displayName="MySyntheticMonitor"。

修改合成监控工具或 Cloud Run 函数

控制台

如需使用合成监控工具详细信息页面修改合成监控工具或其 Cloud Run 函数，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 合成监控页面：

    前往合成监控

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

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。
  3. 找到要修改的合成监控工具，点击 更多选项，然后选择修改。

  4. 可选：如需修改 Cloud Run 函数，请点击修改函数，进行更改，然后点击应用函数。

    对于损坏的链接检查工具，如需修改源 URI 或用于定义测试哪些链接的选项，请修改 Cloud Run 函数，然后更新 index.js 文件中的 options 对象。如需了解此对象的字段和语法，请参阅 broken-links-ok/index.js。

  5. 如需保留修改，请点击保存。否则，请点击取消。

gcloud

如需修改拨测或合成监控工具，请运行 gcloud monitoring uptime update 命令：

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS --project=PROJECT_ID

在运行上述命令之前，请替换以下内容：

  • PROJECT_ID：项目的标识符。 对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

  • CHECK_ID：拨测或合成监控工具的标识符。您可以通过运行 gcloud monitoring uptime list-configs 命令并检查名称字段来查找该标识符。如需了解详情，请参阅查找拨测的唯一标识符。

  • 定义要修改的字段。对于合成监控工具，您只能更新以下字段：

    • 时段
    • 显示名称
    • 超时
    • 用户标签

例如，如需将合成监控工具的时段设置为 10 分钟，请运行以下命令：

gcloud monitoring uptime update CHECK_ID --period=10 --project=PROJECT_ID

REST

合成监控工具不包含提醒政策和函数，因此无法通过本部分所述的过程对其进行修改：

如需修改合成监控工具，请调用 projects.uptimeCheckConfigs.patch 方法：

  1. 点击 projects.uptimeCheckConfigs.patch。

  2. 使用 APIs Explorer。

    1. 将方法的父级设置为合成监控工具的标识符。标识符采用以下格式：

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

      在上述表达式中：

      • PROJECT_ID 是项目 ID。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。
      • CHECK_ID 是合成监控工具的 ID。

      如需查找 CHECK_ID 的值，您可以发出 projects.uptimeCheckConfigs.list 方法。 如需减少返回的结果数量，请添加过滤条件。 例如，添加过滤条件 displayName="MySyntheticMonitor"。

    2. 设置方法的查询参数 updateMask，以标识对象中要修改的字段。例如，如需更新 displayName 的值，则查询参数如下所示：

      updateMask=displayName

复制合成监控工具

控制台

如需在 Google Cloud 项目中复制合成监控工具，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 合成监控页面：

    前往合成监控

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

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

  3. 找到要修改的合成监控工具，点击 更多选项，然后选择复制。

    系统会打开复制合成检查对话框，其中预先填充了字段，包括 Cloud Run 函数的副本。

  4. 点击创建函数，根据需要更新函数，然后点击应用函数。

  5. 如需保留修改，请点击创建。否则，请点击取消。

    点击创建后，系统会创建并部署 Cloud Run 函数，然后创建合成监控工具。

gcloud

没有可让您复制合成监控工具的 Google Cloud CLI 方法。

REST

没有可让您复制合成监控工具的 API 方法。不过，您可以按照以下步骤创建副本：

  1. 调用 projects.uptimeCheckConfigs.get 方法并保存回答。如需了解详情，请参阅查看合成监控工具的详细信息。
  2. 修改回答。
  3. 调用 projects.uptimeCheckConfigs.create 方法，并将修改的回答传递给该方法。

删除合成监控工具

控制台

如需删除合成监控工具和任何关联的提醒政策，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 合成监控页面：

    前往合成监控

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

  2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。

  3. 找到要删除的合成监控工具，然后点击其名称。

  4. 可选：如果您要删除 Cloud Run 函数，请选择代码标签页，然后点击函数的名称。函数详细信息页面将在新窗口中打开。

  5. 在合成监控工具详细信息页面中，点击 删除，然后完成对话框。

    您现在已删除合成监控工具。

  6. 如需删除 Cloud Run 函数，请前往函数详细信息页面，点击 删除，然后完成对话框。

gcloud

如需删除拨测或合成监控工具，请运行 gcloud monitoring uptime delete 命令：

gcloud monitoring uptime delete CHECK_ID  --project=PROJECT_ID

在运行上述命令之前，请替换以下内容：

  • PROJECT_ID：项目的标识符。 对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。
  • CHECK_ID：拨测或合成监控工具的标识符。您可以通过运行 gcloud monitoring uptime list-configs 命令并检查 name 字段来查找该标识符。如需了解详情，请参阅查找合成监控工具的唯一标识符。

REST

如需删除合成监控工具和关联的提醒政策，请调用 projects.uptimeCheckConfigs.delete 方法：

  1. 点击 projects.uptimeCheckConfigs.delete。

  2. 使用 APIs Explorer。

    将方法的父级设置为合成监控工具的名称，并确保使用以下格式：

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    在上述表达式中：

    • PROJECT_ID 是项目 ID。对于 App Hub 配置，请选择 App Hub 宿主项目或已启用应用的文件夹的管理项目。
    • CHECK_ID 是合成监控工具的 ID。

    如需查找 CHECK_ID 的值，您可以发出 projects.uptimeCheckConfigs.list 方法。 如需减少返回的结果数量，请添加过滤条件。 例如，添加过滤条件 displayName="MySyntheticMonitor"。

查找合成监控工具的唯一标识符

创建合成监控工具后，Monitoring 会为其分配一个标识符。此标识符可嵌入合成监控工具的资源名称中，格式如下：

projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

CHECK_ID 包含在创建或列出合成监控工具的 Google Cloud CLI 和 Cloud Monitoring API 方法的回答中。

后续步骤