Skip to content
Import jHiccup CSV log files into Elasticsearch
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


hiccup2es is a utility that imports jHiccup CSV log files into Elasticsearch so they can be analyzed with Kibana.


hiccup2es requires Python 3.4+ available as python3 on the path (verify with: python3 --version). Also you need to have access to an Elasticsearch cluster.


Just clone the repo:

git clone

hiccup2es has no additional dependencies except Python 3. If you use https and want to verify SSL certificates you can install certifi with pip3 install certifi.

Usage / Workflow

  1. Create a hiccup log. Currently, the only tested configuration is export _JAVA_OPTIONS='-javaagent:PATH_TO_JHICCUP/jHiccup.jar="-d 0 -i 1000 -l hiccuplog -c"'.
  2. Convert the hiccup log to CSV with jHiccupLogProcessor, e.g. ./jHiccupLogProcessor -i hiccuplog -o hiccuplog-plain
  3. Import the file into Elasticsearch with python3 --input-file=hiccuplog-plain --create-index. Note: This is assuming that Elasticsearch is running on localhost in its default configuration. See python3 --help for further options.
  4. Create a visualization in Kibana and enjoy:


hiccup2es is distributed under the terms of the Apache Software Foundation license, version 2.0.

You can’t perform that action at this time.