Esta página aborda a instalação do agente Java da New Relic usando o Maven. O Maven baixa e descompacta newrelic-java.zip como uma dependência de build, colocando os arquivos do agente em seu diretório de build automaticamente.
Compatibilidade e requisitos
Suportado
- Java 8, 11, 17, 21, 24, 25 e 26 (Java 7 suportado apenas no agente v6.5.4 e anteriores)
- Maven 3.x
maven-dependency-plugin3.1.1 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 Maven com
pom.xml
Instalar
Configure o Maven para baixar newrelic-java.zip
Adicione o agente Java como uma dependência provided no seu pom.xml. Substitua JAVA_AGENT_VERSION pela versão mais recente do agente Java:
<dependency> <groupId>com.newrelic.agent.java</groupId> <artifactId>newrelic-java</artifactId> <version>JAVA_AGENT_VERSION</version> <scope>provided</scope> <type>zip</type></dependency>Configure o Maven para descompactar o agente
Adicione maven-dependency-plugin à seção <build><plugins> do seu pom.xml para descompactar o zip do agente no seu diretório de build:
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-dependency-plugin</artifactId> <version>3.1.1</version> <executions> <execution> <id>unpack-newrelic</id> <phase>package</phase> <goals> <goal>unpack-dependencies</goal> </goals> <configuration> <includeGroupIds>com.newrelic.agent.java</includeGroupIds> <includeArtifactIds>newrelic-java</includeArtifactIds> <overWriteReleases>false</overWriteReleases> <overWriteSnapshots>false</overWriteSnapshots> <overWriteIfNewer>true</overWriteIfNewer> <outputDirectory>${project.build.directory}</outputDirectory> </configuration> </execution> </executions></plugin>Após executar mvn package, uma pasta newrelic/ aparece em target/ contendo:
newrelic.jar— o agente Javanewrelic.yml— o arquivo de configuração do agentenewrelic-api.jar— o jar da API do agente JavaREADME
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:
$java -javaagent:/path/to/target/newrelic/newrelic.jar -jar my-example-app.jarConfigurar
Edite target/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).