Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Žurnalų auditas ir stebėsena per konsolę

Paskaita 10 iš 12 Atnaujinta 2026 m. liepos 28 d. Pažengusiems
Šiame puslapyje
  1. Audito svarba reguliuojamoje aplinkoje
  2. xAI konsolė: tavo saugumo skydelis
  3. Naudojimo analizė per API
  4. Įspėjimų sistemos kūrimas
  5. Programos žurnalai kliento pusėje
  6. Penki rodikliai, darantys stebėseną suprantamą
  7. Svarbiausi punktai

Audito svarba reguliuojamoje aplinkoje

Kai SOC 2 auditorius klausia: „Kas, kada ir kaip sunaudojo duomenis, ir kaip tai sužinotumėte kilus anomalijai?“, atsakymas negali būti „pažiūrėsime“. Bet kuriai organizacijai, privalančiai laikytis atitikties reikalavimų – SOC 2, HIPAA, GDPR – veiksmų atsekamumas yra esminis reikalavimas, kurį turi parengti prieš incidentą, o ne po jo. xAI konsolė (console.x.ai) suteikia stebėsenos ir audito įrankius, leidžiančius sekti jūsų API rakto naudojimą ir aptikti anomalijas; šioje pamokoje sužinosi, kaip jais naudotis, o tada – kaip juos papildyti programos lygmenyje.

xAI konsolė: tavo saugumo skydelis

Konsolė, pasiekiama adresu console.x.ai, sujungia keturias funkcijas: API raktų valdymą, naudojimo stebėseną, sąskaitų faktūrų valdymą su išlaidų limitais ir paskyros saugumo informaciją. Duomenų požiūriu ji pateikia naudojimą pagal raktą (užklausų skaičius, sunaudoti tokenai), naudojimą pagal modelį, išsamią sąskaitų faktūrų istoriją pagal laikotarpius ir kiekvieno rakto būseną – aktyvus, užblokuotas arba išjungtas. Įprask ją reguliariai tikrinti: dauguma raktų kompromisų pirmiausia pastebimi pagal naudojimo kreivę, kuri nebeatitinka ankstesnių savaičių rodiklių.

Naudojimo analizė per API

Konsolė pakanka greitai peržiūrai, tačiau rimta stebėsena turi būti programuojama: tam skirtas analizės galinis taškas.

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"]
  }
}

Šis užklausimas prašo pateikti sunaudotų tokenų sumą dieną pagal dieną, suskirstytą pagal modelį, kovo mėnesiui. Lankstumą suteikia derinamos parinktys: laiko vienetai svyruoja nuo MONTH iki MINUTE, įskaitant CALENDAR_WEEK, DAY, HOUR ir QUARTER_HOUR; galimos agregacijos yra SUM, AVG, MIN, MAX, procentilės P50, P90 ir P99, taip pat COUNT ir COUNT_DISTINCT; gali grupuoti pagal modelį, laikotarpį arba raktą.

Šie komponentai patenkina keturis konkrečius poreikius. Pirma, anomalijų aptikimas: staigus suvartojimo šuolis rakto, kuris paprastai apdoroja stabilų kiekį, atveju yra klasikinis kompromiso simptomas – tai užklausa, kurią tavo stebėsenos scenarijus turėtų vykdyti kiekvieną naktį. Antra, išlaidų optimizavimas: sugrupavus pagal modelį, pastebėsi nepakankamai naudojamus galinius taškus arba brangius modelius, kviečiamus be reikalo. Atitikties ataskaitos: ta pati užklausa, atlikta per ketvirtį, pateiks skaičius, kurių prašys auditorius. Galiausiai, pajėgumų planavimas: vartojimo tendencija parodo, kada papildyti kreditus, kad jų nepristigtum sekmadienį.

Įspėjimų sistemos kūrimas

Skydelis, į kurį nežiūri, nieko neapsaugo; tačiau įspėjimai ateina pas tave. Štai kasdienio tikrinimo, lyginančio paskutinių 24 valandų vartojimą su slenksčiu, struktūra:

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")

Papildyk šią sąranką biudžetiniu saugos tinklu: galinis taškas POST /v1/billing/teams/{team_id}/postpaid/spending-limits leidžia nustatyti mėnesio išlaidų limitą – tada nekontroliuojamas išlaidų viršijimas tampa neįmanomas, nepaisant priežasties. O norint bet kuriuo atsiskaitymo ciklo momentu žinoti savo padėtį, GET /v1/billing/teams/{team_id}/postpaid/invoice/preview pateikia sukauptų mokesčių peržiūrą prieš išrašant galutinę sąskaitą faktūrą.

Programos žurnalai kliento pusėje

xAI konsolė mato, kas vyksta ties xAI; ji nemato, kas vyksta tavo pusėje. Tavo pačios programos žurnalai yra kita atsekamumo dalis: būtent jie atsakys į klausimą „kuris vartotojas inicijavo šį kvietimą?“. Kiekvienam API kvietimui įrašyk laiko žymą, kvietimą inicijavusio vartotojo ID, naudotą modelį ir galinį tašką, įvesties ir išvesties tokenų skaičių, HTTP atsako būseną, delsą ir API rakto ID užmaskuota versija.

Atvirkštinė disciplina yra vienodai svarbi, nes išsamūs žurnalai patys tampa duomenų nutekėjimu. Niekada nerašyk į žurnalą promptų, kuriuose yra asmens duomenų, turinio, atsakymų, kuriuose yra konfidencialios informacijos, API raktų grynuoju tekstu ar laikinųjų tokenų. Žurnalo failas, kuriame yra tavo vartotojų promptai, yra užmaskuota asmeninė duomenų bazė – su visomis GDPR pareigomis, kurias tai reiškia, įskaitant teisę būti pamirštam.

Penki rodikliai, darantys stebėseną suprantamą

Norint įtvirtinti šią pamoką, surink stebėsenos duomenis į vieną skydelį, o ne daugink ekranus. Pirmieji du rodikliai apibūdina normalią veiklą: dienos suvartojimas pagal raktą ir modelį bei klaidų rodiklis (4xx, 5xx) pagal galinį tašką, kuris atskleidžia tiek diegimo klaidą, tiek raktą su neteisingai sukonfigūruotais leidimais. Kiti du apibūdina trintį: suaktyvintus moderavimo bandymus, kurie parodo, ką bando daryti tavo vartotojai, ir raktus, kurių galiojimas baigiasi, kad galėtum numatyti jų atnaujinimą, o ne susidurti su juo netikėtai.

Penktasis rodiklis yra tas, kuris lemia skirtumą: palyginimas su istoriniais vidurkiais. Neapdorotas skaičius nieko nesako – aštuoni milijonai tokenų praėjusią naktį, ar tai daug? Tačiau nukrypimas nuo normos pasako viską, ir būtent dėl šio nukrypimo turi suveikti tavo įspėjimai.

Svarbiausi punktai

  • xAI konsolė (console.x.ai) centralizuoja stebėseną, raktų valdymą ir sąskaitų faktūrų tvarkymą
  • Galinis taškas usage leidžia programiškai analizuoti duomenis su lanksčia agregacija (nuo SUM iki P99, nuo MINUTE iki MONTH)
  • Konfigūruok slenkstinio lygio įspėjimus dėl suvartojimo: nenormalus šuolis yra pirmasis kompromiso požymis
  • Nustatyk išlaidų limitus per Management API, kad apribotum bet kokį viršijimą
  • Programos lygmenyje įrašyk tik metaduomenis, niekada – jautrų turinį arba raktus grynuoju tekstu