Granskningsloggar och övervakning via konsolen
På denna sida
Vikten av granskning i en reglerad miljö
När en SOC 2-revisor frågar: “Vem konsumerade vad, när, och hur skulle du veta det vid en avvikelse?” kan svaret inte vara “vi får undersöka saken”. För varje organisation som lyder under efterlevnadskrav – SOC 2, HIPAA, GDPR – är spårbarhet för åtgärder ett grundläggande krav som du förbereder innan incidenten inträffar, inte efteråt. xAI-konsolen (console.x.ai) tillhandahåller de övervaknings- och granskningsverktyg som låter dig spåra din API-nyckelanvändning och upptäcka avvikelser; denna lektion visar dig hur du använder dem och sedan hur du kompletterar dem på applikationssidan.
xAI-konsolen: din säkerhetsinstrumentpanel
Konsolen, tillgänglig på console.x.ai, centraliserar fyra funktioner: hantering av API-nycklar, användningsövervakning, fakturering med utgiftstak och information om kontosäkerhet. När det gäller data ger den dig användning per nyckel (antal förfrågningar, konsumerade tokens), användning per modell, detaljerad faktureringshistorik per period och status för varje nyckel – aktiv, blockerad eller inaktiverad. Gör det till en vana att granska den regelbundet: de flesta komprometterade nycklar upptäcks först genom en användningskurva som inte längre liknar de tidigare veckornas.
Användningsanalys via API:t
Konsolen räcker för en snabb överblick, men seriös övervakning måste vara programmatisk: det är analys-slutpunktens roll.
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"]
}
}
Denna förfrågan begär summan av konsumerade tokens, dag för dag, uppdelat per modell, för månaden mars. Flexibiliteten kommer från kombinerbara alternativ: tidsenheter sträcker sig från MONTH till MINUTE, inklusive CALENDAR_WEEK, DAY, HOUR och QUARTER_HOUR; tillgängliga aggregeringar är SUM, AVG, MIN, MAX, percentiler P50, P90 och P99, samt COUNT och COUNT_DISTINCT; och du kan gruppera efter modell, period eller nyckel.
Dessa komponenter täcker fyra konkreta behov. Först, avvikelsedetektering: en plötslig topp i konsumtionen på en nyckel som vanligtvis hanterar en stabil volym är det klassiska symtomet på en kompromettering – detta är frågan ditt övervakningsskript bör köra varje natt. Därefter, kostnadsoptimering: genom att gruppera efter modell identifierar du underutnyttjade slutpunkter eller dyra modeller som anropas i onödan. Efterlevnadsrapporter: samma fråga, över ett kvartal, producerar de siffror revisorn kommer att begära. Slutligen, kapacitetsplanering: konsumtionstrenden berättar när du behöver fylla på dina krediter innan de tar slut en söndag.
Bygga ett larmsystem
En instrumentpanel du inte tittar på skyddar ingenting; larm kommer dock till dig. Här är skelettet för en daglig kontroll som jämför de senaste 24 timmarnas konsumtion med ett tröskelvärde:
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")
Komplettera denna setup med ett ekonomiskt säkerhetsnät: slutpunkten POST /v1/billing/teams/{team_id}/postpaid/spending-limits låter dig ställa in en månatlig utgiftsgräns – okontrollerad överskridande blir då omöjlig, oavsett orsak. Och för att veta var du står vid vilken tidpunkt som helst under faktureringscykeln ger GET /v1/billing/teams/{team_id}/postpaid/invoice/preview en förhandsvisning av ackumulerade avgifter innan den slutgiltiga fakturan.
Applikationsloggar på klientsidan
xAI-konsolen ser vad som händer hos xAI; den ser inte vad som händer hos dig. Dina egna applikationsloggar är den andra halvan av spårbarheten: det är de som kommer att svara på frågan “vilken användare utlöste detta anrop?”. För varje API-anrop, logga tidsstämpeln, ID:t för användaren som initierade anropet, modellen och slutpunkten som användes, antalet inmatnings- och utmatningstokens, HTTP-svarsstatus, latens och API-nyckel-ID:t i maskerad version.
Den omvända disciplinen är lika viktig, eftersom en utförlig logg i sig blir en dataintrång. Logga aldrig innehållet i prompts som innehåller personuppgifter, ej heller svar som innehåller känslig information, ej API-nycklar i klartext och ej flyktiga tokens. En loggfil som innehåller dina användares prompts är en personuppgiftsregister i förklädnad – med alla GDPR-skyldigheter det innebär, inklusive rätten till radering.
Fem mätvärden som gör övervakningen läsbar
För att sammanfatta denna lektion, samla dina övervakningsdata i en enda instrumentpanel istället för att multiplicera skärmar. De två första mätvärdena beskriver normal aktivitet: daglig konsumtion per nyckel och per modell, samt felgraden (4xx, 5xx) per slutpunkt, vilket avslöjar både ett distributionsfel och en nyckel med felaktigt konfigurerade behörigheter. De nästa två beskriver friktion: utlösta modereringsförsök, som berättar vad dina användare försöker göra, och nycklar nära utgångsdatum, för att förutse förnyelser snarare än att ställas inför dem oväntat.
Det femte mätvärdet är det som gör skillnaden: jämförelse med historiska genomsnitt. Ett rått tal säger ingenting – åtta miljoner tokens igår natt, är det mycket? En avvikelse från normen säger dock allt, och det är på denna avvikelse dina larm bör utlösas.
Viktiga punkter
- xAI-konsolen (console.x.ai) centraliserar övervakning, nyckelhantering och fakturering
- Slutpunkten för användning möjliggör programmatisk analys med flexibel aggregering (SUM till P99, från MINUTE till MONTH)
- Konfigurera tröskellarm för konsumtion: en onormal topp är det första tecknet på kompromettering
- Ställ in utgiftstak via Management API:t för att begränsa alla överskridanden
- Logga metadata på applikationssidan, aldrig känsligt innehåll eller nycklar i klartext