---
title: "CDF - Cumulative Distribution Function panel plugin for Grafana"
description: "Panel for CDF visualizations. CDF - Cumulative Distribution Function panel plugin for Grafana by sebastiangunreben. See install steps and the changelog."
---

> This is the Markdown version of https://grafana.com/grafana/plugins/sebastiangunreben-cdf-panel/

# CDF - Cumulative Distribution Function

- Developer: sebastiangunreben
- Version: 0.3.0
- [Installation](https://grafana.com/grafana/plugins/sebastiangunreben-cdf-panel/installation.md)
- [Change log](https://grafana.com/grafana/plugins/sebastiangunreben-cdf-panel/changelog.md)

![first](https://grafana.com/api/plugins/sebastiangunreben-cdf-panel/versions/0.3.0/images/img/first.png)

![second](https://grafana.com/api/plugins/sebastiangunreben-cdf-panel/versions/0.3.0/images/img/second.png)

# Cumulative Distribution Function (CDF) Panel

If you already know what a CDF is, you may skip the next sections and directly jump to the bottom to check out the steps to install this plugin.

## What does the CDF panel plugin show?

The CDF panel plugin visualizes the (complementary) cumulative distribution of a given series of values. Statistically speaking, it shows P(x <= X). It shows the frequency/probability P of a certain value "x" to be less than "X".

![CDF in action 1](https://github.com/telekom/sebastiangunreben-cdf-plugin/blob/main/src/img/sample.png?raw=true)

The CDF may be used to quantify the amount of outliers not fitting into the expection of the value distribution.

![CDF in action 2](https://github.com/telekom/sebastiangunreben-cdf-plugin/blob/main/src/img/second.png?raw=true)

### Example

A query responses with the following series:

| time | value |
| ---- | :---: |
| t1   |   1   |
| t2   |   5   |
| t3   |   3   |
| t4   |   2   |

The time values (t1, t2, t3, t4) are ignored and not processed. Only relevant are the values 1, 5, 3, 2. The probability of a value "x" to be less than X=3 is P(x <= 3) = 0.75 as the values 1, 2, 3 are equal or less than 3 and these are 3 out of 4 values.

### Properties

If "x" is less than the smallest value of the series, the probability is zero. If "x" is larger or equal to the largest value of the seres, the probability is one.

## How to use this panel?

This panel has been developed together with influxdb. However, as the series responds with a "number" series, any other db fulfilling this requirement is fine, too. Per query, the first "number" field is evaluated.

The panel displays on the x-axis, the value range and on the y-axis the probability from 0 to 1.

## Config

This panel allows a flavor of config options:

### X-Axis

![X-Axis config options](https://github.com/telekom/sebastiangunreben-cdf-plugin/blob/main/src/img/xaxis.png?raw=true)

- Show grid
- Visualize thresholds on x-axis ..\* min threshold with value and label ..\* max threshold with value and label
- Change title
- Configurable range on x-axis
- Margins for proper vizualization

### Y-Axis

![Y-Axis config options](https://github.com/telekom/sebastiangunreben-cdf-plugin/blob/main/src/img/yaxis.png?raw=true)

- Show grid
- Change title
- Margins for proper vizualization

### Display

![Display config options](https://github.com/telekom/sebastiangunreben-cdf-plugin/blob/main/src/img/display.png?raw=true)

- Change color per series
- Change stroke witdth
- Change to complementary distribution function 1-P(x <= X).

### Contact

For feature request or bug reporting please use <sebastian.gunreben@telekom.de>.

# Learn more

- [Howto install this plugin in Grafana](https://grafana.com/docs/grafana/latest/plugins/installation/)
- [CDF at Wikipedia](https://en.wikipedia.org/wiki/Cumulative_distribution_function)
- [d3js](https://d3js.org/)
- [ReactJS](https://reactjs.org/)
- [TypeScript](https://www.typescriptlang.org/)

# Contact

For feature requests or bug reports, please contact me directly
