扩展事件

功能的

列出扩展事件会话及其运行状态和每个会话的详细信息;启动和停止以脚本为先。

两个并排的网格:左侧列出各个会话、其启动状态以及当前是否正在运行;选中一个, 显示事件和目标 右侧网格将显示该会话的事件和目标。启动和停止会话是 以脚本为先: 生成启动脚本 和 生成停止脚本 打开确切的 ALTER EVENT SESSION … STATE = START|STOP 语句以供查看,而不是从对话框中执行——页脚上有相应说明。

支持作用域感知。 从数据库打开时,它会列出该数据库自己的数据库作用域会话(sys.database_event_sessions)。从命令面板打开时,它会列出实例的服务器级会话;而在 Azure SQL Database 上,由于那里只有数据库级会话,会自动改为列出这些会话。
SQLly
SQLly 扩展事件窗格
扩展事件:提供会话列表及运行状态、每个会话的事件/目标详情,并优先提供启动/停止脚本。

打开它

  • 对于一个数据库: 在资源管理器中右键单击该数据库并选择 工具 › 扩展事件...。SQLly 会先将该数据库设为活动数据库。对话框标题以 (数据库范围).
  • 对于整个实例: 运行 扩展事件... 从 命令面板。标题以 (服务器范围)。如果无法读取服务器范围的目录(例如在 Azure SQL Database 上),窗格会改用数据库范围重试,标题也会注明。

检查会话并停止它

假设同事留了一个正在运行的跟踪会话,你想在关掉之前确认它捕获了什么:

  1. 打开扩展事件。左侧网格按名称列出每个会话 startup_state (它是否以服务器开头),以及 is_running (1 当它当前正在运行时)。
  2. 选择会话所在行并按 显示事件和目标。右侧网格的标题为 事件和目标 - <session>,列出 event_name 和 target_name 对,例如 sql_batch_completed 写入一个 event_file 目标。
  3. 按 生成停止脚本。对话框关闭,并打开一个带这条语句的查询标签页,由你自己检查后手动运行:
ALTER EVENT SESSION [long_running_queries] ON SERVER STATE = STOP;

如果是数据库,语句会写成 ON DATABASE 代替。 生成启动脚本 会生成相同的语句,其中 STATE = START。会话名称加方括号引用,其中任何 ] 翻倍,因此不寻常的名称也没问题。

按钮

按钮作用
刷新重新读取会话列表并清除详细信息网格。
显示事件和目标将所选会话的事件和目标加载到右侧网格中。
生成启动脚本 / 生成停止脚本打开 ALTER EVENT SESSION 在新查询标签页中显示所选会话对应的语句。对话框本身不会执行任何操作。

未选中任何行时,操作会提示你先选择会话,而不是自行猜测。

权限和限制

  • 读取扩展事件元数据需要 VIEW SERVER STATE,或 VIEW DATABASE STATE 在 Azure SQL 上。如果列表无法读取,窗格会显示服务器的错误以及该提示。
  • 该窗格列出会话及其配置;它不会创建会话,也不会读取捕获的事件数据。请编写 CREATE EVENT SESSION ,并使用常用函数读取目标,例如 sys.fn_xe_file_target_read_file.

在 SQL Server 系列中,扩展事件是 SQL Server 的一个功能。在其他引擎中,菜单项会提示这一点;在 ClickHouse 上,它会指向 system.query_log 和 system.trace_log,这 查询洞察 已经可以读取。