---
title: "Palindrome.js panel plugin for Grafana"
description: "Palindrome.js Grafana panel. Palindrome.js panel plugin for Grafana by Smile. Available in Grafana Cloud and self-managed Grafana."
---

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

# Palindrome.js

- Developer: Smile
- Version: 1.0.0
- [Installation](https://grafana.com/grafana/plugins/smile-palindromejs-panel/installation.md)
- [Change log](https://grafana.com/grafana/plugins/smile-palindromejs-panel/changelog.md)

![Panel](https://grafana.com/api/plugins/smile-palindromejs-panel/versions/1.0.0/images/img/dashboard.png)

![Panel](https://grafana.com/api/plugins/smile-palindromejs-panel/versions/1.0.0/images/img/panel.png)

# Grafana Palindrome.js Panel

Visualize Prometheus metrics or other datasources in 3D with the Grafana Palindrome.js panel. This panel is based over the SMILE [Palindrome.js](https://github.com/Smile-SA/palindrome.js/) library.

[![Grafana Palindrome.js Panel](https://github.com/Smile-SA/palindrome.js-grafana-plugin/raw/main/src/img/Palindrome.js-logo-and-title.jpg)](https://github.com/Smile-SA/palindrome.js/)

## 🎯 Features and usage

Palindrome.js is composed of layers defined by the user. Each layer can contain from 1 to _n_ metrics. Metrics ranges are described through minimum, median, and maximum values, which are inputs from the user. The current value is obtained from the time series database. The overall Palindrome.js shape and color reflect the current values evolving in their user described ranges. For further details, please refer to the Palindrome.js [documentation](https://github.com/Smile-SA/palindrome.js/wiki).

This panel should be connected to one of these supported data sources:

- Prometheus
- InfluxDB v2
- Graphite

Once done, you can define layers and metrics using code queries, following this format:

```
<query> <comment-sign>label: <label>, layer: <layerName>, ranges: [<min value>, <med value>, <max value>]
```

**Notes:**

- Palindrome.js metadata should be inside a comment section.
- Comment signs can be `#` or `//`.
- `label` metadata is optional

**Example for Prometheus data source**:

```Promql
node_disk_io_now{device="nvme0n1"} #label: ssdMetric, layer: systemMetrics, ranges: [0, 50, 100]
```

- Once you've finished typing queries, click on `Run queries`, and the 3D object will appear.

**Example for InfluxDB v2 data source**:

```Flux
from(bucket: "Palindrome.js")
  |> range(start:-1m)
  |> filter(fn: (r) => r["_measurement"] == "cpu")
  |> filter(fn: (r) => r["_field"] == "usage_system")
  |> filter(fn: (r) => r["cpu"] == "cpu0")
  //layer: Container Metrics, ranges: [0, 3, 10]
```

**Example for Graphite data source**:

```
carbon.agents.*-a.pointsPerUpdate #layer: layer2, ranges: [0, 1, 3]
```

After setting up queries, two fields will be populated: `Palindrome Data Structure` and `Palindrome Configuration`:

- **Palindrome Data Structure:** This is the data structure of Palindrome.js based on the metrics entered by the user. It is a read-only text area (editable through query comments).

- **Palindrome Configuration:** This field displays the current configuration used to display the 3D object. It is editable. For more information, please refer to our [API reference](https://github.com/Smile-SA/palindrome.js/wiki/API-Reference).

![Palindrome.js integration in Grafana](https://github.com/Smile-SA/palindrome.js-grafana-plugin/raw/main/src/img/dashboard.png)

Palindrome.js is also available in a light theme version.

![Palindrome.js light](https://github.com/Smile-SA/palindrome.js-grafana-plugin/raw/main/src/img/light-panel.png).

## ⚡ Realtime Palindrome.js

![Palindrome.js integration in Grafana](https://github.com/Smile-SA/palindrome.js-grafana-plugin/raw/main/src/img/realtime.gif)

## 📺 Creation demo

![Palindrome.js integration in Grafana demo](https://github.com/Smile-SA/palindrome.js-grafana-plugin/raw/main/src/img/demo.gif)

## 📜 License

This project is licensed under [Apache2.0](https://github.com/Smile-SA/palindrome.js-grafana-plugin/raw/main/LICENSE).
