Skip to content

Workshop fun with time-series databases, dashboarding and more

License

Notifications You must be signed in to change notification settings

cisco-ie/ez-dash

Repository files navigation

ez-dash

Dashboarding with Open-Source Monitoring Stacks Made Easy
DevNet Create 2018 - WS23, WS54 | Presentation

Learn about the different open source tools like TICK, ELK, Prometheus, Grafana, and more - and how to make good looking dashboards of your environment without having to rebuild the wheel.

Objectives

  • Provide a quick introduction to monitoring concepts
  • Provide a quick introduction to available tooling
  • Create a sample environment/application which exposes metrics to monitoring tooling
  • Explore sample dashboards in Grafana
  • Create custom dashboards in Grafana

Prerequisites

In order to complete this lab you will need a development workstation with Docker, and other fundamental tools installed. :)

  • Docker [CE]
    • Community Edition is fully capable.
    • v17.06 or higher.
  • Web browser
    • Latest versions of most browsers work.
    • Firefox or Chrome recommended.

Install Docker CE

Get the code!

You're ready to workshop!

Usage

This stack should work across any OS that supports the prerequisited Docker CE installation. All processes are containerized and deployable via Docker Swarm. If you are running pre-existing Docker containers, ensure that there are no port conflicts in the docker-compose.yml file.

Explanation of the components is provided in the Dashboarding with Open-Source Monitoring Stacks Made Easy PowerPoint.

Get Started

The following expects you to utilize a terminal of some kind, also known as command prompt in Windows.

# Get the code!
git clone https://github.com/cisco-ie/ez-dash
cd ez-dash
# If you have never run Docker Swarm before...
./setup.sh # MacOS or Linux
.\setup.bat # Windows
# Start the stack!
./start.sh # MacOS or Linux
.\start.bat # Windows
# See what's running!
docker stack ps ezdash
# Shut it down when you're done!
./stop.sh # MacOS or Linux
.\stop.bat # Windows

Web Interfaces

The following listings detail ports made available over HTTP to explore the stack.

Help!

If you require any assistance, please open an issue in this repository, or reach out to: