> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Graphs

Point de terminaison \[`GET`] :

| Point de terminaison            | Description                      |
| ------------------------------- | -------------------------------- |
| **/api/\[app\_id]/graphs.json** | Renvoie les données de graphique |

Paramètres :

| Param        | Type             | Description                                                      |
| ------------ | ---------------- | ---------------------------------------------------------------- |
| kind         | string           | Agrégat de l'espace de noms fourni (web, background ou le vôtre) |
| action\_name | string           | Exemple : BlogPostsController-hash-show                          |
| from         | string (ISO8601) | Par défaut, il y a 1 jour si nil                                 |
| to           | string (ISO8601) | Par défaut, maintenant si nil                                    |
| timeframe    | string           | Peut être : \[hour, day, month, year]                            |
| fields       | array            | Peut être : \[mean, count, ex\_count, ex\_rate, pct]             |

Fournissez soit le paramètre `action_name`, soit le paramètre `kind`.
Vous pouvez soit spécifier les valeurs from et to, **soit** la valeur timeframe.

Les timeframes valides sont : `hour`, `day`, `month` et `year`

Les champs valides sont :

| Champ     | Description                                                       |
| --------- | ----------------------------------------------------------------- |
| mean      | temps de réponse moyen                                            |
| count     | débit                                                             |
| ex\_count | nombre d'exceptions                                               |
| ex\_rate  | taux d'exceptions (pourcentage d'exceptions par rapport au count) |
| pct       | 90e centile (uniquement pour les requêtes lentes)                 |

Si vous souhaitez une action et une exception, concaténez les chaînes avec `:|:` comme séparateur

Ainsi, `BlogPostsController#show` avec `Mongoid::RecordNotFound` devient :
`BlogPostsController-hash-show:|:Mongoid::RecordNotFound"`

Exemple de requête :

```shell Shell theme={null}
/api/5534f7e38c5ce90000000000/graphs.json?action_name=BlogPostsController-hash-show&fields[]=mean&fields[]=pct&timeframe=month&token=aaa&from=2013-09-03T22:00:00+01:00&to=2013-10-04T00:00:00+01:00
```

Ce point de terminaison renvoie un objet JSON :

<CodeGroup>
  ```json JSON theme={null}
  {
    "from": "2013-09-03T22:00:00Z",
    "to": "2013-10-04T00:00:00Z",
    "resolution": "hourly",
    "data": [
      {
        "timestamp": 1378245600,
        "mean": 13.51942822948383,
        "pct": 13.213056043635918
      }
    ]
  }
  ```
</CodeGroup>