如何在Log Analytics工作区获取Synapse管道与活动错误日志用于Power BI

没错，创建诊断设置就是实现这个需求的标准方法，下面是具体操作步骤和后续查询的方法：

操作步骤 #

• 登录Azure门户，打开你的Synapse Analytics工作区
• 左侧导航栏找「监控」→「诊断设置」
• 点击「添加诊断设置」：
  • 给这个设置起个好记的名字，比如Synapse-Failed-Pipeline-Logs
  • 在「日志」分类下，必须勾选这两个类别：
    • SynapseIntegrationActivityRuns：活动运行的详细日志，包含失败活动的错误码、错误信息（你之前在本地日志里没看到，是因为没通过诊断设置把这些日志同步到Log Analytics）
    • SynapseIntegrationPipelineRuns：管道层面的运行日志，能看到整个管道失败的原因
  • 「目标详情」选「发送到Log Analytics工作区」，然后挑你要同步到的那个Log Analytics工作区
  • 保存设置，等15-30分钟，日志就会开始同步过去

查询错误详情的Kusto语句 #

日志同步后，在Log Analytics里用这些语句就能提取你要的信息：

活动级错误码查询 #

SynapseIntegrationActivityRuns
| where Status == "Failed"
| project ActivityName, ActivityRunId, ErrorCode, ErrorMessage, PipelineName, StartTime

管道级错误详情查询 #

SynapseIntegrationPipelineRuns
| where Status == "Failed"
| project PipelineName, PipelineRunId, ErrorMessage, StartTime

额外建议 #

• 要是想节省存储成本，可以在诊断设置的「日志类别详细设置」里，只勾选失败状态的日志事件，不用同步所有运行记录
• 日志同步延迟一般在15分钟内，完全能支撑Power BI报表的监控需求

内容的提问来源于stack exchange，提问作者Kevin Joseph G. Jurado