> ## 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.

# Point de terminaison public - Métriques StatsD

Ce point de terminaison d'API StatsD est fourni pour ajouter des métriques
supplémentaires à AppSignal, lorsqu'une intégration existante ne peut pas être
utilisée ou que le langage utilisé n'est pas (encore) pris en charge.

Ce point de terminaison est destiné aux intégrations qui envoient des
métriques agrégées sur une courte période. Il est préférable d'envoyer une
requête toutes les 5 secondes contenant 100 métriques plutôt que 100 requêtes
toutes les 5 minutes avec une métrique chacune.

## Point de terminaison

Méthode de requête : `POST`

| Point de terminaison                                                                           | Description                     |
| ---------------------------------------------------------------------------------------------- | ------------------------------- |
| [https://appsignal-endpoint.net/metrics/statsd](https://appsignal-endpoint.net/metrics/statsd) | Accepte les données (Dog)StatsD |

## Paramètres d'URL

| Paramètre | Type   | Description                                                                                                                       |
| --------- | ------ | --------------------------------------------------------------------------------------------------------------------------------- |
| api\_key  | String | Clé d'API **Front-end**, peut être trouvée dans les [paramètres de l'application](https://appsignal.com/redirect-to/app?to=info). |

```shell Shell theme={null}
https://appsignal-endpoint.net/metrics/statsd?api_key=<api_key>
```

## Paramètres du corps

Le corps de la requête POST doit contenir des métriques formatées (Dog)StatsD
séparées par un saut de ligne.

Par exemple :

<CodeGroup>
  ```shell Shell theme={null}
  login_count:1|c|#hostname:frontend1
  stripe_api_duration:19|ms|#function:payment,domain:appsignal
  cpu_usage:55.1|g|#hostname:frontend1,cpu:0
  ```
</CodeGroup>

Voici un exemple complet d'envoi de ces métriques à l'aide de `cURL`. (Notez
l'utilisation des guillemets simples pour l'option `--data` et le `$`
précédent. Ce n'est qu'à cette condition que les sauts de ligne fonctionneront
dans la valeur `--data`.)

<CodeGroup>
  ```shell Shell theme={null}
  curl -H "Content-Type: text/plain"  -X POST --data $'login_count:10|c|#hostname:frontend1\nstripe_api_duration:19|ms|#function:payment,domain:appsignal' "https://appsignal-endpoint.net/metrics/statsd?api_key=FRONTEND-API-KEY"
  ```
</CodeGroup>

<Tip>
  **Note** : Cet endpoint est optimisé pour de grands volumes de trafic et ne
  valide pas la clé API ni la charge utile. Une réponse `200` (`OK`) est renvoyée lorsque la
  taille du corps est dans la limite de `200k`. Cela ne signifie pas que la requête est
  acceptée lors de sa réception.
</Tip>