Skip to main content

Tool to plot HDR histogram data and histostats data generated by NoSQLBench

Project description

NB HDR plotter

A tool to plot HDR histogram data (and histostats output) from NoSQLBench.

Setup

Pre-requisites

Python 3.8+ is required.

Installation

Install with

pip install nb-hdr-plotter

Quickstart

Assuming you have an HDR histogram file to plot:

nb_hdr_plotter                          \
    hdr_data.log                        \
    -b -c -s                            \
    -p SampleData                       \
    -d SampleDump                       \
    -m cqlkeyvalue_default_main.result

Assuming you have a histostats output file to plot:

histostats_plotter                      \
    histostats.log                      \
    -p HistostatsSample                 \
    -m cqlkeyvalue_default_main.result

The Github repository contains sample plots obtained with these tools.

More options

  • nb_hdr_plotter can dump to a txt table file (as opposed to a PNG image);
  • it can selectively plot histogram, percentiles, stability plot;
  • it can interactively help you select the metric to plot;
  • it can optionally refrain from time unit conversion and overwrite files.

Check out the online help:

$> nb_hdr_plotter -h
usage: nb_hdr_plotter [-h] [-i] [-m METRICTAG] [-b] [-c] [-s] [-p PLOTFILEROOT] [-d DUMPFILEROOT] [-f] [-r] filename

Manipulate HDR data generated in NoSQLBench.

positional arguments:
  filename              HDR input data

optional arguments:
  -h, --help            show this help message and exit
  -i, --inspect         Detailed input breakdown

Analysis tasks:
  -m METRICTAG, --metric METRICTAG
                        Work on the specified metric tag (interactive choice if not provided)
  -b, --baseplot        Create standard distribution plot
  -c, --percentiles     Create percentile analysis
  -s, --stability       Perform stability analysis (per-slice plots)

Output control:
  -p PLOTFILEROOT, --plot PLOTFILEROOT
                        Create plot images (with given file root)
  -d DUMPFILEROOT, --dump DUMPFILEROOT
                        Dump to data files (with given file root)
  -f, --force           Overwrite existing file(s) if necessary
  -r, --raw             Keep raw values found in histograms (no unit conversions)
  • histostats_plotter can include/exclude plotting the "max" alongside the other percentiles;
  • it offers interactive selection of the metric to plot;
  • it optionally overwrites existing files:
$> histostats_plotter -h
usage: histostats_plotter [-h] [-m METRICTAG] [-p PLOTFILEROOT] [--include-max] [-f] filename

Quickly plot "--log-histostats" output from NoSQLBench to an image.

positional arguments:
  filename              Histostats input file

optional arguments:
  -h, --help            show this help message and exit
  -m METRICTAG, --metric METRICTAG
                        Work on the specified metric tag (interactive choice if not provided)
  -p PLOTFILEROOT, --plot PLOTFILEROOT
                        Create plot image (with given file root), automatic if not provided
  --include-max         Include "max" to plotting
  -f, --force           Overwrite existing file if necessary

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nb_hdr_plotter-0.1.2.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

nb_hdr_plotter-0.1.2-py3-none-any.whl (17.7 kB view details)

Uploaded Python 3

File details

Details for the file nb_hdr_plotter-0.1.2.tar.gz.

File metadata

  • Download URL: nb_hdr_plotter-0.1.2.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.5

File hashes

Hashes for nb_hdr_plotter-0.1.2.tar.gz
Algorithm Hash digest
SHA256 94e7e105dbca48446e9b3061fb1f6efcd208cda5a2edea398495f70813703396
MD5 a5405da33ec2229e1fab1bb776842e0f
BLAKE2b-256 57725d936ab382ea03fcb1d770766665652efbaa7939f0c6708bdd9a10bdc0b9

See more details on using hashes here.

File details

Details for the file nb_hdr_plotter-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for nb_hdr_plotter-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2e7204ce313d9e3a7b165583e753698a0db784cb3a6c7cdd85de651c502df719
MD5 f330d06e3bbea8f8c3e311292970ba32
BLAKE2b-256 772287c438e71452e2bba18bc82e217815482a83d76e1d912c9ce606735c9050

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page