# 收集崩溃日志 (/zh-CN/realtime-media/local-server-recording/build/legacy/collect-logs)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

## 实现方法 [#实现方法]

声网建议你在集成本地服务端录制前，使用我们提供的 enable_coredump.sh 脚本开启系统 core dump 功能，以便在后续录制出现问题时，能够快速调查和定位问题，提高问题解决效率。

首先，你可先执行 `ulimit -c` 命令查看是否已开启 Core dump。输出结果如果为 0，则说明 Core dump 没有打开。

参考以下步骤在 Linux 系统中开启 Core dump 功能。

### 1. 获取脚本 [#1-获取脚本]

点击[此处](https://download.agora.io/serversdk/tools/enable_coredump.sh)获取 `enable_coredump.sh` 脚本。

### 2. 执行脚本 [#2-执行脚本]

打开终端，运行以下命令执行 `enable_coredump.sh` 脚本打开 Core dump：

```shell
sudo ./enable_coredump.sh
```

:::info[信息]
- 运行脚本后，要重启服务器才能生效。
- 如不能重启，请额外执行 `ulimit -c unlimited` 命令，使其在当前用户下生效。
:::

生成的 `core` 文件将位于 `/var/corefile` 目录下。

如果你是在 Docker 中跑录制进程，则运行以下命令：

```shell
docker run --ulimit core=-1 --security-opt seccomp=unconfined --privileged=true
```

| 参数                              | 描述                         |
|-----------------------------------|------------------------------|
| `--ulimit core=-1`                  | 不限制 `coredump` 大小         |
| `--security-opt seccomp=unconfined` | 允许容器执行全部系统调用     |
| `--privileged=true`                 | 允许录制进程生成 core dump 文件 |

## 注意事项 [#注意事项]

开发过程中，你还要关注如下开发注意事项：

- 运行一次该脚本后，如果系统重启，该脚本依然生效。
- 如果你集成的是本地服务端录制 SDK 2.2.3 及之后版本，会在 `AgoraCoreService` 所在目录下生成 `recording_crash.log`，作为崩溃问题分析的辅助文件。