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

# Instalação do OpenTelemetry para Java

Por favor, siga primeiro o [guia de instalação](/guides/new-application) ao adicionar uma nova aplicação ao AppSignal.

Em seguida, certifique-se de [instalar o collector do AppSignal](/collector/installation) antes de prosseguir.

Para instalar e configurar o OpenTelemetry na sua aplicação Java, recomendamos usar o agente Java do OpenTelemetry para exportar dados para o collector do AppSignal. Esse agente irá instrumentar sua aplicação automaticamente.

## Baixe o agente Java do OpenTelemetry

Baixe o agente Java do OpenTelemetry a partir do [release mais recente no GitHub](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar). Ao executar sua aplicação, o agente Java do OpenTelemetry precisará estar presente.

## Execute sua aplicação com o agente

Ao executar sua aplicação, você precisará configurar o runtime do Java para carregar o agente Java do OpenTelemetry. Altere a forma como você inicia sua aplicação para carregar o agente Java do OpenTelemetry junto com ela:

<CodeGroup>
  ```shell Shell theme={null}
  java -javaagent:/path/to/opentelemetry-javaagent.jar -jar your-application.jar
  ```
</CodeGroup>

Substitua `/path/to/opentelemetry-javaagent.jar` pelo caminho até o agente baixado e `your-application.jar` pelo caminho do arquivo JAR da sua aplicação.

### Gradle

Ao usar o Gradle, você pode adicionar o agente à task que inicia sua aplicação no arquivo `build.gradle`:

<CodeGroup>
  ```groovy title="build.gradle.kts" theme={null}
  tasks.bootRun {
      jvmArgs = listOf("-javaagent:/path/to/opentelemetry-javaagent.jar")
      // With any other configuration after
  }
  ```
</CodeGroup>

## Configure o agente

O agente pode ser configurado usando propriedades Java ou variáveis de ambiente. Recomendamos usar variáveis de ambiente para a configuração. Primeiro, configure o agente para exportar traces e logs para o collector do AppSignal:

<CodeGroup>
  ```shell Shell theme={null}
  # Export traces and metrics to the AppSignal collector using the OTLP protocol.
  # Replace `http://localhost:8099` with the address of your AppSignal collector
  # if it's running on another host.
  export OTEL_TRACES_EXPORTER=otlp
  export OTEL_METRICS_EXPORTER=otlp
  export OTEL_LOGS_EXPORTER=otlp
  export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
  export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:8099
  ```
</CodeGroup>

Em seguida, configure os atributos de resource do OpenTelemetry exigidos pelo AppSignal:

<CodeGroup>
  ```shell Shell theme={null}
  # Replace these values with your AppSignal application name, environment
  # and push API key. These are used by the resource attributes configuration below.
  APPSIGNAL_APP_NAME=your-app-name
  APPSIGNAL_APP_ENV=production
  APPSIGNAL_PUSH_API_KEY=your-push-api-key

  # Optionally, set a custom revision and hostname. If not set, the resource attributes
  # configuration below will use the current Git revision and system hostname.
  # REVISION=your-custom-revision
  # HOSTNAME=your-custom-hostname

  # Set the name of the service that is being monitored. A common choice is the
  # name of the framework used. This is used to group traces and metrics in AppSignal.
  export OTEL_SERVICE_NAME=my-service-name

  export OTEL_RESOURCE_ATTRIBUTES="\
  appsignal.config.name=$APPSIGNAL_APP_NAME,\
  appsignal.config.environment=$APPSIGNAL_APP_ENV,\
  appsignal.config.push_api_key=$APPSIGNAL_PUSH_API_KEY,\
  appsignal.config.revision=${REVISION:-$(git rev-parse --short HEAD 2>/dev/null || echo unknown)},\
  appsignal.config.language_integration=java,\
  appsignal.config.app_path=$PWD,\
  host.name=${HOSTNAME:-$(hostname)}\
  "
  ```
</CodeGroup>

## Teste a aplicação!

Agora que todos os componentes estão conectados, inicie sua aplicação com as variáveis de ambiente necessárias e verifique se você vê dados chegando ao AppSignal. Confira especificamente as páginas ["Errors > Issue list"](https://appsignal.com/redirect-to/app?to=exceptions) e ["Performance > Traces"](https://appsignal.com/redirect-to/app?to=performance/traces).

Se, depois de seguir nossas instruções de instalação, você ainda não ver dados no AppSignal, [nos avise](mailto:support@appsignal.com?subject=OpenTelemetry%20beta%20issue) e nós te ajudaremos a finalizar a instalação do OpenTelemetry!