# Honeycomb

A Honeycomb chart displays the status of multiple entities using color-coded hexagons. Each hexagon represents one instance (node, server, pod, service, device). It’s built for fast “what’s up/down?” scanning.

It’s ideal for:

* Cluster health
* Node availability
* Service status
* Pod or container health
* IoT device monitoring

### What a Honeycomb chart represents

Each hexagon = one instance. Hexagon color shows its current state.

Common states:

* Green = Up / OK
* Yellow = Warning / Degraded
* Red = Down / Critical

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FmqOYDqrYzxwIB5HmzEjl%2Fimage.png?alt=media&#x26;token=32c23e1b-a852-49a3-a592-58e35fca5724" alt="Example Honeycomb chart showing many instances as hexagons with status colors"><figcaption><p>Example Honeycomb status chart</p></figcaption></figure>

### Configure a Honeycomb chart

Set **Chart type** to **Honeycomb**. Pick the **Label column** and **Value column**. Enable **Custom config** to define status rules.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F2zMEI2ycTAYHMCFvIw4i%2FScreenshot%20from%202026-01-15%2012-45-17.png?alt=media&#x26;token=5c5bb5bc-3672-4842-987a-b4a905830b46" alt=""><figcaption></figcaption></figure>

### Honeycomb configuration options

| Option        | Purpose                                                 |
| ------------- | ------------------------------------------------------- |
| Chart type    | Must be **Honeycomb**.                                  |
| Label column  | The entity name shown for each hexagon.                 |
| Value column  | Numeric field used to compute status.                   |
| Custom config | Enables status rules.                                   |
| Condition     | Operator used in a rule (`>`, `<`, `>=`, `<=`, `=`).    |
| Threshold     | Comparison value for the rule.                          |
| Text          | Label applied when the rule matches (for example `up`). |
| Color         | Hexagon color when the rule matches.                    |

Example rules:

* `= 1` → `up` (green)
* `< 1` → `down` (red)

{% hint style="info" %}
Key rules:

* Each instance is evaluated independently.
* Rules are evaluated **top-to-bottom** (in order).
* The first matching rule is applied.
* Keep rules mutually exclusive, or order them carefully.
  {% endhint %}

### What the user sees

The user instantly sees:

* How many entities are healthy
* Which entities are down
* Where problems are concentrated

No log digging required.

### When to use Honeycomb

Use Honeycomb when you need to:

* Monitor many components at once
* Detect failures quickly
* Show binary or state-based health

Ideal for Kubernetes nodes, microservices, servers, network devices, and IoT fleets.

### Why the honeycomb layout works

The hexagon layout:

* Packs many items into a small space
* Makes failures visually obvious
* Works better than tables for live monitoring