{ "meta": { "title": "Proxmox Monitor-API — Integrationsreferens | ProxMenux", "description": "HTTP-slutpunkter i ProxMenux Monitor för Home Assistant, Homepage, Grafana, Prometheus, n8n och egna paneler. Läs status och anropa dokumenterade åtgärder: VM-styrning, säkerhetskopiering, aviseringar och bekräftelse av varningar.", "ogTitle": "Proxmox Monitor-API — Integrationsreferens", "ogDescription": "ProxMenux Monitor-slutpunkter för Home Assistant, Homepage, Grafana, Prometheus, n8n och egna paneler.", "twitterTitle": "Proxmox Monitor-API | ProxMenux", "twitterDescription": "Slutpunkter för Home Assistant, Homepage, Grafana, Prometheus, n8n och egna paneler." }, "header": { "title": "API-referens", "description": "HTTP-slutpunkter för att läsa status och anropa dokumenterade åtgärder: Home Assistant-sensorer, Homepage-kort, Grafana-paneler, Prometheus-insamling, n8n-flöden och egna skript. Med kategorier, exporterade mätvärden och curl-exempel.", "section": "ProxMenux Monitor" }, "intro": { "title": "Vad sidan används till", "body": "Sidan samlar slutpunkter för integrationer: dataläsning, start av säkerhetskopiering, egna aviseringar och bekräftelse av varningar. API:t körs i panelens Flask-process på TCP 8008. Bindningsadress och TLS beskrivs i Åtkomst och autentisering." }, "headerEndpoint": "Slutpunkt", "headerMethod": "Metod", "headerUse": "Användning", "auth": { "heading": "Autentisering", "intro": "När autentisering är på väntar skyddade slutpunkter ett JWT Bearer-token i begärans header:", "tokensIntro": "Två sätt att få token:", "items": [ "API-token, rekommenderade för integrationer. Giltiga i 365 dagar, skapade under Säkerhet → API-token. De namnges och kan återkallas var för sig. Använd read_only för data och full_admin bara för nödvändiga administrationsåtgärder.", "Inloggning, JWT i 24 timmar. POST /api/auth/login med användarnamn, lösenord och TOTP när 2FA kräver det. JWT:t går ut efter 24 timmar; skript måste då autentisera igen." ], "flowLink": "Inloggning, lösenord, 2FA, granskningslogg och TLS beskrivs i Åtkomst och autentisering.", "rows": [ { "endpoint": "/api/auth/login", "method": "POST", "use": "Fält i begäran (schema): '{'\"username\",\"password\",\"totp_token?\"'}'. Returnerar ett JWT för 24 timmar." }, { "endpoint": "/api/auth/api-tokens", "method": "GET", "use": "Lista API tokens (endast metadata - namn, prefix, datum; aldrig den faktiska hemligheten)." }, { "endpoint": "/api/auth/generate-api-token", "method": "POST", "use": "Skapar ett API-token för 365 dagar i en autentiserad session. Fält: password, token_name?, totp_token?, scope?. Lösenord och krävd TOTP kontrolleras igen. scope är read_only som standard; full_admin måste väljas uttryckligen. Hemligheten returneras bara en gång." }, { "endpoint": "/api/auth/api-tokens/", "method": "DELETE", "use": "Återkalla en specifik API token av dess ID." } ] }, "conventions": { "heading": "Konventioner", "items": [ "De flesta använder JSON. Nedladdningar kan ge vanlig text; /api/prometheus använder Prometheus textformat 0.0.4 i stället för OpenMetrics. Kontrollera svarstypen för den aktuella slutpunkten.", "Många skrivningar returnerar '{'\"success\": true, ...'}'. Felformat varierar; ett vanligt format är '{'\"success\": false, \"error\": \"'<'reason'>'\"'}'. Kontrollera HTTP-status och fält: vissa autentiseringsutmaningar använder HTTP 200 med success false.", "Frågeparametrar varierar per slutpunkt. Använd limit, offset, since och kategorifilter bara där de stöds.", "Tidsformat varierar: Unix-tidsstämplar, ISO-8601-strängar och systemd-datum förekommer. Anta inte samma enhet eller uttrycklig tidszon för alla fält." ] }, "system": { "heading": "System & hårdvara", "rows": [ { "endpoint": "/api/system", "method": "GET", "use": "Aktuella värden för CPU, minne, swap, drifttid och belastning." }, { "endpoint": "/api/info", "method": "GET", "use": "Statisk värdinformation: värdnamn, kärna, PVE-version, CPU-modell och distribution." }, { "endpoint": "/api/system-info", "method": "GET", "use": "Utökade systemdata för panelens sidhuvud: övergripande mätvärden och starttid." }, { "endpoint": "/api/hardware", "method": "GET", "use": "Detaljerad maskinvaruinventering: PCI-enheter, GPU:er och sensorer." }, { "endpoint": "/api/hardware/live", "method": "GET", "use": "Aktuella värden från sensorer som ändras snabbt." }, { "endpoint": "/api/temperature/history", "method": "GET", "use": "Tidsserier för CPU- och kapslingstemperatur." }, { "endpoint": "/api/gpu//realtime", "method": "GET", "use": "Aktuella GPU-mätvärden för NVIDIA, Intel och AMD per PCI-plats." } ] }, "actions": { "heading": "Systemåtgärder", "intro": "Dessa asynkrona systemåtgärder körs i tillfälliga systemd-enheter. Med autentisering på kräver skrivningar full_admin; read_only kan läsa .../status. Godkänd start ger HTTP 202 och status; läs .../status för förloppet. Gäststyrning och säkerhetskopiering har andra svar som beskrivs nedan.", "shapeTitle": "Vanlig svarsform", "shapeIntro": "Asynkrona systemåtgärder delar JSON-statusobjektet nedan. Gäststyrning och säkerhetskopiering har andra format:", "shapeCode": "{\n \"unit\": \"proxmenux-action-pve-update.service\",\n \"state\": \"idle | running | success | failed | cancelled\",\n \"started_at\": \"Sat 2026-08-01 11:01:32 CEST\",\n \"finished_at\": null,\n \"exit_code\": null,\n \"result\": null\n}", "concurrencyTitle": "Samtidig körning och avbrott", "concurrencyBody": "En ny start av samma aktiva åtgärd ger HTTP 409. Avbrott finns bara med dokumenterad DELETE-slutpunkt, som för PVE-uppdatering. Status blir cancelled med bevarade tidsstämplar. Slutstatus ligger i processminnet och kan försvinna när Monitor startas om.", "rows": [ { "endpoint": "/api/system/power/reboot", "method": "POST", "use": "Startar om Proxmox-värden. HTTP-anslutningen kan stängas när systemd börjar avstängningen." }, { "endpoint": "/api/system/power/reboot/status", "method": "GET", "use": "Status för aktuell eller senaste omstart." }, { "endpoint": "/api/system/power/shutdown", "method": "POST", "use": "Stänger av Proxmox-värden, exempelvis som svar på en avstängningssignal från UPS." }, { "endpoint": "/api/system/power/shutdown/status", "method": "GET", "use": "Status för aktuell eller senaste avstängning." }, { "endpoint": "/api/system/pve-update/run", "method": "POST", "use": "Startar samma PVE-uppdatering som Uppdatera nu i Health Monitor och skalmenyn; anropar update-pve-safe.sh." }, { "endpoint": "/api/system/pve-update/status", "method": "GET", "use": "Status för aktuell eller senaste PVE-uppdatering." }, { "endpoint": "/api/system/pve-update", "method": "DELETE", "use": "Avbryter en pågående PVE-uppdatering med SIGTERM." }, { "endpoint": "/api/proxmenux/self-update/run", "method": "POST", "use": "Uppdaterar ProxMenux med installationsprogrammet för vald stabil- eller betakanal. En egen systemd-enhet låter jobbet fortsätta när installationsprogrammet startar om proxmenux-monitor." }, { "endpoint": "/api/proxmenux/self-update/status", "method": "GET", "use": "Status för aktuell eller senaste ProxMenux-uppdatering." }, { "endpoint": "/api/vms//control", "method": "POST", "use": "Skickar en styrorder för VM eller LXC. Fältet action accepterar start, stop, shutdown eller reboot. Ett lyckat svar ger en bekräftad PVE-uppgift, men betyder inte att den är klar. Läs gästens control-task-slutpunkt för resultatet." }, { "endpoint": "/api/vms//backup", "method": "POST", "use": "Skapar en vzdump-säkerhetskopia av en VM eller LXC. Fält i begäran, alla valfria om inte standardvärdena passar lagringsupplägget: storage (en PVE-lagring), mode (snapshot, suspend eller stop), compress (zstd, lzo, gzip eller none), protected (true eller false), notes och pbs_change_detection (default, legacy eller data). Returnerar PVE-uppgiftens UPID." }, { "endpoint": "/api/vms//backups", "method": "GET", "use": "Lista tidigare säkerhetskopior för en VM eller LXC över alla tillgängliga lager." } ], "syncVsAsyncTitle": "Två typer av åtgärder", "syncVsAsyncBody": "Värdens strömstyrning och uppdateringar använder tillfälliga systemd-enheter med .../status. Bara PVE-uppdatering har här en DELETE-slutpunkt för avbrott. VM/LXC-styrning ger en uppgift att följa; säkerhetskopiering ger ett UPID för ett bakgrundsjobb. Godkännande betyder inte slutförande. Autentisering och behörighet beror på slutpunkten.", "curlTitle": "curl-exempel", "curlBody": "Startar en PVE-uppdatering och följer den tills den är klar, som en Home Assistant-automation eller en Ansible-playbook.", "curlCode": "TOKEN=\n\ncurl -sSf -X POST \\\n -H \"Authorization: Bearer $TOKEN\" \\\n https://:8008/api/system/pve-update/run\n\nwhile true; do\n state=$(curl -sSf -H \"Authorization: Bearer $TOKEN\" \\\n https://:8008/api/system/pve-update/status | jq -r .state)\n [ \"$state\" != \"running\" ] && break\n sleep 30\ndone\necho \"final state: $state\"", "haTitle": "Exempel för Home Assistant", "haBody": "En rest-sensor läser status och rest_command startar uppdateringen. Koppla dem till en panelknapp och önskade automationer:", "haCode": "# configuration.yaml\nsensor:\n - platform: rest\n resource: https://pve.local:8008/api/system/pve-update/status\n name: pve_update_state\n value_template: \"{{ value_json.state }}\"\n scan_interval: 60\n headers:\n Authorization: \"Bearer !secret proxmenux_token\"\n\nrest_command:\n pve_update:\n url: https://pve.local:8008/api/system/pve-update/run\n method: POST\n headers:\n Authorization: \"Bearer !secret proxmenux_token\"\n\n # Start VM 100 (works for LXC too — same endpoint)\n vm_100_start:\n url: https://pve.local:8008/api/vms/100/control\n method: POST\n content_type: 'application/json'\n payload: '{\"action\": \"start\"}'\n headers:\n Authorization: \"Bearer !secret proxmenux_token\"\n\n # Backup VM 100 to the 'pbs-main' storage\n vm_100_backup:\n url: https://pve.local:8008/api/vms/100/backup\n method: POST\n content_type: 'application/json'\n payload: '{\"storage\": \"pbs-main\", \"mode\": \"snapshot\", \"compress\": \"zstd\"}'\n headers:\n Authorization: \"Bearer !secret proxmenux_token\"" }, "health": { "heading": "Hälsoövervakare", "rows": [ { "endpoint": "/api/health", "method": "GET", "use": "Lätt kontroll som ger JSON med status, timestamp och version. Lämplig för nyckelordskontroll i Uptime Kuma; med autentisering på måste klienten skicka Bearer-headern." }, { "endpoint": "/api/health/status", "method": "GET", "use": "Övergripande status: en allvarlighetsgrad och en sammanfattning." }, { "endpoint": "/api/health/details", "method": "GET", "use": "Alla tio kategorier med status och strukturerade data från varje kontroll." }, { "endpoint": "/api/health/full", "method": "GET", "use": "Fullständiga data: kategorier, aktiva fel, avfärdade varningar och inställningar för undertryckning. Använder bakgrundsresultat yngre än sex minuter; annars eller vid tvingad uppdatering körs en ny kontroll." }, { "endpoint": "/api/health/active-errors", "method": "GET", "use": "Aktiv lista, filtrerad av ?category=<name>." }, { "endpoint": "/api/health/dismissed", "method": "GET", "use": "Avfärdade varningar med återstående timmar av undertryckning." }, { "endpoint": "/api/health/settings", "method": "GET", "use": "Konfigurerad tid för undertryckning per kategori." }, { "endpoint": "/api/health/remote-storages", "method": "GET", "use": "Inventering av fjärrlagring definierad i Proxmox, med tillgänglighetsstatus." }, { "endpoint": "/api/health/interfaces", "method": "GET", "use": "Nätverksgränssnitt med typ (brygga / bond / fysiskt), IP och länkhastighet." }, { "endpoint": "/api/health/acknowledge", "method": "POST", "use": "Begärans innehåll: '{'\"error_key\":\"smart_sdh\"'}'. Undertrycker en varning under kategorins inställda tid." }, { "endpoint": "/api/health/cleanup-orphans", "method": "POST", "use": "Manuell rensning av fel vars underliggande enhet eller VM är borta. Idempotent." } ], "outro": "Svarsformat och kategorier beskrivs i Health Monitor." }, "storage": { "heading": "Lagring", "rows": [ { "endpoint": "/api/storage", "method": "GET", "use": "Diskar som är synliga för värden: blockenheter, ZFS-pooler och LVM." }, { "endpoint": "/api/storage/summary", "method": "GET", "use": "Kompakt sammanfattning som används av instrumentpanelkort." }, { "endpoint": "/api/proxmox-storage", "method": "GET", "use": "Lagring definierad i /etc/pve/storage.cfg, med tillgänglighetsstatus och ledigt utrymme." }, { "endpoint": "/api/storage/observations", "method": "GET", "use": "Beständig observationshistorik: SMART-varningar, I/O-fel och ZFS-händelser. Bevaras efter automatisk lösning av varningar." }, { "endpoint": "/api/storage/smart/", "method": "GET", "use": "Nuvarande SMART attribut för en disk." }, { "endpoint": "/api/storage/smart//latest", "method": "GET", "use": "Senaste SMART självtest för disken." }, { "endpoint": "/api/storage/smart//history", "method": "GET", "use": "Lista över lagrade SMART-rapporter för disken." }, { "endpoint": "/api/storage/smart//history/", "method": "GET", "use": "Läs en specifik lagrad SMART-rapport." }, { "endpoint": "/api/storage/smart//test", "method": "POST", "use": "Startar ett SMART-självtest. Schema för begäran: '{'\"test_type\":\"short\"|\"long\"'}'." }, { "endpoint": "/api/storage/smart/schedules", "method": "GET", "use": "Lista de schemalagda SMART-testerna." }, { "endpoint": "/api/storage/smart/tools", "method": "GET", "use": "Kontrollerar om smartctl och relaterade verktyg är installerade." } ] }, "network": { "heading": "Nätverk", "rows": [ { "endpoint": "/api/network", "method": "GET", "use": "Alla gränssnitt med länkstatus och adresser." }, { "endpoint": "/api/network/summary", "method": "GET", "use": "Kompakt vy för panelen." }, { "endpoint": "/api/network//metrics", "method": "GET", "use": "RX/TX per gränssnitt, felräknare och RRD-tidsserier." }, { "endpoint": "/api/network/latency/current", "method": "GET", "use": "Senaste latensmätning till gatewayen." }, { "endpoint": "/api/network/latency/history", "method": "GET", "use": "Tidsserie av gateway latens." } ] }, "vms": { "heading": "VM och containrar", "rows": [ { "endpoint": "/api/vms", "method": "GET", "use": "VM och CT på den lokala noden med status, vmid och namn." }, { "endpoint": "/api/vms/", "method": "GET", "use": "Full detalj för en gäst (konfig, nätverk, diskar)." }, { "endpoint": "/api/vms//metrics", "method": "GET", "use": "CPU / minne / disk I / O tidsserie för en gäst (RRD)." }, { "endpoint": "/api/vms//logs", "method": "GET", "use": "Loggar för gästens senaste uppgifter." }, { "endpoint": "/api/vms//backups", "method": "GET", "use": "Säkerhetskopior som sparats för den här gästen." }, { "endpoint": "/api/vms//control", "method": "POST", "use": "Välj en åtgärd i schemat: '{'\"action\":\"start|stop|reboot|shutdown\"'}'. Styr gästens strömtillstånd." }, { "endpoint": "/api/vms//backup", "method": "POST", "use": "Startar vzdump för gästen. Innehållet väljer lagring och läge (snapshot / suspend / stop)." }, { "endpoint": "/api/vms//config", "method": "PUT", "use": "Uppdatera beskrivningsfältet (noter) av en VM / CT. Andra konfignycklar är inte modifierbara från denna slutpunkt." }, { "endpoint": "/api/node/metrics", "method": "GET", "use": "Aggregerade nodmätvärden som RRD-tidsserier." } ] }, "backups": { "heading": "Säkerhetskopieringar", "rows": [ { "endpoint": "/api/backups", "method": "GET", "use": "Säkerhetskopior i dir-, NFS-, CIFS- och PBS-lagring som frågas via den lokala noden. Ingen fullständig genomsökning av alla klusternoder." }, { "endpoint": "/api/backup-storages", "method": "GET", "use": "Lagring markerad som mål för säkerhetskopiering, med ledigt utrymme." } ] }, "logs": { "heading": "Loggar, uppgifter, händelser", "rows": [ { "endpoint": "/api/logs", "method": "GET", "use": "Filtrerade journalposter. Query: ?level=&service=&limit=" }, { "endpoint": "/api/logs/download", "method": "GET", "use": "Exporterar det filtrerade intervallet som vanlig text." }, { "endpoint": "/api/events", "method": "GET", "use": "Intern händelseström - samma som matar meddelanden." }, { "endpoint": "/api/task-log/", "method": "GET", "use": "Fullständig logg i vanlig text för en Proxmox-uppgift identifierad med UPID." } ] }, "notifications": { "heading": "Aviseringar och AI", "intro": "Sändning, kanaler och AI-omformulering beskrivs i Aviseringar och AI-assistent.", "rows": [ { "endpoint": "/api/notifications", "method": "GET", "use": "Senaste aviseringar som visas på panelen." }, { "endpoint": "/api/notifications/download", "method": "GET", "use": "Exporterar aviseringar som text." }, { "endpoint": "/api/notifications/status", "method": "GET", "use": "Sändningsstatus: aktiv bakgrundsprocess, kölängd och senaste sändning." }, { "endpoint": "/api/notifications/settings", "method": "GET", "use": "Läser aviseringsinställningar: kanaler, händelsereglage, AI-omformulering och visningsnamn." }, { "endpoint": "/api/notifications/history", "method": "GET", "use": "Sändningshistorik. Parametrar: ?limit=&offset=&severity=&channel=." }, { "endpoint": "/api/notifications/history", "method": "DELETE", "use": "Tömmer tabellen för sändningshistorik." }, { "endpoint": "/api/notifications/test", "method": "POST", "use": "Skickar en testavisering till en kanal. Begärans innehåll: '{'\"channel\":\"telegram\"'}'." }, { "endpoint": "/api/notifications/send", "method": "POST", "use": "Skapar en egen händelse. Begärans innehåll: '{'\"event_type\":\"custom\",\"severity\":\"WARNING\",\"title\":\"...\",\"body\":\"...\",\"data\":'{''}''}'." }, { "endpoint": "/api/notifications/test-ai", "method": "POST", "use": "Testar anslutningen till AI-leverantören. Fält i begäran (schema): '{'\"provider\",\"api_key\",\"model\",\"ollama_url?\"'}'." }, { "endpoint": "/api/notifications/provider-models", "method": "POST", "use": "Lista tillgängliga modeller för den valda AI-leverantören." }, { "endpoint": "/api/notifications/proxmox/setup-webhook", "method": "POST", "use": "Registrera Monitor som ett webhook-mål i /etc/pve/notifications.cfg." }, { "endpoint": "/api/notifications/proxmox/cleanup-webhook", "method": "POST", "use": "Tar bort Monitor-målet från PVE:s aviseringsinställningar." }, { "endpoint": "/api/notifications/proxmox/read-cfg", "method": "GET", "use": "Läs PVE: s nuvarande notifications.cfg som PVE ser det." } ] }, "security": { "heading": "Säkerhet (läs)", "rows": [ { "endpoint": "/api/security/firewall/status", "method": "GET", "use": "PVE brandvägg och aktiva regler." }, { "endpoint": "/api/security/fail2ban/details", "method": "GET", "use": "Status för Fail2Ban-jail; kräver att den valfria komponenten är installerad." }, { "endpoint": "/api/security/fail2ban/activity", "method": "GET", "use": "Senaste Fail2Ban-händelser: blockeringar, hävda blockeringar och jailstarter." }, { "endpoint": "/api/security/lynis/status", "method": "GET", "use": "Lynis-status: installation och tidpunkt för senaste kontroll." }, { "endpoint": "/api/security/lynis/report", "method": "GET", "use": "Senaste Lynis-rapport: varningar, förslag och härdningsindex." }, { "endpoint": "/api/security/tools", "method": "GET", "use": "Upptäck vilka valfria säkerhetsverktyg (Fail2Ban, Lynis) som är installerade." } ] }, "proxmenuxIntegration": { "heading": "ProxMenux-integration", "rows": [ { "endpoint": "/api/proxmenux/update-status", "method": "GET", "use": "Tillgänglig ProxMenux Monitor-uppdatering samt installerad och senaste version." }, { "endpoint": "/api/proxmenux/installed-tools", "method": "GET", "use": "Lista över varje ProxMenux efterinstallationsoptimering som för närvarande är registrerad på värden (från /usr/local/share/proxmenux/installed_tools.json)." }, { "endpoint": "/api/proxmenux/tool-source/", "method": "GET", "use": "Källkod för den kopplade efterinstallationsfunktionen från aktuella värdskript eller bevarad äldre kod. Ingen garanterad kopia av exakt den kod som ursprungligen kördes." } ] }, "prometheus": { "heading": "Prometheus-mätvärden", "intro": "Den autentiserade slutpunkten GET /api/prometheus ger Prometheus textformat 0.0.4. Varje mätvärde innehåller node=\"<hostname>\" och en uttrycklig tidsstämpel. Samla med Prometheus eller en kompatibel tidsseriedatabas.", "exportedTitle": "Exporterade mätvärden", "headerGroup": "Grupp", "headerMetric": "Mätvärde", "headerDesc": "Beskrivning", "groups": [ { "group": "System", "metrics": [ { "metric": "proxmox_cpu_usage", "desc": "CPU-användning i procent, typen gauge." }, { "metric": "proxmox_memory_total_bytes", "desc": "Totalt fysiskt minne i byte." }, { "metric": "proxmox_memory_used_bytes", "desc": "Använt minne i byte." }, { "metric": "proxmox_memory_usage_percent", "desc": "Minnesanvändningsprocent." }, { "metric": "proxmox_load_average", "desc": "Genomsnittlig systembelastning. Etikett period=\"1m\" | \"5m\" | \"15m\"." } ] }, { "group": "Drifttid", "metrics": [ { "metric": "proxmox_uptime_seconds", "desc": "Sekunder sedan senaste start." } ] }, { "group": "Hårdvara", "metrics": [ { "metric": "proxmox_cpu_temperature_celsius", "desc": "CPU:ns kapslingstemperatur." }, { "metric": "proxmox_disk_temperature_celsius", "desc": "Temperatur per disk. Etikett disk." }, { "metric": "proxmox_fan_speed_rpm", "desc": "Fläkthastigheter. Etikett fan." } ] }, { "group": "Diskutrymme", "metrics": [ { "metric": "proxmox_disk_total_bytes", "desc": "Total kapacitet per exporterad diskpost. Etikett disk." }, { "metric": "proxmox_disk_used_bytes", "desc": "Använd kapacitet per exporterad diskpost." }, { "metric": "proxmox_disk_usage_percent", "desc": "Använd kapacitet i procent per exporterad diskpost." } ] }, { "group": "Nätverk", "metrics": [ { "metric": "proxmox_network_bytes_sent_total", "desc": "Totalt antal skickade byte, typen counter." }, { "metric": "proxmox_network_bytes_received_total", "desc": "Totalt antal mottagna byte, typen counter." }, { "metric": "proxmox_interface_bytes_sent_total", "desc": "Skickade byte per gränssnitt. Etikett interface." }, { "metric": "proxmox_interface_bytes_received_total", "desc": "Mottagna byte per gränssnitt." } ] }, { "group": "VMs / CTs", "metrics": [ { "metric": "proxmox_vms_total", "desc": "Totalt antal VM och LXC." }, { "metric": "proxmox_vms_running", "desc": "Antal körande gäster." }, { "metric": "proxmox_vms_stopped", "desc": "Antal stoppade gäster." }, { "metric": "proxmox_vm_status", "desc": "Status per VM/CT: 1 körs, 0 annars. Etiketter node, vmid och name." }, { "metric": "proxmox_vm_cpu_usage", "desc": "CPU-användning per VM/CT, med samma etiketter." }, { "metric": "proxmox_vm_memory_used_bytes / _max_bytes", "desc": "Använt minne och konfigurerat maximum per VM/CT." } ] }, { "group": "GPU", "metrics": [ { "metric": "proxmox_gpu_temperature_celsius", "desc": "GPU-temperatur. Etiketter slot och vendor; gpu innehåller även GPU-namnet." }, { "metric": "proxmox_gpu_utilization_percent", "desc": "GPU-användning i procent." }, { "metric": "proxmox_gpu_memory_total_bytes", "desc": "Totalt GPU-minne." }, { "metric": "proxmox_gpu_power_draw_watts", "desc": "GPU:ns effektförbrukning i watt." }, { "metric": "proxmox_gpu_clock_speed_mhz", "desc": "GPU:ns kärnklockfrekvens." }, { "metric": "proxmox_gpu_memory_clock_mhz", "desc": "GPU:ns minnesklockfrekvens." } ] }, { "group": "UPS", "metrics": [ { "metric": "proxmox_ups_battery_charge_percent", "desc": "Batteriets laddning i procent." }, { "metric": "proxmox_ups_load_percent", "desc": "Nuvarande belastning på UPS." }, { "metric": "proxmox_ups_runtime_seconds", "desc": "Beräknad drifttid på batteri." }, { "metric": "proxmox_ups_input_voltage_volts", "desc": "Ingångsspänning" } ] } ], "scrapeTitle": "Insamlingskonfiguration för Prometheus", "scrapeIntro": "Med autentisering på anger du ett API-token i Bearer-headern för Prometheus insamlingskonfiguration:", "perHostTitle": "Insamling per värd", "perHostBody": "Varje instans exporterar mätvärden för sin egen värd. Låt Prometheus samla från varje nod i ett kluster. Etiketten node skiljer serierna i Grafana (proxmox_vms_running'{'node=\"pve01\"'}')." }, "puttingItTogether": { "heading": "Kombinera integrationerna", "body": "Se Integrationer för att ansluta slutpunkterna till Home Assistant-sensorer, Homepage-kort, Grafana-paneler, n8n-flöden och fler verktyg. Där finns vanliga konfigurationer att kopiera. Den här sidan samlar slutpunktskatalogen." }, "whereNext": { "heading": "Gå vidare", "items": [ { "label": "Åtkomst och autentisering", "href": "/docs/monitor/access-auth", "tail": " — skapande av token, granskningslogg, valfri Fail2Ban-jail och TLS." }, { "label": "Aviseringar", "href": "/docs/monitor/notifications", "tailRich": " — innehåll i data per händelsetyp vid anrop till /api/notifications/send." }, { "label": "AI-assistent", "href": "/docs/monitor/ai-assistant", "tailRich": " — hur /api/notifications/test-ai och /api/notifications/provider-models fungerar." }, { "label": "Hälsoövervakare", "href": "/docs/monitor/health-monitor", "tailRich": " — svarsformat för /api/health/* och betydelsen av de tio kategorierna." } ] } }