PMDA to provide enhanced analysis reports for Vector. Work in progress.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
BINFlameGraph
BINHeatMap chore: sync with internal branch Jan 25, 2018
JSTACK chore: sync with internal branch Jan 25, 2018
.NeedInstall
.gitignore
Install chore: sync with internal branch Jan 25, 2018
LICENSE
Makefile
README
Remove chore: sync with internal branch Jan 25, 2018
cpuflamegraph.sh task: update webroot to pcp default Feb 7, 2018
cswflamegraph.sh task: update webroot to pcp default Feb 7, 2018
diskioflamegraph.sh
domain.h fix: missing sync files Jan 25, 2018
heatmap.sh
help chore: sync with internal branch Jan 25, 2018
ipcflamegraph.sh task: update webroot to pcp default Feb 7, 2018
jstack.sh task: update webroot to pcp default Feb 7, 2018
offcpuflamegraph.sh
offwakeflamegraph.sh task: update webroot to pcp default Feb 7, 2018
pagefaultflamegraph.sh task: update webroot to pcp default Feb 7, 2018
perfmaplib.sh correct fix for nsenter Feb 8, 2018
perfmaptidy.pl
pmns chore: sync with internal branch Jan 25, 2018
pnamecpuflamegraph.sh task: update webroot to pcp default Feb 7, 2018
root chore: sync with internal branch Jan 25, 2018
uninlinedcpuflamegraph.sh
vector.c
vectorlib.sh

README

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.