5分钟上手CodeIgniter日志分析：从0到1搭建应用监控系统
项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter 你是否曾因用户投诉"页面突然打不开"却找不到原因而焦头烂额？还在为定位生产环境的偶发bug反复调试代码？CodeIgniter框架内置的日志系统（Log.php）正是解决这些痛点的利器。本文将带你从配置到实战，用最简洁的方式构建完整的应用监控体系，实时掌握系统健康状态与用户行为轨迹。
日志系统核心配置：3个参数锁定关键信息
CodeIgniter的日志功能默认处于关闭状态，需要通过配置文件启用。核心配置位于application/config/config.php，主要包含三个关键参数：
// 日志级别设置（默认为0关闭）
$config['log_threshold'] = 2; // 1=错误 2=调试 3=信息 4=全部
// 日志存储路径（默认application/logs/）
$config['log_path'] = APPPATH.'logs/';
// 日期格式（影响日志可读性）
$config['log_date_format'] = 'Y-m-d H:i:s.u'; // 精确到微秒
最佳实践：开发环境建议设为2（DEBUG），生产环境设为1（ERROR）配合3（INFO）关键业务节点日志。日志路径需确保服务器有写入权限，可通过以下命令检查：
cd gh_mirrors/co/CodeIgniter && ls -ld application/logs/
日志记录实战：4种场景覆盖90%监控需求
1. 系统错误自动捕获
框架会自动记录PHP错误、数据库异常等关键系统事件。当开启日志级别1时，所有错误将写入类似log-2025-11-01.php的文件，典型错误日志格式：
ERROR - 2025-11-01 14:30:45 --> 数据库连接失败: Access denied for user 'root'@'localhost'
2. 自定义业务日志
在控制器或模型中使用log_message()函数记录关键业务流程：
// 记录用户登录事件（controllers/Auth.php）
public function login() {
$user = $this->input->post('username');
log_message('info', "用户登录: $user 来自IP: ".$this->input->ip_address());
// 登录逻辑...
if ($success) {
log_message('debug', "登录成功: $user 会话ID: ".session_id());
} else {
log_message('error', "登录失败: $user 尝试次数: ".++$this->login_attempts);
}
}
3. 性能瓶颈追踪
结合Benchmark类记录关键操作耗时：
// 监控数据库查询性能（models/Product_model.php）
public function get_products() {
$this->benchmark->mark('query_start');
$result = $this->db->get('products')->result();
$this->benchmark->mark('query_end');
log_message('info', "产品查询耗时: ".
$this->benchmark->elapsed_time('query_start', 'query_end'));
return $result;
}
4. 用户行为轨迹分析
通过钩子（Hooks）实现全局用户行为记录：
// 配置文件开启钩子（config.php）
$config['enable_hooks'] = TRUE;
// 钩子配置（application/config/hooks.php）
$hook['post_controller'] = array(
'class' => 'Log_hook',
'function' => 'record_visit',
'filename' => 'Log_hook.php',
'filepath' => 'hooks'
);
// 钩子实现（application/hooks/Log_hook.php）
class Log_hook {
function record_visit() {
$CI =& get_instance();
log_message('info', "页面访问: ".current_url().
" 来源: ".$CI->input->get_request_header('Referer'));
}
}
日志分析工具链：从原始日志到可视化报表
日志文件结构解析
默认日志文件位于application/logs/目录，采用PHP文件格式存储以防止直接访问。典型日志条目包含级别、时间戳和消息三部分：
INFO - 2025-11-01 10:15:30.123456 --> 用户登录: admin 来自IP: 192.168.1.100
DEBUG - 2025-11-01 10:15:32.789012 --> 登录成功: admin 会话ID: abc123xyz
实时监控脚本
创建application/controllers/Log_analyzer.php实现基础分析功能：
class Log_analyzer extends CI_Controller {
public function index() {
$log_file = $this->input->get('file') ?: 'log-'.date('Y-m-d').'.php';
$content = file_get_contents(APPPATH.'logs/'.$log_file);
// 统计错误数量
preg_match_all('/ERROR - (.*?) --> (.*)/', $content, $errors);
// 提取最近10条访问记录
preg_match_all('/INFO - (.*?) --> 页面访问: (.*?)\s/', $content, $visits);
$data = [
'error_count' => count($errors[0]),
'recent_visits' => array_slice(array_reverse($visits[0]), 0, 10)
];
$this->load->view('log_analyzer', $data);
}
}
可视化监控面板
配套视图文件application/views/log_analyzer.php：
<!DOCTYPE html>
<html>
<head>
<title>应用监控面板</title>
<style>
.error { color: #dc3545; font-weight: bold; }
.visit { color: #28a745; }
.stats { display: flex; gap: 20px; margin: 20px 0; }
.card { padding: 15px; border: 1px solid #ddd; border-radius: 8px; }
</style>
</head>
<body>
<h1>应用监控中心</h1>
<div class="stats">
<div class="card">
<h3>今日错误数</h3>
<p class="error"><?= $error_count ?></p>
</div>
<div class="card">
<h3>最近访问</h3>
<?php foreach($recent_visits as $visit): ?>
<p class="visit"><?= $visit ?></p>
<?php endforeach ?>
</div>
</div>
</body>
</html>
高级技巧：日志系统扩展与优化
日志轮转防止磁盘占满
通过配置application/config/config.php设置日志文件名格式：
// 按小时分割日志（需自定义Log类）
$config['log_filename'] = 'log-'.date('Y-m-d-H').'.php';
或使用Linux的logrotate工具，创建/etc/logrotate.d/codeigniter：
/var/www/gh_mirrors/co/CodeIgniter/application/logs/*.php {
daily
missingok
rotate 14
compress
delaycompress
notifempty
create 0644 www-data www-data
}
敏感信息过滤
重写日志格式化方法（创建application/core/MY_Log.php）：
class MY_Log extends CI_Log {
protected function _format_line($level, $date, $message) {
// 过滤手机号、邮箱等敏感信息
$message = preg_replace('/1[3-9]\d{9}/', '1**********', $message);
$message = preg_replace('/\w+@\w+\.\w+/', '***@hidden.com', $message);
return parent::_format_line($level, $date, $message);
}
}
常见问题与解决方案
日志文件不生成？
- 检查目录权限：
chmod -R 0755 application/logs/ - 确认配置：
$config['log_threshold']是否大于0 - 查看PHP错误日志：
tail -f /var/log/php/error.log
日志信息不完整？
- 检查日志级别是否过低，DEBUG级需要设为2
- 确认
log_message()调用位置是否在异常捕获块内 - 生产环境建议开启
error_reporting(E_ALL & ~E_NOTICE)
性能影响？
CodeIgniter日志系统采用高效的文件追加模式，基准测试显示单条日志写入耗时<0.1ms。建议：
- 生产环境避免过多DEBUG级日志
- 高频操作（如循环内）慎用日志记录
- 考虑使用Redis等异步日志方案
通过本文介绍的方法，你已掌握CodeIgniter日志系统的配置、使用和扩展技巧。合理利用日志不仅能快速定位问题，更能通过用户行为分析发现产品优化点。建议立即在项目中实施基础监控配置，并逐步完善关键业务节点的日志记录，让应用问题无所遁形。
想进一步提升监控能力？可探索将日志接入ELK栈（Elasticsearch+Logstash+Kibana）或使用system/libraries/Profiler.php实现性能分析。完整日志系统源码可参考system/core/Log.php的实现。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
