Instale o agente Java com o Gradle

Esta página aborda a instalação do agente Java da New Relic usando o Gradle. As tarefas do Gradle acionadas pelo plug-in de.undercouch.download buscam e descompactam newrelic-java.zip no diretório do seu projeto.

Compatibilidade e requisitos

Suportado

Java 8, 11, 17, 21, 24, 25 e 26 (Java 7 suportado apenas no agente v6.5.4 e anteriores)
Gradle 6.x ou superior
de.undercouch.download plug-in versão 5.3.0 ou superior
Qualquer servidor de aplicativo compatível ou processo de JVM autônomo que aceite um argumento -javaagent
Consulte a compatibilidade e os requisitos para ver os intervalos de versões de framework e biblioteca suportados

Não suportado

Execução em conjunto com outros agentes APM — o agente Java não pode garantir o comportamento correto quando outro agente APM está ativo na mesma JVM

Você precisa

Uma conta New Relic e
Uma JVM com suporte a SSL SHA-2 (256 bits)
Um projeto Gradle com build.gradle

Instalar

Adicionar o plug-in de download

Adicione o plug-in de.undercouch.download ao bloco plugins do seu build.gradle:

plugins {
    id "de.undercouch.download" version "5.3.0"
}

Adicione tarefas de download e descompactação

Adicione duas tarefas a build.gradle — uma para baixar o zip do agente e outra para descompactá-lo:

task downloadNewrelic(type: Download) {
    mkdir 'newrelic'
    src 'https://download.newrelic.com/newrelic/java-agent/newrelic-agent/current/newrelic-java.zip'
    dest file('newrelic')
}

task unzipNewrelic(type: Copy) {
    from zipTree(file('newrelic/newrelic-java.zip'))
    into rootDir
}

Isso coloca os arquivos do agente em um diretório newrelic/ na raiz do projeto, contendo:

newrelic.jar — o agente Java
newrelic.yml — o arquivo de configuração do agente
newrelic-api.jar — o jar da API do agente Java
README

Executar as tarefas

Execute ambas as tarefas para baixar e descompactar o agente:

bash

$./gradlew downloadNewrelic
$./gradlew unzipNewrelic

Passe o `-javaagent`

Adicione o argumento -javaagent da JVM apontando para newrelic.jar ao iniciar o seu aplicativo. O método exato depende do seu servidor de aplicativos — consulte Passe o argumento da JVM para o seu servidor para obter instruções específicas do servidor.

Para um jar do Spring Boot, por exemplo:

bash

$java -javaagent:/path/to/newrelic/newrelic.jar -jar my-app.jar

Configurar

Edite newrelic/newrelic.yml e defina dois valores obrigatórios:

license_key: 'YOUR_LICENSE_KEY'
app_name: 'My Application'

O agente lê newrelic.yml do mesmo diretório que newrelic.jar na inicialização. Também é possível substituir qualquer configuração usando propriedades do sistema Java (por exemplo, -Dnewrelic.config.license_key=YOUR_KEY) ou variáveis de ambiente.

Consulte a configuração do agente Java para ver todas as opções disponíveis.

Verifique sua instalação

Reinicie o seu aplicativo. Envie pelo menos dois requests, depois aguarde 2–3 minutos e o seu aplicativo aparecerá em APM & serviços.

Se nenhum dado aparecer após cinco minutos, consulte Nenhum dado aparece (Java).

Esta tradução de máquina é fornecida para sua comodidade.

Compatibilidade e requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}