| title | tags | metaDescription | freshnessValidatedDate | translationType | |||
|---|---|---|---|---|---|---|---|
Compatibilidade e requisitos para o agente Java |
|
The New Relic APM Java agent: compatibility and requirements. |
never |
machine |
O agente Java da New Relic inclui instrumentação integrada das partes mais populares do ecossistema Java, incluindo servidores de aplicativos, estrutura, banco de dados e sistemas de enfileiramento de mensagens. Para framework e biblioteca que não são instrumentados fora da caixa, você pode estender o agente com instrumentação personalizada Java.
Quer experimentar o agente Java da New Relic? Crie uma conta New Relic gratuitamente! Não é necessário cartão de crédito.
Antes de instalar o agente Java, certifique-se de que seu sistema atenda a estes requisitos:
O agente Java é compatível com qualquer linguagem baseada em JVM, incluindo: Java, Scala, Kotlin e Clojure. Para obter suporte de instrumentação para recursos específicos de linguagem, consulte a seção [Estrutura e biblioteca instrumentada automaticamente](#auto-instrumented) abaixo.<table>
<thead>
<tr>
<th style={{ width: "200px" }}>
Versão Java
</th>
<th style={{ width: "300px" }}>
Versões compatíveis do agente Java
</th>
</tr>
</thead>
<tbody>
<tr>
<td>
Java 7
</td>
<td>
v3.0.0 a v6.5.0, v6.5.2, v6.5.3 e v6.5.4
</td>
</tr>
<tr>
<td>
Java 8
</td>
<td>
v3.10.0 para atual
</td>
</tr>
<tr>
<td>
Java 11
</td>
<td>
v4.7.0 para atual
</td>
</tr>
<tr>
<td>
Java 17
</td>
<td>
v7.4.0 para atual
</td>
</tr>
<tr>
<td>
Java 21
</td>
<td>
v8.7.0 para atual
</td>
</tr>
</tbody>
</table>
Algumas versões do agente Java nesta tabela não são mais suportadas, mas ainda estão listadas para referência. A lista de versões suportadas do agente Java está na [política EOL do agente Java](/docs/apm/agents/java-agent/getting-started/java-agent-eol-policy/).
<Collapser id="security-requirements" title="Requisitos de segurança"
Como [medida de segurança padrão para coleta de dados](/docs/accounts-partnerships/accounts/security/data-security), o servidor do seu aplicativo deve oferecer suporte a SHA-2 (256 bits). SHA-1 não é compatível.
<Collapser id="other-apm" title="Uso de outro software de monitoramento"
Se o seu aplicativo usa outro software de monitoramento de aplicativo além do nosso agente, não podemos garantir que nosso agente funcionará corretamente e não podemos oferecer suporte técnico. Para obter mais informações, consulte [Erros ao usar outro software de monitoramento](/docs/apm/new-relic-apm/troubleshooting/errors-while-using-new-relic-apm-alongside-other-apm-software).
Depois de instalar o agente Java, ele automaticamente utiliza muitas estruturas e bibliotecas populares. Com instrumentação automática, o agente coleta dados avançados prontos para uso, e os dados aparecerão no painel do New Relic minutos após a instalação. Mesmo que sua biblioteca não seja instrumentada automaticamente, você ainda pode coletar dados com a instrumentação personalizada e a API do agente Java.
O agente automaticamente utiliza estes frameworks e bibliotecas:
O agente instrumenta automaticamente os seguintes servidores de aplicativos/web. Para instalar o agente Java em servidores de aplicativos/web suportados, consulte [Instalar o agente Java](/docs/agents/java-agent/installation/java-agent-manual-installation).* ColdFusion 10
* Glassfish 3.0 até o mais recente
* JBoss 7.0 até o mais recente
* JBoss EAP 6.0 até o mais recente
* Jetty 9.3.0.M1 até o mais recente
* Mule ESB 3.4 a 3.9.x
* Netty 3.3.0.Alpha1 a 5.0.0.Alpha1
* Resin 3.1.9 para 4.0.x
* Lata de spray 1.3.1 até a mais recente
* Tomcat 7.0.0 até o mais recente
* TomEE 1.5 até o mais recente
* WebLogic 12.1.2.1 a 12.2.x
* WebSphere 8.5.x a 9.x
* WebSphere Liberty Profile 8.5 até o mais recente
* WildFly 8.0.0.Final até o mais recente
<Collapser id="frameworks" title="Estrutura e biblioteca"
O agente automaticamente utiliza o seguinte framework. Para instalar o agente Java na estrutura suportada, consulte [Instalar o agente Java](/docs/agents/java-agent/installation/java-agent-manual-installation).
* Akka 2.2.0-RC1 até o mais recente
* Cliente AmazonS3 1.2.13 até o mais recente
* Clientes AmazonSNS e AmazonSNSAsync 1.11.12 até a mais recente
* Clientes AmazonSQS e AmazonSQSAsync 1.3.22 até a versão mais recente
* Efeito Gatos v2
* Scala 2.12: 2.1 até o mais recente
* Scala 2.13: 2.1 até o mais recente
* Efeito Gatos v3
* Scala 2.12: 3.2.x
* Scala 2.13: 3.2.x
* CXF 2.1.3 para o mais recente
* Grails 1.3.7 a 2.3.x
* GraphQL 16.0 - 16.2
* GraphQL 17.0 a 20.x
* GraphQL 21.0 até o mais recente
* Hibernate 3.3.0.CR1 a 6.0.0.Alpha2
* Hystrix 1.3.15 até o mais recente
* API RESTful WS de Jacarta 2.1.x para 3.1.x
* JAX-RS 1.0 a 3.x
* JBoss Logging 1.3.0.Final até o mais recente (para nosso recurso [de logs contextualizados](/docs/logs/logs-context/java-configure-logs-context-all/) )
* [API JCache](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-3200) 1.0.0 até a mais recente
* Jersey 1.0.1 até o mais recente
* JSF (Java Server Faces)
* JUL (registro do utilitário Java) (para nosso recurso [de logs contextualizados](/docs/logs/logs-context/java-configure-logs-context-all/) )
* Log4j1 1.2.17 até o mais recente (para nosso recurso [de logs contextualizados](/docs/logs/logs-context/java-configure-logs-context-all/) )
* Log4j2 2.6 até o mais recente (para nosso recurso [de logs contextualizados](/docs/logs/logs-context/java-configure-logs-context-all/) )
* Logback 1.1 até o mais recente (para nosso recurso [de logs contextualizados](/docs/logs/logs-context/java-configure-logs-context-all/) )
* Tarefas Monix
* Scala 2.11: 3.0.0 a 3.2.x
* Scala 2.12: 3.0.0 até o mais recente
* Scala 2.13: 3.0.0 até o mais recente
* Scala 3: 3.0.0 até o mais recente
* Pekko 1.0.0 até o mais recente
* Play Server 2.3.0 a 2.x /\* O suporte ao Play será estendido para o mais recente assim que oferecermos suporte ao Pekko-Http \*/
* Quartz Job Scheduler 1.8.3 a 2.2.x
* RESTEasy 2.2-RC-1 até o mais recente
* S3Cliente 2.1.0 para o mais recente
* SnsClient 2.1.0 para o mais recente
* Pulverize 1.3.1 para o mais recente
* Spring 3.0.0.RELEASE até o mais recente
* Spring Batch 4.0.0 até o mais recente
* Spring Web Services de 1.5.7 até o mais recente
* Spring Webflux 5.0.0.RELEASE para o mais recente
* SqsClient 2.1.0 para o mais recente
* Struts 2.0 até o mais recente
* Economia 0.8.0 até o mais recente
* Vert.x 3.2.0 a 4.5.x
* ZIO
* Scala 2.13: 1.0.9 até o mais recente
<Collapser id="http-messaging" title="HTTP e mensagens"
O agente utiliza automaticamente os seguintes clientes HTTP e serviços de mensagens. Para obter instruções, consulte [Instalar o agente Java](/docs/agents/java-agent/installation/java-agent-manual-installation).
* Akka HTTP 2.4.5 até o mais recente
* Akka Http Core de 0.4 até o mais recente
* AsyncHttpClient 2.0.0-RC1 até o mais recente
* gRPC 1.4.0 até o mais recente
* Cliente Blaze HTTP4s
* Escala 2,12: 0,21 - 0,23,0-M1
* Escala 2,13: 0,21 - 0,23,0-M1
* Servidor Blaze HTTP4s
* Escala 2,12: 0,21 - 0,22,0-M8
* Escala 2,13: 0,21 - 0,22,0-M8
* HttpAsyncClient 4.1 até o mais recente
* Apache Httpclient de 3.1 a 5.x
* java.net.HttpURLConnection
* JMS de 1.1 até o mais recente
* [Clientes Kafka](/docs/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues) 0.10.0.0 até o mais recente (para dados métricos e de eventos)
* [Clientes Kafka](/docs/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues) 0.11.0.0 até o mais recente (para distributed tracing e dados de eventos)
* [Kafka Connect](/docs/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues) 1.0.0 até o mais recente (para métrica)
* [Kafka Connect](/docs/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues) 2.0.0 até o mais recente (para distributed tracing e dados de transação)
* [Kafka Streams](/docs/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues) 1.0.0 até o mais recente (para métrica)
* [Kafka Streams](/docs/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues) 2.0.0 até o mais recente (para distributed tracing e dados de transação)
* OkHttp 3.6.0 até o mais recente
* Ning AsyncHttpClient 1.x
* Play WS
* Scala 2.11: 2.6.0 até o mais recente
* Scala 2.12: 2.6.0 até o mais recente
* Scala 2.13: 2.7.3 até o mais recente
* RabbitMQ 1.7.2 até o mais recente (AMQP e JMS)
* Spray-client 1.3.1 até o mais recente
* Spring JMS 1.1 até o mais recente
* Spring webclient de 5.0.0.release para o mais recente
* STTP v2
* Scala 2.12: 2.2.3 até 2.x mais recente
* Scala 2.13: 2.2.3 até 2.x mais recente, 3.0.0 até 3.x mais recente
<Collapser id="JDBC" title="Armazenamentos de dados"
Atualmente, o New Relic oferece suporte a MySQL e PostgreSQL para capturar planos de explicação para consulta lenta ao banco de dados.
* Amazon v1 DynamoDB 1.11.106 até o mais recente
* Amazon v2 DynamoDB 2.1.0 para o mais recente
* Anorma de 2,0 a 2,5
* DataStax Cassandra 3.0.0 até o mais recente (Se você usa [alta segurança](/docs/accounts-partnerships/accounts/security/high-security), consulte a [documentação de configuração para lista de permissões](/docs/agents/java-agent/configuration/java-agent-configuration-config-file#tt-slow_query_whitelist).)
* DB2 9.1 até o mais recente
* Derby 10.11.1.1 até o mais recente
* JDBC genérico (qualquer driver compatível com JDBC)
* H2 1.0.57 para o mais recente
* HSQL 1.7.2.2 até o mais recente
* Driver Oracle INet (Oranxo) 3.06, 3.14
* INet MERLIA 7.0.3, 8.04.03 e 8.06
* Jedis Redis driver 1.4.0 a 2.10.x, 3.0.0 a 4.x
* jTDS 1.2 até o mais recente
* Driver Lettuce Redis 4.3 para o mais recente
* MariaDB 1.1.7 ou superior
* Microsoft SQL Server 1.2 a 12.6.x
* MongoDB
* Clientes síncronos: 3.1.0-rc0 para o mais recente
* Clientes assíncrono: 3.4.0 a 4.1.x
* Clientes de fluxos reativos: 4.2.0 até o mais recente
* MySQL MySQL-connector-java 3.0.8 até o mais recente
* Oráculo ojdbc5, ojdbc6, ojdbc7, ojdbc8, ojdbc10, ojdbc14
* Postgres 8.0-312.jdbc3 até o mais recente
* R2DBC H2 0,8.x a 0,9.x
* R2DBC MariaDB 1.0.2 a 1.1.1
* R2DBC MySQL 0.8.x até o mais recente
* R2DBC MSSQL 0.8.0 até o mais recente
* R2DBC Oracle 0.x até o mais recente
* R2DBC Postgres 0.9.x até o mais recente
* Slick 3.0.0 a 3.3.x
* Solr 4.0 até o mais recente
* Spymemcached 2.11 até o mais recente
* Driver Sybase (jConnect) JDBC 3 6.0 até o mais recente
<Collapser id="instance-level-db" title="Informações do banco de dados em nível de instância"
New Relic coleta [detalhes de instância para uma variedade de bancos de dados e drivers do banco de dados](/docs/apm/applications-menu/features/analyze-database-instance-level-performance-issues). A capacidade de visualizar instâncias específicas e os tipos de informações do banco de dados no APM depende da versão do agente New Relic.
[As versões 3.33.0 ou superior](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-3330) do agente Java da New Relic oferecem suporte ao seguinte:
* Qualquer [driver JDBC compatível](#JDBC)
* Amazon DynamoDB 1.11.106 ou superior
* Amazon v2 DynamoDB 2.1.0 para o mais recente
* Driver DataStax Cassandra 3.0.0 até o mais recente
* Jedis Redis driver 1.4 a 2.10.x, 3.0.0 a 4.x
* MongoDB
* Clientes síncronos: 3.1.0-rc0 para o mais recente
* Clientes de streams assíncrono/reativos: 3.4.0 até 4.1.2
* Spymemcached 2.11.0 até o mais recente
<DoNotTranslate>**Exception:**</DoNotTranslate> As informações no nível da instância não são informadas para chamadas ao método de API `getBulk()` .
O agente Java relata o nome do banco de dados e o atributo do servidor/identificador do banco de dados na consulta lenta trace e trace da transação para esses drivers do banco de dados. Para solicitar informações em nível de instância de datastores adicionais, obtenha suporte em [support.newrelic.com](https://support.newrelic.com).
<Collapser id="hosting-services" title="Serviços de hospedagem"
Você pode instalar o agente Java em vários serviços de hospedagem, incluindo aqueles não listados abaixo. Aqui estão guias de instalação detalhados para serviços de hospedagem específicos:
* [Ambiente flexível do Google App Engine (GAE)](/docs/agents/java-agent/additional-installation/google-app-engine-flexible-installation-java#tomcat-example)
* [Heroku](/docs/agents/java-agent/heroku/java-agent-heroku)
<Collapser id="async" title="Instrumentação assíncrona"
Para frameworks suportados, o agente Java [geralmente funciona automaticamente como instrumento assíncrono](/docs/agents/java-agent/async-instrumentation/asynchronous-applications-monitoring-considerations). No entanto, você pode usar a API do agente Java para [estender essa instrumentação](/docs/agents/java-agent/async-instrumentation/java-agent-api-asynchronous-applications).
<Collapser id="other" title="Outro recurso instrumentado"
* Beans de sessão EJB 3.0 ou superior
* JMX
* JSP (Java Server Pages) 2.0 a 3.0
* [Scala](/docs/agents/java-agent/frameworks/scala-installation-java) 2.9.3 até o mais recente
O agente Java se integra a outros produtos New Relic para oferecer visibilidade de ponta a ponta:
<th>
Integração
</th>
</tr>
<td>
O agente Java injeta automaticamente o agente JavaScript do browser quando você [ativa a instrumentação automática](/docs/browser/new-relic-browser/installation/install-new-relic-browser-agent#select-apm-app). Depois de ativar a injeção do browser, você pode visualizar os dados do browser na [página Resumo do APM](/docs/apm/applications-menu/monitoring/apm-overview-page) e alternar rapidamente entre o APM e os dados do browser para um aplicativo específico. Para opções de configuração e instrumentação manual, consulte [<InlinePopover type="browser"/>e o agente Java](/docs/agents/java-agent/instrumentation/page-load-timing-java).
</td>
</tr>
<tr>
<td>
[Monitoramento de infraestrutura](/docs/infrastructure/new-relic-infrastructure/getting-started/introduction-new-relic-infrastructure)
</td>
<td>
Ao instalar a infraestrutura e o agente APM no mesmo host, eles detectam um ao outro automaticamente. Você pode então visualizar uma lista de hosts na interface do APM e filtrar seus hosts por aplicativo APM em nossa interface de infraestrutura. Para obter mais informações, consulte [Dados do APM na interface de infraestrutura](/docs/infrastructure/new-relic-infrastructure/data-instrumentation/new-relic-apm-data-infrastructure).
</td>
</tr>
<tr>
<td>
[Painel New Relic](/docs/query-your-data/explore-query-data/dashboards/introduction-new-relic-one-dashboards)
</td>
<td>
O agente Java envia evento e atributo padrão para o dashboard, ou você pode [executar a consulta NRQL no criador de consulta](/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data). Você também pode [gravar eventos personalizados](/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents) para análise avançada.
</td>
</tr>
<tr>
<td>
[Monitoramento sintético](/docs/synthetics/new-relic-synthetics/getting-started/introduction-new-relic-synthetics)
</td>
<td>
[Sintético trace da transação](/docs/synthetics/new-relic-synthetics/using-monitors/collect-synthetic-transaction-traces) conecta solicitações do monitor Sintético à transação APM subjacente.
</td>
</tr>
| Produtos |
|---|
| [Monitoramento de browser](/docs/browser/new-relic-browser/getting-started/introduction-new-relic-browser) |