News KrakenD CE v2.7 released with better rate-limiting and security options

Enterprise Documentation

Recent changes

You are viewing a previous version of KrakenD Enterprise Edition (v2.0) , go to the latest version

Generate graphs from your configuration

Document updated on May 7, 2021

The krakend.json file whether it is a single file or the result of using the flexible configuration, it might be a complex file. A generated image of the configuration might help you understand better the running configuration.

The config2dot generator will generate internally an intermediate DOT dile that you can render into a png image with GraphViz or similar software.

The following image illustrates an example of a KrakenD configuration:

Config to dot

Generating the Config2dot

The command needed to generate a DOT file is krakend generate config2dot:

Command to start KrakenD 
$krakend generate config2dot -h

╓▄█                          ▄▄▌                               ╓██████▄µ
▐███  ▄███╨▐███▄██H╗██████▄  ║██▌ ,▄███╨ ▄██████▄  ▓██▌█████▄  ███▀╙╙▀▀███╕
▐███▄███▀  ▐█████▀"╙▀▀"╙▀███ ║███▄███┘  ███▀""▀███ ████▀╙▀███H ███     ╙███
▐██████▌   ▐███⌐  ,▄████████M║██████▄  ║██████████M███▌   ███H ███     ,███
▐███╨▀███µ ▐███   ███▌  ,███M║███╙▀███  ███▄```▄▄` ███▌   ███H ███,,,╓▄███▀
▐███  ╙███▄▐███   ╙█████████M║██▌  ╙███▄`▀███████╨ ███▌   ███H █████████▀
                     ``                     `'`

Version: v2.0

Generates a DOT graph from your KrakenD configuration.
  krakend generate config2dot [flags]
krakend generate config2dot -c config.json -o
  -h, --help   help for config2dot
Global Flags:
  -c, --config string   Path to the configuration filename
  -d, --debug           Enable the debug
  -o, --out string      Path to the generated result.")

Generating the image

Once you have generated the dot file, you get a plain text content that is ready to be rendered by any software library that is capable of processing dot files. A good of example is Graphviz.

You can install Graphviz on Linux (Debian/Ubuntu) with the following command, but other distributions are similar:

sudo apt-get install graphviz

On Mac:

brew install graphviz

Or you can also add Graphviz to the official Enterprise Docker image (gets heavier):

RUN apk update
RUN apk add graphviz

Then you can generate the image with the following command:

dot -Tpng -o graph.png

Unresolved issues?

The documentation is only a piece of the help you can get! Whether you are looking for Open Source or Enterprise support, see more support channels that can help you.