Jurnale de audit și monitorizare prin consolă
Pe această pagină
Importanța auditului într-un mediu reglementat
Când un auditor SOC 2 întreabă: „Cine a consumat ce, când și cum ați afla în caz de anomalie?“, răspunsul nu poate fi „ne vom uita“. Pentru orice organizație supusă obligațiilor de conformitate—SOC 2, HIPAA, GDPR—trasabilitatea acțiunilor este o cerință fundamentală, iar dumneavoastră o pregătiți înainte de incident, nu după. Consola xAI (console.x.ai) oferă instrumentele de monitorizare și audit care vă permit să urmăriți utilizarea cheilor API și să detectați anomaliile; această lecție vă arată cum să le utilizați și apoi cum să le completați la nivelul aplicației.
Consola xAI: tabloul dumneavoastră de bord pentru securitate
Consola, accesibilă la console.x.ai, centralizează patru funcții: gestionarea cheilor API, monitorizarea utilizării, facturarea cu limite de cheltuieli și informațiile despre securitatea contului. Din punct de vedere al datelor, aceasta vă oferă utilizarea per cheie (număr de cereri, tokeni consumați), utilizarea per model, istoricul detaliat al facturării pe perioade și starea fiecărei chei—activă, blocată sau dezactivată. Obișnuiți-vă să o revizuiți regulat: majoritatea compromiterilor cheilor sunt observate mai întâi printr-o curbă de utilizare care nu mai seamănă cu cea din săptămânile anterioare.
Analiza utilizării prin API
Consola este suficientă pentru o privire rapidă, dar o monitorizare serioasă trebuie să fie programatică: acesta este rolul endpoint-ului de analiză.
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"]
}
}
Această cerere solicită suma tokenilor consumați, zi de zi, defalcată pe modele, pentru luna martie. Flexibilitatea provine din opțiunile combinabile: unitățile de timp variază de la MONTH la MINUTE, incluzând CALENDAR_WEEK, DAY, HOUR și QUARTER_HOUR; agregările disponibile sunt SUM, AVG, MIN, MAX, percentilele P50, P90 și P99, precum și COUNT și COUNT_DISTINCT; iar dumneavoastră puteți grupa după model, perioadă sau cheie.
Aceste componente acoperă patru nevoi concrete. În primul rând, detectarea anomaliilor: o creștere bruscă a consumului pe o cheie care gestionează de obicei un volum stabil este simptomul clasic al unei compromiteri—aceasta este interogarea pe care scriptul dumneavoastră de monitorizare ar trebui să o ruleze în fiecare noapte. În al doilea rând, optimizarea costurilor: grupând după model, identificați endpoint-uri subutilizate sau modele scumpe apelate inutil. Rapoarte de conformitate: aceeași interogare, pe un trimestru, produce cifrele pe care auditorul le va solicita. În final, planificarea capacității: tendința de consum vă indică când să reîncărcați creditele înainte de a rămâne fără ele într-o duminică.
Construirea unui sistem de alertare
Un tablou de bord pe care nu îl priviți nu protejează nimic; alertele, însă, vin la dumneavoastră. Iată scheletul unei verificări zilnice care compară consumul ultimelor 24 de ore cu un prag:
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")
Completați această configurare cu o plasă de siguranță bugetară: endpoint-ul POST /v1/billing/teams/{team_id}/postpaid/spending-limits vă permite să setați o limită lunară de cheltuieli—depășirea necontrolată devine astfel imposibilă, indiferent de cauză. Și pentru a ști unde vă situați în orice moment al ciclului de facturare, GET /v1/billing/teams/{team_id}/postpaid/invoice/preview vă oferă o previzualizare a taxelor acumulate înainte de factura finală.
Jurnalele aplicației la nivel de client
Consola xAI vede ce se întâmplă la xAI; nu vede ce se întâmplă la dumneavoastră. Jurnalele propriei aplicații reprezintă cealaltă jumătate a trasabilității: ele sunt cele care vor răspunde la întrebarea „care utilizator a declanșat acest apel?“. Pentru fiecare apel API, înregistrați marcajul temporal, ID-ul utilizatorului care a inițiat apelul, modelul și endpoint-ul utilizat, numărul de tokeni de intrare și de ieșire, statusul răspunsului HTTP, latența și ID-ul cheii API în versiune mascată.
Disciplina inversă este la fel de importantă, deoarece un jurnal prea detaliat devine el însuși o scurgere de date. Nu înregistrați niciodată conținutul prompturilor care conțin date personale, nici răspunsurile care conțin informații sensibile, nici cheile API în text clar, nici tokenii efemeri. Un fișier jurnal care conține prompturile utilizatorilor dumneavoastră este o bază de date cu caracter personal deghizată—cu toate obligațiile GDPR pe care acest lucru le implică, inclusiv dreptul la ștergere.
Cinci metrici care fac monitorizarea lizibilă
Pentru a consolida această lecție, grupați datele de monitorizare într-un singur tablou de bord, în loc să înmulțiți ecranele. Primele două metrici descriu activitatea normală: consumul zilnic per cheie și per model, și rata de eroare (4xx, 5xx) per endpoint, care relevă atât o eroare de implementare, cât și o cheie cu permisiuni configurate greșit. Următoarele două descriu frecarea: încercările de moderare declanșate, care vă spun ce încearcă să facă utilizatorii dumneavoastră, și cheile apropiate de expirare, pentru a anticipa reînnoirile în loc să le gestionați neașteptat.
A cincea metrică este cea care face diferența: comparația cu mediile istorice. Un număr brut nu spune nimic—opt milioane de tokeni aseară, este mult? O abatere de la normă, însă, spune totul, iar pe această abatere ar trebui să se declanșeze alertele dumneavoastră.
Puncte cheie
- Consola xAI (console.x.ai) centralizează monitorizarea, gestionarea cheilor și facturarea
- Endpoint-ul usage permite analiza programatică cu agregare flexibilă (de la SUM la P99, de la MINUTE la MONTH)
- Configurați alerte de prag pentru consum: o creștere anormală este primul semn al unei compromiteri
- Stabiliți limite de cheltuieli prin Management API pentru a limita orice depășire
- Înregistrați metadate la nivelul aplicației, niciodată conținut sensibil sau chei în text clar