btrace

btrace

Uma ferramenta de rastreamento dinâmica e segura para a plataforma Java

Versão

2.2.6

Resumo rápido

BTrace é uma ferramenta de rastreamento dinâmica e segura para a plataforma Java.

O BTrace pode ser usado para rastrear dinamicamente um programa Java em execução (semelhante ao DTrace para aplicativos e sistemas operacionais OpenSolaris). O BTrace instrumenta dinamicamente as classes do aplicativo de destino para injetar código de rastreamento ("rastreamento de bytecode").

Créditos

• Baseado em ASM
• Desenvolvido por JCTools
• Desenvolvido por hppcrt
• Otimizado com JProfiler Java Profiler
• Construa um auxiliar de ambiente usando SDKMAN!

Construindo BTrace

Configurar

Você precisará dos seguintes aplicativos instalados

• Git
• (opcionalmente, o inicializador padrão é o wrapper gradlew incluído) Gradle

Construir

Gradle

 cd < btrace >
./gradlew :btrace-dist:build

Os pacotes dist binários podem ser encontrados em <btrace>/btrace-dist/build/distributions como os arquivos *.tar.gz, *.zip, *.rpm e *.deb. A pasta binária explodida que pode ser usada imediatamente está localizada em <btrace>/btrace-dist/build/resources/main que serve como local BTRACE_HOME .

Usando BTrace

Instalação

Baixe um arquivo de distribuição na página de lançamento. Exploda o arquivo de distribuição binária (*.tar.gz ou *.zip) para um diretório de sua escolha.

Você pode definir a variável de ambiente do sistema BTRACE_HOME para apontar para o diretório que contém a distribuição explodida.

Você pode aprimorar a variável de ambiente do sistema PATH com $BTRACE_HOME/bin para sua conveniência.

Ou, alternativamente, você pode instalar um dos pacotes *.rpm ou *.deb

Correndo

• <btrace>/bin/btrace <PID> <trace_script> será anexado ao aplicativo java com o PID fornecido e compilará e enviará o script de rastreamento
• <btrace>/bin/btracec <trace_script> compilará o script de rastreamento fornecido
• <btrace>/bin/btracer <compiled_script> <args to launch a java app> iniciará o aplicativo java especificado com o agente btrace em execução e o script previamente compilado por btracec carregado

Para obter o guia do usuário detalhado, verifique o Wiki.

Integração Maven

O plugin maven fornece fácil compilação de scripts BTrace como parte do processo de construção. Como bônus, você pode utilizar o Arquétipo do Projeto BTrace para inicializar o desenvolvimento de scripts BTrace .

Contribuindo - !!! Importante !!!

Solicitações pull podem ser aceitas somente dos signatários do Contrato de Contribuinte da Oracle

Repositório Deb

Usando a linha de comando, adicione o seguinte ao arquivo de configuração do sistema /etc/apt/sources.list:

 echo "deb http://dl.bintray.com/btraceio/deb xenial universe" | sudo tee -a /etc/apt/sources.list

Ou adicione os URLs do repositório usando a interface de administração de "Fontes de software":

 deb http://dl.bintray.com/btraceio/deb xenial universe

Repositório RPM

Pegue o arquivo *.repo wget https://bintray.com/btraceio/rpm/rpm -O bintray-btraceio-rpm.repo e use-o.