Användningsstatistik

Tenantadmin

Två endpoints, bara för läsning, svarar på “hur mycket GPU använde varje projekt” och “hur fullt var det”, för att hämta in i ett kalkylark eller en BI-modell som Power BI. De har ingen sida i webbgränssnittet. Båda svarar bara för din egen tenant, och bara till en tenantadmin. Autentisera som för vilket annat anrop som helst - se REST API - eller med en API-nyckel.

GPU-timmar per projekt

curl -s "https://app.example.aiqu.ai/api/admin/statistics/gpu_usage?from=2026-01-01&to=2026-09-30&granularity=month" \
  -H "Authorization: Bearer aiqu_sk_..."

Parameter
from	Första dagen, YYYY-MM-DD. Förval är det äldsta jobbet som finns
to	Sista dagen, inklusive. Förval är idag
granularity	month (förval) eller day

En rad per projekt och period:

Fält
projectid, projectname	Projektet. null för jobb som körts utanför ett projekt
period_start	Periodens första dag. Med month betyder 2026-09-01 hela september
granularity	Vad raden är aggregerad på
jobs	Jobb som körde under perioden
gpu_hours	Körda timmar gånger GPU:erna jobbet höll
job_hours	Körda timmar, oavsett antal GPU:er

En körning som korsar en periodgräns delas: ett jobb från 28 augusti till 3 september lägger sina augustitimmar i augusti och resten i september. Varje körning av ett omstartat jobb räknas, inte bara den senaste.

Gruppera på projectid, och summera inte jobs

Projektnamn är inte unika - ett borttaget projekts namn kan återanvändas - så koppla på projectid. Ett jobb som sträcker sig över två perioder räknas i jobs för båda, så att summera jobs över perioder räknar för många. Timmarna summeras korrekt.

Beläggning över tid

curl -s "https://app.example.aiqu.ai/api/admin/statistics/gpu_timeline?interval=15" \
  -H "Authorization: Bearer aiqu_sk_..."

Parameter
from	Första dagen. Förval är igår, så förvalt fönster är igår och idag
to	Sista dagen, inklusive. Förval är idag
interval	Hinkens storlek i minuter, 1 till 1440. Förval 60

En rad per hink, tomma hinkar inräknade, så serien har inga hål:

Fält
ts	Hinkens början, serverns lokala tid
jobs_running	Jobb vars körning överlappade hinken
gpus_allocated	GPU:er som de jobben höll

gpus_allocated är vad som var bokat, inte hur hårt GPU:erna arbetade. Ett jobb som håller fyra GPU:er och står still räknas ändå som fyra. För utnyttjandegrad, använd nodernas mätvärden.

Ett anrop får täcka högst 20 000 hinkar. Ett år med minutupplösning är långt över det och avvisas med en 400 som säger det: öka interval eller minska fönstret.