README

Sistema de monitoramento de saúde e performance para aplicações PHP - gratuito, leve e auto-hospedado.

🎯 Motivação

A maioria dos desenvolvedores PHP não tem acesso a ferramentas robustas de APM como New Relic ou Datadog por questões de custo. PHP Health Monitor democratiza a observabilidade, oferecendo monitoramento profissional totalmente gratuito.

✨ Funcionalidades

📊 Monitoramento de Performance - Tempo de resposta, throughput, requisições lentas
🗄️ Análise de Queries SQL - Detecção de queries lentas, N+1, queries sem índices
💾 Monitoramento de Memória - Memory leaks, uso excessivo
🐛 Captura de Erros - Erros e exceções com contexto completo
🚀 Cache Metrics - Hit/miss rate para Redis e Memcached
💚 Health Checks - Verificação automática de serviços
🔔 Alertas - Notificações via Email, Webhook, Slack
📈 Dashboard Web - Interface intuitiva para visualização

🚀 Instalação

Via Composer (recomendado)

composer require phphealth/monitor

Configuração Rápida

Laravel

php artisan vendor:publish --provider="PHPHealth\Monitor\Laravel\HealthMonitorServiceProvider"
php artisan migrate

Symfony

php bin/console health-monitor:install

PHP Puro

<?php
require_once 'vendor/autoload.php';

use PHPHealth\Monitor\Monitor;

$monitor = new Monitor([
    'storage' => 'sqlite',
    'database_path' => __DIR__ . '/storage/health-monitor.db',
]);

$monitor->start();

📖 Uso Básico

Monitoramento Automático

Uma vez instalado, o monitoramento é completamente automático. Não precisa modificar seu código.

Acessar Dashboard

Navegue para: http://seu-dominio.com/health-monitor

Credenciais padrão:

Usuário: admin
Senha: admin (altere imediatamente!)

Configurar Alertas

// config/health-monitor.php

return [
    'alerts' => [
        'slow_request' => [
            'enabled' => true,
            'threshold' => 1000, // ms
            'channels' => ['email', 'slack'],
        ],
        'high_error_rate' => [
            'enabled' => true,
            'threshold' => 5, // porcentagem
            'channels' => ['slack'],
        ],
    ],
    
    'channels' => [
        'email' => [
            'to' => 'dev@example.com',
        ],
        'slack' => [
            'webhook_url' => env('SLACK_WEBHOOK_URL'),
        ],
    ],
];

📊 Screenshots

Dashboard Principal

Análise de Requisições

Queries SQL

🏗️ Arquitetura

┌─────────────┐
│  Aplicação  │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Collector  │ ◄── Intercepta requisições, queries, erros
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Buffer    │ ◄── Armazena temporariamente (performance)
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Storage   │ ◄── SQLite/MySQL/PostgreSQL
└──────┬──────┘
       │
       ├──────────┐
       ▼          ▼
┌──────────┐  ┌─────────┐
│ Analyzer │  │  Alerts │
└────┬─────┘  └────┬────┘
     │             │
     ▼             ▼
┌──────────────────────┐
│     Dashboard        │
└──────────────────────┘

🎯 Roadmap

v1.0.0 - MVP (Em Desenvolvimento)

Estrutura base do projeto
Documentação inicial
Collector de requisições HTTP
Collector de queries SQL (MySQL)
Storage SQLite
Dashboard básico
Testes unitários

v1.1.0 - Expansão

Collector de erros/exceções
Monitoramento de memória
Gráficos e estatísticas
Alertas por email
Integração Laravel

v1.2.0 - Avançado

Suporte PostgreSQL
Health checks
Alertas Slack/Webhook
Integrações Symfony e WordPress
API REST

🤝 Contribuindo

Contribuições são muito bem-vindas! Veja CONTRIBUTING.md para detalhes.

Como Contribuir

Fork o projeto
Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
Push para a branch (git push origin feature/MinhaFeature)
Abra um Pull Request

📝 Requisitos

PHP >= 7.4
Extensões: PDO, JSON
Opcionais: Redis, Memcached (para monitoramento de cache)

🔒 Segurança

Se você descobrir alguma vulnerabilidade de segurança, por favor envie um email para francielefernandes126@gmail.com ao invés de usar o issue tracker.

📄 Licença

Este projeto está sob a licença MIT. Veja LICENSE para mais detalhes.

🙏 Agradecimentos

Inspirado em ferramentas como New Relic, Datadog e Laravel Telescope
Comunidade PHP por todo o suporte

📞 Suporte

Feito com ❤️ para a comunidade PHP

phphealth / monitor

Maintainers

Package info

Statistics

Security