Skip to content

Latest commit

 

History

History
81 lines (58 loc) · 3.74 KB

README.md

File metadata and controls

81 lines (58 loc) · 3.74 KB
Raw

Telemetry Dashboards for KrakenD

This repository contains example configurations to support logging and metrics dashboards:

  • Elastic + Logstash + Kibana (ELK) installation.
  • Grafana

It also includes two Kibana dashboards, one for the Access Log activity and another for the Application Log activity.

These configurations are used in KrakenD Playground and you can test them directly.

By using the configurations included here, you will have KrakenD configured for ELK.

Kibana screenshot

Logstash

The logstash folder includes an example of a Logstash configuration. It parses and ingests KrakenD logs for KrakenD Enterprise and KrakenD Community Edition.

To use it, change the hostname of your Elasticsearch server and any custom ports you might use. Then, start Logstash with this configuration to properly ingest KrakenD logs.

Kibana

To import the Kibana dashboard included in this repository, execute the following command once your Kibana is up and running. Replace localhost:5601 if needed:

curl -X POST "localhost:5601/api/saved_objects/_import" -H "kbn-xsrf: true" --form file=@kibana/dashboard.ndjson -H "kbn-xsrf: true"

KrakenD configuration for ELK

On your krakend.json, ensure to include the telemetry/logging and telemetry/gelf components as shown below. Also, make sure the GELF address is correct.

{
  "$schema": "https://www.krakend.io/schema/v3.json",
  "version": 3,
  "extra_config": {
    "telemetry/logging": {
      "level": "DEBUG",
      "@comment": "Prefix should always be inside [] to keep the grok expression working"
      "prefix": "[KRAKEND]",
      "syslog": false,
      "stdout": true
    },
    "telemetry/gelf": {
      "address": "logstash:12201",
      "enable_tcp": false
    }
  }
}

Grafana

The grafana folder includes Grafana dashboards that feed from Influx DB. Depending on your Influx version you will need to use a v1 or a v2 (Flux language) dashboard.

The dashboards are published on Grafana Cloud, and you can import them from there, but the source files are in this folder.

If you are using docker you can mount a volume using the content of this repo as follows:

  volumes:
  - "./grafana/datasources/all.yml:/etc/grafana/provisioning/datasources/all.yml"
  - "./grafana/dashboards/all.yml:/etc/grafana/provisioning/dashboards/all.yml"
  - "./grafana/krakend:/var/lib/grafana/dashboards/krakend"

Redis Dashboard overview

The Redis dashboard is designed to provide insights into metrics specifically related to Krakend usage. It is not intended as a tool for monitoring Redis instances or clusters directly.

For comprehensive monitoring of your Redis instances, we recommend installing the Redis Data Source plugin for Grafana and importing a pre-built dashboard that suits your requirements. You can explore a variety of dashboards created by the Redis team on their Grafana page.

If you are using docker, you can optionally provision the redis-datasource plugin in your Grafana container by adding this env variable:

environment:
  - GF_INSTALL_PLUGINS=redis-datasource

Contribute!

In this repository, you have an example of the ingestion process and dashboard visualization, and you can improve it in many ways.

Try it out! If it doesn't help you, or you think you can add additional metrics or improvements, please open a pull request!

Thanks!

If you have any questions or doubts, you can find our support resources at https://www.krakend.io/support/