Revizije zapisnika i nadzor putem konzole
Na ovoj stranici
Važnost revizije u reguliranom okruženju
Kada revizor za SOC 2 upita: „Tko je što koristio, kada i kako biste to saznali u slučaju anomalije?“, odgovor ne smije biti „pogledat ćemo“. Za svaku organizaciju koja podliježe obvezama usklađenosti – SOC 2, HIPAA, GDPR – sljedivost radnji temeljni je zahtjev, a pripremaš je prije incidenta, a ne nakon njega. xAI konzola (console.x.ai) nudi alate za nadzor i reviziju koji ti omogućuju praćenje korištenja API ključeva i otkrivanje anomalija; ova lekcija pokazuje ti kako ih koristiti, a zatim kako ih nadopuniti na strani aplikacije.
xAI konzola: tvoja sigurnosna nadzorna ploča
Konzola, dostupna na console.x.ai, objedinjuje četiri funkcije: upravljanje API ključevima, nadzor korištenja, naplatu s ograničenjima trošenja i informacije o sigurnosti računa. Što se tiče podataka, daje ti pregled korištenja po ključu (broj zahtjeva, potrošeni tokeni), korištenje po modelu, detaljnu povijest naplate po razdoblju i status svakog ključa – aktivan, blokiran ili onemogućen. Učini navikom da je redovito pregledavaš: većina kompromitacija ključeva prvo se uoči po krivulji korištenja koja više ne nalikuje onoj iz prethodnih tjedana.
Analiza korištenja putem API-ja
Konzola je dovoljna za brz pregled, ali ozbiljan nadzor mora biti programski: tu nastupa krajnja točka za analizu.
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"]
}
}
Ovaj zahtjev traži zbroj potrošenih tokena, dan po dan, raščlanjeno po modelu, za mjesec ožujak. Fleksibilnost proizlazi iz kombinabilnih opcija: vremenske jedinice kreću se od MJESECA do MINUTE, uključujući CALENDAR_WEEK, DAY, HOUR i QUARTER_HOUR; dostupne agregacije su SUM, AVG, MIN, MAX, percentili P50, P90 i P99, kao i COUNT te COUNT_DISTINCT; a grupirati možeš po modelu, razdoblju ili ključu.
Ove komponente pokrivaju četiri konkretne potrebe. Prvo, otkrivanje anomalija: nagli skok u potrošnji na ključu koji obično obrađuje stabilan volumen klasičan je simptom kompromitacije – ovo je upit koji bi tvoja skripta za nadzor trebala pokretati svake noći. Dalje, optimizacija troškova: grupiranjem po modelu uočavaš nedovoljno iskorištene krajnje točke ili skupe modele koji se nepotrebno pozivaju. Izvješća o usklađenosti: isti upit, tijekom kvartala, proizvodi brojke koje će revizor tražiti. Konačno, planiranje kapaciteta: trend potrošnje govori ti kada trebaš ponovno napuniti kredite prije nego što potrošiš sve u nedjelju.
Izgradnja sustava upozorenja
Nadzorna ploča koju ne gledaš ništa ne štiti; upozorenja, međutim, dolaze tebi. Evo kostura dnevne provjere koja uspoređuje posljednjih 24 sata potrošnje 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")
Nadopuni ovu postavku financijskom sigurnosnom mrežom: krajnja točka POST /v1/billing/teams/{team_id}/postpaid/spending-limits omogućuje ti postavljanje mjesečnog ograničenja trošenja – nekontrolirano prekoračenje tada postaje nemoguće, bez obzira na uzrok. A da bi znao gdje se nalaziš u bilo kojem trenutku obračunskog ciklusa, GET /v1/billing/teams/{team_id}/postpaid/invoice/preview daje ti pregled akumuliranih troškova prije konačnog računa.
Zapisnici aplikacije na strani klijenta
xAI konzola vidi što se događa kod xAI-ja; ne vidi što se događa kod tebe. Tvoji vlastiti zapisnici aplikacije druga su polovica sljedivosti: oni su ti koji će odgovoriti na pitanje „koji je korisnik pokrenuo ovaj poziv?“. Za svaki API poziv zabilježi vremensku oznaku, ID korisnika koji je inicirao poziv, korišteni model i krajnju točku, broj ulaznih i izlaznih tokena, HTTP status odgovora, kašnjenje i ID API ključa u maskiranoj verziji.
Suprotna disciplina jednako je važna jer opširan zapisnik sam postaje curenje podataka. Nikada ne bilježi sadržaj promptova koji sadrže osobne podatke, niti odgovore koji sadrže osjetljive informacije, niti API ključeve u čistom tekstu, niti privremene tokene. Datoteka zapisnika koja sadrži promptove tvojih korisnika zamaskirana je baza osobnih podataka – sa svim obvezama iz GDPR-a koje to podrazumijeva, uključujući pravo na brisanje.
Pet metrika koje činje nadzor čitljivim
Da bi zaokružio ovu lekciju, prikupi svoje podatke o nadzoru na jednoj nadzornoj ploči umjesto da umnožavaš ekrane. Prve dvije metrike opisuju normalnu aktivnost: dnevna potrošnja po ključu i modelu te stopa pogrešaka (4xx, 5xx) po krajnjoj točki, što otkriva i grešku u implementaciji i ključ s pogrešno konfiguriranim dopuštenjima. Sljedeće dvije opisuju trenje: pokušaji moderiranja koji su se aktivirali, koji govore što tvoji korisnici pokušavaju učiniti, i ključevi blizu isteka, kako bi anticipirao obnove umjesto da se suočiš s njima neočekivano.
Peta metrika je ona koja čini razliku: usporedba s povijesnim prosjecima. Sirov broj ne govori ništa – osam milijuna tokena prošle noći, je li to puno? Odstupanje od norme, međutim, govori sve, i upravo na tom odstupanju tvoja upozorenja trebaju okinuti.
Ključne točke
- xAI konzola (console.x.ai) objedinjuje nadzor, upravljanje ključevima i naplatu
- Krajnja točka usage omogućuje programsku analizu s fleksibilnom agregacijom (od SUM do P99, od MINUTE do MONTH)
- Konfiguriraj upozorenja na pragove potrošnje: abnormalni skok prvi je znak kompromitacije
- Postavi ograničenja trošenja putem Management API-ja kako bi ograničio svako prekoračenje
- Bilježi metapodatke na strani aplikacije, nikada osjetljivi sadržaj ili ključeve u čistom tekstu