CodeIgniter集成Opbeat监控教程

Opbeat_CodeIgniter 已彻底失效，因其依赖的 opbeat/opbeat-php SDK 自2017年起停止维护，无法兼容PHP 7.4+、CodeIgniter 3.1.11+及现代异常体系，且Opbeat服务端早在2018年被Elastic收购后下线，所有上报地址已不可用；当前唯一可靠方案是迁移到Elastic官方的elastic/apm-agent-php代理（通过日志桥接实现APM监控），或回归CodeIgniter原生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() 并自行落盘。

到这里，我们也就讲完了《CodeIgniter集成Opbeat监控教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于CodeIgniter的知识点！