Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/countvajhula/splinter

A Simple Graph Stress Tester
https://github.com/countvajhula/splinter

Last synced: 22 days ago
JSON representation

A Simple Graph Stress Tester

Awesome Lists containing this project

README

        

h1. Introduction

A simple automated graph stress test tool based on the "Pilot":https://github.com/countvajhula/pilot graph operator, utilizing the "Tinkerpop":http://tinkerpop.com stack -- i.e. "Blueprints":https://github.com/tinkerpop/blueprints/wiki, "Gremlin":https://github.com/tinkerpop/gremlin/wiki, "Pipes":https://github.com/tinkerpop/pipes/wiki. You can use it to:
* *quickly generate random graphs* of whatever configuration you want (you can specify number of vertices and level of connectivity)
* *benchmark* different graph database providers on some defined metrics
* *automate* sets of tests to be run on any number of graphs

h1. To Use:

h2. For Maven Users

After downloading the project, just:

bc. $ mvn clean install
$ mvn exec:java -Dexec.args="sampletestdefinition.xml"

p. In the above command, any test definition XML file may be used in place of the example sampletestdefinition.xml file provided.

h2. Non-Maven

h3. Dependencies

Make sure you have Pilot, the Tinkerpop libraries, and your favorite graph database already in your system CLASSPATH.

h3. Running

Copy the sources in src/main/groovy/com/countvajhula/splinter/ to a desired location and _cd_ into that directory. Then:

bc. $ groovyc *.groovy
$ ./Splinter.groovy

p. As an example, the provided sampletestdefinition.xml file may be used in the above command.

h2. Test Definition

The test definition file is pretty straightforward XML (see sampletestdefinition.xml for a comprehensive example) like so:

bc.


100

linear
0.2






100


100


h2. Example output:

bc. $./GraphStressTester.groovy sampletestdefinition.xml
...
TinkerGraph graph initialized.
Graph empty or overwrite set to true. Recreating graph.
Running getNeighbors...
profiler results:
------PROFILER RESULTS (tinkergraph_100vertices_linear0.2connxns--getneighbors) ------
Total Duration = 152.004 ms
getNeighbors: 149.073 ms 98.07176127 %
getVertex: 1.988 ms 1.30786032 %
hashCode: 0.595 ms 0.39143707 %
equals: 0.348 ms 0.22894134 %
super$2$getElementProperty: 0.0 ms 0.0 %
$createCallSiteArray: 0.0 ms 0.0 %
super$2$getAllEdges: 0.0 ms 0.0 %
super$2$removeEdge: 0.0 ms 0.0 %
super$2$this$dist$set$2: 0.0 ms 0.0 %
... etc.
------xxxxxxxxxxxxxxxx (tinkergraph_100vertices_linear0.2connxns--getneighbors) ------