如何在Log Analytics工作区获取Synapse Analytics工作区错误详情日志

1 修正诊断设置配置 #

Synapse的管道、活动运行错误日志默认不输出到SynapseIntegrationActivityRuns表，你首先需要检查工作区诊断设置的日志勾选情况：

• 进入Synapse工作区→诊断设置→编辑现有配置
• 确保勾选Pipeline runs、Activity runs两个日志类别，保存配置后等待15分钟左右日志即可正常同步

2 使用KQL解析获取错误详情 #

Synapse的错误字段没有做单独的列拆分，全部存在Properties动态字段中，你可以通过以下两个查询分别提取管道、活动的失败错误信息：

管道运行错误查询 #

SynapsePipelineRuns
| where Status == "Failed"
| extend ErrorDetails = parse_json(Properties).errors
| mv-expand ErrorDetails
| extend ErrorCode = ErrorDetails.errorCode,
         ErrorMessage = ErrorDetails.message,
         FailureType = ErrorDetails.failureType
| project PipelineName, RunStart, RunId, Status, ErrorCode, ErrorMessage, FailureType

活动运行错误查询 #

SynapseActivityRuns
| where Status == "Failed"
| extend ErrorDetails = parse_json(Properties).errors
| mv-expand ErrorDetails
| extend ErrorCode = ErrorDetails.errorCode,
         ErrorMessage = ErrorDetails.message
| project PipelineName, ActivityName, RunStart, Status, ErrorCode, ErrorMessage

3 对接Power BI统一报表 #

• 将上述两个KQL查询作为Log Analytics数据源的查询语句导入Power BI
• 和你已有的ADF日志表做字段对齐后合并，即可统一统计全量失败管道/活动的数量、失败原因分类

提示：如果遇到特殊活动的错误嵌套层级更深的情况，直接用parse_json逐层解析Properties字段即可拿到对应错误信息。

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