Opbeat 已于 2019 年被 Elastic 收购并整合进 Elastic APM，CodeIgniter 官方从未内置 Opbeat 支持，也无官方 Opbeat_CodeIgniter 扩展包；当前直接使用该旧包会导致 Composer 依赖失败、类未定义、PHP 版本不兼容及连接错误。
Opbeat 已于 2019 年被 Elastic 收购并整合进 Elastic APM，CodeIgniter 官方从未内置 Opbeat 支持，也没有维护过 Opbeat_CodeIgniter 官方扩展包。当前（2026年）直接使用 Opbeat_CodeIgniter 会导致 Composer 依赖失败、类未定义、PHP 版本不兼容（如 PHP 8.1+）、以及连接 404 或认证拒绝等错误。
你实际需要的是：在 CodeIgniter 中接入现代 APM 工具，且能兼容其轻量架构和无自动 DI 的特点。
为什么找不到可用的 Opbeat_CodeIgniter 包
搜索 Packagist 或 GitHub 可确认：opbeat/opbeat-php 和所有基于它的 CodeIgniter 封装包（如 opbeat/codeigniter）均已归档、不再更新，最后提交集中在 2017–2018 年。它们依赖已废弃的 opbeat-api v1 接口，而 Elastic APM 使用完全不同的 agent 协议（HTTP + JSON over intake API）。
常见报错包括：
Class 'Opbeat\CodeIgniter\Opbeat' not foundCall to undefined method Opbeat::captureException()cURL error 6: Could not resolve host: intake.opbeat.com
用 Elastic APM 替代 Opbeat 的最小可行接入
CodeIgniter 不依赖 PSR-15 中间件或自动 instrument，所以不能像 Laravel 那样一键 composer require elastic/apm-agent。但你可以通过手动 hook 实现核心能力：错误捕获 + 请求性能 + SQL 耗时。
操作步骤：
- 安装官方 PHP agent：
composer require elastic/apm-agent（支持 PHP 7.4–8.3） - 在
index.php顶部启用 agent（早于 CodeIgniter 加载）：require_once __DIR__.'/vendor/autoload.php'; \Elastic\Apm\Agent::start([ 'service_name' => 'ci-app', 'server_url' => 'http://localhost:8200', // 或你的 APM Server 地址 'environment' => defined('ENVIRONMENT') ? ENVIRONMENT : 'development', ]); - 在主控制器基类（如
MY_Controller）构造函数中手动开始事务：$this->apmTransaction = \Elastic\Apm\Agent::getInstance()->beginTransaction( $this->router->fetch_class() . '/' . $this->router->fetch_method(), 'request' ); - 在析构函数或
_output方法中结束事务：if ($this->apmTransaction) { $this->apmTransaction->end(); }
注意：SQL 查询追踪需额外 patch CI_DB_driver，在 query() 前后调用 startSpan() / endSpan()，否则只会看到“PHP request”总耗时，看不到慢查询。
更轻量、更匹配 CodeIgniter 的替代方案
如果你不需要分布式追踪或跨服务链路，仅需快速定位慢请求和错误，以下方案更贴合 CodeIgniter 的哲学：
-
内置 Profiler + 日志增强：开启
$this->output->enable_profiler(TRUE)，配合log_threshold = 4，再用tail -f application/logs/log-*.php | grep -E "(ERROR|query.*ms)"实时过滤，零依赖、零部署成本 -
自建简易监控端点：在某个控制器中返回
memory_get_peak_usage()、microtime(true) - $_SERVER['REQUEST_TIME_FLOAT']、$this->db->queries数量与总耗时，前端轮询该接口画趋势图 -
Logstash + Filebeat + Kibana：将
application/logs/目录作为日志源，用 Filebeat 收集，Kibana 做错误频次、响应时间 P95 等看板 —— 不侵入代码，适合生产环境灰度上线
这些方式不依赖外部 SaaS，也不要求修改框架核心，适配 CodeIgniter “显式优于隐式”的设计原则。
真正要警惕的兼容性陷阱
很多教程仍推荐复制粘贴老旧的 Opbeat_CodeIgniter 类库到 application/libraries/，但这类代码通常：
- 硬编码
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)，违反现代 TLS 安全要求 - 把
$_POST全量上报，存在敏感数据泄露风险（如密码字段） - 未处理 CI 的钩子（hook）生命周期，导致事务在 AJAX 请求中提前关闭
- 与 CodeIgniter 4 的命名空间冲突，无法在 CI4 项目中复用
与其修复一个已死亡的集成，不如用 20 行代码把关键指标写进日志，再交给专业日志平台处理 —— 这才是 CodeIgniter 开发者该有的务实路径。
