Skip to main content
Por favor, siga primeiro o guia de instalação ao adicionar uma nova aplicação ao AppSignal. Em seguida, certifique-se de instalar o collector do AppSignal 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. 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: 
java -javaagent:/path/to/opentelemetry-javaagent.jar -jar your-application.jar
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: 
tasks.bootRun {
    jvmArgs = listOf("-javaagent:/path/to/opentelemetry-javaagent.jar")
    // With any other configuration after
}

​
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: 
# 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
Em seguida, configure os atributos de resource do OpenTelemetry exigidos pelo AppSignal: 
# 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)}\
"

​
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” e “Performance > Traces”. Se, depois de seguir nossas instruções de instalação, você ainda não ver dados no AppSignal, nos avise e nós te ajudaremos a finalizar a instalação do OpenTelemetry!