Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Auditné záznamy a monitorovanie cez konzolu

Lekcia 10 z 12 Aktualizované 28. júla 2026 Pokročilý
Na tejto strane
  1. Dôležitosť auditu v regulovanom prostredí
  2. Konzola xAI: váš bezpečnostný panel
  3. Analýza využitia cez API
  4. Budovanie systému alertov
  5. Aplikačné záznamy na strane klienta
  6. Päť metrík, ktoré robia monitorovanie čitateľným
  7. Kľúčové poznatky

Dôležitosť auditu v regulovanom prostredí

Keď sa audítor SOC 2 opýta: „Kto čo spotreboval, kedy a ako by ste to zistili v prípade anomálie?“, odpoveď nemôže znieť: „Pozrieme sa na to.“ Pre každú organizáciu podliehajúcu povinnostiam zhody – SOC 2, HIPAA, GDPR – je sledovateľnosť akcií základnou požiadavkou, ktorú pripravujete pred incidentom, nie až po ňom. Konzola xAI (console.x.ai) poskytuje nástroje na monitorovanie a audit, ktoré vám umožňujú sledovať využívanie vášho API kľúča a odhaľovať anomálie; táto lekcia vám ukáže, ako ich používať a následne ako ich doplniť na strane aplikácie.

Konzola xAI: váš bezpečnostný panel

Konzola, dostupná na adrese console.x.ai, centralizuje štyri funkcie: správu API kľúčov, monitorovanie využitia, fakturáciu s limitmi míňania a informácie o bezpečnosti účtu. Z hľadiska údajov vám poskytuje využitie na kľúč (počet požiadaviek, spotrebované tokeny), využitie na model, podrobnú históriu fakturácie podľa obdobia a stav každého kľúča – aktívny, blokovaný alebo deaktivovaný. Urobte si zvyk pravidelne ju kontrolovať: väčšina kompromitácií kľúčov sa odhalí najprv podľa krivky využitia, ktorá už nezodpovedá predchádzajúcim týždňom.

Analýza využitia cez API

Konzola stačí na rýchly pohľad, ale seriózne monitorovanie musí byť programové: tu prichádza na rad koncový bod pre analýzu.

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áto požiadavka žiada o súčet spotrebovaných tokenov deň po dni, rozdelený podľa modelu, za mesiac marec. Flexibilita vyplýva z kombinovateľných možností: časové jednotky siahajú od MONTH po MINUTE, vrátane CALENDAR_WEEK, DAY, HOUR a QUARTER_HOUR; dostupné agregácie sú SUM, AVG, MIN, MAX, percentily P50, P90 a P99, ako aj COUNT a COUNT_DISTINCT; a môžete zoskupovať podľa modelu, obdobia alebo kľúča.

Tieto komponenty pokrývajú štyri konkrétne potreby. Po prvé, detekcia anomálií: náhly nárast spotreby na kľúči, ktorý zvyčajne spracováva stabilný objem, je klasickým príznakom kompromitácie – toto je dopyt, ktorý by mal váš monitorovací skript spúšťať každú noc. Ďalej, optimalizácia nákladov: zoskupením podľa modelu odhalíte nedostatočne využívané koncové body alebo drahé modely volané zbytočne. Správy o zhode: rovnaký dopyt za štvrťrok vyprodukuje čísla, ktoré bude audítor požadovať. Nakoniec, plánovanie kapacity: trend spotreby vám povie, kedy musíte dobiť kredity, aby ste nedeľu nestrávili bez nich.

Budovanie systému alertov

Panel, na ktorý sa nepozriete, nič neochráni; alerty však prídu za vami. Tu je kostra dennej kontroly, ktorá porovnáva spotrebu za posledných 24 hodín s prahovou hodnotou:

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

Doplňte toto nastavenie o rozpočtovú bezpečnostnú sieť: koncový bod POST /v1/billing/teams/{team_id}/postpaid/spending-limits vám umožňuje nastaviť mesačný limit míňania – nekontrolované prekročenie rozpočtu sa potom stane nemožným, bez ohľadu na príčinu. A aby ste vedeli, kde stojíte v ktoromkoľvek bode fakturačného cyklu, GET /v1/billing/teams/{team_id}/postpaid/invoice/preview vám poskytne náhľad na akumulované poplatky pred vystavením konečnej faktúry.

Aplikačné záznamy na strane klienta

Konzola xAI vidí to, čo sa deje u xAI; nevidí to, čo sa deje u vás. Vlastné záznamy vašej aplikácie sú druhou polovicou sledovateľnosti: práve ony odpovedajú na otázku „ktorý používateľ spustil toto volanie?“. Pre každé volanie API zaznamenajte časovú pečiatku, ID používateľa, ktorý volanie inicioval, použitý model a koncový bod, počet vstupných a výstupných tokenov, stav odpovede HTTP, latenciu a ID API kľúča v maskovanej verzii.

Opačná disciplína je rovnako dôležitá, pretože ukecaný záznam sa sám stáva únikom údajov. Nikdy nezaznamenávajte obsah promptov obsahujúcich osobné údaje, ani odpovede obsahujúce citlivé informácie, ani API kľúče v plain texte, ani ephemeral tokeny. Súbor záznamov obsahujúci prompty vašich používateľov je zamaskovanou osobnou databázou – so všetkými povinnosťami GDPR, ktoré to so sebou nesie, vrátane práva na vymazanie.

Päť metrík, ktoré robia monitorovanie čitateľným

Na upevnenie tejto lekcie zhromaždite svoje monitorovacie údaje na jednom dashboarde namiesto násobenia obrazoviek. Prvé dve metriky opisujú bežnú aktivitu: denná spotreba na kľúč a na model a miera chýb (4xx, 5xx) na koncový bod, čo odhaľuje chybu v nasadení aj kľúč s nesprávne nakonfigurovanými oprávneniami. Ďalšie dve opisujú trenie: spustené pokusy o moderovanie, ktoré vám povedia, čo sa vaši používatelia snažia robiť, a kľúče blízko expirácie, aby ste obnovy predvídali, namiesto toho, aby vás zastihli nepripravených.

Piata metrika je tá, ktorá robí rozdiel: porovnanie s historickými priemermi. Surové číslo nič nehovorí – osem miliónov tokenov minulej noci, je to veľa? Odchýlka od normy však hovorí všetko a práve na túto odchýlku by mali vaše alerty reagovať.

Kľúčové poznatky

  • Konzola xAI (console.x.ai) centralizuje monitorovanie, správu kľúčov a fakturáciu
  • Koncový bod usage umožňuje programovú analýzu s flexibilnou agregáciou (od SUM po P99, od MINUTE po MONTH)
  • Nakonfigurujte alerty s prahovými hodnotami na spotrebu: abnormálny nárast je prvým znakom kompromitácie
  • Nastavte limity míňania cez Management API na obmedzenie akéhokoľvek prekročenia
  • Na strane aplikácie zaznamenávajte iba metadáta, nikdy nie citlivý obsah alebo kľúče v plain texte