Revizijski dnevniki in nadzor prek konzole
Na tej strani
Pomen revizije v urejenem okolju
Ko revizor SOC 2 vpraša: „Kdo je porabil kaj, kdaj in kako bi to ugotovili v primeru anomalije?”, odgovor ne more biti „pogledali bomo”. Za vsako organizacijo, ki spada pod obveznosti skladnosti – SOC 2, HIPAA, GDPR – je sledljivost dejanj temeljna zahteva, ki jo pripravite pred incidentom, ne po njem. Konzola xAI (console.x.ai) ponuja orodja za nadzor in revizijo, ki vam omogočajo sledenje uporabi vaših API ključev in odkrivanje anomalij; ta lekcija vam pokaže, kako jih uporabiti in kako jih dopolniti na strani aplikacije.
Konzola xAI: vaša varnostna nadzorna plošča
Konzola, dostopna na naslovu console.x.ai, združuje štiri funkcije: upravljanje API ključev, nadzor uporabe, obračunavanje z omejitvami porabe in informacije o varnosti računa. Kar zadeva podatke, vam ponuja uporabo na ključ (število zahtevkov, porabljeni žetoni), uporabo na model, podrobno zgodovino obračunov po obdobjih in stanje vsakega ključa – aktivno, blokirano ali onemogočeno. Navadite se rednega pregledovanja: večina kompromitacij ključev se najprej odkrije s krivuljo uporabe, ki ne spominja več na prejšnje tedne.
Analiza uporabe prek API-ja
Konzola zadostuje za hiter pregled, vendar mora biti resen nadzor programski: to je vloga končne točke za analizo.
POST /v1/billing/teams/{team_id}/usage
{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-03-01 00:00:00",
"endTime": "2026-04-01 00:00:00",
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}],
"groupBy": ["model"]
}
}
Ta zahtevek pridobi vsoto porabljenih žetonov, dan za dnem, razčlenjeno po modelih, za mesec marec. Fleksibilnost izhaja iz kombinirljivih možnosti: časovne enote segajo od MONTH do MINUTE, vključno z CALENDAR_WEEK, DAY, HOUR in QUARTER_HOUR; razpoložljive agregacije so SUM, AVG, MIN, MAX, percentili P50, P90 in P99, ter COUNT in COUNT_DISTINCT; združujete lahko po modelu, obdobju ali ključu.
Te komponente pokrivajo štiri konkretne potrebe. Prvič, odkrivanje anomalij: nenaden skok v porabi na ključu, ki običajno obdeluje stabilen obseg, je klasičen simptom kompromitacije – to je poizvedba, ki naj jo vaša skripta za nadzor izvaja vsako noč. Drugič, optimizacija stroškov: z združevanjem po modelu odkrijete premalo izkoriščene končne točke ali drage modele, ki so nepotrebno poklicani. Tretjič, poročila o skladnosti: ista poizvedba, raztegnjena na četrtletje, proizvede številke, ki jih bo zahteval revizor. Nazadnje, načrtovanje zmogljivosti: trend porabe vam pove, kdaj napolniti kredite, preden vam zmanjka v nedeljo.
Izgradnja sistema opozoril
Nadzorna plošča, ki je ne gledate, ne ščiti ničesar; opozorila pa pridejo do vas. Tukaj je osnutek dnevnega preverjanja, ki primerja zadnjih 24 ur porabe s pragom:
import requests
from datetime import datetime, timedelta
def check_usage_anomaly(team_id, threshold_tokens):
today = datetime.utcnow()
yesterday = today - timedelta(days=1)
response = requests.post(
f"https://management-api.x.ai/v1/billing/teams/{team_id}/usage",
headers={"Authorization": f"Bearer {MGMT_KEY}"},
json={
"analyticsRequest": {
"timeRange": {
"startTime": yesterday.strftime("%Y-%m-%d 00:00:00"),
"endTime": today.strftime("%Y-%m-%d 00:00:00"),
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}]
}
}
)
total_tokens = sum_tokens(response.json())
if total_tokens > threshold_tokens:
send_alert(f"Abnormal usage: {total_tokens} tokens in 24h")
To nastavitev dopolnite z varnostno mrežo za proračun: končna točka POST /v1/billing/teams/{team_id}/postpaid/spending-limits vam omogoča nastavitev mesečne omejitve porabe – nenadzorovano prekomerno trošenje tako postane nemogoče, ne glede na vzrok. Da bi vedeli, kje stojite v katerem koli trenutku obračunskega cikla, vam GET /v1/billing/teams/{team_id}/postpaid/invoice/preview ponudi predogled nabranih stroškov pred izdajo končnega računa.
Dnevniki aplikacije na strani odjemalca
Konzola xAI vidi, kaj se dogaja pri xAI; ne vidi pa, kaj se dogaja pri vas. Vaši lastni dnevniki aplikacije so druga polovica sledljivosti: tisti so, ki bodo odgovorili na vprašanje „kateri uporabnik je sprožil ta klic?”. Za vsak klic API zabeležite časovni žig, ID uporabnika, ki je sprožil klic, uporabljeni model in končno točko, število vhodnih in izhodnih žetonov, stanje odziva HTTP, zakasnitev in ID API ključa v maskirani različici.
Enako pomembna je obratna disciplina, saj obsežen dnevnik sam postane uhajanje podatkov. Nikoli ne beležite vsebine pozivov, ki vsebujejo osebne podatke, niti odgovorov z občutljivimi informacijami, niti API ključev v čistem besedilu, niti prehodnih žetonov. Datoteka dnevnika, ki vsebuje pozive vaših uporabnikov, je prikrita osebna baza podatkov – z vsemi obveznostmi GDPR, ki to vključuje, vključno s pravico do izbrisa.
Pet metrik za berljiv nadzor
Za utrditev te lekcije zberite podatke nadzora na eni sami nadzorni plošči, namesto da množite zaslone. Prvi dve metriki opisujeta normalno dejavnost: dnevna poraba na ključ in na model ter stopnja napak (4xx, 5xx) na končno točko, kar razkriva tako napako pri uvedbi kot ključ z napačno konfiguriranimi dovoljenji. Naslednji dve opisujeta trenje: sproženi poskusi moderiranja, ki vam povedo, kaj vaši uporabniki poskušajo storiti, in ključi, ki se bližajo poteku veljavnosti, da predvidite obnove, namesto da bi se z njimi soočili nepričakovano.
Peta metrika je tista, ki naredi razliko: primerjava s povprečji iz preteklosti. Surovo število ne pove nič – osem milijonov žetonov prejšnjo noč, je to veliko? Odstopanje od norme pa pove vse in prav na tem odstopanju naj se sprožijo vaša opozorila.
Ključne ugotovitve
- Konzola xAI (console.x.ai) združuje nadzor, upravljanje ključev in obračunavanje
- Končna točka usage omogoča programsko analizo s prilagodljivo agregacijo (od SUM do P99, od MINUTE do MONTH)
- Konfigurirajte opozorila na pragove porabe: nenormalen skok je prvi znak kompromitacije
- Nastavite omejitve porabe prek Management API-ja za omejitev morebitnega presežka
- Na strani aplikacije beležite metapodatke, nikoli občutljive vsebine ali ključev v čistem besedilu