crashReporter
将崩溃日志提交给远程服务器
以下是一个设置Electron自动提交崩溃日志到远程服务器的示例:
const { crashReporter } = require('electron')
crashReporter.start({ submitURL: 'https://your-domain.com/url-to-submit' })
构建一个用于接受和处理崩溃日志的服务,你需要以下工程
注意: Electron 使用 Crashpad 而不是 Breakpad 来收集和上传崩溃信息,不过到目前为止,它们的上传协议是一样的。
或者使用第三方托管的解决办法:
崩溃报告在上传之前会临时存放在应用程序的用户数据目录下(Windows 和 MacOS 上文件夹名为 "Crashpad",Linux 上是 "Crash Reports")。 你可以在启动崩溃报告器之前,调用 app.setPath('crashDumps', '/path/to/crashes')
来覆盖该目录。
Electron 使用 crashpad 来监视和报告崩溃情况。
方法
crashReporter
模块具有以下方法:
crashReporter.start(options)
选项
对象submitURL
string (可选) - 崩溃报告将以POST的方式发送给这个URL。 必填 除非uploadToServer
是false
productName
string (可选) - 默认为app.name
.companyName
string (可选) 已废弃 - 已废弃别名为{ globalExtra: { _companyName: ... } }
。uploadToServer
boolean (可选) - 是否将崩溃报告发送给服务器。 如果为 false,崩溃报告将被收集并存储在崩溃目录中,但不会上传。 默认值为true
。ignoreSystemCrashHandler
boolean (可选) - 如果为true,在主进程中生成的崩溃将不会转发给系统崩溃处理器。 默认值为false
.rateLimit
boolean (可选) macOS Windows - 如果为true,将上传的崩溃次数限制到 1次/小时。 默认值为false
.compress
boolean (可选) - 如果为true,崩溃报告将压缩并上传,使用带有Content-Encoding: gzip
的头部。 默认值为true
。extra
Record<string, string> (optional) - Extra string key/value annotations that will be sent along with crash reports that are generated in the main process. 只支持string值。 在子进程中产生的崩溃将不会在子进程生成的崩溃报告中包含这些额外的参数。 在子进程中调用addExtrameter
。globalExtra
Record<string, string> (optional) - Extra string key/value annotations that will be sent along with any crash reports generated in any process. 一旦崩溃报告器启动,这些注解就无法更改。 如果一个键在global extra参数和进程特定的额外参数中出现,那么全局的那个将优先使用。 默认情况下,会包括productName
和应用程序版本,也就是Electron版本。
该方法必须在使用其他 崩溃报告器
的API之前调用。 一旦以这种方式初始化,crashpad处理器就会从所有随后创建的进程中收集崩溃信息。 崩溃报告器一旦启动就无法禁用了。
该方法应尽早地在app启动后调用,最好在 app.on('ready')
之前。 如果崩溃报告器没有在渲染器进程创建前初始化,那么渲染器进程将不会被崩溃报告器监视。
注意: 您可以通过使用process.crash()
生成一个崩溃来测试崩溃报告器。
** 注意: **,如果您在第一次调用 start
后需要发送 附加的/更新的 extra
参数,你可以调用 addExtraParameter
。
注意: 通过 extra
, globalExtra
传递,或通过addExtrameter
设置的参数对键和值的长度有限制。 键名最长是 39 字节,值不能超过 127 字节。 超过最大长度的键名将被直接忽略。 超过最大长度的键值将被截断。
注意: 此方法仅在主进程中可用。
crashReporter.getLastCrashReport()
Returns CrashReport | null - The date and ID of the last crash report. 只有已上传的崩溃报告会被返回;在磁盘上存在崩溃报告,除非上传了,否则不会返回。 如果没有上传的报告,则返回null
注意: 此方法仅在主进程中可用。
crashReporter.getUploadedReports()
Returns CrashReport[]:
返回所有已上传的崩溃报告。 每个报告包含日期以及上传ID。
注意: 此方法仅在主进程中可用。
crashReporter.getUploadToServer()
返回 boolean
- 是否应向服务器提交报告。 通过start
方法或 setUploadToServer
设置。
注意: 此方法仅在主进程中可用。
crashReporter.setUploadToServer(uploadToServer)
uploadToServer
boolean - 是否将报告提交到服务器。
通常由用户首选项控制。 如果在 start
被调用前调用,该方法将不起作用。
注意: 此方法仅在主进程中可用。
crashReporter.addExtraParameter(key, value)
key
string - 参数键,长度必须小于39个字节。value
string - 参数值,长度必须小于127个字节。
设置一个在发送崩溃报告时将额外包含的参数。 当调用 start
时, 在这里指定的值会和所有通过 extra
选项设置的值一起发送。
以这种方式添加的参数 (或通过 extra
参数到crashReporter.start
)是特定于调用进程的。 在主进程中添加extra参数,这些参数将不会与渲染器或其它子进程的崩溃报告一起发送。 同样,在渲染器进程中添加的extra参数不会与其它渲染器进程或主进程中发生的崩溃一起发送。
注意: 参数对键和值的长度有限制。 键名最长是 39 字节,值不能超过 20320 字节。 超过最大长度的键名将被直接忽略。 超过最大长度的键值将被截断。
crashReporter.removeExtraParameter(key)
key
string - 参数键,长度必须小于39个字节。
从当前的参数集中删除一个额外的参数。 未来的崩溃中将不包含此参数。
crashReporter.getParameters()
返回 Record<string, string>
- 崩溃报告器当前的“extra”参数。
在 Node 子进程中
由于Node的子进程中无法使用 require('electron')
,那么在Node的子进程中的 process
对象中的以下 API 是可用的。
process.crashReporter.start(options)
注意,崩溃报告器在主进程里启动后会自动监视各子进程,不能再在子进程里启动它。 只应在主进程里没有初始化崩溃报告器的情况下调用此方法。
process.crashReporter.getParameters()
见 crashReporter.getParameters()
。
process.crashReporter.addExtraParameter(key, value)
见 crashReporter.addExtraParameter(key, value)
。
process.crashReporter.removeExtraParameter(key)
见 crashReporter.removeExtraParameter(key)
。
崩溃报告内容
崩溃报告将发送下面 multipart/form-data
POST
型的数据给 submitURL
:
ver
string - Electron 的版本.platform
string - 例如 'win32'.process_type
string - 例如 'renderer'.guid
string - 例如 '5e1286fc-da97-479e-918b-6bfb0c3d1c72'._version
string -package.json
里的版本号._productName
string -crashReporter
options
对象中的产品名字prod
string - 基础产品的名称。 在这种情况下是Electron。_companyName
string -crashReporter
options
对象中的公司名称upload_file_minidump
File -minidump
格式的崩溃报告- All level one properties of the
extra
object in thecrashReporter
options
object.