btrace

btrace

Ein sicheres, dynamisches Tracing-Tool für die Java-Plattform

Version

2.2.6

Kurze Zusammenfassung

BTrace ist ein sicheres, dynamisches Tracing-Tool für die Java-Plattform.

BTrace kann verwendet werden, um ein laufendes Java-Programm dynamisch zu verfolgen (ähnlich wie DTrace für OpenSolaris-Anwendungen und -Betriebssysteme). BTrace instrumentiert die Klassen der Zielanwendung dynamisch, um Tracing-Code („Bytecode-Tracing“) einzuschleusen.

Credits

• Basierend auf ASM
• Unterstützt von JCTools
• Unterstützt von hppcrt
• Optimiert mit JProfiler Java Profiler
• Erstellen Sie einen Umgebungshelfer mit SDKMAN!

Erstellen von BTrace

Aufstellen

Sie müssen die folgenden Anwendungen installiert haben

• Git
• (Optional ist der Standard-Launcher der mitgelieferte gradlew -Wrapper) Gradle

Bauen

Gradle

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

Die binären Dist-Pakete finden Sie in <btrace>/btrace-dist/build/distributions als *.tar.gz-, *.zip-, *.rpm- und *.deb-Dateien. Der explodierte Binärordner, der sofort verwendet werden kann, befindet sich unter <btrace>/btrace-dist/build/resources/main , der als BTRACE_HOME -Speicherort dient.

Verwendung von BTrace

Installation

Laden Sie eine Distributionsdatei von der Release-Seite herunter. Explodieren Sie die Binärverteilungsdatei (entweder *.tar.gz oder *.zip) in ein Verzeichnis Ihrer Wahl.

Sie können die Systemumgebungsvariable BTRACE_HOME so festlegen, dass sie auf das Verzeichnis zeigt, das die explodierte Verteilung enthält.

Sie können die Systemumgebungsvariable PATH zu Ihrer Bequemlichkeit mit $BTRACE_HOME/bin erweitern.

Alternativ können Sie auch eines der *.rpm- oder *.deb-Pakete installieren

Läuft

• <btrace>/bin/btrace <PID> <trace_script> stellt eine Verbindung zur Java- Anwendung mit der angegebenen PID her und kompiliert und sendet das Trace-Skript
• <btrace>/bin/btracec <trace_script> kompiliert das bereitgestellte Trace-Skript
• <btrace>/bin/btracer <compiled_script> <args to launch a java app> startet die angegebene Java-Anwendung mit laufendem Btrace-Agent und geladenem Skript, das zuvor von Btracec kompiliert wurde

Die ausführliche Bedienungsanleitung finden Sie im Wiki.

Maven-Integration

Das Maven-Plugin ermöglicht die einfache Kompilierung von BTrace -Skripten als Teil des Build-Prozesses. Als Bonus können Sie den BTrace-Projektarchetyp verwenden, um die Entwicklung von BTrace -Skripten zu starten.

Mitwirken - !!! Wichtig !!!

Pull-Requests können nur von den Unterzeichnern der Oracle Contributor Agreement akzeptiert werden

Deb-Repository

Fügen Sie über die Befehlszeile Folgendes zu Ihrer Systemkonfigurationsdatei /etc/apt/sources.list hinzu:

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

Oder fügen Sie die Repository-URLs über die Admin-Benutzeroberfläche „Softwarequellen“ hinzu:

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

RPM-Repository

Besorgen Sie sich die *.repo- Datei wget https://bintray.com/btraceio/rpm/rpm -O bintray-btraceio-rpm.repo und verwenden Sie sie.