BullFrog is an Artifactory specific open source Java APM based on Glowroot.
- Java 8+
- Artifactory 4+
BullFrog builds on top of Glowroot. The early phase will include Artifactory gauge defaults, cosmetic, and terminology changes.
The next phases will add:
- Dashboard - Monitor Artifactory and system resources on a single page
- View Artifactory specific properties from the BullFrog UI
- Alerts for known bottleneck resources (connections, threads, db, etc)
The installation instructions depend on your set up. There are two options, the standalone and the central collection option.
The standalone option is a good choice if you only want to monitor 1 Artifactory instance. You can read the instructions on the Agent Installation wiki.
Central Collector Installation
The central collector option is the way to go if you want to monitor multiple Artifactory instances from a single location. You will need to first set up the central server and then configure the agents to talk to it. You can read the instructions on the Central Collector Installation wiki.
Please report any issues!
mvn clean install
Binary distribution is built under agent-parent/dist/target.
Building requires Java 7+ (in order to perform Immutables annotation processing) and Maven 3.1.0+.
BullFrog/Glowroot uses Immutables annotation processing to eliminate maintenance on lots of boilerplate code. If you are using Eclipse, this requires installing the m2e-apt plugin and changing Window > Preferences > Maven > Annotation Processing to "Automatically configure JDT APT".
To work on the UI, run org.glowroot.ui.sandbox.UiSandboxMain under a debugger inside your favorite IDE. This starts Glowroot and generates a variety of sample traces to give the UI something to display. Connect your browser to http://localhost:4000.
mvn clean install, Node, Bower and Grunt are installed locally under the
ui directory (thanks to the frontend-maven-plugin).
If you are modifying web assets, you either need to run grunt to re-build them after each change, or (better) run
grunt serve from the
ui directory and connect your browser to http://localhost:9000.
grunt serve serves up the Glowroot web assets to the browser without the concat/minify/rev step, which makes testing/debugging much easier. It reverse proxies non- static resource requests to http://localhost:4000 to be handled by Glowroot. It also watches for changes to the files and performs live-reload of web assets inside the browser.
Integration tests are run during Maven's standard
integration-test lifecycle phase.
The Glowroot agent has an integration test harness which makes it easy to run sample application code and then validate the data captured by the agent. The integration test harness is able to run tests both using a custom weaving class loader (which is very convenient for running and debugging inside your favorite IDE), and by spawning a JVM with the -javaagent flag (which more correctly simulates real world conditions).
Browser-based integration tests are run using WebDriver. By default they run against Firefox. Thanks to Sauce Labs, they also run against Chrome, IE (9, 10, 11) and Safari (6, 7, 8, 9) during every Travis CI build (see the jobs with TARGET=saucelabs).
mvn clean package java -jar target/benchmarks.jar -jvmArgs -javaagent:path/to/glowroot.jar
All third party java libraries used by the agent are shaded under the org.glowroot.agent.shaded package to ensure there are no jar version conflicts with the application being monitored.
BullFrog source code is licensed under the Apache License, Version 2.0.
See Third Party Software for license detail of third party software included in the binary distribution.