Lokitarkastelut ja valvonta konsolin kautta
Tällä sivulla
Tarkastelun merkitys säännellyssä ympäristössä
Kun SOC 2 -tilintarkastaja kysyy: “Kuka kulutti mitä, milloin, ja miten saisit siitä tiedon poikkeaman sattuessa?”, vastaus ei voi olla “selvitämme asian”. Kaikille vaatimustenmukaisuusvelvoitteiden (kuten SOC 2, HIPAA, GDPR) alaisille organisaatioille toimien jäljitettävyys on perusvaatimus, ja se valmistellaan ennen incidenttiä, ei sen jälkeen. xAI-konsoli (console.x.ai) tarjoaa valvonta- ja tarkastelutyökalut, joiden avulla voit seurata API-avaintesi käyttöä ja havaita poikkeavuuksia; tässä oppitunnissa näytetään, miten niitä käytetään ja miten niitä täydennetään sovelluspuolella.
xAI-konsoli: turvallisuutesi kojelauta
Konsoli, joka on osoitteessa console.x.ai, keskittää neljä toimintoa: API-avainten hallinnan, käytön valvonnan, laskutuksen kulurajoituksineen sekä tilitietojen turvallisuuden. Datatasolla se tarjoaa näkymän käyttöön avainkohtaisesti (pyyntöjen määrä, kulutetut tokenit), mallikohtaiseen käyttöön, yksityiskohtaiseen laskutushistoriaan kausittain sekä kunkin avaimen tilaan (aktiivinen, estetty tai poistettu käytöstä). Tee tavaksi tarkistaa se säännöllisesti: useimmat avainkompromissit havaitaan ensin käyttökäyrästä, joka ei enää muistuta edellisten viikkojen dataa.
Käyttöanalyysi API:n kautta
Konsoli riittää nopeaan silmäilyyn, mutta vakava valvonta on tehtävä ohjelmallisesti: tähän tarkoitukseen on analyysipäätepiste.
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"]
}
}
Tämä pyyntö hakee kulutettujen tokenien summan päivittäin mallikohtaisesti jaettuna maaliskuun ajalta. Joustavuus tulee yhdisteltävistä vaihtoehdoista: aika-asteikot vaihtelevat MONTH-arvosta MINUTE-arvoon sisältäen CALENDAR_WEEK, DAY, HOUR ja QUARTER_HOUR; käytettävissä olevat aggregoinnit ovat SUM, AVG, MIN, MAX, persentiilit P50, P90 ja P99 sekä COUNT ja COUNT_DISTINCT; ja voit ryhmitellä tulokset mallin, ajanjakson tai avaimen mukaan.
Nämä komponentit kattavat neljä konkreettista tarvetta. Ensinnäkin poikkeavuuksien havaitseminen: äkillinen piikki kulutuksessa avaimella, joka yleensä käsittelee vakaata määrää, on klassinen merkki kompromissista – tämä on kysely, jonka valvontaskriptisi pitäisi suorittaa joka yö. Toiseksi kustannusten optimointi: ryhmittelemällä mallin mukaan havaitset alikäytetyt päätepisteet tai tarpeettomasti kutsutut kalliit mallit. Kolmanneksi vaatimustenmukaisuusraportit: sama kysely neljännesvuositasolla tuottaa luvut, joita tilintarkastaja pyytää. Lopuksi kapasiteetin suunnittelu: kulutustrendi kertoo, milloin luottosi on ladattava uudelleen ennen kuin ne loppuvat sunnuntaina.
Hälytysjärjestelmän rakentaminen
Kojelauta, jota et katso, ei suojaa mitään; hälytykset sen sijaan tulevat luoksesi. Tässä on luonnos päivittäisestä tarkistuksesta, joka vertaa viimeisen 24 tunnin kulutusta kynnysarvoon:
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äydennä tämä asetus budjetin turvaverkolla: POST /v1/billing/teams/{team_id}/postpaid/spending-limits -päätepisteen avulla voit asettaa kuukausittaisen kulurajan – hallitsematon ylitys muuttuu tällöin mahdottomaksi syystä riippumatta. Ja jotta tiedät tilanteesi missä tahansa laskutuskierron vaiheessa, GET /v1/billing/teams/{team_id}/postpaid/invoice/preview antaa esikatselun kertyneisiin kuluihin ennen lopullista laskua.
Sovelluspuolen lokit
xAI-konsoli näkee vain sen, mitä xAI:ssa tapahtuu; se ei näe sitä, mitä omassa päässäsi tapahtuu. Omat sovelluslokisi ovat jäljitettävyyden toinen puolisko: ne vastaavat kysymykseen “mikä käyttäjä laukaisi tämän kutsun?”. Kirjaa jokaisesta API-kutsusta aikaleima, kutsun aloittaneen käyttäjän ID, käytetty malli ja päätepiste, syöte- ja tulostetokenien määrä, HTTP-vastauksen tilakoodi, viive sekä API-avaimen ID naamioidussa muodossa.
Käänteinen kurinalaisuus on yhtä tärkeää, sillä liian puhelias lokista tulee itse tietovuoto. Älä koskaan lokita henkilökohtaista dataa sisältävien kehotteiden (prompt) sisältöä, arkaluonteista tietoa sisältäviä vastauksia, API-avaimia selväkielisinä tai ephemeraaleja tokeneita. Lokitiedosto, joka sisältää käyttäjiesi kehotteita, on naamioitu henkilörekisteri – kaikkine siihen liittyvine GDPR-velvoitteineen, mukaan lukien oikeus tietojen poistamiseen.
Viisi mittaria, jotka tekevät valvonnasta luettavaa
Kootaksesi tämän oppitunnin yhteen, kerää valvontadatasi yhteen kojelautaan useiden näyttöjen sijaan. Kaksi ensimmäistä mittaria kuvaavat normaalia toimintaa: päivittäinen kulutus avainta ja mallia kohden sekä virheprosentti (4xx, 5xx) päätepistettä kohden, mikä paljastaa sekä käyttöönottovirheen että väärin määritellyt oikeudet omaavan avaimen. Seuraavat kaksi kuvaavat kitkaa: laukaistut moderointiyritykset, jotka kertovat mitä käyttäjäsi yrittävät tehdä, ja vanhenemassa olevat avaimet, jotta voit ennakoida uusimiset sen sijaan, että kohtaisit ne yllättäen.
Viides mittari on se, joka tekee eron: vertailu historiallisiin keskiarvoihin. Raaka luku ei kerro mitään – kahdeksan miljoonaa tokenia eilen illalla, onko se paljon? Poikkeama normista sen sijaan kertoo kaiken, ja juuri tähän poikkeamaan hälytystesi pitäisi laueta.
Keskeiset asiat
- xAI-konsoli (console.x.ai) keskittää valvonnan, avainten hallinnan ja laskutuksen
- usage-päätepiste mahdollistaa ohjelmallisen analyysin joustavin aggregoinnein (SUM–P99, MINUTE–MONTH)
- Määritä kynnysarvohälytykset kulutukselle: epänormaali piikki on ensimmäinen merkki kompromissista
- Aseta kulurajat Management API:n kautta rajoittaaksesi ylitykset
- Lokita metadata sovelluspuolella, ei koskaan arkaluonteista sisältöä tai avaimia selväkielisinä