如何将Cloud SQL中SQL Server实例日志集成至Stackdriver Console？

核心问题直接解答 #

1. 所需插件清单 #

不需要安装任何第三方插件或额外组件：

• 无数据库侧插件需求：所有查询捕获能力都是SQL Server原生内置的，Express与Standard版本均支持
• 无GCP平台侧采集组件需求：Cloud SQL 原生内置与Stackdriver（现官方名称为Cloud Logging）的日志上报链路，不需要部署任何采集代理
• 无客户端侧配置需求：SSMS、sqlcmd、SQLPro等客户端只要正常连接实例，执行的查询都会被自动捕获，无需在客户端安装插件。

2. 原生能力可行性 #

无需依赖任何第三方工具，完全通过Cloud SQL与SQL Server原生能力即可实现需求：

• Cloud SQL for SQL Server 是全托管服务，已经预配置了日志上报至Stackdriver的链路，不需要用户自行搭建日志采集管道
• SQL Server 内置的扩展事件（XEvent）、服务器审核功能，可直接捕获客户端执行的查询文本、客户端类型、操作账号等信息，能精准区分SSMS、sqlcmd、SQLPro等不同客户端的执行动作。

详细实现步骤 #

步骤1：打通Cloud SQL与Stackdriver的日志链路 #

确认Cloud SQL实例的日志上报配置已开启（默认托管实例已开通，可按需调整）：

• 进入GCP控制台对应Cloud SQL for SQL Server实例的「编辑」页面
• 在「数据库标志」配置项中，确认已开启日志输出相关的原生内置标志，确保SQL Server侧生成的日志可正常同步到Stackdriver
• 在实例的「日志」配置页，勾选需要采集的日志类型，后续配置的XEvent/审核日志会自动出现在Stackdriver的日志列表中。

步骤2：配置SQL Server原生能力捕获全量客户端查询 #

通过任意可连接实例的SQL客户端（SSMS、sqlcmd、SQLPro均可）执行以下原生SQL脚本，创建自定义扩展事件会话，捕获所有客户端执行的查询：

-- 创建捕获查询的XEvent会话，无需额外组件
CREATE EVENT SESSION [Capture_Client_Queries] ON SERVER 
ADD EVENT sqlserver.sql_statement_completed(
    -- 采集需要的元数据字段：客户端类型、主机名、执行账号、会话ID
    ACTION(
        sqlserver.client_app_name, 
        sqlserver.client_hostname, 
        sqlserver.username, 
        sqlserver.session_id
    )
    -- 按需添加过滤规则，排除系统账号的冗余查询，降低性能开销
    WHERE sqlserver.username NOT IN ('sqlserveradmin', 'cloudsqladmin')
)
-- 配置输出目标，Cloud SQL会自动采集该目标生成的日志
ADD TARGET package0.event_file(
    SET filename=N'capture_client_queries.xel', 
    max_file_size=10, -- 单文件最大10MB
    max_rollover_files=5 -- 最多保留5个滚动文件，可按需调整
)
WITH (
    MAX_MEMORY=4096 KB,
    EVENT_RETENTION_MODE=ALLOW_SINGLE_EVENT_LOSS,
    MAX_DISPATCH_LATENCY=30 SECONDS -- 最长30秒批量投递一次日志
);

-- 启动事件会话
ALTER EVENT SESSION [Capture_Client_Queries] ON SERVER STATE = START;

替代方案：如果需要更细粒度的权限审核规则，也可以使用SQL Server原生的「服务器审核」功能配置查询捕获，输出同样会自动同步到Stackdriver，全程无需插件。
可扩展规则：如果需要捕获存储过程执行、DDL语句等更全面的操作，可额外添加sqlserver.sp_statement_completed、sqlserver.sql_statement_starting等原生事件，均无需插件。

步骤3：在Stackdriver Console查看日志 #

会话启动后，执行的查询日志会在1分钟内同步到Stackdriver：

• 进入Stackdriver的「日志浏览器」页面
• 资源类型选择 Cloud SQL Database，筛选对应的Cloud SQL实例ID
• 可通过日志中的clientAppName字段过滤特定客户端的查询，比如过滤SSMS的查询可使用条件：jsonPayload.clientAppName = 'Microsoft SQL Server Management Studio - Query'

性能优化注意事项 #

• 全量捕获所有查询会占用一定的CPU与存储资源，建议按需添加过滤规则（比如仅捕获特定账号、特定数据库、执行时间超过阈值的查询），同时裁剪不需要的元数据字段，降低资源开销
• 不要长期无限制开启全量捕获，业务高峰期可临时调整过滤条件或停止不需要的事件会话，停止命令为：ALTER EVENT SESSION [Capture_Client_Queries] ON SERVER STATE = STOP;
• 定期清理XEvent生成的旧日志文件，避免占用Cloud SQL的实例存储空间

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