PHP后端服务监控体系-源码库

PHP后端服务监控体系：从零搭建实战指南

作为一名在PHP领域摸爬滚打多年的开发者，我深知服务监控的重要性。记得有一次线上服务突然崩溃，由于缺乏完善的监控体系，我们花了整整两个小时才定位到问题。从那以后，我开始系统性地构建PHP后端监控体系，今天就把这些实战经验分享给大家。

一、基础监控指标搭建

首先我们需要关注最基础的运行指标。我推荐使用Prometheus + Grafana的组合，这是目前最流行的监控方案。


// 安装Prometheus PHP客户端
composer require promphp/prometheus_client_php

// 在应用中集成基础指标收集
class MetricsCollector {
    private $registry;
    
    public function __construct() {
        $this->registry = new PrometheusCollectorRegistry(
            new PrometheusStorageInMemory()
        );
        
        // 定义请求计数器
        $this->requestCounter = $this->registry->getOrRegisterCounter(
            'app',
            'http_requests_total',
            'Total HTTP requests',
            ['method', 'endpoint', 'status_code']
        );
        
        // 定义响应时间直方图
        $this->responseTimeHistogram = $this->registry->getOrRegisterHistogram(
            'app',
            'http_response_time_seconds',
            'HTTP response times',
            ['endpoint'],
            [0.1, 0.5, 1.0, 2.0, 5.0]
        );
    }
}

二、应用性能监控(APM)集成

基础指标只能看到表面现象，要深入分析性能瓶颈，APM工具必不可少。我强烈推荐使用New Relic或者国产的SkyWalking。


# 安装New Relic PHP代理
wget -O newrelic-php5-agent.tar.gz https://download.newrelic.com/php_agent/archive/latest/newrelic-php5-agent-latest.tar.gz
tar -xzf newrelic-php5-agent.tar.gz
cd newrelic-php5-agent-*
./newrelic-install install

配置文件中需要设置：


// newrelic.ini 配置
newrelic.appname = "你的应用名称"
newrelic.license = "你的许可证密钥"
newrelic.browser_monitoring.auto_instrument = true

三、日志收集与分析

日志是排查问题的关键证据。我习惯使用ELK Stack（Elasticsearch + Logstash + Kibana）来构建日志系统。


// 结构化日志记录
class StructuredLogger {
    public function logRequest($request, $response, $executionTime) {
        $logData = [
            'timestamp' => date('c'),
            'level' => 'INFO',
            'service' => 'php-backend',
            'method' => $request->getMethod(),
            'uri' => $request->getUri(),
            'status_code' => $response->getStatusCode(),
            'execution_time' => $executionTime,
            'user_agent' => $request->getHeader('User-Agent')[0] ?? '',
            'ip' => $request->getServerParams()['REMOTE_ADDR'] ?? ''
        ];
        
        file_put_contents(
            '/var/log/php-app/access.log',
            json_encode($logData) . PHP_EOL,
            FILE_APPEND
        );
    }
}

四、健康检查与告警

监控的最终目的是及时发现问题并告警。我通常会设置多层次的健康检查：


// 健康检查端点
class HealthCheckController {
    public function check() {
        $checks = [
            'database' => $this->checkDatabase(),
            'redis' => $this->checkRedis(),
            'disk_space' => $this->checkDiskSpace(),
            'memory_usage' => $this->checkMemoryUsage()
        ];
        
        $allHealthy = true;
        foreach ($checks as $check) {
            if (!$check['healthy']) {
                $allHealthy = false;
                break;
            }
        }
        
        return json_encode([
            'status' => $allHealthy ? 'healthy' : 'unhealthy',
            'timestamp' => time(),
            'checks' => $checks
        ]);
    }
    
    private function checkDatabase() {
        try {
            // 数据库连接检查
            $pdo = new PDO(...);
            return ['healthy' => true, 'message' => 'Database connection OK'];
        } catch (Exception $e) {
            return ['healthy' => false, 'message' => $e->getMessage()];
        }
    }
}