Visualize Unifi metrics in the Grafana

Posted Jan 15, 2026 Updated Jan 16, 2026

By Filip Zverec 5 min read

Introduction

In this previous post I’ve showed you how you can use grafana to check on your Qbitorrent metrics, so let’s continue this grafana trend with visualizing Unifi metrics now!

We can do so with the help of unpoller

What is Unpoller?

TLDR unpoller allows you to collect the data from your UniFi network controller, then save it to the database (we will use influx DB in this case, but you can use prometheus as well) and display it in the grafana

For more info checkout their documentation with the description or if you just want to follow their install guide as well

UniFi

Create delegated UniFi user

Uncheck “Remote Access”
Choose name and password of your liking
Set the role “Site admin”

Try logging in with the new user and set permanent password.

Influx DB

Create influx DB

Depending on your setup, you can run it on docker or LXC with the proxmox scripts as me

https://community-scripts.github.io/ProxmoxVE/scripts?id=influxdb

Simply run following command in the proxmox node bash

  
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/influxdb.sh)"

Create bucket

After you install influxdb and login, you need to create new bucket (which in short is it’s own isolated database, you can have multiple these buckets/databases in parallel)

To do so go to -> Buckets -> Create new bucket Name it: “unifi”

Generate API token

To allow services access to this database/bucket we need to generate API token

Go to API Tokens -> Generate API Token -> Custom Api Token

Set description of your liking
Under Resources check both Read && Write for our newly created bucket “unifi”

And Click on Generate!

Unifi-poller

Configure && Run unifi-poller

Easiest way is to run as docker container with docker-compose.

You can find the official docker-compose on their git here

  
version: "3.8"

services:
  unifi-poller:
    container_name: unifi-poller
    image: ghcr.io/unpoller/unpoller:${POLLER_TAG}
    restart: always
    environment:
      UP_INFLUXDB_URL: ${INFLUXDB_URL}
      UP_INFLUXDB_ORG: ${INFLUXDB_ORG}
      UP_INFLUXDB_BUCKET: ${INFLUXDB_BUCKET}
      UP_INFLUXDB_AUTH_TOKEN: ${INFLUXDB_ADMIN_TOKEN}

      UP_UNIFI_CONTROLLER_0_URL: ${UNIFI_URL}
      UP_UNIFI_CONTROLLER_0_USER: ${UNIFI_USER}
      UP_UNIFI_CONTROLLER_0_PASS: ${UNIFI_PASS}
      UP_UNIFI_CONTROLLER_0_SITE: ${UNIFI_SITE}
      UP_UNIFI_CONTROLLER_0_VERIFY_SSL: "false"

      UP_POLLER_DEBUG: ${POLLER_DEBUG}
      UP_UNIFI_DEFAULT_SAVE_DPI: ${POLLER_SAVE_DPI}

And now we just need to create the values.txt file, which is going to be unique to everybody!

Change all of the values according to your created user and setup.

  
# unpoller
POLLER_TAG=latest
POLLER_DEBUG=false
POLLER_SAVE_DPI=false

# UniFi
UNIFI_USER=unifipoller
UNIFI_PASS=unifipoller
UNIFI_URL=https://10.1.1.37:8443
UNIFI_SITE=homelab    #you can get this site info in unifi controller top left corner, check the picture under this post

# InfluxDB v2
INFLUXDB_URL=http://10.1.1.32:8086
INFLUXDB_ORG=thetechcorner      #if you don't remember your org you can get this info in the influxdb top left corner, check the picture under this post
INFLUXDB_BUCKET=unifi
INFLUXDB_ADMIN_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Then run the container, if everything is working you should be able to get some info from the container logs

Something like this

  
2026/01/16 12:15:54 [INFO] UniFi Metrics Recorded. Site: 1, Client: 2, Gateways: 0, UAP: 1, USW: 0, IDs/Event/Alarm/Anomaly: 0/0/0/0, DPI Site/Client: 0/0, Point: 14, Fields: 470, Bytes: 11047, Err: 0, Dur: 5ms

2026/01/16 12:16:24 [INFO] UniFi Metrics Recorded. Site: 1, Client: 2, Gateways: 0, UAP: 1, USW: 0, IDs/Event/Alarm/Anomaly: 0/0/0/0, DPI Site/Client: 0/0, Point: 14, Fields: 470, Bytes: 11050, Err: 0, Dur: 26ms

2026/01/16 12:16:54 [INFO] UniFi Metrics Recorded. Site: 1, Client: 2, Gateways: 0, UAP: 1, USW: 0, IDs/Event/Alarm/Anomaly: 0/0/0/0, DPI Site/Client: 0/0, Point: 14, Fields: 470, Bytes: 11047, Err: 0, Dur: 5ms

You can also use portainer stacks if you are more comfortable with that (don’t worry password if fake)

Grafana

Create new data source

Go to connections -> Data sources -> Add new data source -> InfluxDB

Name: influxdb-unifi
Query Language: Flux
HTTP -> URL: “http://10.1.1.32:8086” #IP of unpoller container change it to your IP/port
InfluxDB details -> Organization: “thetechcorner” #change to your influxDB organization
InfluxDB details -> Token: “xxxxxxxxxxxxxxx” #put your influxdb bucket token we have created previously
Default Bucket: unifi #change to your bucket name if differ