Datadog监视器中如何正确引用log.attributes下的嵌套日志属性值

问题场景 #

在Datadog平台创建日志监视器时，需要从日志的JSON结构中提取limitedSessionData.user.email路径对应的用户邮箱字段，用于告警通知内容展示。配置监视器通知模板过程中，系统弹出了相关属性引用提示，但测试了以下四种变量引用写法，均无法正常获取对应字段值：

• "{{log.attributes.limitedSessionData.user.email}}" - 给这个用户发邮件，询问他是否需要帮助。
• "{{log.attributes.[limitedSessionData.user.email]}}" - 给这个用户发邮件，询问他是否需要帮助。
• "{{log.attributes[limitedSessionData.user.email]}}" - 给这个用户发邮件，询问他是否需要帮助。
• "{{log.attributes[@limitedSessionData.user.email]}}" - 给这个用户发邮件，询问他是否需要帮助。

现需要确认这类嵌套日志属性的正确模板引用方式，以及是否需要提前将对应日志属性配置为facet才能在模板中正常调用。配置时的系统提示截图参考：

正确配置说明 #

1. Facet配置要求 #

必须提前将limitedSessionData.user.email对应路径的字段配置为日志facet。未配置为facet的属性不会被日志索引存储，监视器通知模板无法读取到对应值。配置facet时需要保证嵌套层级和日志实际JSON结构完全一致，避免层级错位。

2. 正确引用语法 #

你测试的第一种写法{{log.attributes.limitedSessionData.user.email}}本身语法是正确的，如果拿不到值优先检查facet是否配置正确，以及日志上报时该字段是否确实存在、值不为空。
其余三种写法的错误原因：

• 不要在点号访问层级后额外用方括号包裹完整嵌套路径，方括号仅用于属性名本身包含特殊字符（如点、空格、连字符）的场景，使用方括号时需要给属性名加双引号，例如如果存在一个非嵌套的、属性名本身就叫user.email的字段，才需要写成{{log.attributes["user.email"]}}
• 不要在属性路径前加@前缀，@是Datadog日志搜索栏里引用facet的语法，不适用于通知模板的变量访问场景。

3. 快速配置技巧 #

如果手动拼写路径容易出错，可以在日志检索页找到已经配置完成的对应facet，点击facet菜单里的「复制通知引用」选项，系统会自动生成完全匹配的模板变量，直接粘贴到通知模板里即可，避免手动拼写出现的层级错误。

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