Synapse管道日志未显示在Log Analytics中，如何排查及配置告警？

一、先核对诊断设置的配置细节 #

• 确认作用范围：诊断设置必须绑定到包含目标管道的Synapse工作区或对应的集成运行时，别误选了SQL池、Spark池这类无关资源。
• 补全日志类别：除了你选的Integration Pipeline Runs、Integration Activity Runs、Integration Trigger Runs，建议加上Integration Pipeline Failures、Integration Activity Failures——这类专门的失败日志能更快定位问题。
• 检查工作区连接：在诊断设置页面确认目标Log Analytics工作区状态正常，没有权限报错或连接中断的提示。

二、注意日志同步延迟 #

Synapse的日志同步到Log Analytics通常有5-15分钟的延迟，调试或触发管道后别立刻去查，等10分钟左右再刷新Logs页面试试。

三、用Kusto查询精准定位日志 #

在Log Analytics的Logs界面，用以下Kusto语句筛选日志：

1. 查看所有管道运行记录：

AzureDiagnostics
| where Category == "IntegrationPipelineRuns"
| project TimeGenerated, PipelineName, RunId, Status, StartTime, EndTime

2. 快速筛选失败的管道/活动：

AzureDiagnostics
| where Category in ("IntegrationPipelineFailures", "IntegrationActivityFailures")
| project TimeGenerated, PipelineName, ActivityName, ErrorMessage, Status

3. 定位df_to_consult相关的运行日志：

AzureDiagnostics
| where Category == "IntegrationActivityRuns"
| where Properties contains "df_to_consult"
| project TimeGenerated, PipelineName, ActivityName, Status, Properties

四、直接在Synapse Studio查看日志（应急方案） #

如果Log Analytics暂时没数据，直接在Synapse Studio里查更即时：

• 进入「集成」模块，左侧菜单选「监视」，在「管道运行」或「活动运行」里筛选目标管道，能直接看到执行状态、失败时的具体错误信息。
• 要查df_to_consult的流入触发记录，去「触发器运行」里筛选，能确认数据流入时的触发事件是否正常执行。

五、补充：实现数据流入通知的优化方案 #

除了依赖诊断日志，还有更直接的通知方式：

• 在管道里加「Web活动」，当数据成功写入df_to_consult后，调用邮件、Teams机器人的接口发送通知。
• 在Log Analytics里创建警报规则，基于涉及df_to_consult的IntegrationActivityRuns记录触发，一旦有新数据流入就自动发通知。

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