The SPC Chart panel automatically calculates and displays control limits for XmR, Xbar-R, and Xbar-S charts — so you can monitor process stability, detect special cause variation, and make data-driven decisions in real time.
Control charts are the foundation of statistical process control. They separate common cause variation (normal process behavior) from special cause variation (signals that something has changed). This plugin makes that analysis effortless:
- Automatic control limits — LCL, UCL, and Mean are calculated and displayed automatically based on the selected chart type
- Multiple chart types — XmR for individual measurements, Xbar-R for small subgroups, Xbar-S for larger subgroups
- Custom control lines — add Nominal, LSL, USL, or any custom reference line with static values or dynamic series lookup
- Fill regions — visually highlight zones between control lines to show acceptable process ranges
SPC Chart is built using Grafana's native visualization components. This means it inherits the look, feel, and behavior you already know:
- Native theming — automatically adapts to light and dark mode
- Standard panel options — legend placement, tooltip behavior, and field overrides work just like any other Grafana panel
- Works with any data source — use it with SQL databases, Prometheus, InfluxDB, CSV files, or any other Grafana data source
| Feature | Description |
|---|---|
| XmR charts | Individual (X) and Moving Range (mR) charts for single measurements |
| Xbar-R charts | Subgroup mean (X-bar) and Range (R) charts for small subgroups |
| Xbar-S charts | Subgroup mean (X-bar) and Standard Deviation (S) charts for larger subgroups |
| Automatic control limits | LCL, UCL, and Mean calculated from the data using standard SPC formulas |
| Custom control lines | Add Nominal, LSL, USL, or custom lines with static values or dynamic series lookup |
| Subgrouping | Group consecutive measurements into subgroups of size 2-25 |
| Aggregation | Aggregate raw data by moving range, range, mean, or standard deviation |
| Fill regions | Color-fill areas between control lines to highlight process zones |
| Alerting support | Grafana alerting integration with alert state annotations on the chart |
| Custom annotations | Create, edit, and delete annotations directly on the chart |
| Threshold visualization | Display alert thresholds alongside SPC control limits |
| Dashboard variables | Control subgroup size across multiple panels with a single subgroupSize variable |
| Feature queries | Exclude reference queries from SPC calculations |
- Manufacturing quality — monitor process parameters and detect shifts before they produce defects
- IT operations — track response times, error rates, or throughput to distinguish real incidents from normal variation
- Laboratory analysis — control measurement systems and reagent performance over time
- Supply chain — monitor delivery times, fill rates, or inventory levels for process stability
- Healthcare — track clinical metrics and patient outcomes with statistical rigor
- Grafana 11.6.10 or later
- Install the plugin from the Grafana Plugin Catalog
- Add a new panel and select SPC Chart as the visualization
- Configure a query that returns time series data (a time field and one or more numeric value fields)
- Select a Chart Type (XmR, Xbar-R, or Xbar-S) to automatically calculate control limits
The plugin comes with sample provisioned dashboards. Build and start the plugin to see them.
For detailed documentation, configuration guides, and formula references, see the full documentation.
SPC Chart is part of a growing family of Statistical Process Control plugins for Grafana by Kenso Software:
SPC Histogram Panel — Distribution analysis with histograms, bell curves, and a built-in statistics table showing Cp, Cpk, Pp, and Ppk. Use it to understand process capability: is your process producing results within specification limits?
SPC Pareto Panel — Pareto analysis with automatic sorting, cumulative percentage lines, and 80/20 threshold highlighting. Use it to identify the vital few factors contributing to defects or issues.
SPC CAD Panel — Brings 3D geometry into the picture, letting you bind the data from control charts and histograms to physical features on your parts.
- Node.js (LTS version recommended)
- Yarn
- Docker (for local Grafana instance)
-
Clone the repository
git clone https://github.com/KensoBI/spc-chart.git cd spc-chart -
Install dependencies
yarn install
-
Build plugin in development mode with watch
yarn run dev
-
Run Grafana locally
docker compose up
Access Grafana at
http://localhost:3000(default credentials: admin/admin) -
Build plugin for production
yarn run build
# Run tests in watch mode
yarn run test
# Run tests once (CI mode)
yarn run test:ciWe welcome contributions, feedback, and feature requests!
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Run tests (
yarn run test:ci) - Commit your changes
- Push to your fork
- Open a Pull Request
Please open an issue to discuss major changes before submitting a PR.
This software is distributed under the Apache License 2.0.
If you have any questions or feedback, you can:
- Create an issue to report bugs, issues, and feature suggestions.
- Ask a question on the KensoBI Discord channel.
- Grafana Community: https://community.grafana.com/