Auditlogs en monitoring via de console
Op deze pagina
Het belang van auditing in een gereguleerde omgeving
Wanneer een SOC 2-auditor vraagt: “Wie heeft wat verbruikt, wanneer, en hoe zou u dat weten bij een afwijking?”, kan het antwoord niet zijn: “daar kijken we dan wel naar”. Voor elke organisatie die onderworpen is aan compliance-verplichtingen—SOC 2, HIPAA, GDPR—is traceerbaarheid van acties een fundamentele vereiste. U bereidt dit voor vóór het incident, niet erna. De xAI-console (console.x.ai) biedt de monitoring- en audittools waarmee u uw API-sleutelgebruik kunt volgen en afwijkingen kunt detecteren; deze les laat u zien hoe u deze gebruikt en hoe u ze aan de toepassingskant kunt aanvullen.
De xAI-console: uw securitydashboard
De console, toegankelijk via console.x.ai, centraliseert vier functies: API-sleutelbeheer, gebruiksmonitoring, facturatie met uitgavenlimieten en informatie over accountbeveiliging. Qua gegevens biedt het u het gebruik per sleutel (aantal verzoeken, verbruikte tokens), gebruik per model, gedetailleerde factuurgeschiedenis per periode en de status van elke sleutel—actief, geblokkeerd of uitgeschakeld. Maak er een gewoonte van om deze regelmatig te controleren: de meeste compromitteringen van sleutels worden eerst opgemerkt aan een gebruikscurve die niet meer lijkt op die van de vorige weken.
Gebruiksaanalyse via de API
De console volstaat voor een snelle blik, maar serieuze monitoring moet programmatisch gebeuren: dat is de rol van het analyse-endpoint.
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"]
}
}
Dit verzoek vraagt om de som van verbruikte tokens, dag per dag, uitgesplitst per model, voor de maand maart. De flexibiliteit komt door combineerbare opties: tijdseenheden variëren van MONTH tot MINUTE, inclusief CALENDAR_WEEK, DAY, HOUR en QUARTER_HOUR; beschikbare aggregaties zijn SUM, AVG, MIN, MAX, percentielen P50, P90 en P99, evenals COUNT en COUNT_DISTINCT; en u kunt groeperen op model, periode of sleutel.
Deze componenten dekken vier concrete behoeften. Ten eerste afwijkingsdetectie: een plotselinge piek in verbruik op een sleutel die doorgaans een stabiel volume verwerkt, is het klassieke symptoom van een compromis—dit is de query die uw monitoringsscript elke nacht moet uitvoeren. Vervolgens kostenoptimalisatie: door te groeperen op model, spot u onderbenutte endpoints of dure modellen die onnodig worden aangeroepen. Compliance-rapportages: dezelfde query, over een kwartaal, produceert de cijfers die de auditor zal opvragen. Tot slot capaciteitsplanning: de verbruikstrend vertelt u wanneer u uw credits moet opladen voordat ze op een zondag op zijn.
Een waarschuwingssysteem bouwen
Een dashboard waarnaar u niet kijkt, beschermt niets; waarschuwingen daarentegen komen naar u toe. Hier is het skelet van een dagelijkse controle die het verbruik van de laatste 24 uur vergelijkt met een drempelwaarde:
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"Abnormaal gebruik: {total_tokens} tokens in 24u")
Vul deze opzet aan met een budgettair veiligheidsnet: het endpoint POST /v1/billing/teams/{team_id}/postpaid/spending-limits stelt u in staat een maandelijkse uitgavenlimiet in te stellen—ongecontroleerde overschrijdingen worden dan onmogelijk, ongeacht de oorzaak. En om op elk moment in de factureringscyclus te weten waar u staat, geeft GET /v1/billing/teams/{team_id}/postpaid/invoice/preview u een voorbeeld van de opgebouwde kosten vóór de definitieve factuur.
Toepassingslogs aan de clientzijde
De xAI-console ziet wat er bij xAI gebeurt; het ziet niet wat er aan uw kant gebeurt. Uw eigen toepassingslogs vormen de andere helft van de traceerbaarheid: zij zijn het die de vraag beantwoorden “welke gebruiker heeft deze oproep geactiveerd?”. Log voor elke API-oproep het tijdstip, de ID van de gebruiker die de oproep initieerde, het gebruikte model en endpoint, het aantal input- en outputtokens, de HTTP-responsstatus, de latentie en de API-sleutel-ID in gemaskeerde vorm.
De omgekeerde discipline is net zo belangrijk, want een te uitgebreid logboek wordt zelf een datalek. Log nooit de inhoud van prompts die persoonsgegevens bevatten, noch antwoorden met gevoelige informatie, noch API-sleutels in platte tekst, noch ephemere tokens. Een logbestand dat de prompts van uw gebruikers bevat, is een verkapte persoonsdatabase—met alle GDPR-verplichtingen die dat met zich meebrengt, inclusief het recht op wissing.
Vijf metrieken die monitoring leesbaar maken
Om deze les samen te vatten, brengt u uw monitoringgegevens samen in één dashboard in plaats van schermen te vermenigvuldigen. De eerste twee metrieken beschrijven normale activiteit: dagelijks verbruik per sleutel en per model, en het foutenpercentage (4xx, 5xx) per endpoint, wat zowel een implementatiefout als een sleutel met verkeerd geconfigureerde rechten onthult. De volgende twee beschrijven wrijving: geactiveerde moderatiepogingen, die u vertellen wat uw gebruikers proberen te doen, en sleutels die dicht bij vervaldatum zijn, om verlengingen te anticiperen in plaats van er onverwachts mee geconfronteerd te worden.
De vijfde metriek is degene die het verschil maakt: vergelijking met historische gemiddelden. Een ruw getal zegt niets—acht miljoen tokens gisteravond, is dat veel? Een afwijking van de norm zegt echter alles, en het is op deze afwijking dat uw waarschuwingen moeten activeren.
Belangrijkste punten
- De xAI-console (console.x.ai) centraliseert monitoring, sleutelbeheer en facturatie
- Het usage-endpoint maakt programmatische analyse mogelijk met flexibele aggregatie (SUM tot P99, van MINUTE tot MONTH)
- Configureer drempelwaarschuwingen op verbruik: een abnormale piek is het eerste teken van een compromis
- Stel uitgavenlimieten in via de Management API om elke overschrijding te beperken
- Log metadata aan de toepassingszijde, nooit gevoelige inhoud of sleutels in platte tekst