Errbit应用管理指南：从基础配置到高级过滤技巧

Errbit应用管理指南：从基础配置到高级过滤技巧

errbit The open source error catcher that's Airbrake API compliant 项目地址: https://gitcode.com/gh_mirrors/er/errbit

什么是Errbit应用

在Errbit错误监控系统中，"应用"（App）是一个核心概念，它代表了一个接收错误通知的逻辑容器。每个连接到Errbit的外部应用部署都需要在Errbit中创建一个对应的应用记录，这个记录包含两个关键信息：

1. 应用名称：用于标识和区分不同的应用
2. 唯一API密钥：用于验证错误通知的来源

当你的应用程序发生错误时，错误通知会通过这个API密钥发送到对应的Errbit应用中，实现错误的集中收集和管理。

应用版本控制策略

为什么需要版本控制

在实际生产环境中，我们经常会遇到这样的情况：同一个应用可能有多个版本同时运行，而其中一些旧版本可能已经不再维护或者即将下线。这时候，来自这些旧版本应用的错误通知可能不再具有实际意义。

如何设置版本控制

Errbit提供了"最新应用版本"（LATEST APP VERSION）字段来解决这个问题：

1. 在应用配置中设置当前最新的应用版本号
2. Errbit会自动忽略来自低于这个版本号的应用错误通知

重要提示：要使版本控制生效，你的错误通知器必须正确设置context.version字段。这个字段应该包含发送错误的应用的实际版本号。

高级错误过滤技巧

默认视图的问题

默认情况下，Errbit的问题页面会显示所有应用的最新错误。这在某些场景下可能会带来不便，特别是当：

• 某些应用产生的错误特别频繁
• 某些应用的错误暂时不需要关注
• 你想专注于特定应用的错误分析

使用URL参数过滤

Errbit支持通过URL参数实现高级过滤，语法格式为： /problems?filter=-app:应用名1%20-app:应用名2

实际案例： 假设你有三个应用：awesomeapp（重要）、noisy_app（噪音）和another_noisy_app（噪音），你可以这样访问URL来排除噪音应用： /problems?filter=-app:noisy_app%20-app:another_noisy_app

注意：

• 目前这个功能只能通过URL参数使用，没有图形界面支持
• 参数中的空格需要使用URL编码%20表示

自定义回溯链接配置

回溯链接的作用

Errbit的错误回溯信息默认支持点击跳转到代码仓库查看具体代码。系统原生支持GitHub和Bitbucket，但也可以通过配置支持其他代码托管平台。

配置模板变量

自定义回溯链接模板支持以下变量：

| 变量名 | 描述 | |------------|-----------------------------| | %{branch} | 代码分支名称 | | %{file} | 错误发生的相对文件路径 | | %{line} | 错误发生的行号 | | %{ebranch} | URL编码后的分支名称 | | %{efile} | URL编码后的文件路径 |

常见平台配置示例

1. Gitea：

   https://errbit.example.com/repo/name/src/branch/%{branch}/%{file}#L%{line}
   

2. Gitlab：

   https://errbit.example.com/repo/name/-/blob/%{branch}/%{file}#L%{line}
   

通过合理配置这些模板，你可以让开发人员直接从错误回溯跳转到对应的代码位置，大大提高错误排查效率。

最佳实践建议

1. 命名规范：为应用设置清晰、一致的命名规则，便于识别和管理
2. 版本管理：在每次发布新版本时，及时更新LATEST APP VERSION字段
3. 过滤收藏：将常用的过滤URL加入书签，快速访问特定视图
4. 团队协作：确保团队成员了解如何配置和使用自定义回溯链接

通过合理利用Errbit的这些应用管理功能，你可以显著提升错误监控的效率和针对性，让团队能够更专注于真正需要解决的问题。

errbit The open source error catcher that's Airbrake API compliant 项目地址: https://gitcode.com/gh_mirrors/er/errbit