Laravel outils de reporting

Un outils de génération de rapport a partir d'un dashboard pour les application Laravel découvrez eloquentize

Laravel outils de reporting

1. Qu’est-ce que Eloquentize ?

Eloquentize est présenté comme un reporting tool spécifiquement conçu pour les applications Laravel. Il se compose de :

  1. Une bibliothèque que vous installez dans vos projets et qui fournit plusieurs commandes Artisan (PHP) pour la collecte des métriques.
  2. Une API (gérée par Eloquentize en SaaS) qui reçoit et stocke les données envoyées par la bibliothèque.
  3. Un tableau de bord (dashboard) où vous pouvez visualiser et analyser facilement les métriques de l’ensemble de vos projets.

Sa raison d’être

L’objectif principal d’Eloquentize est de simplifier la supervision en centralisant toutes vos données, qu’il s’agisse de créations d’utilisateurs, de montants de factures, de conversions, ou encore d’événements divers (création, mise à jour, suppression de modèles Eloquent, etc.). Au lieu de disperser vos rapports et vos scripts de suivi dans plusieurs applications, vous disposez d’un point d’accès unique pour agréger, filtrer, comparer et présenter ces données.

Sa valeur ajoutée pour les applications Laravel

  • Centralisation totale : Sur un seul dashboard, vous regroupez tous vos indicateurs en provenance de multiples projets Laravel.
  • Rapidité de mise en place : En quelques commandes Artisan, Eloquentize récupère les informations clés de vos Eloquent models, sans nécessiter de schéma de base de données supplémentaire.
  • Granularité et personnalisation : Vous décidez quelles métriques suivre (nombre de créations, agrégations de champs, etc.) et comment les visualiser.

2. Installation et intégration

Via Composer

L’installation se fait classiquement à l’aide de Composer :

composer require eloquentize/laravel-eloquentize-client


Configuration de l’API Eloquentize

Une fois le package installé, créez un compte sur la plateforme Eloquentize puis récupérez votre clé API. Dans votre fichier .env, renseignez :

ELOQUENTIZE_API_TOKEN=your_api_key_here 

C’est cette clé qui autorise votre application Laravel à communiquer avec la plateforme Eloquentize.

Ajout au scheduler

Pour automatiser la collecte de métriques, pensez à inclure les commandes Eloquentize dans le scheduler de Laravel (app/Console/Kernel.php ou routes/console.php si vous utilisez Laravel 11). Veillez également à activer la cron job sur votre hébergement si cela n’est pas déjà fait.

3. Fonctionnement : Artisan, API et dashboard

Commandes Artisan pour collecter des métriques

Le cœur de la collecte de données se trouve dans les commandes Artisan. Les plus courantes sont :

  • php artisan eloquentize:models-count : compte le nombre de créations, de mises à jour ou de suppressions d’un modèle Eloquent sur une période donnée.
  • php artisan eloquentize:property-aggregate : calcule des agrégations (somme, moyenne, min, max) sur un champ précis d’un modèle (ex. le total des montants d’invoices).
  • php artisan eloquentize:models-count-legacy : permet de récupérer de façon rétroactive l’historique de créations depuis les débuts de l’application (basé sur created_at).

Grâce à ces commandes, vous pouvez préciser :

  • La date ou la période à analyser (hier, une date donnée, etc.).
  • Le type d’événement (created_at, updated_at, deleted_at ou toute autre colonne temporelle).
  • Les modèles ciblés (User, Invoice, Post, etc.).
  • Le type d’agrégation (si vous voulez suivre, par exemple, la somme ou la moyenne d’un champ numérique).

Usage de l’API

Toutes ces données collectées sont ensuite envoyées à l’API Eloquentize. Vous n’avez pas besoin de gérer ces appels directement : c’est la librairie (le package que vous avez installé) qui s’en charge. Les métriques sont alors stockées de manière sécurisée et peuvent être restituées sous forme de graphiques, de tables ou d’export dans votre dashboard.

Dashboard de visualisation

En vous connectant à votre compte Eloquentize, vous accédez à un tableau de bord personnalisable. Vous pouvez :

  • Créer des widgets pour chaque métrique que vous suivez.
  • Regrouper vos Applications (ou “Sources”) dans un même espace.
  • Comparer des modèles ou des indicateurs entre plusieurs projets Laravel.
  • Partager certaines métriques avec d’autres membres de l’équipe ou même avec vos clients, grâce à des dashboards adaptés et restreints.

4. Avantages concrets pour la supervision de projets Laravel

  1. Unification des données : Plus besoin de vous connecter à chaque application indépendamment ni de créer des scripts artisanaux pour chaque projet. Eloquentize centralise toutes vos statistiques.
  2. Agrégations puissantes : Vous pouvez suivre la somme, la moyenne, le minimum ou le maximum d’un champ précis (montant des factures, etc.).
  3. Rapports personnalisés : Créez des rapports adaptés à chaque usage (équipe marketing, équipe technique, direction) grâce à des widgets dédiés.
  4. Pilotage multi-projets : Idéal pour les agences, les freelances ou les entreprises qui gèrent de nombreux projets Laravel. Le fait de tout retrouver en un seul coup d’œil fait gagner un temps précieux.
  5. Automatisation : En quelques lignes de configuration dans votre Kernel, la collecte est entièrement automatisée au jour le jour.

5. Exemples d’utilisation

  • Modèles monitorés : Par défaut, eloquentize:models-count va lister toutes les classes Eloquent de votre dossier app/Models et remonter le nombre de créations. Vous pouvez filtrer pour cibler uniquement certains modèles (User, Post, Invoice, etc.).
  • Agrégations sur les factures : Avec php artisan eloquentize:property-aggregate Bill sum amount, vous obtenez le total des montants (amount) pour chaque journée, idéal pour suivre votre CA journalier.
  • Suivi d’événements : En spécifiant --event=updated_at ou deleted_at, vous pouvez comptabiliser les mises à jour ou suppressions quotidiennes d’un modèle.
  • Récupération rétroactive : eloquentize:models-count-legacy pour analyser d’anciennes données, par exemple le total d’utilisateurs créés depuis le début de votre plateforme.

6. Comparaison avec d’autres solutions de reporting

De nombreuses solutions de reporting ou de monitoring existent sur le marché, mais Eloquentize se distingue par :

  • Son orientation 100 % Laravel : Les commandes Artisan et l’intégration Eloquent sont pensées spécifiquement pour cet écosystème.
  • La simplicité de déploiement : Un seul package, quelques variables d’environnement, et le tour est joué.
  • La granularité de l’agrégation : On peut suivre n’importe quel champ Eloquent, sans avoir à créer des tables de logs dédiées.
  • La gestion multi-projets : Le dashboard multi-sources est un vrai différenciateur pour ceux qui maintiennent plusieurs applications simultanément.

7. Cas d’usage pratiques

  • Suivi de l’évolution des utilisateurs : Combien d’utilisateurs s’inscrivent chaque jour ? Quelle est la tendance mensuelle ?
  • Facturation : Combien de factures sont émises ? Quel est le montant total ou moyen facturé par jour ou par semaine ?
  • Tests A/B : Vous pouvez compter combien d’utilisateurs ont effectué une action (commande, inscription) dans tel ou tel groupe de test, en combinant un scope Eloquent personnalisé.
  • Rétention ou churn : En intégrant des dates de désinscription ou de suppression de compte, vous pouvez mesurer votre taux de churn de manière précise.

8. Limites et prérequis

  • Version de Laravel : Eloquentize fonctionne généralement à partir de Laravel 5.6, mais l’idéal est d’avoir une version plus récente pour bénéficier des derniers apports (par exemple Laravel 8, 9, 10 ou 11).
  • Accès au scheduler (cron) : Pour automatiser la collecte des métriques, vous devez avoir la possibilité d’exécuter des tâches cron sur votre hébergement (ou via Forge, Vapor, etc.).
  • Tables timestamps : Eloquentize s’appuie principalement sur des colonnes comme created_at, updated_at, deleted_at ou tout champ temporel similaire. Assurez-vous donc que vos modèles aient bien ces champs (ou équivalents).
  • Performances : Même si Eloquentize est léger, le volume de données historisées peut devenir important. Pensez à un hébergement adapté si vous gérez un parc de projets très volumineux.

9. Tarification et formules proposées

Eloquentize propose trois formules principales :

  1. Solo (9 €/mois)
    • Suivi d’une application unique.
    • Tableau de bord personnalisé.
    • Limite de métriques journalières (20) et support basique.
  2. Advanced (29 €/mois)
    • Nombre d’applications Laravel illimité.
    • Jusqu’à 100 métriques quotidiennes.
    • Tableaux de bord illimités, partage avec votre équipe (5 utilisateurs).
    • Support prioritaire.
  3. Business (120 €/mois)
    • Pensé pour les entreprises gérant un grand nombre d’applications.
    • Aucun plafond sur les métriques, utilisateurs et dashboards.
    • Support prioritaire et fonctionnalités avancées (accès multi-projets sans limite).

Chaque formule vous donne accès à un tableau de bord multi-projets pour piloter finement toutes vos applications. Une période d’essai gratuit de 5 jours est généralement proposée, sans carte bancaire, afin de tester l’outil en conditions réelles.

10. Conclusion

Pour toute équipe Laravel souhaitant bénéficier d’une vue unifiée, détaillée et personnalisable de ses métriques, Eloquentize se présente comme un allié de poids. Son intégration rapide via Composer, l’automatisation offerte par les commandes Artisan et sa plate-forme de visualisation en font un reporting tool complet. Que vous soyez développeur, lead technique ou manager, vous apprécierez de pouvoir superviser l’ensemble de vos projets Laravel en un seul tableau de bord, sans effort supplémentaire de mise en place ou de maintenance.

Si vous cherchez à améliorer la visibilité et la compréhension de vos données, Eloquentize est un investissement judicieux pour centraliser vos indicateurs, automatiser vos rapports et gagner du temps dans la prise de décision.

Prêt à franchir le pas ? Rendez-vous sur la plateforme Eloquentize pour créer votre compte, récupérer votre clé API et commencer à centraliser vos métriques Laravel !