btrace

btrace

Un outil de traçage sûr et dynamique pour la plateforme Java

Version

2.2.6

Résumé rapide

BTrace est un outil de traçage sécurisé et dynamique pour la plateforme Java.

BTrace peut être utilisé pour tracer dynamiquement un programme Java en cours d'exécution (similaire à DTrace pour les applications et le système d'exploitation OpenSolaris). BTrace instrumente dynamiquement les classes de l'application cible pour injecter du code de traçage ("bytecode tracing").

Crédits

• Basé sur l'ASM
• Propulsé par JCTools
• Propulsé par hppcrt
• Optimisé avec JProfiler Java Profiler
• Créez un assistant d'environnement à l'aide de SDKMAN !

Construire BTrace

Installation

Vous aurez besoin des applications suivantes installées

• Git
• (en option, le lanceur par défaut est le wrapper gradlew fourni) Gradle

Construire

Graduation

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

Les packages de distribution binaire peuvent être trouvés dans <btrace>/btrace-dist/build/distributions sous les fichiers *.tar.gz, *.zip, *.rpm et *.deb. Le dossier binaire éclaté qui peut être utilisé immédiatement se trouve dans <btrace>/btrace-dist/build/resources/main qui sert d'emplacement BTRACE_HOME .

Utiliser BTrace

Installation

Téléchargez un fichier de distribution à partir de la page de version. Décomposez le fichier de distribution binaire (soit *.tar.gz, soit *.zip) dans un répertoire de votre choix.

Vous pouvez définir la variable d'environnement système BTRACE_HOME pour qu'elle pointe vers le répertoire contenant la distribution éclatée.

Vous pouvez améliorer la variable d'environnement système PATH avec $BTRACE_HOME/bin pour votre commodité.

Vous pouvez également installer l'un des packages *.rpm ou *.deb.

En cours d'exécution

• <btrace>/bin/btrace <PID> <trace_script> s'attachera à l'application Java avec le PID donné et compilera et soumettra le script de trace
• <btrace>/bin/btracec <trace_script> compilera le script de trace fourni
• <btrace>/bin/btracer <compiled_script> <args to launch a java app> démarrera l'application java spécifiée avec l'agent btrace en cours d'exécution et le script précédemment compilé par btracec chargé

Pour le guide d'utilisation détaillé, veuillez consulter le Wiki.

Intégration Maven

Le plugin maven fournit une compilation facile de scripts BTrace dans le cadre du processus de construction. En prime, vous pouvez utiliser l' archétype du projet BTrace pour amorcer le développement de scripts BTrace .

Contribuer - !!! Important !!!

Les demandes d'extraction ne peuvent être acceptées que des signataires de l'accord de contributeur Oracle.

Dépôt Deb

À l'aide de la ligne de commande, ajoutez ce qui suit à votre fichier de configuration système /etc/apt/sources.list :

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

Vous pouvez également ajouter les URL du référentiel à l'aide de l'interface utilisateur d'administration « Sources logicielles » :

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

Référentiel RPM

Récupérez le fichier *.repo wget https://bintray.com/btraceio/rpm/rpm -O bintray-btraceio-rpm.repo et utilisez-le.