使用 PromQL 的代码编辑器

本页介绍了如何使用 PromQL 的代码编辑器。此编辑器可在 Google Cloud 控制台中使用,并提供建议和其他工具,以创建有效的 PromQL 查询。

本页未介绍 PromQL 语言;了解 PromQL,我们建议您参阅开源文档。以下资源可帮助您轻松上手:

访问代码编辑器

您可以从 Google Cloud 控制台中的以下页面访问 PromQL:

  • Metrics Explorer
  • 创建信息中心时添加微件

如需在使用 Metrics Explorer 时打开代码编辑器,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Metrics Explorer 页面:

    进入 Metrics Explorer

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

  2. 在查询构建器窗格的工具栏中,选择名为  MQL PromQL 的按钮。
  3. 验证已在语言 (Language) 切换开关中选择 PromQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
  4. 完成查询后,您可以配置图例或更改数据的显示方式。如需了解详情,请参阅以下页面:

使用代码编辑器

如需使用代码编辑器,请在文本字段中输入查询,然后点击运行查询

自动补全

在您输入查询时,编辑器会显示一个在语法上有效的补全列表。您可以通过按 Control+Space 手动打开自动补全菜单,也可以按 Escape 将其关闭。

要浏览选项列表,请使用箭头键。按 Enter 插入所选选项。

要插入所有可用选项通用的前缀,请按 Tab

查找和替换

编辑器支持查找和替换功能。如需查找并选择行替换查询中的字词,请按 Control+F(或在 Mac 上按 Command+F)。以下屏幕截图展示了该功能:

代码编辑器支持查找和替换功能。

编辑器控件

编辑器有两个控件,用于确定与查询的互动方式。

默认情况下,只有在点击执行查询后才会执行查询。您可以将编辑器设置为在键入时自动执行查询,但此选项默认处于停用状态。

如需启用自动运行选项,请使用 Auto-run 切换开关。 启用此选项后,编辑器的工作方式如下:

  • 不显示执行查询按钮。
  • 系统会在您输入时持续显示错误消息。
  • 如果您的光标位于不完整但没有错误的查询的末尾,编辑器会在控制栏中显示一个黄色三角形。如果有空间,还会显示 Incomplete query 字样。

    编辑器不会尝试计算不完整的查询。

代码编辑器和图表区域之间还有一个拖动条。 使用此条可更改两个区域的相对大小。

保存图表

保存图表的方式取决于您创建图表的背景, 图表:

  • 通过 Metrics Explorer。
  • 在创建或修改自定义信息中心的过程中。

保存 Metrics Explorer 中的图表

在 Metrics Explorer 的代码编辑器中,您可以选择将图表保存到自定义信息中心。要保存图表,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Metrics Explorer 页面:

    进入 Metrics Explorer

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

  2. 在查询构建器窗格的工具栏中,选择名为  MQL PromQL 的按钮。
  3. 验证已在语言 (Language) 切换开关中选择 PromQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
  4. 在编辑器中输入查询。
  5. 如果您未为代码编辑器启用自动运行选项,请在保存图表之前点击运行查询来运行查询。默认情况下,自定义信息中心会定期保存您的更改。如果您没有先运行查询,则代码编辑器会保存您最后一次运行的查询。

  6. 点击保存图表

  7. 要继续保存图表,请执行以下操作:

    1. 为图表指定一个说明性标题。
    2. 选择新图表的信息中心。
    3. 点击对话框中的保存

在自定义信息中心内保存图表

如需将新图表保存到信息中心,请执行以下操作:

  1. 为图表指定一个说明性标题。

  2. 如果您未为代码编辑器启用自动运行选项,请在保存图表之前点击运行查询来运行查询。默认情况下,自定义信息中心会定期保存您的更改。如果您没有先运行查询,则代码编辑器会保存您最后一次运行的查询。

  3. 如果您未为信息中心启用自动保存功能,请点击保存

Google Cloud 控制台支持为自定义信息中心设置页面级过滤条件。PromQL 支持这些过滤条件 自定义信息中心上的图表

退出代码编辑器

要退出代码编辑器而不保存查询,请执行以下操作: 点击其他某个选择器标签页。编辑器中的任何查询文本都会被舍弃,但您可以选择将其保存到剪贴板。