Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
PMDA to provide enhanced analysis reports for Vector. Work in progress.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Vector PMDA =========== PMDA to provide enhanced analysis reports for Vector. See http://getvector.io/docs/cpu-flame-graphs.html **WARNING:** This is a work in progress. Use at your own risk. Metrics ======= The file ./help contains descriptions for all of the metrics exported by this PMDA. Once the PMDA has been installed, the following command will list all the available metrics and their explanatory "help" text: $ pminfo -fT vector Dependencies ============ You **must** have these dependencies installed in order to successfully generate the graphs. * **perf command** - On Debian/Ubuntu based distributions, this is part of the *linux-tools* package. * **perf-map-agent** - *Java-only* - If you would like to translate Java symbols, you will need perf-map-agent. Follow the instructions on [perf-map-agent](https://github.com/jrudolph/perf-map-agent) to install it. * **Patched JDK** - *Java-only* - Besides perf-map-agent, you will also need a patched JDK that includes *frame pointer register*. From Java 8 update 60 onwards, this is made available by the *-XX:+PreserveFramePointer* option. Installation ============ + # cd $PCP_PMDAS_DIR/vector + Check that there is no clash in the Performance Metrics Domain defined in ./domain.h and the other PMDAs currently in use (see $PCP_PMCDCONF_PATH). If there is, edit ./domain.h to choose another domain number. + Build the PMDA # ./make + Then simply use # ./Install and choose both the "collector" and "monitor" installation configuration options -- everything else is automated. De-installation =============== + Simply use # cd $PCP_PMDAS_DIR/vector # ./Remove Troubleshooting =============== + After installing or restarting the agent, the PMCD log file ($PCP_LOG_DIR/pmcd/pmcd.log) and the PMDA log file ($PCP_LOG_DIR/pmcd/vector.log) should be checked for any warnings or errors.