PHPackages                             api-insight/metrics-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging &amp; Monitoring](/categories/logging)
4. /
5. api-insight/metrics-bundle

ActiveSymfony-bundle[Logging &amp; Monitoring](/categories/logging)

api-insight/metrics-bundle
==========================

Métriques et monitoring pour API Symfony

1.1.0(11mo ago)01MITPHPPHP &gt;=8.2

Since May 23Pushed 11mo agoCompare

[ Source](https://github.com/Sylv3str3/symfony-api-insight)[ Packagist](https://packagist.org/packages/api-insight/metrics-bundle)[ RSS](/packages/api-insight-metrics-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (3)Used By (0)

API Insight - Métriques &amp; Monitoring pour Symfony APIs
==========================================================

[](#api-insight---métriques--monitoring-pour-symfony-apis)

[![Version](https://camo.githubusercontent.com/82607e69abe99314712caaca3e9c3d804b6290df91f9771848c2c84b1d6bf4b8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e312e302d626c75652e737667)](https://camo.githubusercontent.com/82607e69abe99314712caaca3e9c3d804b6290df91f9771848c2c84b1d6bf4b8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e312e302d626c75652e737667)[![PHP](https://camo.githubusercontent.com/948d330a5b6ec7083d97fa42345daff9f9b39a54d99216f8ffa575ac53ebb92d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d382e322532422d707572706c652e737667)](https://camo.githubusercontent.com/948d330a5b6ec7083d97fa42345daff9f9b39a54d99216f8ffa575ac53ebb92d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d382e322532422d707572706c652e737667)[![Symfony](https://camo.githubusercontent.com/7cfdf9fb3a124b1e912a34248bb0e34ede453e9d2b6ede49469ab846727eb93c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73796d666f6e792d362e78253230253743253230372e782d626c61636b2e737667)](https://camo.githubusercontent.com/7cfdf9fb3a124b1e912a34248bb0e34ede453e9d2b6ede49469ab846727eb93c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73796d666f6e792d362e78253230253743253230372e782d626c61636b2e737667)

API Insight est un bundle Symfony ultra-léger qui ajoute des métriques, de la visibilité et un point d'observation (`/metrics`) à toutes tes routes API

🚀 Installation
--------------

[](#-installation)

```
composer require api-insight/metrics-bundle
```

⚙️ Configuration
----------------

[](#️-configuration)

Ajouter le bundle dans `config/bundles.php`:

```
return [
    // ...
    ApiInsight\ApiInsightBundle::class => ['all' => true],
];
```

Créer le fichier de configuration `config/packages/api_insight.yaml`:

```
api_insight:
    enabled: true
    storage: memory # Options: memory, redis, database (Pro)
    auth:
        enabled: false
        type: token # Options: token, jwt (Pro)
        token: null # Votre token secret
    prometheus:
        enabled: false # Disponible en version Pro
    dashboard:
        enabled: false # Disponible en version Pro
```

Importer les routes dans `config/routes.yaml`:

```
api_insight:
    resource: '@ApiInsightBundle/Resources/config/routes.yaml'
```

📊 Utilisation
-------------

[](#-utilisation)

Une fois installé, API Insight commence automatiquement à collecter des métriques sur toutes les requêtes API.

### Accès aux métriques globales

[](#accès-aux-métriques-globales)

Accédez à vos métriques via l'endpoint `/metrics`:

```
curl http://votre-api.com/metrics
```

Exemple de réponse:

```
{
    "global": {
        "total_calls": 325,
        "total_errors": 12,
        "error_rate": 3.69,
        "routes_count": 8
    },
    "routes": {
        "api_users_get": {
            "total_calls": 120,
            "avg_duration": 0.056,
            "min_duration": 0.012,
            "max_duration": 0.234,
            "status_codes": {
                "200": 118,
                "404": 2
            },
            "errors": 2,
            "error_rate": 1.67
        },
        // ... autres routes
    }
}
```

### Accès aux métriques temporelles

[](#accès-aux-métriques-temporelles)

Vous pouvez également accéder aux métriques réparties dans le temps via l'endpoint `/metrics/time`:

```
# Métriques journalières (par défaut)
curl http://votre-api.com/metrics/time

# Métriques period= {minute, hour, day, month, year}
curl http://votre-api.com/metrics/time?period=hour

# Métriques pour une route spécifique
curl http://votre-api.com/metrics/time?route=api_users_get
```

Exemple de réponse pour les métriques temporelles:

```
{
    "period": "day",
    "metrics": {
        "2023-11-15": {
            "api_users_get": {
                "total_calls": 45,
                "errors": 2,
                "avg_duration": 0.067,
                "error_rate": 4.44
            },
            "api_products_list": {
                "total_calls": 38,
                "errors": 0,
                "avg_duration": 0.123,
                "error_rate": 0
            }
        },
        "2023-11-16": {
            // ... métriques pour ce jour
        }
    }
}
```

Exemple de réponse pour les métriques mensuelles:

```
{
    "period": "month",
    "metrics": {
        "2023-11": {
            "api_users_get": {
                "total_calls": 1245,
                "errors": 23,
                "avg_duration": 0.062,
                "error_rate": 1.85
            },
            // ... autres routes
        },
        "2023-12": {
            // ... métriques pour ce mois
        }
    }
}
```

### Réinitialisation des métriques

[](#réinitialisation-des-métriques)

```
curl -X POST http://votre-api.com/metrics/reset
```

🔒 Sécurité
----------

[](#-sécurité)

Pour protéger l'accès à vos métriques, activez l'authentification:

```
api_insight:
    auth:
        enabled: true
        type: token
        token: "votre-token-secret"
```

Puis accédez aux métriques avec l'en-tête d'authentification:

```
curl http://votre-api.com/metrics -H "X-API-Insight-Token: votre-token-secret"
```

🌟 Fonctionnalités
-----------------

[](#-fonctionnalités)

FonctionVersion gratuiteVersion ProCompteur de requêtes API (par route)✅✅Suivi des erreurs HTTP (4xx/5xx)✅✅Latence moyenne par endpoint✅✅Route /metrics en JSON✅✅Métriques temporelles (minute/heure/jour/mois/année)✅✅Export Prometheus❌✅Export vers Grafana/Influx/Elastic❌✅Authentification JWT ou Token❌✅Dashboard web intégré❌✅Limitation de débit &amp; alertes❌✅📝 Licence
---------

[](#-licence)

MIT

🤝 Support
---------

[](#-support)

Pour toute question ou assistance, [ouvrez une issue](https://github.com/api-insight/metrics-bundle/issues).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance51

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

359d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0794c72882d0b99fd1c195c79b7f4f8e5135fe65d18c1b520a8779a67ff2d2b7?d=identicon)[Sylv3str3](/maintainers/Sylv3str3)

---

Top Contributors

[![Sylv3str3](https://avatars.githubusercontent.com/u/139703387?v=4)](https://github.com/Sylv3str3 "Sylv3str3 (3 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/api-insight-metrics-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/api-insight-metrics-bundle/health.svg)](https://phpackages.com/packages/api-insight-metrics-bundle)
```

###  Alternatives

[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[scheb/2fa

Two-factor authentication for Symfony applications (please use scheb/2fa-bundle to install)

578630.7k1](/packages/scheb-2fa)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

7310.3k29](/packages/open-dxp-opendxp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
