> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airys.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# APM e Rastreamento

> Configure APM e ferramentas de monitoramento de erros para o AirysChat

O AirysChat suporta várias ferramentas de APM e monitoramento.
Você pode ativá-las configurando as variáveis de ambiente fornecidas.

## [Sentry](https://sentry.io/)

Forneça o seu `sentry dsn`.

```bash theme={null}
SENTRY_DSN=
```

## [Scout](https://scoutapm.com)

Forneça valores para as seguintes variáveis de ambiente. Consulte a [documentação do scout](https://scoutapm.com/docs/ruby/configuration) para opções adicionais.

```bash theme={null}
## https://scoutapm.com/docs/ruby/configuration
# SCOUT_KEY=YOURKEY
# SCOUT_NAME=YOURAPPNAME (Production)
# SCOUT_MONITOR=true
```

## [NewRelic](https://newrelic.com/)

Habilite o Newrelic configurando a chave de licença. Consulte a [documentação do newrelic](https://docs.newrelic.com/docs/agents/ruby-agent/configuration/ruby-agent-configuration/) para opções adicionais.

```bash theme={null}
# https://docs.newrelic.com/docs/agents/ruby-agent/configuration/ruby-agent-configuration/
# NEW_RELIC_LICENSE_KEY=
```

## [DataDog](https://www.datadoghq.com/)

O Datadog requer um agente rodando na máquina host para a qual a biblioteca de rastreamento pode enviar dados. O código ruby do AirysChat contém a biblioteca de rastreamento, mas você precisa configurar o agente em sua máquina host/ambiente docker para que a integração funcione.

Habilite o Datadog no airyschat configurando a `trace agent url`.

```bash theme={null}
## https://github.com/DataDog/dd-trace-rb/blob/master/docs/GettingStarted.md#environment-variables
# DD_TRACE_AGENT_URL=http://localhost:8126
```

### Executando o agente Datadog localmente via docker

```bash theme={null}
# to run in your local machine binding to port 8126
# replace <dd API key> and dd_site as required

docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -p 8126:8126  -e DD_API_KEY=<dd api key> -e DD_SITE="datadoghq.com" gcr.io/datadoghq/agent:7
```

Consulte a documentação do Datadog para instalar o agente em ambientes específicos como [Ubuntu](https://docs.datadoghq.com/agent/basic_agent_usage/ubuntu/?tab=agentv6v7), [Docker](https://docs.datadoghq.com/agent/docker/?tab=standard), [kubernetes](https://docs.datadoghq.com/agent/kubernetes/?tab=helm) etc.
