如何在GCP Log Explorer日志型告警的文档部分添加日志文本payload？

核心逻辑 #

日志型告警的**文档（Documentation）**区域原生支持模板变量，可直接引用日志事件的Payload内容，无需在策略条件区域额外处理。

可用模板变量（官方文档翻译） #

以下变量可用于在文档中提取日志Payload的各类信息：

• $labels.<label_key>：调用日志标签的指定键值，例如$labels.resource_name获取关联资源名称
• $resource.<resource_key>：调用日志关联资源的属性，例如$resource.project_id获取所属项目ID
• $log_entry.<field_path>：直接调用日志条目Payload的字段，支持嵌套路径，例如$log_entry.jsonPayload.error.message提取嵌套的错误详情
• $timestamp：日志事件的生成时间戳
• $severity：日志的严重级别

实操步骤 #

1. 打开GCP监控的告警策略编辑页，定位到**文档（Documentation）**模块
2. 在文档编辑框中用模板变量拼接告警详情，示例代码：

   ### 告警触发详情
   - 触发时间：$timestamp
   - 目标实例ID：$resource.instance_id
   - 错误内容：$log_entry.jsonPayload.error.detail
   - 完整日志Payload：$log_entry
   

3. 保存策略，当告警触发时，文档区域会自动填充对应日志的实际Payload内容

注意点 #

• 若字段可能为空，可使用$labels.<key> || '无数据'的语法设置默认值，避免显示空值
• 针对纯文本格式的日志，使用$log_entry.textPayload提取内容

内容的提问来源于stack exchange，提问作者Or Kiraly