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

# Public Endpoint - StatsD Metrics

Este endpoint da API StatsD é fornecido para adicionar métricas adicionais ao AppSignal, onde uma integração existente não pode ser usada ou a linguagem usada ainda não é suportada.

Este endpoint é destinado a integrações que enviam métricas agregadas em um curto período; é preferível enviar uma requisição a cada 5 segundos com 100 métricas do que 100 requisições a cada 5 minutos com uma métrica cada.

## Endpoint

Método da requisição: `POST`

| Endpoint                                                                                       | Descrição                |
| ---------------------------------------------------------------------------------------------- | ------------------------ |
| [https://appsignal-endpoint.net/metrics/statsd](https://appsignal-endpoint.net/metrics/statsd) | Aceita dados (Dog)StatsD |

## Parâmetros de URL

| Parâmetro | Tipo   | Descrição                                                                                                                  |
| --------- | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| api\_key  | String | Chave de API **Front-end**, pode ser encontrada nas [configurações do App](https://appsignal.com/redirect-to/app?to=info). |

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

## Parâmetros do corpo

O corpo do post deve conter métricas formatadas em (Dog)StatsD separadas por uma nova linha.

Por exemplo:

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

Aqui está um exemplo completo de como enviar essas métricas usando `cURL`. (Observe o uso de aspas simples para a opção `--data` e o `$` no início. Somente assim as quebras de linha funcionarão no valor de `--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>
  **Nota**: Este endpoint é otimizado para grandes volumes de tráfego e não
  valida a chave da API ou o payload, uma resposta `200` (`OK`) é retornada quando o
  tamanho do corpo está dentro do limite de `200k`. Isso não significa que a requisição é
  aceita ao ser recebida.
</Tip>