README

🇵🇸 Free Palestine

🤖💬 Chat With Your Logs Using Smart AI 💬🤖

Transform debugging from tedious to effortless! 🔍 → ⚡
Stop digging through dashboards and complex queries. Just ask your logs directly in plain English.

🐌 Traditional vs ⚡ AI-Powered

🐌 Traditional Way

Open Kibana/ElasticSearch dashboards
Write complex Datadog queries
Manual grep through log files
Filter thousands of log entries
Correlate timestamps & request IDs by hand
Spend hours finding root causes

Result: Hours of manual work 😩

⚡ AI Agent Way

// Just ask naturally!
$agent->ask("Why did payments fail?");
$agent->ask("What caused the 3 PM outage?");
$agent->ask("Show me timeout patterns");
$agent->ask("How many users affected?");

Result: Instant intelligent answers 🧠

💬 Real Examples - Ask Anything!

$agent = new LogInspectorAgent($platform, $model, $store);

// 🚨 Checkout Issues
$result = $agent->ask('Why did the last checkout request fail?');
// → "Payment gateway timeout after 30 seconds. The last 3 checkout attempts 
//    all failed with 'gateway_timeout' errors between 14:23-14:25."

// 🔍 Database Problems  
$result = $agent->ask('Show me all database errors from the last hour');
// → "Found 12 database connection failures. Pattern shows connection pool 
//    exhaustion starting at 15:30, affecting user authentication service."

// 🌊 Performance Issues
$result = $agent->ask('What caused the sudden spike in API response times?');
// → "Memory leak in Redis connection causing 2.5s delays. Started after 
//    deployment at 13:45, affecting 847 requests per minute."

// 🔐 Security Monitoring
$result = $agent->ask('Are there any suspicious login attempts?');
// → "Detected brute force attack from IP 192.168.1.100. 156 failed login 
//    attempts in 5 minutes targeting admin accounts."

// 📊 Impact Assessment
$result = $agent->ask('How many users were affected by the outage?');
// → "Based on error logs, approximately 2,341 unique users experienced 
//    service disruption between 14:15-14:32 during the database incident."

⚠️ EXPERIMENTAL - Built on Symfony AI (experimental). Not for production use yet.

✨ What Makes It Special

🔍 Semantic Search - Understands context, not just keywords
🧠 AI Analysis - Explains what happened and why
⚡ Lightning Fast - Get answers in seconds, not hours
🛠️ Tool-Based - Extensible architecture with Symfony AI
📊 Vector Powered - Smart similarity matching
🔄 Fallback Ready - Works even when AI is unavailable

🚀 Quick Start

Install

composer require hakam/ai-log-inspector-agent

Setup & Use

<?php
use Hakam\AiLogInspector\Agent\Agent\LogInspectorAgent;use Symfony\AI\Platform\Capability;use Symfony\AI\Platform\Model;use Symfony\AI\Store\Bridge\Local\InMemoryStore;

// Configure your AI platform
$platform = new YourAIPlatform(); 
$model = new Model('your-model', [
    Capability::TOOL_CALLING,
    Capability::INPUT_TEXT,
    Capability::OUTPUT_TEXT
]);
$store = new InMemoryStore();

// Create the agent
$agent = new LogInspectorAgent($platform, $model, $store);

// Start asking questions!
$result = $agent->ask('Why did the checkout fail?');
echo $result->getContent();

Advanced Questions

// Root cause analysis
$agent->ask('What caused the 500 errors in payment service?');

// Timeline investigation  
$agent->ask('What happened before the database failure?');

// Pattern discovery
$agent->ask('Are there recurring memory leak patterns?');

// Security investigation
$agent->ask('Suspicious auth patterns from IP 192.168.1.100?');

Response Structure

[
    'success' => true,                    // Found relevant logs?
    'reason' => 'Payment gateway timeout caused...',  // AI explanation
    'evidence_logs' => [                  // Supporting evidence
        [
            'id' => 'log_001',
            'content' => '[2024-01-15] ERROR: ...',
            'timestamp' => '2024-01-15T14:23:45Z',
            'level' => 'error',
            'source' => 'payment-service', 
            'tags' => ['payment', 'timeout']
        ]
    ]
]

⚙️ Configuration

AI Platform Options

// OpenAI
use Symfony\AI\Platform\OpenAI\OpenAIPlatform;
$platform = new OpenAIPlatform($apiKey);

// Anthropic
use Symfony\AI\Platform\Anthropic\AnthropicPlatform;
$platform = new AnthropicPlatform($apiKey);

// Custom Platform
class CustomPlatform implements PlatformInterface {
    // Your implementation
}

Vector Store Options

// Memory (testing)
$store = new InMemoryStore();

// Production stores
use Symfony\AI\Store\Bridge\Chroma\ChromaStore;
use Symfony\AI\Store\Bridge\Pinecone\PineconeStore;

$store = new ChromaStore($config);
$store = new PineconeStore($config);

Custom System Prompts

$customPrompt = 'You are a security log analyzer. Focus on threats and incidents.';

$agent = new LogInspectorAgent($platform, $model, $store, $customPrompt);

🧪 Testing & Validation - REAL WORKING PACKAGE

🎯 PROOF IT WORKS: Comprehensive end-to-end tests with real Ollama integration.

✅ Full Functional Test Suite

13/13 tests PASSING with real Ollama (llama3.2:1b):

💳 Payment system analysis - Real e-commerce error investigation
🛡️ Security incident detection - Brute force & auth failure analysis
💾 Database performance issues - Connection timeouts & query problems
🐛 Application error analysis - Exception handling & memory issues
⚡ Performance monitoring - API response time analysis
📊 50+ realistic PHP logs from actual applications

🏃‍♂️ Run Tests Yourself

# Setup Ollama
curl -fsSL https://ollama.ai/install.sh | sh
ollama pull llama3.2:1b

# Run full test suite
OLLAMA_MODEL=llama3.2:1b vendor/bin/phpunit test/Functional/

Results: 104 successful assertions, 2-10s response times, multi-platform support proven.

🚀 Extend Testing

Want to test with YOUR logs? Add more realistic log examples:

Expand test/fixtures/logs/ with logs from:
- ✅ Laravel applications - Real Laravel/Eloquent errors (included)
- ✅ Kubernetes pods - OOMKilled, CrashLoopBackOff, resource issues (included)
- ✅ Microservices - Circuit breakers, service mesh, distributed tracing (included)
- Symfony applications
- API gateways
- Docker containers
Test real scenarios:
- "What caused the 3 AM outage?"
- "Show me memory leaks in user service"
- "Find all failed credit card transactions"
- "Analyze API rate limiting errors"
Validate with your AI platform:
- OpenAI (full semantic search)
- Anthropic (full semantic search)
- Ollama (intelligent keyword fallback)

This package works with REAL data and REAL AI models - test it yourself!

🤝 Contributing

Fork the repository
Create feature branch: git checkout -b feature/amazing-feature
Commit changes: git commit -m 'Add amazing feature'
Push to branch: git push origin feature/amazing-feature
Open Pull Request

Made with ❤️ for developers who hate digging through logs!

Transform your debugging experience today 🚀

hakam / ai-log-inspector-agent

Maintainers

Details