Auditilogid ja jälgimine konsooli kaudu
Sellel lehel
Auditeerimise tähtsus reguleeritud keskkonnas
Kui SOC 2 audiitor küsib: „Kes mida tarbis, millal ja kuidas sa seda anomaalia korral teada saaksid?“, ei saa vastus olla „uurime asja“. Igale vastavuskohustustele (SOC 2, HIPAA, GDPR) alluvale organisatsioonile on tegevuste jälgitavus fundamentaalne nõue, milleks valmistutakse enne intsidenti, mitte pärast. xAI konsool (console.x.ai) pakub jälgimis- ja auditivahendeid, mis võimaldavad sul jälgida oma API võtmete kasutust ja tuvastada anomaaliaid; see õppetund näitab, kuidas neid kasutada ja seejärel, kuidas neid rakenduse tasandil täiendada.
xAI konsool: sinu turbe armatuurlaud
Konsool, mis on kättesaadav aadressil console.x.ai, koondab neli funktsiooni: API võtmete haldus, kasutuse jälgimine, arveldus kulupiirangutega ja konto turbeinfo. Andmete poolelt annab see sulle kasutuse võtme kaupa (päringute arv, tarbitud tokenid), kasutuse mudeli kaupa, üksikasjaliku arveldusajaloo periooditi ja iga võtme staatuse – aktiivne, blokeeritud või deaktiveeritud. Tee harjumuseks seda regulaarselt üle vaadata: enamik võtmekompromisse avastatakse esmalt kasutuskõvera kaudu, mis ei sarnane enam eelmiste nädalate omaga.
Kasutuse analüüs API kaudu
Konsool sobib kiireks ülevaateks, kuid tõsine jälgimine peab olema programmeeritav: selleks ongi mõeldud analüüsi lõpp-punkt.
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"]
}
}
See päring küsib tarbitud tokenite summat päev kaupa, jaotatuna mudelite kaupa, märtsikuu jaoks. Paindlikkus tuleneb kombineeritavatest valikutest: ajaühikud ulatuvad KUUST MINUTINI, kaasates CALENDAR_WEEK, DAY, HOUR ja QUARTER_HOUR; saadaolevad agregeerimised on SUM, AVG, MIN, MAX, protsentiilid P50, P90 ja P99, samuti COUNT ja COUNT_DISTINCT; ja saad rühmitada mudeli, perioodi või võtme järgi.
Need komponendid katavad nelja konkreetset vajadust. Esiteks, anomaaliate tuvastamine: järsk tarbimise tõus võtmel, mis tavaliselt töötleb stabiilset mahtu, on klassikaline kompromissi sümptom – see on päring, mida sinu jälgimisskript peaks igal ööl käivitama. Järgmiseks, kulude optimeerimine: rühmitades mudeli järgi, märkad vähekasutatud lõpp-punkte või põhjendamatult kutsutud kalleid mudeleid. Vastavusaruanded: sama päring kvartali lõikes toodab arvud, mida audiitor küsib. Lõpuks, võimsuse planeerimine: tarbimise trend ütleb, millal oma krediidid uuesti laadida, enne kui need pühapäeval otsa saavad.
Hoiatussüsteemi loomine
Armatuurlaud, mida sa ei vaata, ei kaitse midagi; hoiatused aga tulevad sinu juurde. Siin on igapäevase kontrolli luustik, mis võrdleb viimase 24 tunni tarbimist lävendiga:
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")
Täienda seda seadistust eelarvelise ohutusvõrguga: lõpp-punkt POST /v1/billing/teams/{team_id}/postpaid/spending-limits võimaldab sul määrata kuu kulupiirangu – kontrollimatu ületarbimine muutub seejärel võimatuks, sõltumata põhjusest. Et teada saada, kus sa arveldustsükli igal hetkel seisad, annab GET /v1/billing/teams/{team_id}/postpaid/invoice/preview ülevaate kogunenud kuludest enne lõplikku arvet.
Kliendipoolse rakenduse logid
xAI konsool näeb, mis toimub xAI-s; see ei näe, mis toimub sinu pool. Sinu enda rakenduse logid on jälgitavuse teine pool: need on need, mis vastavad küsimusele „milline kasutaja selle kõne käivitas?“. Iga API kõne jaoks logi ajatempel, kõne algatanud kasutaja ID, kasutatud mudel ja lõpp-punkt, sisend- ja väljundtokenite arv, HTTP vastuse staatus, latentsus ja API võtme ID maskeeritud versioonis.
Pöördne distsipliin on sama oluline, sest liiga detailne logi muutub ise andmelekkeks. Ära kunagi logi isikuandmeid sisaldavate vihjete (prompt) sisu, tundlikku teavet sisaldavaid vastuseid, API võtmeid selgesõnaliselt ega efemeerseid tokeneid. Logifail, mis sisaldab sinu kasutajate vihjeid, on maskeeritud isikuandmebaas – koos kõigi GDPR-i kohustustega, mida see endaga kaasa toob, sealhulgas õigus kustutamisele.
Viis mõõdikut, mis muudavad jälgimise loetavaks
Selle õppetunni kokkuvõtteks koonda oma jälgimisandmed ühele armatuurlauale, mitte ei korruta ekraane. Esimesed kaks mõõdikut kirjeldavad normaalset tegevust: päevane tarbimine võtme ja mudeli kaupa ning veamäär (4xx, 5xx) lõpp-punkti kohta, mis paljastab nii juurutusvea kui ka valesti konfigureeritud õigustega võtme. Järgmised kaks kirjeldavad hõõrdumist: käivitatud moderatsioonikatsetused, mis annavad teada, mida sinu kasutajad teha üritavad, ja aegumisele lähenevad võtmed, et uuendusi ette näha, mitte nendega ootamatult silmitsi seista.
Viies mõõdik on see, mis teeb vahet: võrdlus ajalooliste keskmistega. Toorarv ei ütle midagi – kaheksa miljonit tokenit eile õhtul, kas see on palju? Normist kõrvalekalle aga ütleb kõik ja just sellele kõrvalekaldele peaksid sinu hoiatused reageerima.
Peamised punktid
- xAI konsool (console.x.ai) koondab jälgimise, võtmehalduse ja arvelduse
- Kasutuse lõpp-punkt võimaldab programmeeritavat analüüsi paindliku agregeerimisega (SUM kuni P99, MINUTIST KUUNI)
- Seadista tarbimisele lävendipõhised hoiatused: ebanormaalne tõus on esimene kompromissi märk
- Määra kulupiirangud haldus-API kaudu, et piirata igasugust ületamist
- Logi rakenduse tasandil metaandmeid, mitte kunagi tundlikku sisu ega võtmeid selgesõnaliselt