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

# Configuração

> Aprenda como configurar o Heroku para o AppSignal.

As métricas, o reporte de erros e os dashboards do Heroku no AppSignal estão disponíveis para aplicações das gerações Cedar (Plataforma Legada) e Fir, e podem ser configurados em apenas algumas etapas.

## Aplicações Cedar (Plataforma Legada)

Para aplicações [Heroku Cedar](https://devcenter.heroku.com/articles/generations#cedar), você pode configurar as métricas, o reporte de erros e os dashboards do AppSignal com um [Logplex Log Drain](https://devcenter.heroku.com/articles/logplex).

Se você também quiser acessar e gerenciar seus logs do Heroku no AppSignal, configure também o [Heroku Log drain para AppSignal Logging](/logging/platforms/heroku).

Você só precisa configurar este log drain uma vez por aplicação e ele fornecerá dados para todos os recursos, como [erros da plataforma Heroku](/heroku/logplex-errors), dashboards e métricas de host.

<Warning>
  Esta configuração do log drain do Heroku enviará apenas métricas para o AppSignal. O AppSignal
  receberá logs do Heroku, mas eles serão descartados. Para enviar tanto
  métricas quanto logs ao AppSignal, siga a configuração do log drain do Heroku [na nossa
  documentação de Logging](/logging/platforms/heroku).
</Warning>

```bash Bash theme={null}
heroku drains:add "https://appsignal-endpoint.net/logplex?api_key=<push_api_key>&name=<app_name>&environment=<app_environment>"
```

Certifique-se de substituir os placeholders (`<push_api_key>`, `<app_name>` e `<app_environment>`) pela Push API key da sua organização AppSignal, e pelo nome e ambiente do seu app. Certifique-se de que o nome e o ambiente do seu app correspondem exatamente à configuração do seu app no AppSignal. Esses valores diferenciam maiúsculas de minúsculas.

Você pode encontrar sua Push API key, nome do app e ambiente no AppSignal.com em ["App settings > Push & Deploy"](https://appsignal.com/redirect-to/app?to=info).

Depois que o log drain estiver configurado, os [erros da plataforma Heroku](/heroku/logplex-errors) e os [dashboards](/heroku/dashboards) devem aparecer automaticamente. Uma configuração adicional é necessária para as [Métricas de Host](/heroku/host-metrics).

## Aplicações Fir

Você pode configurar as métricas, o reporte de erros e os dashboards do AppSignal para aplicações [Heroku Fir](https://devcenter.heroku.com/articles/generations#fir) com um [Telemetry drain](https://devcenter.heroku.com/articles/heroku-telemetry).

```bash Bash theme={null}
heroku telemetry:add --app <heroku_app_name> <collector-endpoint-url> --headers '{"AppSignal-Config-Name":"<app_name>","AppSignal-Config-Environment":"<app_environment>","AppSignal-Config-PushApiKey":"<push_api_key>","AppSignal-Config-LanguageIntegration":"heroku-fir","AppSignal-Config-Revision":"unknown","OpenTelemetry-HostName":"heroku"}'
```

Certifique-se de substituir os seguintes placeholders:

* `<heroku_app_name>` pelo nome da aplicação no Heroku
* `<collector-endpoint-url>` pela URL do seu [Hosted Collector](/collector/hosted-vs-self-hosted), que pode ser encontrada nas [configurações de Hosted Collectors](https://appsignal.com/redirect-to/organization?to=admin/hosted_collectors) da sua organização
* `<app_name>` pelo nome da sua aplicação
* `<app_environment>` pelo ambiente da sua aplicação
* e `<push_api_key>` pela Push API key da sua organização AppSignal.

Depois disso, o Heroku criará um telemetry drain e enviará todos os sinais de telemetria (traces, métricas e logs) para o AppSignal. Isso preencherá as métricas de host da plataforma Heroku, métricas de serviços de primeira parte ([Heroku Postgres](https://devcenter.heroku.com/articles/heroku-postgresql) e [Heroku Redis](https://devcenter.heroku.com/categories/heroku-redis)) que sua aplicação usa, e armazenará quaisquer logs da Heroku Platform API.