使用 MQL 设置基于查询的提醒

使用 MQL 设置基于查询的提醒

本文档介绍了如何使用 Monitoring Query Language (MQL) 在 Google Cloud 控制台中探索指标、创建图表和设置基于查询的提醒。如果您希望使用 Cloud Monitoring API，请参阅为提醒政策创建条件。

在本文档中，您将执行以下操作：

1. 创建 Compute Engine 实例。

2. 前往代码编辑器。

3. 执行查询并创建图表。

4. 设置基于查询的提醒。

准备工作

要使用 MQL，您需要创建 Google Cloud 项目并启用结算功能。

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

3. 确保您的 Google Cloud 项目已启用结算功能。

4. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

5. 确保您的 Google Cloud 项目已启用结算功能。

接下来，配置权限和通知渠道。

1. 如需获取创建基于 MQL 的条件的提醒政策所需的权限，请让管理员授予您项目的 Monitoring Editor (roles/monitoring.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理访问权限。

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

   如需详细了解 Cloud Monitoring 角色，请参阅使用 Identity and Access Management 控制访问权限。

2. 确保您熟悉提醒政策、MQL 和代码编辑器的一般概念。如需了解详情，请参阅以下主题：

   • 提醒概览
   • 使用 MQL 的提醒政策
   • 使用 MQL 的代码编辑器

创建 Compute Engine 实例

如需可以收集指标的 Google Cloud 资源，请通过完成以下步骤创建 Compute Engine 实例：

1. 从 Google Cloud 控制台菜单中选择 Compute Engine。

   

2. 选择创建实例，然后点击创建。

注意：如果您在创建实例时遇到问题，请参阅快速入门：使用 Linux 虚拟机。

转到代码编辑器

要开始使用 MQL，请执行以下操作：

1. 在 Google Cloud 控制台的导航面板中，选择 Monitoring，然后选择  Metrics Explorer：

   进入 Metrics Explorer

2. 在查询构建器窗格的工具栏中，选择名为  MQL 或  PromQL 的按钮。
3. 验证已在语言切换开关中选择 MQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

使用代码编辑器构建、测试和运行 MQL 查询。

执行查询并创建图表

创建一个查询来为实例的 CPU 利用率绘制图表：

1. 将以下查询粘贴到代码编辑器中：

   fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
   | {
       top 1, max(val())
     ;
       bottom 1, min(val())
     }
   | union
   

   此查询会选择 CPU 使用率最高和最低的时序来绘制图表。如需详细了解此查询，请参阅将所选内容与 union 结合。

2. 点击运行查询。该图表显示两条线，显示了实例的最高和最低 CPU 使用率：

   

3. 要保存图表，请点击保存图表。给图表命名，并将其添加到现有信息中心或新信息中心。然后点击保存。

您可以通过以下方式访问该图表：转到监控概览页面；或者如果您将其保存到信息中心，请转到该信息中心页面。

设置基于查询的提醒

您可以创建提醒政策，以便监控查询结果。要创建此类提醒政策，请完成以下步骤：

1. 在 Google Cloud 控制台的导航面板中，选择 Monitoring，然后选择  提醒：

   进入提醒

2. 在 提醒页面中，点击 修改通知渠道。在此步骤中，您将配置用于接收提醒通知的电子邮件地址。

   1. 在通知渠道页面上，前往电子邮件，然后点击新增。

   2. 在电子邮件地址字段中输入接收提醒通知的电子邮件地址。

   3. 在显示名字段中输入该渠道的简要说明，如“提醒随时待命”。

   4. 点击保存。

   5. 点击页面标题上的 返回以返回提醒页面。

3. 在 提醒页面中，点击 创建政策。

   本页面将引导您完成创建提醒政策的步骤：

   1. 描述您要收到提醒的内容。
   2. 提供有关如何解决此问题的信息。
   3. 为提醒指定通知渠道。

4. 点击新建条件，描述您要接收提醒的内容。此操作会打开基于表单的条件编辑器。

   1. 在政策配置模式下，选择代码编辑器（MQL 或 PromQL）。

   2. 验证已在语言切换开关中选择 MQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

   3. 在代码编辑器中输入用于选择要监控的数据的查询。当实例的 CPU 使用率持续高于 20 秒时，以下查询会触发提醒：

      fetch gce_instance::compute.googleapis.com/instance/cpu/usage_time
      | window 1m
      | condition val() > 20 's'
      

      condition 操作可确立您要发出提醒的性能阈值。如需详细了解 condition 和其他提醒操作，请参阅 MQL 参考文档中的提醒。

      如果启用了自动运行，则 MQL 图表会显示所选数据和阈值线：

      

   4. 如需配置提醒触发器，请点击下一步：

      1. 在提醒触发器菜单中，选择必须满足提醒操作条件的时序数量才能触发提醒政策。您可以从以下条件中进行选择：

         • 一个时序。
         • 特定的时序数量。
         • 时序的百分比。
         • 所有时序。

      2. 可选：展开高级选项菜单，然后在在此时长内满足条件时触发字段中，输入或选择值。

         此字段定义在触发提醒政策之前必须满足条件的时长。重新测试窗口与 MQL 查询中使用的校准窗口不同。如需详细了解这些值之间的关系，请参阅校准时间段和时长。

      3. 输入条件的名称，例如“基本 MQL 条件”。

5. 如需设置通知、文档和提醒政策名称，请点击下一步。

   1. 选择您之前创建的通知渠道。

   2. 选择严重级别。

   3. 在 文档字段中输入一些要与提醒通知一起发送的文本。此文本通常为响应者提供相关信息以帮助他们解决问题。对于本练习，请输入“您的 CPU 使用率已超过 20 秒”。

   4. 在提醒政策名称字段中输入提醒政策的名称。此值可让您区分来自不同提醒政策的通知。

6. 点击创建政策以保存政策。

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

1. 转到 Google Cloud 控制台中的“Identity and Access Management”页面：

   转到项目设置

2. 点击关停，然后按照说明操作。

后续步骤

• 详细了解如何使用代码编辑器。
• 浏览一组 MQL 样本。
• 详细了解基于 MQL 的提醒政策。
• 了解如何通过 Cloud Monitoring API 调用 MQL 查询。
• 在 MQL 参考文档中探索 MQL 的详细信息。
• 阅读我们关于 DevOps 的资源，并了解 DORA 的研究项目。