对采集到服务端的日志进行查询分析时，您可以将原始日志数据或检索分析结果下载到本地，进行数据查看或进一步分析。 ## 费用说明下载日志功能正在公测中，公测期间暂不计费。 ## 使用限制下载日志时，下载任务的数据量存在以下限制： :::tip * 大数据量时，推荐缩小查询的时间范围，分多次下载。 * 下载日志的任务进行时，修改其检索语句中使用到的索引，可能会造成日志下载失败。 ::: |操作 |说明 | |---|---| |仅检索或预览日志 |* 单次最多下载 2000 万条满足检索条件的日志数据，且数据量不超过 20GiB。超出限制时，仅下载日志时间更早的前 2000 万条数据或前 20GiB 数据。|\ | |* 超过 20GiB 时，**导出历史**页面会显示**文件生成中断**。 | |检索分析日志 |单次最多下载 100 万条检索分析结果，且数据量不超过 2GiB。超出限制时，仅下载前 100 万条数据或前 2GiB 数据。 | ## 步骤一创建下载任务您可以通过控制台或 API 下载日志数据，本文档以控制台下载为例介绍相关的操作步骤。 1. 登录[日志服务控制台](https://console.volcengine.com/tls)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择**常用功能** \> **检索分析**。。 4. 在**检索分析**页面的左侧列表中，选择指定的日志项目和日志主题。 5. 在指定日志主题的检索分析页面，指定时间范围和检索分析语句。 6. 下载日志数据。 * 检索后下载日志：在**原始日志**页签右上角，选择**下载日志 \> 下载日志**。 * 检索分析后下载日志：在**图表分析**页签右上角，选择**下载日志 \> 下载日志**。 7. 填写日志下载任务的基本配置，并单击**确定**。 |配置 |说明 | |---|---| |任务名称 |日志下载任务的名称，同时是日志压缩文件的名称。|\ | |同一个日志项目下，下载任务名称不可重复。 | |时间范围 |日志检索的时间范围。如需修改，请返回**检索分析**页面重新检索。 | |检索语句 |日志检索语句或检索分析语句。如需修改，请返回**检索分析**页面重新检索。 | |日志数量 |本次下载涉及的数据量。您可以下载满足筛选条件的全部数据量，或自定义下载的数据量。 | |下载查询不精确结果 |查询结果不精确时可能会下载失败，开启后将继续下载已查询出的不精确结果日志。 | |导出格式 |导出的文件格式，支持 CSV 、JSON、JSONL。 | |日志排序 |仅检索不分析时，日志的排序方式，支持升序或倒序。 | |压缩类型 |导出文件的压缩类型，支持不压缩、zip、gzip。|\ | |:::tip|\ | |下载到本地后，请选择合适的解压工具解析压缩包。|\ | ||\ | |:::| ## 步骤二下载日志文件 1. 选择**下载日志 \> 导出历史。** 2. 在导出历史列表中，找到目标下载任务，单击其**操作**列的**下载**。 ## 相关操作 ### 查看下载历史创建下载任务之后，您可以选择**下载日志 \> 导出历史**，查看日志导出的历史记录。 :::tip * 下载任务根据创建时间依次执行下载，存在多个新任务时，请耐心等待任务执行。 * 支持查看最近 1 天的日志导出记录，超过 1 天的日志导出记录和对应日志文件会被自动清除。 ::: 导出记录中包含下载任务的基本信息，例如文件名称、文件大小、日志条数、压缩格式等。 ### 查看下载状态创建日志下载任务之后，您可以选择**下载日志 \> 导出历史**，查看每个下载任务对应的文件状态。各个状态的说明如下： |状态 |说明 | |---|---| |文件生成中 |下载任务对应的压缩文件正在生成中，请耐心等待。 | |文件生成中断 |日志服务在导出数据时，如果日志量超限，则只能下载部分日志数据，超出限制的部分数据无法成功导出。|\ | |大数据量时，推荐缩小查询的时间范围，分多次下载。 | |文件已生成 |日志服务已成功导出指定的日志数据，可以随时下载文件。 | |等待中 |该 Topic 中存在**文件生成中**的下载任务，请耐心等待。 | |已失败 |在网络波动、关闭索引、删除 Topic 等其他异常情况下，日志导出失败，此时文件为**已失败**状态。 | ### 取消下载任务创建下载任务之后，日志服务支持取消下载。 1. 选择**下载日志 \> 导出历史。** 2. 在导出历史列表中，找到目标下载任务，单击其**操作**列的**取消**。