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.4) , go to the latest version

Graylog and the GELF format

Document updated on Oct 25, 2022

KrakenD supports sending structured events in GELF format to your Graylog Cluster thanks to the krakend-gelf integration.

The setup of GELF is straightforward and requires to add two components in the configuration:

  • telemetry/logging to capture the logs
  • telemetry/gelf to format the logs

The configuration you need to add is this, and explained below:

    "extra_config": {
      "telemetry/gelf": {
        "address": "myGraylogInstance:12201",
        "enable_tcp": false
      "telemetry/logging": {
          "level": "INFO",
          "prefix": "[KRAKEND]",
          "syslog": false,
          "stdout": false

The GELF configuration parameters for telemetry/gelf are:

Fields of GELF
* required fields
address  *

The address (including the port) of your Graylog cluster (or any other service that receives GELF inputs). E.g., myGraylogInstance:12201
enable_tcp  *

Set to false (recommended) to use UDP, or true to use TCP. TCP performance is worst than UDP under heavy load.

In addition, you must also add the telemetry/logging:

Fields of "telemetry/logging"
* required fields
level  *

What type of reporting level do you expect from the application? Use the DEBUG level in the development stages but not in production. Possible values are from more verbose to least.
Possible values are: "DEBUG" , "INFO" , "WARNING" , "ERROR" , "CRITICAL"

Adds the defined string at the beginning of every logged line, so you can quickly filter messages with external tools later on. It’s recommended to always add a prefix [INSIDE BRACKETS] to make use of predefined dashboards.

Set to true to send logs to stdout.
Defaults to false

Set to true to send logs to syslog.
Defaults to false

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.