Sergii Bondarenko
Tags: Kibana
Kibana is an Open Source software to explore and visualize data stored in Elasticsearch. It provides a plugin system to allows developers to add new functionality. However, there has always been a shortage on good tutorials that demonstrate how to build Kibana plugins from scratch. This is especially true since Elastic decided to switch to a completely new architecture for Kibana in 2020, called "New Platform".
This article series provides you with a quick start on how to develop your own plugins for Kibana, using the "Kibana New Platform" architecture. The first two parts cover the basics regarding setting up the development infrastructure and a skeleton project for the plugin. The next parts will cover working with data stored in Elasticsearch.
The prerequisites: acquaintance with Elasticsearch and Kibana, basic Unix command line skills, knowledge of JavaScript, and ReactJS.

Environment

First, we need to set up a development environment. The main components of the environment are of course Elasticsearch and Kibana.

Setup

First clone the Kibana repository from GitHub into a new directory
$ git clone [email protected]:elastic/kibana.git && cd kibana
Next, checkout the the latest production-ready branch, for example 7.12:
git checkout 7.12
Kibana is a Node.js application. In order to find out which Node.js version you require, run:
$ cat .node-versionΒ  14.16.1
Install the required Node.js version. We recommend using NVM because the required Node.js version will change with time, and you probably want to support your plugin for multiple Kibana versions.
Kibana uses yarn as package manager. If you do not have yarn already installed, please follow the download and installation instructions on the yarn documentation.
Next, install all required packes for running Kibana. This step requires some time to complete, so be patient!
$ yarn kbn bootstrap
Kibana comes with scripts to download and run Elasticsearch. Execute the following command:
$ yarn es snapshot --license oss
Also, you can run
yarn es
to list all available command options.
Next, start Kibana in the open-source mode.Β 
$ yarn start --oss
Also, you can run
yarn kbn
to list all available command options.

Kibana configuration

If you have need to use specific configuration settings for Kibana in the development mode, put it in kibana/config/kibana.dev.yml.

Creating your first plugin

First, create the plugins folder inside Kibana:
$ mkdir plugins
You can then use the Kibana plugin generator to create a simple plugin skeleton. You need to answer a list of questions before the plugin code is generated. With the settings used in this tutorial, the generator will create a plugin capable of working both with the frontend and the backend of Kibana.
$ node scripts/generate_plugin.js ? Plugin name (use camelCase) sgKibanaDemoPlugin ? Will this plugin be part of the Kibana repository? No ? Should an UI plugin be generated? Yes ? Should a server plugin be generated? Yes succ οΏ½ Your plugin has been created in plugins/sg_kibana_demo_plugin
Now start Kibana by running
yarn start --oss
, wait some time for it to bootstrap, and then open Kibana in your browser. You can now see the generated plugin in the navigation bar:
Custom Kibana Plugin

Plugin Structure

Let's discover the directory structure of our new plugin:
$ tree plugins/ plugins/ └── sg_kibana_demo_plugin β”œβ”€β”€ README.md β”œβ”€β”€ common β”‚ └── index.ts β”œβ”€β”€ kibana.json β”œβ”€β”€ package.json β”œβ”€β”€ public β”‚ β”œβ”€β”€ application.tsx β”‚ β”œβ”€β”€ components β”‚ β”‚ └── app.tsx β”‚ β”œβ”€β”€ index.scss β”‚ β”œβ”€β”€ index.ts β”‚ β”œβ”€β”€ plugin.ts β”‚ └── types.ts β”œβ”€β”€ server β”‚ β”œβ”€β”€ index.ts β”‚ β”œβ”€β”€ plugin.ts β”‚ β”œβ”€β”€ routes β”‚ β”‚ └── index.ts β”‚ └── types.ts β”œβ”€β”€ target β”‚ └── public β”‚ β”œβ”€β”€ sgKibanaDemoPlugin.chunk.0.js β”‚ β”œβ”€β”€ sgKibanaDemoPlugin.chunk.0.js.map β”‚ β”œβ”€β”€ sgKibanaDemoPlugin.plugin.js β”‚ └── sgKibanaDemoPlugin.plugin.js.map β”œβ”€β”€ translations β”‚ └── ja-JP.json └── tsconfig.json 9 directories, 20 files

Overview

    common
      this folder contains code that is used both by public and server code
    public
      this folder contains all frontend-related code of the plugin, like React.js components, stylesheets and assets. You can write the code either in TypeScript or JavaScript
    server
      the folder server contains code that runs at the Node.js level, e.g. code for calling the Elasticsearch APIs.
    translations
      contains translation files to define localization for the plugin

Part 1: Summary

This finished the setup of our development environment. In this first part of the tutorial we have cloned Kibana from GitHub, switched to the most recent version, made sure we have the correct versions of Node.ja and yarn installed. We ran the Kibana bootstrap script to install all required packages, and we used the Kibana plugin generator to create a minimal plugin skeleton. Last, we ran Kibana and checked that our plugin was loaded and visible.

Where to go next

Kibana plugin development is a great way to add custom functionality and extend Kibana's use cases. Hopefully this article has given you the foundation you need to get started building your own plugins. If you run into any issues or have questions, feel free to reach out - we're always happy to help. Happy plugin developing!
Image: shutterstock / stokk
Published: 2021-04-30
share
linkedIn icon
y icon
Questions? Drop us a line!
your message
newsletter
This form collects your name and email. Please take a look in our privacy policy for a better understanding on how we protect and manage your submitted data.
Other posts you may like
follow us
twitter iconfacebook iconlinkedIn iconyoutube icon
Search Guard Newsletter
For the latest product developments, new versions and cybersecurity news, sign up to our newsletter.