本文档介绍了如何使用 Google Cloud 控制台、Google Cloud CLI、Cloud Monitoring API 和客户端库来管理拨测。
列出所有拨测
控制台
-
在 Google Cloud 控制台中,前往 拨测页面:
如果您使用搜索栏查找此页面,请选择子标题为监控的结果。
以下示例展示了拨测示例页面:
(可选)要限制列出的拨测,请添加过滤条件。
每个过滤条件都由名称和值组成。 您可以将该值设置为与正常运行时间检查名称完全匹配或部分匹配。匹配不区分大小写。例如,如需列出名称包含
default
的所有正常运行时间检查,请执行以下操作:- 点击过滤表格,然后选择显示名称。
- 输入
default
,然后按回车键。
如果您有多个过滤条件,则除非您插入
OR
过滤条件,否则这些过滤条件会由逻辑AND
自动联接。前一示例使用OR
过滤条件,以便在拨测名称与default
或Testing check
匹配时列出拨测。
gcloud
如需列出您的拨测和合成监控工具,请运行 gcloud monitoring uptime list-configs
命令:
gcloud monitoring uptime list-configs
返回的数据包括以下内容:
- 名称和显示名称。
- 检查标识符。
- 受监控的资源。
- 两次检查之间的间隔。
您可以配置 Google Cloud CLI 命令以过滤和排序结果。
API
如需列出您的拨测和合成监控工具,请调用 projects.uptimeCheckConfigs.list
方法。指定以下参数:
parent:您想要列出其正常运行时间检查的项目。格式为:
projects/PROJECT_ID
要获取特定的正常运行时间检查,请调用 projects.uptimeCheckConfigs.get
方法。指定以下参数:
name:正常运行时间检查配置的完整名称。
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
如需详细了解拨测标识符,请参阅查找拨测的唯一标识符。
C#
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
PHP
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
查看拨测的详细信息
控制台
-
在 Google Cloud 控制台中,前往 拨测页面:
如果您使用搜索栏查找此页面,请选择子标题为监控的结果。
找到要查看的拨测,然后点击其名称。
以下屏幕截图显示了名称为“我的拨测”(My Uptime Check) 的拨测的正常运行时间详细信息:
正常运行时间详情页面包含以下信息:
- 选定的时间间隔。默认情况下,时间间隔为 1 小时。
- 正常运行时间检查的名称。在示例中,名称为我的正常运行时间检查 (My Uptime Check)。
- 您添加到正常运行时间检查的标签。
正常运行时间百分比和平均延迟时间。 正常运行时间百分比值是按照
(S/T)*100
计算出的百分比,其中S
表示检查响应的成功次数,T
是所有位置的检查响应总数。对于群组检查,S
和T
的值分别是所有当前组成员中相应值的总和。例如,在 25 分钟时段内,从所有区域运行一分钟时长的正常运行时间检查会从 6 个位置收到请求,每个位置 25 个,共计 150 个请求。如果信息中心报告的正常运行时间百分比为 83.3%,则表示 150 个请求中有 125 个成功。
已通过检查 (Passed checks) 和正常运行时间检查延迟时间 (Uptime check latency) 窗格会以图形方式显示已通过检查的数量和每项检查的延迟时间随时间变化的情况。
当前状态窗格会显示最近检查的状态。 区域旁边内含对勾的绿色圆圈表示该区域中最近一次检查成功运行;内含 x 的红色圆圈则表示失败。
配置窗格显示正常运行时间检查的配置。 此数据是在创建正常运行时间检查时分配的。 检查 Id 值对应于 API 调用中的
CHECK_ID
值。提醒政策窗格列出了关联的提醒政策的相关信息。在示例信息中心中,已配置一个提醒政策。
gcloud
如需列出正常运行时间检查或合成监视器的详细信息,请运行 gcloud monitoring uptime describe
命令:
gcloud monitoring uptime describe CHECK_ID
在运行上一个命令之前,请将 CHECK_ID 替换为正常运行时间检查或合成监控器的标识符。您可以通过运行 gcloud monitoring uptime list-configs
命令并检查 name 字段来查找标识符。如需了解详情,请参阅查找拨测的唯一标识符。
为正常运行时间检查返回的数据包括以下内容:
- 名称和显示名称。
- 检查标识符。
- 受监控的资源。
- 两次检查之间的间隔。
API
如需列出正常运行时间检查或综合监控器的详细信息,请调用 projects.uptimeCheckConfigs.get
方法。指定以下参数:
name:正常运行时间检查配置的完整名称。
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
如需详细了解拨测标识符,请参阅查找拨测的唯一标识符。
C#
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
PHP
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
修改拨测
您可以修改拨测的某些字段。例如,您可能希望检查更频繁地进行,或者您可能希望增加与响应验证关联的超时。但是,如果您的拨测未配置正确的协议、资源类型或资源,请删除当前拨测并创建新的拨测。
如需了解如何修改用于监控正常运行时间检查的提醒政策,请参阅以下文档:
如需修改公开拨测,您可以在以下任何标签页上使用相应进程。如需修改非公开拨测,请使用控制台或 API 标签页:
控制台
gcloud
如需修改正常运行时间检查或合成监控器,请运行 gcloud monitoring uptime update
命令:
gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS
在运行上一个命令之前,请执行以下操作:
将 CHECK_ID 替换为正常运行时间检查或合成监视器的标识符。您可以通过运行
gcloud monitoring uptime list-configs
命令并检查 name 字段来找到标识符。如需了解详情,请参阅查找拨测的唯一标识符。指定要修改的字段。
例如,如需将正常运行时间检查的周期设置为 10 分钟,请运行以下命令:
gcloud monitoring uptime update CHECK_ID --period=10
API
调用 projects.uptimeCheckConfigs.patch
方法。为该方法设置参数,如下所示:
uptimeCheckConfig.name:必需。这是 REST 网址的一部分,是待修改正常运行时间检查的资源名称:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
如需详细了解拨测标识符,请参阅查找拨测的唯一标识符。
updateMask:可选。这是一个查询参数:
?updateMask=[FIELD_LIST]
。[FIELD_LIST]
是UptimeCheckConfig
对象中应更改的字段的英文逗号分隔列表。例如:"resource.type,httpCheck.path"
请求正文必须包含带有新字段值的
UptimeCheckConfig
。
如果设置了 updateMask
,则只有 updateMask
中列出的字段会替换现有配置中的相应字段。如果一个字段具有子字段,并且该字段已在字段掩码中列出但其子字段均未列出,则该字段的所有子字段都将替换相应的字段。
如果未设置 updateMask
,则请求正文中的配置将替换整个现有配置。
patch
方法会返回已更改配置的 UptimeCheckConfig
对象。
C#
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
PHP
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
新的正常运行时间检查结果最长可能会延迟 5 分钟显示。在此期间,之前的拨测的结果会显示在信息中心内并应用于提醒政策中。
删除正常运行时间检查
我们建议您在关闭拨测所监控的服务或资源时删除拨测。注意:在删除正常运行时间检查之前,请确保没有监控正常运行时间检查的提醒政策。当提醒政策监控拨测时,Google Cloud 控制台会阻止删除该拨测。但是,Cloud Monitoring API 不会生成错误或阻止删除。不会针对缺失检查创建任何突发事件。
要删除正常运行时间检查,请执行以下操作:
控制台
-
在 Google Cloud 控制台中,前往 拨测页面:
如果您使用搜索栏查找此页面,请选择子标题为监控的结果。
找到要修改的拨测,然后执行以下任一操作:
- 点击更多 more_vert 并选择删除。
- 查看正常运行时间检查详情,然后点击删除
gcloud
如需删除正常运行时间检查或合成监控器,请运行 gcloud monitoring uptime delete
命令:
gcloud monitoring uptime delete CHECK_ID
在运行上一个命令之前,请将 CHECK_ID 替换为正常运行时间检查或合成监控器的标识符。您可以通过运行 gcloud monitoring uptime list-configs
命令并检查 name 字段来找到标识符。如需了解详情,请参阅查找拨测的唯一标识符。
API
如需删除正常运行时间检查或合成监控,请调用 projects.uptimeCheckConfigs.delete
方法。填写参数,如下所示:
name:必需。这是待删除正常运行时间检查配置的资源名称:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
如需详细了解拨测标识符,请参阅查找拨测的唯一标识符。
C#
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
PHP
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需向 Monitoring 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
监控拨测
我们建议您创建提醒政策,以便在拨测失败时收到通知。如需了解详情,请参阅为拨测创建提醒政策。
查找拨测的唯一标识符
创建拨测后,Monitoring 会为其分配一个称为“拨测 ID”的标识符。此标识符可嵌入新拨测的资源名称中:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
拨测 ID 包含在能够创建或列出拨测的 Cloud Monitoring API 方法的响应中。您也可以在 Google Cloud 控制台的正常运行时间详情页面的配置窗格中找到正常运行时间检查 ID。如需了解如何查看正常运行时间详情页面,请参阅本文档的查看拨测详情 (View details of an uptime check) 部分。