Search by

inprovo / howler-client

inprovo

Error tracking client for Howler - sends exceptions to your Howler server

Package info

github.com/inprovo/howler-client

pkg:composer/inprovo/howler-client

Statistics

Installs: 295

Dependents: 0

Suggesters: 0

Stars: 0

v2.0.0 2026-04-12 19:03 UTC

This package is auto-updated.

Last update: 2026-11-09 05:18:24 UTC


README

Error tracking client voor Howler. Vangt automatisch exceptions op in je Laravel applicatie en stuurt ze naar je Howler server.

Installatie

composer require inprovo/howler-client

Setup

1. Login (eenmalig per machine)

php artisan howler:login

Voer je Howler e-mail en wachtwoord in. Credentials worden opgeslagen in ~/.howler/credentials.

2. Project koppelen

php artisan howler:init

Kies een bestaand project of maak een nieuw project aan. De command schrijft automatisch HOWLER_API_KEY en HOWLER_ENDPOINT naar je .env.

3. Testen

php artisan howler:test

Stuurt een test exception naar Howler om te bevestigen dat alles werkt.

Hoe het werkt

Na installatie registreert de package zich automatisch als exception reporter in Laravel. Elke onafgevangen exception wordt naar Howler gestuurd met:

  • Exception class, message en code
  • Stack trace met code snippets (20 regels rondom de fout)
  • Affected files (alleen app frames)
  • Request data (method, URL, headers, body, IP)
  • User data (ID, email)
  • Route info (name, action)
  • SQL queries met timings
  • Performance metrics (duration, memory, slow queries)
  • Git commit hash
  • Custom context en glows

Gebruik

Custom context

use Inprovo\HowlerClient\Facades\Howler;

// Context toevoegen (beschikbaar bij volgende error)
Howler::context(['tenant_id' => 123, 'plan' => 'premium']);

Glows (breadcrumbs)

Howler::glow('Payment initiated', ['amount' => 49.99, 'provider' => 'mollie']);
Howler::glow('Webhook received', ['event' => 'payment.paid']);

Handmatig rapporteren

Howler::report(new \RuntimeException('Iets ging mis'));

Artisan Commands

Error management (voor Claude Code)

# Lijst van unresolved errors
php artisan howler:errors

# Volledige error details met stack trace en code
php artisan howler:show {error_id}

# Toon error en markeer als in progress
php artisan howler:fix {error_id}

# Markeer als resolved met optionele notitie
php artisan howler:resolve {error_id} --note="Fixed null check in PaymentService"

Setup commands

php artisan howler:login       # Authenticatie
php artisan howler:logout      # Verwijder credentials
php artisan howler:init        # Project koppelen
php artisan howler:test        # Test connectie
php artisan howler:status      # Toon configuratie en status

Configuratie

Publiceer de config (optioneel):

php artisan vendor:publish --tag=howler-config

.env variabelen

HOWLER_API_KEY=hwl_...              # Automatisch ingevuld door howler:init
HOWLER_ENDPOINT=https://howler.inprovo.nl/api/errors
HOWLER_ENVIRONMENT=production       # Standaard: APP_ENV
HOWLER_SLOW_QUERY_THRESHOLD=100     # Milliseconden
HOWLER_ENABLED=true                 # Zet op false om rapportage uit te schakelen

Config opties

// config/howler.php

'rate_limit' => 100,          // Max errors per minuut
'max_queries' => 50,          // Max queries per error
'max_logs' => 20,             // Max log entries per error
'max_glows' => 30,            // Max glows per error

'sanitize_keys' => [          // Keys die gefilterd worden
    'password', 'token', 'secret', 'api_key',
    'authorization', 'cookie', 'credit_card',
],

'ignore_exceptions' => [      // Exceptions die niet gerapporteerd worden
    // \Symfony\Component\HttpKernel\Exception\NotFoundHttpException::class,
],

Vereisten

  • PHP 8.2+
  • Laravel 11, 12 of 13
  • Guzzle 7

CLAUDE.md snippet

Voeg dit toe aan de CLAUDE.md van je project:

## Howler Error Tracking

Dit project is verbonden met Howler error tracking.

### Error fix workflow:
1. `php artisan howler:errors` voor openstaande errors
2. `php artisan howler:show {error_id}` voor details met code context
3. Analyseer stack trace en affected files
4. Fix de bug
5. `php artisan howler:resolve {error_id} --note="Beschrijving van de fix"`

Licentie

MIT