# 通过文档数据库服务查看慢日志
慢日志用来记录执行时间超过当前慢日志阈值"operationProfiling.slowOpThresholdMs"（默认是500ms）的语句，您可以通过慢日志的日志明细、统计分析情况，查找出执行效率低的语句，进行优化。您也可以下载慢日志进行业务分析。
#### 使用须知
- 对于社区版实例，支持通过界面查看和导出日志明细、开启慢日志明文显示、以及下载日志文件的功能。
- 删除实例、添加集群实例的节点、变更规格、重建备机，以及实例冻结时，不支持开启慢日志明文开关。
- 开启慢日志明文开关时，不支持删除实例、添加集群实例的节点、变更规格。
- 慢日志的阈值默认设置的是500ms，执行耗时超过该阈值的语句，就会记录慢日志。
- 当慢日志大小达到一定阈值后，会自动删除比较旧的数据。所以需要对慢日志进行分析时，请及时在控制台下载慢日志。
- 您只能查看30天内的慢日志。
- 文档数据库服务不支持删除慢日志。
- 在慢日志明细页面导出数据时，会将当前页上展示的所有日志导出。
- 如果您需要根据某个字段排序查看慢日志，比如执行完成时间、SQL语句、客户端、用户、执行耗时、锁等待耗时、扫描文档数据、返回文档数、扫描索引数等，请参见数据管理服务（Data Admin Service，简称DAS）用户指南中的"慢SQL"章节。
- 慢日志内容可能存在几秒到数分钟不等的延时，与慢日志产生数量和实例负载有关。
- 在慢日志数量监控中，每个监控坐标点的数据，都是基于这个时间点前5分钟的慢日志总数生成的。
- 如需开通慢日志单次加载500条权限，您可以[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)申请，完成工单提交。开通后，若设置的节点类型查询条件为"All Nodes"或"All shards"，建议设置的查询时间范围在10分钟内。
- 慢日志不具备严格一致性，即页面上的慢日志信息不代表严格全量的慢日志信息。这是因为后台慢日志采集存在周期性，当慢日志产生速度过于频繁时，采集周期有可能会无法覆盖所有时间段慢日志。
 
#### 参数说明
表1DDS慢日志相关的参数说明 
| 参数名称                                 | 说明                                                                                                           |
|:---|:---|
| operationProfiling.slowOpThresholdMs | 慢查询的时间阈值，单位为毫秒，超过该阈值的操作将被认为是慢操作。默认值为500ms。 如无特殊需求，建议使用默认值500ms。 |
   
#### 开启慢日志明文显示
![](https://support.huaweicloud.com/usermanual-dds/public_sys-resources/note_3.0-zh-cn.png)
- 开启后界面会显示明文日志。系统默认在30天后自动删除明文日志，且该时间不可修改。
- 如果慢日志所属的实例被删除，相关日志也同步会删除。
- 明文显示开关开启后允许关闭。关闭前上报的慢日志保持明文，关闭后上报的慢日志将不再显示明文。
 
1. [登录管理控制台](https://console.huaweicloud.com)。
2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001699299998.png)，选择区域和项目。
3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001746939933.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
4. 在"实例管理"页面，选择目标实例，单击实例名称。
5. 在左侧导航树，单击"慢日志"。
6. 在"慢日志"页面，默认在"日志明细"页签下，单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001182396597.png)。
   
   图1开启慢日志明文显示   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002392617381.png "点击放大")
   
   
7. 在弹出框中，单击"是"，开启慢日志明文显示功能。
 
#### 查看和导出日志明细
1. [登录管理控制台](https://console.huaweicloud.com)。
2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001747020081.png)，选择区域和项目。
3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001699140490.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
4. 在"实例管理"页面，选择指定的实例，单击实例名称。
5. 在左侧导航树，单击"慢日志"。
6. 在"慢日志"页面，默认在"日志明细"页签下，设置查询条件，查看日志信息。 
   图2查询指定条件的慢日志   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002359102156.png "点击放大")
   - 对于集群实例，节点类型默认"All shards"，可查看集群实例下所有shard节点的慢日志信息。
   
   - 对于副本集实例，节点类型默认"All nodes"，可查看副本集实例下所有节点的慢日志信息。
   
   - 可查看对应节点在不同时间段的慢日志。
   
   - 可查看以下级别的慢查询语句：
     - 全部语句类型
     
     - INSERT
     
     - QUERY
     
     - UPDATE
     
     - REMOVE
     
     - GETMORE
     
     - COMMAND
      
   
   - 支持查看指定节点类型、指定级别、指定时间段内最多2000条的慢日志。
    
   
   
7. 在"日志明细"页签下，您也可以单击"高级搜索"。 
   图3高级搜索   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002358940416.png "点击放大")
   ![](https://support.huaweicloud.com/usermanual-dds/public_sys-resources/note_3.0-zh-cn.png)
   - 如需开通高级搜索权限，您可以[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)申请，完成工单提交，开通高级搜索权限的申请。目前230830及以后小版本的实例支持高级搜索功能。
    
   
   
8. 您可以设置"关键字"、"执行时间(ms)"、"返回文档数"、"扫描文档数"、"所属数据库"、"所属数据库表"、"扫描的索引数"、"用户名"和"客户端IP"，单击"搜索"，查看日志信息。 
   图4高级搜索参数设置   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002359100984.png "点击放大")
   
   
9. 如需清空"高级搜索"的参数设置，单击"重置"。 
   图5高级搜索参数重置   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002359101360.png "点击放大")
   
   
10. 在"日志明细"页签下，您也可以单击日志列表右上方![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001182516515.png)，导出日志明细。
    
    - 导出完成后，您可以在本地查看生成的".csv"文件。
    
    - 支持单次最多导出2000条日志明细。
    
    
    
    
 
#### 下载日志文件
1. [登录管理控制台](https://console.huaweicloud.com)。
2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001699299946.png)，选择区域和项目。
3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001746939905.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
4. 在"实例管理"页面，选择指定的实例，单击实例名称。
5. 在左侧导航树，单击"慢日志"。
6. 在"慢日志"页面，选择"日志文件"页签，在状态为"准备完成"的日志文件上，单击"下载"，下载慢日志。 
   图6慢日志   
   ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002392621901.png "点击放大")
   - 系统会自动加载下载准备任务，加载时长受日志文件大小及网络环境影响。
     - 下载准备过程中，日志文件状态显示为"准备中..."。
     
     - 下载准备完成，日志文件状态显示为"准备完成"。
     
     - 下载准备失败，日志文件状态显示为"异常"。
      
   
   - 一个节点对应一个待下载的日志文件，最大支持下载40MB日志文件。
   
   - 下载链接有效期为5分钟。如果超时，提示用户下载链接已失效，是否重新下载。如果需要重新下载，单击"确定"，否则，单击"取消"。
   
   
   
   
 
#### 相关内容
[如何优化慢操作](https://support.huaweicloud.com/usermanual-dds/dds_01_0059.html)
#### 相关API
| API                                                                    | 说明            |
|:---|:---|
| [查询数据库慢日志](https://support.huaweicloud.com/api-dds/dds_api_0093.html)  | 查询数据库慢日志信息。   |
| [获取慢日志下载链接](https://support.huaweicloud.com/api-dds/dds_api_0094.html) | 获取慢日志下载链接。    |
| [设置慢日志明文开关](https://support.huaweicloud.com/api-dds/dds_api_0121.html) | 设置实例的慢日志明文开关。 |
| [查询慢日志明文开关](https://support.huaweicloud.com/api-dds/dds_api_0221.html) | 查询慢日志明文开关。    |