• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

API do agente Java para aplicativo assíncrono

New Relic for Java (agente versão 3.37 ou superior) inclui uma API para instrumento de atividade assíncrona. Para frameworks suportados, o agente normalmente instrumento assíncrono funciona automaticamente. No entanto, a API assíncrona ainda pode ser útil para adicionar detalhes. Este documento fornece exemplos de uso de token e segmentos para instrumentar seu aplicativo.

Ferramentas de rastreamento assíncrono: token e segmentos

A API do agente Java fornece duas maneiras de trace a atividade assíncrona:

  • Tokens

    : tokens são passados entre threads para vincular unidade de trabalho assíncrona a uma transação específica. Eles não executam nenhuma cronometragem diretamente.

  • Segments

    : os segmentos são usados para medir uma parte arbitrária do código de aplicativo assíncrono, não necessariamente associado a um método ou thread. Os segmentos normalmente são usados para rastrear chamadas externas que são concluídas por um mecanismo de retorno de chamada.

Token: conecta threads assíncronos

Use token para vincular unidades de trabalho arbitrárias que estejam em threads separados. Esta seção descreve como usar as chamadas relacionadas ao token em conjunto para o trabalho assíncrono do instrumento. Para obter informações detalhadas sobre classes e métodos, consulte o Javadoc.

Para usar tokens, primeiro você precisa criar o token e depois vincular outra chamada à transação de origem. Você deve vincular o token o mais rápido possível na outra chamada. Se você não vincular o token imediatamente, corre o risco de perder quaisquer métodos que contenham um @Trace abaixo da chamada que você está tentando vincular. Você também pode expirar o token na chamada original. O agente Java vinculará o trabalho na interface do New Relic. Estes exemplos ilustram como usar as chamadas relacionadas ao token juntas:

Dica

Por padrão, uma transação pode criar no máximo 3.000 tokens e cada token tem um tempo limite padrão de 180s. Você pode alterar o limite anterior com a opção de configuração token_limit e o último com a opção de configuração token_timeout . trace para transação que exceda token_limit conterá um atributo token_clamp . Aumentar qualquer uma das opções de configuração pode aumentar o uso de memória do agente.

Segmentos: atividade assíncrona arbitrária de tempo

Segmentos são usados para medir uma parte arbitrária de código de aplicativo assíncrono, não necessariamente associado a um método ou thread. Isso é mais comumente usado para cronometrar conexões com serviços externos. Use segmentos se quiser:

  • Código de tempo que é concluído por meio de um retorno de chamada
  • Cronometre uma chamada assíncrono que abrange vários métodos
  • Meça o tempo entre a criação e a execução do trabalho (por exemplo, em um pool de threads)

Dica

Por padrão, o agente pode rastrear no máximo 1.000 segmentos durante uma determinada transação. Você pode alterar esse limite com a opção de configuração segment_timeout . rastreamento de transação que exceda esse limite conterá um atributo segment_clamp . Aumentar esse limite pode aumentar o uso de memória do agente.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.