Skip to content

Kidash: A GrimoireLab tool & library to manage Kibana/Kibiter visualizations and dashboards

License

Notifications You must be signed in to change notification settings

snitch3s/grimoirelab-kidash

 
 

Repository files navigation

Kidash Build Status Coverage Status PyPI version

Kidash is a tool for managing Kibana-related dashboards from the command line. The standard GrimoireLab dashboards are available in the Sigils repository.

Requirements

  • Python >= 3.8

You will also need some other libraries for running the tool, you can find the whole list of dependencies in pyproject.toml file.

Installation

There are several ways to install Kidash on your system: packages or source code using Poetry or pip.

PyPI:

Kidash can be installed using pip, a tool for installing Python packages. To do it, run the next command:

$ pip install kidash

Source code

To install from the source code you will need to clone the repository first:

$ git clone https://github.com/chaoss/grimoirelab-kidash
$ cd grimoirelab-kidash

Then use pip or Poetry to install the package along with its dependencies.

Pip

To install the package from local directory run the following command:

$ pip install .

In case you are a developer, you should install kidash in editable mode:

$ pip install -e .

Poetry

We use poetry for dependency management and packaging. You can install it following its documentation. Once you have installed it, you can install kidash and the dependencies:

$ poetry install

To spaw a new shell within the virtual environment use:

$ poetry shell

Usage

  • Get a list of all options with:
$ kidash --help
  • Import a dashboard:
kidash -g -e <elasticsearch-url>:<port> --import <local-file-path>
example: kidash -g -e https://admin:admin@localhost:9200 --import ./overview.json
  • Export a dashboard:
kidash -g -e <elasticsearch-url> --dashboard <dashboard-id>* --export <local-file-path> --split-index-pattern
example: kidash -g -e https://admin:admin@localhost:9200 --dashboard overview --export overview.json

License

Licensed under GNU General Public License (GPL), version 3 or later.

About

Kidash: A GrimoireLab tool & library to manage Kibana/Kibiter visualizations and dashboards

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%