<?php
/**
* Router Integration Patch for Monitor
*
* This file provides instructions for integrating the Monitor class into Router.php
*
* INTEGRATION STEPS:
* ==================
*
* 1. Add Monitor property to Router class (around line 13):
* private ?Monitor $monitor = null;
*
* 2. Initialize Monitor in constructor (around line 35):
* // Initialize monitor
* if (!empty($this->apiConfig['monitoring']['enabled'])) {
* $this->monitor = new Monitor($this->apiConfig['monitoring'] ?? []);
* }
*
* 3. Record request in route() method (around line 70, after rate limit headers):
* // Record request metric
* if ($this->monitor) {
* $this->monitor->recordRequest([
* 'method' => $_SERVER['REQUEST_METHOD'] ?? 'UNKNOWN',
* 'action' => $query['action'] ?? null,
* 'table' => $query['table'] ?? null,
* 'ip' => $_SERVER['REMOTE_ADDR'] ?? 'unknown',
* 'user' => $this->auth->getCurrentUser()['username'] ?? null,
* ]);
* }
*
* 4. Record security events for rate limit (around line 80):
* if (!$this->rateLimiter->checkLimit($identifier)) {
* // ... existing logger code ...
*
* // Record security event
* if ($this->monitor) {
* $this->monitor->recordSecurityEvent('rate_limit_hit', [
* 'identifier' => $identifier,
* 'requests' => $this->rateLimiter->getRequestCount($identifier),
* ]);
* }
*
* $this->rateLimiter->sendRateLimitResponse($identifier);
* }
*
* 5. Record security events for authentication (around line 100):
* // After successful auth:
* if ($this->monitor) {
* $this->monitor->recordSecurityEvent('auth_success', [
* 'method' => 'jwt',
* 'user' => $user,
* ]);
* }
*
* // After failed auth:
* if ($this->monitor) {
* $this->monitor->recordSecurityEvent('auth_failure', [
* 'method' => 'jwt',
* 'reason' => 'Invalid credentials',
* 'ip' => $_SERVER['REMOTE_ADDR'] ?? 'unknown',
* ]);
* }
*
* 6. Modify logResponse() method to record metrics (around line 450):
* private function logResponse($data, int $code, array $query): void
* {
* $executionTime = (microtime(true) - $this->requestStartTime) * 1000;
* $responseSize = strlen(json_encode($data));
*
* // Existing logger code...
*
* // Record response metric
* if ($this->monitor) {
* $this->monitor->recordResponse($code, $executionTime, $responseSize);
* }
* }
*
* 7. Record errors in catch block (around line 400):
* catch (\Exception $e) {
* // Existing logger code...
*
* // Record error metric
* if ($this->monitor) {
* $this->monitor->recordError($e->getMessage(), [
* 'file' => $e->getFile(),
* 'line' => $e->getLine(),
* 'action' => $query['action'] ?? null,
* 'table' => $query['table'] ?? null,
* ]);
* }
*
* // Existing response code...
* }
*/
// This file is documentation only - no executable code
|
Download
