Skip to content

Visualize the traffic of your clusters in realtime from Prometheus data

License

Notifications You must be signed in to change notification settings

nghialv/promviz

Repository files navigation

Promviz PRs Welcome MIT Licensed

Promviz is an application that helps you visualize the traffic of your cluster from Prometheus data.

It has 2 components:

  • Promviz: retrieves data from Prometheus servers, aggregates them and provides an API to get the graph data.

  • Promviz-front: based on Netflix's vizceral to render traffic graph.

Features:

  • Generates and renders traffic graph in realtime
  • Able to replay from any time in the past
  • Able to generate notices on node and connection from prom query
  • Provides a sidecar application for k8s that watches config changes and reload Promviz server in runtime
  • Fits with Istio's metrics

Architecture

Install

Helm chart

If you are using Helm, the simplest way to install is using the charts in helm directory with

helm install --name promviz ./helm/promviz
helm install --name promviz-front ./helm/promviz-front

Docker images

Docker images of both promviz and promviz-front are available on Docker Hub.

Example

I have already prepared 2 examples and put them in the example directory.

You can try it by going to that directory and run

docker-compose -f simple-compose.yaml up --build

or

docker-compose -f full-compose.yaml up --build

Then checkout each service at:

Configuration

See configuration.md in documentation directory.

Contributing

Please feel free to create an issue or pull request.

LICENSE

Promviz is released under the MIT license. See LICENSE file for details.