> ## 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 de Gráficos

Endpoint \[`GET`]:

| Endpoint                        | Descrição                  |
| ------------------------------- | -------------------------- |
| **/api/\[app\_id]/graphs.json** | Retorna dados dos gráficos |

Parâmetros:

| Param        | Tipo             | Descrição                                                           |
| ------------ | ---------------- | ------------------------------------------------------------------- |
| kind         | string           | Agregação do namespace fornecido (web, background ou personalizado) |
| action\_name | string           | Exemplo: BlogPostsController-hash-show                              |
| from         | string (ISO8601) | Padrão é 1 dia atrás se for nulo                                    |
| to           | string (ISO8601) | Padrão é agora se for nulo                                          |
| timeframe    | string           | Pode ser: \[hour, day, month, year]                                 |
| fields       | array            | Pode ser: \[mean, count, ex\_count, ex\_rate, pct]                  |

Forneça o parâmetro `action_name` ou `kind`.
Você pode especificar os valores from e to, **ou** o valor timeframe.

Os timeframes válidos são: `hour`, `day`, `month` e `year`

Os fields válidos são:

| Field     | Descrição                                                      |
| --------- | -------------------------------------------------------------- |
| mean      | tempo médio de resposta                                        |
| count     | throughput                                                     |
| ex\_count | contagem de exceções                                           |
| ex\_rate  | taxa de exceções (porcentagem de exceções em relação ao count) |
| pct       | percentil 90 (apenas para requisições lentas)                  |

Se quiser uma action e uma exception, concatene as strings com `:|:` como separador.

Então `BlogPostsController#show` com `Mongoid::RecordNotFound` se torna:
`BlogPostsController-hash-show:|:Mongoid::RecordNotFound"`

Requisição de exemplo:

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

Este endpoint retorna um objeto 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>