Add Proxmox Enhanced App

[hoopmutter]

after logging in

folder view -> datacenter -> summary

you get nice stats and overview

• heath
• nodes online/offline
• guests (vm running/stop + lxc running/stoped)
• resources (cpu/memory/storage)

[cliffordwhansen]

Can find API info here: https://pve.proxmox.com/wiki/Proxmox_VE_API

[yscialom]

@cliffordwhansen It's deplorable how badly the API is documented and designed.
Anyway, I found this as a great source for an Heimdall enhanced application:

https://(redacted)/api2/json/cluster/resources
{
   "data":[
      {
         "status":"running",
         "disk":0,
         "maxmem":8589934592,
         "template":0,
         "netout":552380083,
         "name":"(redacted)",
         "id":"qemu/100",
         "cpu":0.0265518207843781,
         "maxcpu":4,
         "diskread":1425387008,
         "uptime":229935,
         "mem":4503056384,
         "maxdisk":34359738368,
         "type":"qemu",
         "netin":1147118538,
         "diskwrite":16459658240,
         "vmid":100,
         "node":"pve1"
      },
      {
         "node":"pve",
         "type":"node",
         "status":"unknown",
         "id":"node/pve"
      },
      {
         "storage":"local",
         "node":"pve",
         "shared":0,
         "id":"storage/pve/local",
         "plugintype":"dir",
         "type":"storage",
         "content":"vztmpl,iso,backup",
         "status":"unknown"
      },
      {
         "node":"pve",
         "storage":"local-lvm",
         "shared":0,
         "id":"storage/pve/local-lvm",
         "plugintype":"lvmthin",
         "type":"storage",
         "content":"rootdir,images",
         "status":"unknown"
      }
   ]
}

Hope it helps.

[L1cardo]

You need to turn on skip tls

[cliffordwhansen]

What URL do you use in Config for Proxmox Enhanced Card ? Since if I use anything else than Proxmox IP:Port I get 501. However the card doesn't show anything after successful test.

I had the same, and after removing the "Privilege Seperation" from the API token it all worked

[mnarrell]

This certainly fixed my issue, thank you.

[djonko]

@cliffordwhansen thanks

[toraddict]

You shouldn't remove "Privilege Separation", "Privilege Separation" separates the API Token permissions from the user permissions. You need to assign permissions to the API Token.

Here is documentation: https://pve.proxmox.com/wiki/User_Management

[g199209]

I always get "General error connecting with API" error when test configuration.
Anybody know how to solve this problem?

[mnarrell]

I'm able to connect to the API when testing, but there are no node stats shown on the tile. I have the config enabled and have disabled TLS verification.

[schumi2004]

Have you managed to resolve it?
I'm facing the same issue.
I do see CPU and MEM stats but no nodes.
I only have privileges: Sys.Audit

Am I missing some?

[lantranbot]

Sys.Audit for CPU and memory and VM.Audit for the count of LXC / VM's.

[yscialom]

Works for me. Great job. Thank you.
If you're looking for improvement ideas: allow user to select what metrics to show in the Proxmox card.

[Brandoskey]

I have a problem, I have a 2 node cluster with a qdevice for quorum, however since I rarely need the second node I tend to keep it powered off. It seems the enhanced app will refuse to show stats unless both nodes are online. I've tried having it display just the node that is running and it doesn't seem to make a difference.

[shalak]

I configured an API token with PVEAuditor permissions for /nodes path. I can see the CPU and RAM on the Heimdall dashboard, but VM and LXC shows 0/0 - what am I missing?

[shalak]

Ok, Once I set up the permissiong for / it started to work OK. I guess the tooltip mentions only the smallest required permission set...

[topa-LE]

Very good. Everything works. Thanks a lot!

[Brandoskey]

Still doesn't work if a node is down, any chance of an update?

[viper1705]

I'm in the same boat, I have a third (backup) node that is usually switched off, and so I also can't see any info until the 3th node is switched on. Please have a look at this...

[matthai5]

I am getting a 501 error every time I try to add the enhanced function. Does anyone have a solution to this? I have added api permissions like others have suggested and have also tried turning off Privilege Separation without any different result.

[4oijq342]

I got it working using this configuration:

I am using the default self-signed cert for Proxmox, so I had to skip TLS in the Heimdall settings.
Thank you @L1cardo @toraddict

@KodeStar you should edit the status of this issue and post a link to my comment because it contains the most documentation for Proxmox-Heimdall: #584

[ohmantics]

It looks like you need to give Sys.Audit for both the API Token and the underlying User or /nodes/{node}/status returns 403. Seems like an inconsistency inside Proxmox's permissions checking when using an API Token.

[wodan66]

When adding Proxmox to Heimdall, it does not even show the config option...
Any idea?