配置慢SQL持久化

操作场景

开启慢SQL持久化，通过慢SQL持久化配置慢SQL数据（存入ES中的索引数据）和文件（存入OBS桶中的文件）的保留天数，会定时采集GaussDB数据库实例的慢SQL记录，进而构建索引数据，持久化到ES集群中存储。开启或关闭SQL持久化，会自动触发工作流任务，将特性配置和状态批量下发到各实例中，操作慢SQL定时采集任务的开启和关闭。

默认慢SQL数据的保留天数为7天，慢SQL文件的保留天数为15天。默认会在每天19点开始启动慢SQL数据清理任务，并在凌晨1点启动慢SQL文件清理任务。

约束限制

持久化功能依赖租户级OBS桶，如果管控平台没有对接租户侧OBS桶，则无法开启持久化。
开启持久化过程中，会在租户侧给每个数据库实例所对应的资源租户创建专用的OBS桶，占用OBS桶资源，且持久化后的数据会持续写入到OBS桶中，请确保有足够的存储空间。
单条慢SQL采集数据大约占用1~10KB，请根据实际业务场景，评估在给定保留时间区间内，所有实例节点上的慢SQL条目数，确定租户侧OBS桶资源是否足够；如果资源不足，请缩短慢SQL文件保留天数或者进行OBS存储资源扩容。
在进行持久化开关操作时，会跳过正在进行涉及DN或CN组件启动/停止/重启/新增/缩减的相关操作的实例待相关操作结束后，可通过同步功能应用特性状态。
慢SQL采集文件在OBS桶的保留天数默认为15天，解析存储到ES集群的保留天数默认为7天，仅支持在开启持久化开关时进行修改，开启后不支持修改。在业务侧产生较多慢SQL和GaussDB数据库实例数较多的场景下，建议保留天数不宜设置过大，避免造成历史数据堆积，占用较大存储资源，并影响ES集群的检索性能。
持久化的相关配置只能在开启持久化开关时进行设置和调整，在开启持久化开关后，不能进行修改，只能进行查看。如需调整相关配置（如文件保留天数），请关闭持久化开关后再重新打开。
请确保管理面和GaussDB实例各节点的时间是同步的（UTC-0时间戳是一致的），误差最多不超过10秒，否则影响整体功能，请务必重视。
在定时采集GaussDB数据库的慢SQL数据时，如果数据库内核发生重启，则会导致部分采集数据丢失，可能会丢失一个采集周期内的数据；严重情况可能会造成上个采集结束时间点到当前采集时间点之间的数据丢失。

注意事项

慢SQL持久化中，按照SQL最小执行时长的默认阈值来采集SQL数据。GaussDB数据库内核基于SQL语句执行时间是否超过此阈值来判断该SQL是否为慢SQL记录。如需调整对应实例的慢SQL采集阈值，可以通过修改实例参数“log_min_duration_statement”进行配置。实例参数的查看和修改方法请参考修改GaussDB实例参数。

持久化开关开启后，特性配置会分批陆续下发到状态为正常的实例上，请耐心等待其生效。异常实例和操作上存在互斥（如重启、删除、扩容等变更操作）的实例，会跳过操作。
如果持久化开关已打开，新创建GaussDB数据库实例，会自动开启该实例的慢SQL持久化功能。关闭持久化开关后实例的慢SQL数据将不会转储到ES集群中。
删除GaussDB数据库实例时，如果该实例已开启过慢SQL持久化，会自动清空ES中对应的慢SQL索引数据和OBS桶中的对应的慢SQL文件。
如果实例侧慢SQL持久化开启失败或关闭失败，可登录DBS运维管理平台，进入任务管理界面，通过实例ID进行过滤，查看具体的报错原因。
当切换慢SQL持久化开关时，如果被操作的GaussDB数据库实例同时已存在互斥操作，特性状态应用则会跳过该部分数据库实例。待持久化开启切换完成且对应数据库实例上互斥操作结束后，可通过“同步”功能，对这些数据库实例进行持久化状态的同步更新。
同步慢SQL持久化的开关状态至所有实例。
- 如果当前持久化开关已打开，同步功能会操作所有持久化状态已关闭或开启失败的实例，尝试开启慢SQL持久化。
- 如果当前持久化开关已关闭，同步功能会操作所有持久化状态未关闭或关闭失败的实例，尝试关闭慢SQL持久化。

开启慢SQL持久化

登录管理控制台。
单击管理控制台左上角的，选择区域和项目。
在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
在左侧导航栏中单击“运维配置中心”，显示“运维配置中心”页面。
在“运维配置中心”页面，单击特性名称为“慢SQL持久化”的卡片，右侧滑出“慢SQL持久化”抽屉。

图1 慢SQL持久化开关配置
单击“慢SQL持久化”开关，右侧滑出下发界面，如下所示。

输入慢SQL文件保留天数和慢SQL数据保留天数，并完整输入“YES”，建议使用默认配置，避免数据保存过多。

图2 开启慢SQL持久化
单击“确定”，完成慢SQL持久化功能开启操作。
在“慢SQL持久化配置”界面等待，可查看各实例的特性状态应用情况。
开启慢SQL持久化后，单击“查看配置”，查看慢SQL文件保留天数和慢SQL数据保留天数。