opbeat_codeigniter已完全不可用,因其依赖废弃的opbeat/opbeat-php sdk(2017年停更),不兼容php 7.4+、ci 3.1.11+及现代php异常体系,且opbeat服务端已下线;推荐改用elastic/apm-agent-php代理或内置profiler+自定义日志分析方案。

CodeIgniter 官方不支持 Opbeat,且 Opbeat 已于 2018 年被 Elastic 收购并整合进 Elastic APM,Opbeat_CodeIgniter 这个第三方扩展包早已停止维护、不兼容 PHP 7.4+ 和 CodeIgniter 3.1.11+(更不用说 CI4),强行接入会导致 Class 'Opbeat\Opbeat' not found 或 Call to undefined method CI_Output::set_profiler_sections() 类错误。
为什么 Opbeat_CodeIgniter 现在基本不能用
这个包依赖已废弃的 opbeat/opbeat-php SDK(最后更新是 2017 年),而该 SDK 底层使用 ext-curl + ext-json 的硬编码方式上报数据,与 CodeIgniter 3.1.10 后引入的 CI_Output 重构、PSR-4 自动加载机制存在冲突。更关键的是:它无法处理现代 PHP 的严格类型提示、匿名类和 Throwable 统一异常体系。
- PHP 7.4+ 下会触发
Deprecated: Non-static method Opbeat_CodeIgniter::init() should not be called statically - CI 3.1.11+ 中
$this->output不再直接暴露原始响应对象,导致钩子注入失败 - 所有上报 endpoint(
https://intake.opbeat.com)已永久下线,HTTP 请求直接超时或返回 404
替代方案:用 Elastic APM 代理 + CodeIgniter 原生日志桥接
如果你仍需 APM 级监控,唯一可行路径是绕过任何 CI 封装包,改用 Elastic 官方推荐的 elastic/apm-agent-php(v1.6+)作为独立进程代理,并通过日志管道桥接关键指标。步骤如下:
- 安装 agent:
composer require elastic/apm-agent-php,然后按官方文档配置ELASTIC_APM_SERVER_URL和 service name - 禁用 CI 自带 profiler(避免干扰):
$config['enable_profiler'] = FALSE;在application/config/profiler.php中 - 在入口文件
index.php顶部手动启动 agent:elastic_apm_start(); - 在控制器中用
log_message('info', 'APM_TRACE_ID: ' . elastic_apm_get_current_transaction_id());手动打点关联日志
注意:agent 默认不捕获 SQL 查询详情,需额外开启 ELASTIC_APM_CAPTURE_BODY=errors 并配合 CI 的 $this->db->last_query() 手动补全。
更轻量、更可控的内置方案:Profiler + 自定义日志分析
对大多数中小项目,$this->output->enable_profiler(TRUE) 配合合理日志分级,比强行套用已死的 Opbeat 更可靠、更易调试。
- 只在开发环境启用:
if (ENVIRONMENT === 'development') $this->output->enable_profiler(TRUE); - 重点打开
queries和benchmarks节点,关闭config和memory_usage(后者在 CLI 模式下不准) - 把 profiler 输出重定向到文件而非页面底部:
$this->output->set_profiler_sections(['queries' => TRUE, 'benchmarks' => TRUE]);,再用file_put_contents(FCPATH . 'logs/profiler_' . date('Y-m-d') . '.log', $this->output->get_profiler_html()); - 用
log_message('debug', 'SQL: ' . $this->db->last_query() . ' | Time: ' . $this->db->query_time);补充慢查询上下文
真正容易被忽略的是:profiler 数据默认不写入 application/logs/,而是直接 echo 到 HTML body 底部——这意味着你无法用 logrotate 或 ELK 收集,必须显式调用 get_profiler_html() 并自行落盘。











