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

# Métricas de host do Heroku

> Aprenda como configurar métricas de host para dynos do Heroku no AppSignal usando o sistema logplex do Heroku.

## Aplicações Cedar (Plataforma Legada)

<Note>
  Certifique-se de que um [Heroku Logplex Log Drain](/heroku/setup) funcional esteja configurado antes de continuar com esta seção.
</Note>

O Heroku fornece um serviço para obter métricas de host de um Dyno através do seu [sistema Logplex](https://devcenter.heroku.com/articles/logplex).
O AppSignal fornece um endpoint para ler essas métricas dos logs do seu app. Esta é a única maneira de receber métricas de host precisas no AppSignal para apps no Heroku. O recurso de [métricas de host](/metrics/host-metrics) do AppSignal não funciona de forma confiável no Heroku, pois não expõe diretamente métricas de runtime para os contêineres LXC nos quais os Dynos rodam. Usando a coleta normal de métricas de host, seus apps Heroku reportariam métricas de host para o sistema pai no qual muitos apps Heroku rodam, em vez de métricas limitadas aos seus Dynos.

A partir do sistema Logplex, podemos receber as seguintes métricas dos seus apps por dyno:

* Load average
* Memory total limit
* Memory used

Para configurar o AppSignal para receber essas métricas, siga o guia abaixo.

### 1. Atualize a integração do AppSignal.

Primeiro, atualize a gem Ruby para a versão 2.6.0 ou mais recente.
Para Elixir, atualize para a versão 1.6.0 ou mais recente da integração do AppSignal.

Trocamos o uso do UUID do dyno pelo nome (por exemplo, `web.1`), para garantir que possamos relacionar as métricas que recebemos do drain Logplex com os dados que recebemos da integração. Certifique-se de estar rodando a versão `2.6.x` ou superior.

### 2. Habilite as métricas de runtime do host no Heroku

O recurso [runtime metrics](https://devcenter.heroku.com/articles/log-runtime-metrics) do host do Heroku registra as métricas de host dos seus dynos em intervalos definidos no log do seu app.

Para habilitar esse recurso no seu app Heroku, execute o seguinte comando no seu console.

```bash Bash theme={null}
heroku labs:enable log-runtime-metrics
heroku restart
```

Após reiniciar o app, você deve ver o seguinte aparecer nos seus logs de tempos em tempos.

<CodeGroup>
  ```bash Bash theme={null}
  $ heroku logs --tail
  source=web.1 dyno=heroku.2808254.d97d0ea7-cf3d-411b-b453-d2943a50b456 sample#load_avg_1m=2.46 sample#load_avg_5m=1.06 sample#load_avg_15m=0.99
  source=web.1 dyno=heroku.2808254.d97d0ea7-cf3d-411b-b453-d2943a50b456 sample#memory_total=21.00MB sample#memory_rss=21.22MB sample#memory_cache=0.00MB sample#memory_swap=0.00MB sample#memory_pgpgin=348836pages sample#memory_pgpgout=343403pages
  ```
</CodeGroup>

Veja a [documentação do Heroku Logplex](https://devcenter.heroku.com/articles/log-runtime-metrics) para mais informações sobre como configurar isso, caso encontre problemas.

Após adicionar o recurso labs, as métricas de host do seu app aparecerão em alguns minutos na [seção "host metrics"](https://appsignal.com/redirect-to/app?to=host_metrics).

## Aplicações Fir

A plataforma Heroku Fir fornece [métricas de runtime do dyno](https://devcenter.heroku.com/articles/heroku-opentelemetry-signals-and-attributes-reference#dyno-runtime-metrics) através dos seus sinais OpenTelemetry, que você pode configurar seguindo o [guia de configuração do Fir](/heroku/setup#fir-applications). Depois de concluir a configuração inicial, nenhum passo adicional é necessário. As [métricas de host](/metrics/host-metrics) da sua aplicação aparecerão no AppSignal em alguns minutos.