Quer ajudar para que o nosso agente Java para Elastic APM trabalhe melhor para você? Aprenda algumas dicas para colaborar com um plugin com este guia prático de

blog-banner-release-apm.png

contribute-apm-java-agent-thumb.png

A cookbook for contributing a plugin to the Elastic APM Java agent

Um manual para colaborar com um plugin voltado ao agente Java para Elastic APM

A versão de produção do agente de Java do Elastic APM já está disponível. Aprenda a instrumentar suas aplicações Java para monitorar a performance

<html><head></head><body><p>&#xC9; com muita alegria que anunciamos o lan&#xE7;amento da vers&#xE3;o de produ&#xE7;&#xE3;o do nosso <a href="/guide/en/apm/agent/java/1.x/index.html">agente de Java</a>. Ap&#xF3;s uma <a href="/pt/blog/elastic-apm-java-agent-beta-released">fase beta bem-sucedida</a>, com muitos downloads e coment&#xE1;rios dos usu&#xE1;rios, estamos preparados para lan&#xE7;ar a vers&#xE3;o de produ&#xE7;&#xE3;o, a 1.0. Observe que esta vers&#xE3;o requer, no m&#xED;nimo, o APM Server 6.5.
</p><p>O agente de Java &#xE9; o novo integrante da fam&#xED;lia de agentes do <a href="/pt/solutions/apm">Elastic APM</a>, juntando-se aos agentes de <a href="https://github.com/elastic/apm-agent-nodejs">Node.js</a>, <a href="https://github.com/elastic/apm-agent-python">Python</a>, <a href="https://github.com/elastic/apm-agent-ruby">Ruby</a>, <a href="https://github.com/elastic/apm-agent-js-base">JavaScript/RUM</a> e <a href="https://github.com/elastic/apm-agent-go">Go</a> (tamb&#xE9;m uma nova <a href="/pt/blog/elastic-apm-go-agent-1-0-0-released">vers&#xE3;o de produ&#xE7;&#xE3;o</a>). O Elastic APM &#xE9; a solu&#xE7;&#xE3;o de monitoramento de performance de aplica&#xE7;&#xF5;es (Application Performance Monitoring, em ingl&#xEA;s) da Elastic que ajuda voc&#xEA; a obter insights sobre a performance das suas aplica&#xE7;&#xF5;es e a rastrear erros.
</p><h2>Principais recursos</h2><p><em>O que j&#xE1; vem pronto para voc&#xEA;</em>
</p><p>A <a href="/guide/en/apm/agent/java/1.x/intro.html#get-started">instala&#xE7;&#xE3;o do agente de Java do Elastic APM</a> &#xE9; t&#xE3;o simples quanto adicionar a flag <code>-javaagent</code> e algumas propriedades de sistema ao comando de inicializa&#xE7;&#xE3;o da sua JVM. Se voc&#xEA; estiver usando <a href="/guide/en/apm/agent/java/1.x/supported-technologies-details.html">frameworks e plataformas compat&#xED;veis</a>, como Spring MVC/Spring Boot, Servlet API e JAX-RS, sua aplica&#xE7;&#xE3;o ser&#xE1; instrumentada e monitorada automaticamente.
</p><h3>Visibilidade de solicita&#xE7;&#xF5;es da Web</h3><p>Tenha uma vis&#xE3;o geral de alto n&#xED;vel das suas aplica&#xE7;&#xF5;es em Java e aprofunde-se nos dados para saber como est&#xE1; o desempenho individual dos seus Servlets ou Spring Controllers:
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt9667c33a676a29ea/5c304b945a7621286e3e907b/java_agent1.jpg" data-sys-asset-uid="blt9667c33a676a29ea">
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt877690091dbeeb03/5c304b8faab458d30b3141da/java_agent2.png" data-sys-asset-uid="blt877690091dbeeb03" alt="" "="">
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltab0475774c8dec5c/5c304b8ba253ae3e67bc858d/java_agent3.jpg" data-sys-asset-uid="bltab0475774c8dec5c" alt="" "="">
</p><h3>Visibilidade do armazenamento de dados</h3><p>Voc&#xEA; usa o JDBC ou o Elasticsearch? Descubra onde sua aplica&#xE7;&#xE3;o em Java passa mais tempo em chamadas de banco de dados, quais consultas demoram mais e quais erros elas est&#xE3;o produzindo. Voc&#xEA; pode se surpreender com os tipos de consultas que o seu mapeador ORM gera!
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltb0f3f9bcdf0aff4e/5c304b8793d9791a70cd7351/java_agent4.png" data-sys-asset-uid="bltb0f3f9bcdf0aff4e" alt="" "="">
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt6be0fe22d8a8590c/5c304b84a253ae3e67bc8587/java_agent5.png" data-sys-asset-uid="blt6be0fe22d8a8590c" alt="" "="">
</p><h3>Visibilidade de redes</h3><p>O agente de Java tamb&#xE9;m registra quanto tempo sua aplica&#xE7;&#xE3;o est&#xE1; dedicando a chamadas HTTP externas para que voc&#xEA; consiga saber quanto &#xE9; gasto com a espera de servi&#xE7;os que est&#xE3;o fora do seu controle.
</p><h3>Rastreamento distribu&#xED;do</h3><p>Se sua aplica&#xE7;&#xE3;o em Java for apenas um componente em uma configura&#xE7;&#xE3;o multisservi&#xE7;o, seus rastreamentos incluir&#xE3;o dados coletados de todos os chamadores e receptores de chamadas que t&#xEA;m um agente de APM instalados neles tamb&#xE9;m. Se voc&#xEA; estiver usando um dos <a href="/guide/en/apm/agent/java/1.x/supported-technologies-details.html#supported-networking-frameworks">frameworks de rede compat&#xED;veis</a>, o agente garantir&#xE1; a passagem de IDs de correla&#xE7;&#xE3;o para que voc&#xEA; consiga ver quais servi&#xE7;os est&#xE3;o envolvidos no atendimento de uma requisi&#xE7;&#xE3;o e qual foi respons&#xE1;vel por uma eventual lentid&#xE3;o da requisi&#xE7;&#xE3;o. Saiba mais sobre o rastreamento distribu&#xED;do no <a href="/pt/blog/elastic-apm-6-5-0-released">an&#xFA;ncio de lan&#xE7;amento do Elastic APM 6.5.0</a>.
</p><h2>Enrique&#xE7;a e expanda</h2><p><em>Para tudo o que voc&#xEA; quer, mas que n&#xE3;o vem pronto</em>
</p><p>Sua aplica&#xE7;&#xE3;o em Java n&#xE3;o usa nenhuma das <a href="/guide/en/apm/agent/java/1.x/supported-technologies-details.html">tecnologias compat&#xED;veis</a>? Voc&#xEA; quer ter mais visibilidade de partes espec&#xED;ficas do seu c&#xF3;digo interno? Tudo bem, n&#xF3;s oferecemos a infraestrutura capaz de ajudar voc&#xEA; a rastrear praticamente qualquer coisa.
</p><h3>Customize sua solu&#xE7;&#xE3;o APM com a nossa API</h3><p>Voc&#xEA; pode rastrear o m&#xE9;todo que quiser usando a nossa <a href="/guide/en/apm/agent/java/1.x/public-api.html">API p&#xFA;blica</a>. Essa API permite que voc&#xEA; customize e crie manualmente intervalos e transa&#xE7;&#xF5;es, al&#xE9;m de rastrear erros.
</p><p>Por exemplo, nossa API de anota&#xE7;&#xF5;es pode ser usada da seguinte maneira:
</p><pre class="prettyprint">import co.elastic.apm.api.CaptureSpan;
import co.elastic.apm.api.ElasticApm;
import co.elastic.apm.api.Span;
public class MyImportantBusinessLogic {
    @CaptureSpan(&quot;Main-business-logic&quot;)
    public void myVeryImportantMethod(String someInfo) {
        ElasticApm.currentSpan().addTag(&quot;info&quot;, someInfo);
        // Minha l&#xF3;gica importante entra aqui
    }
}
</pre><p>Para que seu c&#xF3;digo apare&#xE7;a como um intervalo:
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt34a69514a6b7a76a/5c304b7f5a7621286e3e9075/java_agent6.png" data-sys-asset-uid="blt34a69514a6b7a76a" alt="">
</p><p>Para usar a API p&#xFA;blica no seu c&#xF3;digo, voc&#xEA; pode declarar uma depend&#xEA;ncia ao artefato apm-agent-api, dispon&#xED;vel no <a href="https://search.maven.org/search?q=g:co.elastic.apm%20AND%20a:apm-agent-api">Maven Central</a>.
</p><h3>Compatibilidade com a API do OpenTracing</h3><p>Voc&#xEA; tamb&#xE9;m pode usar nossa <a href="/guide/en/apm/agent/java/1.x/opentracing-bridge.html">ponte do OpenTracing</a> para criar <code>Transa&#xE7;&#xF5;es</code> e <code>Intervalos</code> do Elastic APM, usando a API do OpenTracing. Ela transforma as chamadas da API do OpenTracing para o APM, possibilitando a reutiliza&#xE7;&#xE3;o da instrumenta&#xE7;&#xE3;o existente.
</p><p>H&#xE1; total compatibilidade para mesclar e correlacionar os recursos de instrumenta&#xE7;&#xE3;o autom&#xE1;tica do agente do Elastic APM com uma instrumenta&#xE7;&#xE3;o expl&#xED;cita usando o OpenTracing: voc&#xEA; pode usar a API do OpenTracing para personalizar os intervalos que o Elastic APM cria automaticamente, aperfei&#xE7;oar a instrumenta&#xE7;&#xE3;o autom&#xE1;tica com seus intervalos customizados ou desativar os recursos de instrumenta&#xE7;&#xE3;o autom&#xE1;tica e usar a API do OpenTracing para instrumentar sua aplica&#xE7;&#xE3;o de forma manual.
</p><p>Veja um exemplo que mostra como usar a API do OpenTracing para rastrear m&#xE9;todos customizados:
</p><pre class="prettyprint">import co.elastic.apm.opentracing.ElasticApmTracer;
import io.opentracing.Scope;
import io.opentracing.Span;
import io.opentracing.Tracer;
import io.opentracing.log.Fields;
public class MyBusinessLogic {
    private final Tracer tracer = new ElasticApmTracer();
    public void myVeryImportantMethod(String someInfo) {
        Span span = tracer.buildSpan(&quot;Main-business-logic&quot;).start();
        try (Scope scope = tracer.scopeManager().activate(span, false)) {
            // Minha l&#xF3;gica importante entra aqui
        } catch(Exception ex) {
            Tags.ERROR.set(span, true);
            span.log(Map.of(Fields.EVENT, &quot;error&quot;, Fields.ERROR_OBJECT, ex, Fields.MESSAGE, ex.getMessage()));
        } finally {
            span.finish();
        }
    }
}
</pre><p>Isso cria o seu intervalo do OpenTracing como um filho do intervalo criado pela instrumenta&#xE7;&#xE3;o autom&#xE1;tica do agente do Elastic APM.
</p><h2>O que vem a seguir?</h2><p>At&#xE9; aqui, nos concentramos em modelos de execu&#xE7;&#xE3;o tradicionais de thread por requisi&#xE7;&#xE3;o. No entanto, cada vez mais aplica&#xE7;&#xF5;es usam frameworks reativos para se beneficiar dos ganhos de escalabilidade que esse modelo proporciona. No futuro, ofereceremos integra&#xE7;&#xF5;es e instrumenta&#xE7;&#xE3;o autom&#xE1;ticas melhores para esses frameworks. Tamb&#xE9;m nos concentraremos em aperfei&#xE7;oar a integra&#xE7;&#xE3;o de logs, m&#xE9;tricas e rastreamentos.
</p><h2>Queremos ouvir a sua opini&#xE3;o</h2><p>Se n&#xE3;o oferecemos compatibilidade com o framework ou servidor de aplica&#xE7;&#xF5;es da sua prefer&#xEA;ncia, responda &#xE0; <a href="https://docs.google.com/forms/d/e/1FAIpQLScd0RYiwZGrEuxykYkv9z8Hl3exx_LKCtjsqEo1OWx8BkLrOQ/viewform">pesquisa de agentes de Java</a> para nos ajudar a pensar no futuro.
</p><p>Experimente usar com a sua aplica&#xE7;&#xE3;o em Java hoje mesmo e nos conte sobre sua experi&#xEA;ncia no <a href="https://discuss.elastic.co/c/apm">f&#xF3;rum de discuss&#xE3;o</a>. Se quiser, ser&#xE1; um prazer ter a sua participa&#xE7;&#xE3;o no <a href="https://github.com/elastic/apm-agent-java">GitHub</a>.
</p></body></html>

blog-apm-banner.png

blog-apm-thumbnail.png

Elastic APM Java Agent is Generally Available

A versão de produção do agente de Java do Elastic APM já está disponível

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Eyal Koren

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Communication Preferences - ONLY for /communication-preferences

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/elastic-cloud-account-terms" target="_self">Termos de Serviço</a> e também concorda em receber <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">comunicações especiais</a> por meio dos dados de contato que forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Serverless GDPR Text

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/serverless-preview-terms" target="_self">Termos de Serviço</a> e que a Elastic pode <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">entrar em contato com você</a> para divulgar nossos produtos e serviços relacionados usando os dados que você forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

<p>By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.</p>

Cloud Trial GDPR Text

<p>Ao enviar, você concorda com os <a href="/pt/agreements/global/cloud-services-monthly" rel="nofollow">Termos de Serviço do Elastic Cloud</a>. Seus dados pessoais serão tratados de acordo com a <a href="/pt/legal/privacy-statement">Declaração de Privacidade da Elastic</a>.
</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Newsletter GDPR Text

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/terms-of-use" target="_self">Termos de Serviço</a> e que a Elastic pode <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">entrar em contato com você</a> para divulgar nossos produtos e serviços relacionados usando os dados que você forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

Explore similar demos

Explore outras demonstrações semelhantes

Overview

Load More

Speakers

Close

See more insights

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

O conteúdo desta página não está disponível no idioma selecionado. A Elastic está trabalhando para garantir que o conteúdo esteja disponível em vários idiomas.Agradecemos a compreensão.

Author

Articles by

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Consultar a hora de início do webinar no meu fuso horário

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Não vai conseguir participar? Inscreva-se e nós lhe enviaremos a gravação. Você também receberá um email com conteúdo relacionado.

Author

Articles by Eyal Koren

Um manual para colaborar com um plugin voltado ao agente Java para Elastic APM

A versão de produção do agente de Java do Elastic APM já está disponível

Sign up for Elastic Cloud free trial