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

# OpenTelemetry

Reportar dados da aplicação ao AppSignal por meio do OpenTelemetry envolve mais etapas de instalação do que o habitual.
Por favor, certifique-se de seguir todas as etapas com cuidado para configurar corretamente.

## Instale o AppSignal collector

Para reportar dados ao AppSignal, você precisa instalar o AppSignal collector por meio de um dos seguintes métodos de instalação:

* [Coletor hospedado](/collector/hosted-vs-self-hosted): deixe a AppSignal hospedar o coletor.
* [Pacote Linux](/collector/installation/linux-package): execute o coletor no host que você quer monitorar.
* [Imagem Docker](/collector/installation/docker-image): execute o coletor em um contêiner Docker para se conectar a outros contêineres.
* [Plataforma como Serviço](/collector/installation/platform-as-a-service): execute o coletor em um contêiner Docker, hospedado pelo seu provedor de hospedagem.

Se você tem mais de uma aplicação, ou instâncias de uma aplicação, recomendamos instalar o coletor em sua infraestrutura em uma instância dedicada, para a qual todas as aplicações possam reportar. Isso melhorará nossos relatórios, pois poderemos correlacionar dados de instrumentação entre diferentes aplicações (rastreamento distribuído). Também consome mais recursos instalar o coletor separadamente em cada host.

## Configurando o AppSignal collector

<Tip>
  Você não precisa configurar o collector ao usar o collector hospedado do
  AppSignal.
</Tip>

Ao configurar o collector, use a Push API key no nível da organização da [página de configurações de API keys](https://appsignal.com/redirect-to/organization?to=admin/api_keys). Isso autenticará as requisições com o AppSignal. Sem uma Push API key, o collector não vai iniciar.

<CodeGroup>
  ```toml title="Linux package" theme={null}
  # /etc/appsignal-collector.conf
  push_api_key = "0000-0000-0000-0000"
  ```

  ```bash title="Docker run" theme={null}
  docker run \
    --env APPSIGNAL_PUSH_API_KEY="0000-0000-0000-0000" \
    --publish "8099:8099" \
    appsignal/collector
  ```

  ```yaml title="Docker Compose" theme={null}
  version: "3.8"

  services:
    appsignal-collector:
      image: appsignal/collector:latest
      environment:
        - APPSIGNAL_PUSH_API_KEY="0000-0000-0000-0000"
  ```
</CodeGroup>

## Instale o OpenTelemetry para a sua aplicação

Para instalar os pacotes do OpenTelemetry no seu app, siga as instruções para a linguagem que o seu app usa:

* [Ruby](/opentelemetry/installation/ruby)
* [Elixir](/opentelemetry/installation/elixir)
* [Node.js](/opentelemetry/installation/nodejs)
* [Python](/opentelemetry/installation/python)
* [Go](/go/installation)
* [PHP](/php/installation)
* [Java](/java/installation)
* [Vercel](/vercel/traces#using-the-instrumentation-package)

Certifique-se de seguir as instruções, incluindo a instalação de quaisquer pacotes adicionais necessários para que o OpenTelemetry instrumente os frameworks e bibliotecas que sua aplicação usa.

Para outras linguagens, você pode seguir as instruções de instalação na [documentação do OpenTelemetry](https://opentelemetry.io/docs/) para essa linguagem, junto com nossas [instruções de instalação genéricas, independentes de linguagem](/opentelemetry/installation/generic). Você também pode achar útil usar nossas instruções de instalação para as linguagens que suportamos como referência.