errsole.js告警通知实战Email与Slack即时捕获关键错误报警【免费下载链接】errsole.jsCollect, Store, and Visualize Logs with a Single Module项目地址: https://gitcode.com/gh_mirrors/er/errsole.jserrsole.js 是一个用单个模块就能完成日志收集、存储与可视化的 Node.js 开源日志工具而errsole.js告警通知功能则能在应用崩溃或出现关键错误时第一时间把错误推送到你的 Email 邮箱或 Slack 工作群。本文将以实战方式带你快速完成 errsole.js Email 告警与 Slack 告警的配置让关键错误报警不再迟到。为什么需要 errsole.js 告警通知日志记录只是第一步真正让运维省心的是即时错误报警。想象一下深夜 2 点支付接口悄悄挂了如果没有 errsole.js 告警通知你要等到第二天早上用户投诉才发现问题。而配置好 Email 与 Slack 告警后错误发生的几秒内通知就会送达错误信息、应用名、环境名、服务器名以及直达日志页面的链接一应俱全。errsole.js 的告警通知能力体现在两方面自动捕获未捕获的异常Uncaught Exception和应用崩溃会自动触发告警相关逻辑见 alerts.js。手动触发通过errsole.alert()函数可以把任何你觉得关键的事件主动推送出去。快速接入 errsole.js 日志工具在配置告警之前先把 errsole.js 接入你的 Node.js 应用。以 SQLite 存储为例安装并初始化后日志即开始收集const errsole require(errsole); const errsoleSQLite require(errsole-sqlite); errsole.initialize({ storage: errsoleSQLite({ filePath: /tmp/errsole.log }) });生产环境建议使用 MySQL、PostgreSQL 或 MongoDB 作为集中式日志存储具体接入方式可参考 sqlite-storage.md、mysql-storage.md 等官方文档。接入完成后浏览器打开 Errsole Web Dashboard 即可查看日志。Email 告警配置3 分钟搞定 SMTP 邮件通知errsole.js Email 告警配置是大多数团队的第一选择无需额外安装服务只要有一个可用的 SMTP 邮箱即可。第一步准备 SMTP 信息你需要准备以下信息SMTP 服务器地址host与端口port邮箱账号与授权码username / password发件人邮箱sender收件人邮箱列表recipients支持多人提示端口使用 465 时errsole.js 会自动启用 SSL 加密连接。第二步在 Web Dashboard 中填写配置登录 Errsole Web Dashboard进入 Integrations集成页面找到 Email 一栏依次填入 SMTP Host、Port、Username、Password、Sender 以及收件人地址保存即可。配置会存储到emailIntegration配置项中前端表单逻辑见 Integrations.js。第三步发送测试邮件保存后点击Test Notification按钮errsole.js 会立即向收件人发送一封测试通知对应源码中的testEmailAlert方法。如果没收到请检查 SMTP 端口、授权码和防火墙设置页面上也会有相应错误提示。Slack 告警配置借助 Webhook 直达工作群errsole.js Slack 告警配置适合团队协作场景错误通知直接出现在群聊里艾特相关同事响应速度更快。第一步创建 Slack Incoming Webhook在你的 Slack 工作区中进入 Incoming Webhook 应用管理页面创建一个新的 Webhook选择目标频道复制生成的 Webhook URL。这是 Slack 告警的唯一必填项。第二步在 Dashboard 中粘贴 Webhook URL回到 Errsole 的 Integrations 页面在 Slack 一栏粘贴 Webhook URL 并保存。errsole.js 会把它写入slackIntegration配置项。之后所有告警都会以 Errsole 机器人身份通过 Block Kit 富文本卡片推送到你指定的频道内容包括错误消息、应用名、环境名、服务器名以及点击直达日志的链接。第三步测试 Slack 告警同样点击Test Notification你的 Slack 频道应立刻收到一条测试卡片。测试通过后errsole.js Slack 告警配置就算大功告成。用 errsole.alert() 主动触发关键错误报警除了自动捕获errsole.js 还提供alert日志级别让你主动发送关键错误报警。errsole.alert()用法和errsole.log()完全一致可以传字符串、数字、对象甚至 Error 对象errsole.alert(数据库连接池耗尽); errsole.alert(new Error(第三方支付接口超时)); errsole.meta({ orderId: A1024 }).alert(订单状态异常需要人工介入);调用后errsole.js 会记录该日志并同时向已配置的 Email 和 Slack 渠道推送告警相关实现见 lib/main/index.js 与 alerts.js。更丰富的日志函数error、warn、meta等可以参考 advanced-logging-functions.md。告警通知规则去重、计数与时区errsole.js 的告警通知内置了防打扰机制避免告警风暴小时级去重同一服务器上相同内容的关键错误报警在 1 小时内不会重复通知防止错误刷屏。今日次数统计通知中会显示该错误今天已发生多少次如 This alert has occurred 5 times today帮你判断问题的严重程度。UTC 时区通知中的时间统一使用 UTC 时区跨时区团队不会混淆。直达日志链接每条通知都附带了日志详情页链接点击即可定位到具体错误现场。这些规则由 alerts.js 中的checkAlertStatus与去重逻辑实现基于消息内容的 SHA-256 哈希来识别重复告警。暂停与恢复告警通知在排障或维护窗口期间你可能不想被通知打扰。errsole.js 的 Integrations 页面为 Email 和 Slack 分别提供了Pause Notifications暂停通知与Resume Notifications恢复通知按钮一键即可切换配置无需删除。当告警被暂停时页面会以橙色状态清晰提示。写在最后errsole.js 告警通知让日志收集升级为主动防御Email 兜底、Slack 联动配合errsole.alert()主动上报关键错误报警任何异常都逃不出你的监控网。本文介绍的 Email 与 Slack 两种通道可以同时开启互为备份。建议你在部署后先发一条测试通知确认链路畅通再放心上线。下次应用再出问题你一定是第一个知道的人。【免费下载链接】errsole.jsCollect, Store, and Visualize Logs with a Single Module项目地址: https://gitcode.com/gh_mirrors/er/errsole.js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考