跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

cloud-logging-query-generation · 把排错需求写成日志查询

将服务、时间范围和错误条件转成 Cloud Logging 的 LQL。

先看看示例

作者提供的示例,实际效果取决于你的输入和使用工具。

输入

编辑构造材料(未运行):
Cloud Run 服务 checkout-api;时间从 2026-09-29T00:00:00Z 到 2026-09-30T00:00:00Z;ERROR 及以上。

输出

编辑示例 · 未运行

resource.type="cloud_run_revision"
resource.labels.service_name="checkout-api"
severity>=ERROR
timestamp>="2026-09-29T00:00:00Z"
timestamp<"2026-09-30T00:00:00Z"

方法说明

将服务、时间范围和错误条件转成 Cloud Logging 的 LQL。

具体任务

筛出服务指定时间段的错误日志:将服务、时间范围和错误条件转成 Cloud Logging 的 LQL。

必需材料

服务类型与资源标识

时间范围、严重级别和要匹配的内容

可选材料

已知日志字段样本

排除条件

使用门槛

能描述目标服务与排错时间,执行查询时有日志读取权限。

这个 Skill 额外提供的方法

字符串使用双引号,区分精确匹配和子串;按服务及审计日志 schema 查字段。

编辑示例(未运行)

筛出服务指定时间段的错误日志

任务:筛出服务指定时间段的错误日志

输入:
编辑构造材料(未运行):
Cloud Run 服务 checkout-api;时间从 2026-09-29T00:00:00Z 到 2026-09-30T00:00:00Z;ERROR 及以上。

结果片段:
```text
resource.type="cloud_run_revision"
resource.labels.service_name="checkout-api"
severity>=ERROR
timestamp>="2026-09-29T00:00:00Z"
timestamp<"2026-09-30T00:00:00Z"
```

这是依据固定入口方法撰写的编辑示例,没有运行上游 Skill 或访问真实账号。字符串使用双引号,区分精确匹配和子串;按服务及审计日志 schema 查字段。

首次任务

请使用已安装的 cloud-logging-query-generation Skill。
任务:筛出服务指定时间段的错误日志。

我的必需材料:
- 服务类型与资源标识:[粘贴我的实际材料或路径;缺少时写明]
- 时间范围、严重级别和要匹配的内容:[粘贴我的实际材料或路径;缺少时写明]

可选补充:
- 已知日志字段样本:[可选,未提供时不要假定存在]
- 排除条件:[可选,未提供时不要假定存在]

请先确认材料是否足够,只处理我提供的范围。仅生成 Cloud Logging LQL,不把它当 SQL;资源类型和字段按服务参考核对,缺少 ID 使用明确占位。交付可直接审阅的代码或查询片段,明确尚未执行或验证的部分。不要代入页面例子的虚构数据。
验收:
1. LQL 使用正确资源类型与字段路径。
2. 起止时间、时区及严重级别与要求一致。
3. 查询可粘贴到 Logs Explorer,结果为空时不直接宣称无故障。

验收方法

LQL 使用正确资源类型与字段路径。

起止时间、时区及严重级别与要求一致。

查询可粘贴到 Logs Explorer,结果为空时不直接宣称无故障。

依赖与准备

需要完整 Skill 目录,保留 references/api_reference.md、references/query_app_engine.md、references/query_bigquery.md、references/query_deployment_manager.md 等引用。需要完整 references/api_reference.md 和对应服务参考;生成本身可离线,执行需 Cloud Logging 查询工具或控制台权限。

使用边界

仅生成 Cloud Logging LQL,不把它当 SQL;资源类型和字段按服务参考核对,缺少 ID 使用明确占位。

用于 Cloud Logging,不是 SQL;执行查询仍需日志读取权限。

页面中的例子为编辑撰写,未运行上游 Skill;不代表平台兼容认证或生产实测。

排错

查不到记录:先放宽一个条件检查时间和资源类型,再确认采集范围。

把包含匹配当精确方法名:根据源规则选等号或正则,避免冒号造成子串误匹配。

固定来源

https://github.com/google/skills/blob/2964a69c4d4a27632a43d60dab5f4f645f2a82df/skills/cloud/cloud-logging-query-generation/SKILL.md

许可

Apache-2.0。许可原文:https://github.com/google/skills/blob/2964a69c4d4a27632a43d60dab5f4f645f2a82df/LICENSE

仓库热度

google/skills 仓库 20,504 Stars(2026-09-30 核验);这是父仓库指标,不是单个 Skill 的评分。