Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Auditní záznamy a monitorování přes konzoli

Lekce 10 z 12 Aktualizováno 28. července 2026 Pokročilý
Na této stránce
  1. Význam auditu v regulovaném prostředí
  2. Konzole xAI: váš bezpečnostní panel
  3. Analýza využití přes API
  4. Budování systému alertů
  5. Aplikační záznamy na straně klienta
  6. Pět metrik, které činí monitorování čitelným
  7. Klíčové poznatky

Význam auditu v regulovaném prostředí

Když se auditor SOC 2 zeptá: „Kdo co spotřeboval, kdy a jak byste to v případě anomálie zjistili?“, odpověď nemůže znít: „Podívali bychom se na to.“ Pro jakoukoli organizaci podléhající povinnostem shody – SOC 2, HIPAA, GDPR – je sledovatelnost akcí základním požadavkem, který připravujete před incidentem, nikoliv až po něm. Konzole xAI (console.x.ai) poskytuje nástroje pro monitorování a audit, které vám umožňují sledovat využití vašich API klíčů a odhalovat anomálie; tato lekce vám ukáže, jak je používat a jak je doplnit na straně aplikace.

Konzole xAI: váš bezpečnostní panel

Konzole, přístupná na adrese console.x.ai, centralizuje čtyři funkce: správu API klíčů, monitorování využití, fakturaci s limity útrat a informace o zabezpečení účtu. Z hlediska dat vám poskytuje využití na klíč (počet požadavků, spotřebované tokeny), využití na model, podrobnou historii fakturace za období a stav každého klíče – aktivní, zablokovaný nebo deaktivovaný. Zvykněte si ji pravidelně kontrolovat: většina kompromitací klíčů se odhalí jako první díky křivce využití, která již nepřipomíná předchozí týdny.

Analýza využití přes API

Konzole stačí pro rychlý pohled, ale seriózní monitorování musí být programové: to je role koncového bodu pro 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"]
  }
}

Tento požadavek žádá o součet spotřebovaných tokenů den po dni, rozdělený podle modelu, za měsíc březen. Flexibilita plyne z kombinovatelných možností: časové jednotky sahají od MONTH po MINUTE, včetně CALENDAR_WEEK, DAY, HOUR a QUARTER_HOUR; dostupné agregace jsou SUM, AVG, MIN, MAX, percentily P50, P90 a P99, stejně jako COUNT a COUNT_DISTINCT; a můžete seskupovat podle modelu, období nebo klíče.

Tyto komponenty pokrývají čtyři konkrétní potřeby. Zaprvé, detekce anomálií: náhlý nárůst spotřeby na klíči, který obvykle zpracovává stabilní objem, je klasickým příznakem kompromitace – toto je dotaz, který by měl váš monitorovací skript spouštět každou noc. Zadruhé, optimalizace nákladů: seskupením podle modelu odhalíte nedostatečně využívané koncové body nebo drahé modely volané zbytečně. Zatřetí, zprávy o shodě: stejný dotaz za čtvrtletí vytvoří čísla, která bude auditor požadovat. A konečně, plánování kapacity: trend spotřeby vám řekne, kdy dobít kredity, aby vám v neděli nedošly.

Budování systému alertů

Panel, na který se nepodíváte, nic nechrání; alerty však přijdou za vámi. Zde je kostra denní kontroly, která porovnává posledních 24 hodin spotřeby 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 nastavení rozpočtovou bezpečnostní sítí: koncový bod POST /v1/billing/teams/{team_id}/postpaid/spending-limits vám umožňuje nastavit měsíční limit útrat – nekontrolované překročení rozpočtu se pak stane nemožným, bez ohledu na příčinu. A abyste věděli, kde stojíte v kterémkoli bodě fakturačního cyklu, GET /v1/billing/teams/{team_id}/postpaid/invoice/preview vám poskytne náhled na nahromaděné poplatky před vystavením konečné faktury.

Aplikační záznamy na straně klienta

Konzole xAI vidí, co se děje u xAI; nevidí, co se děje u vás. Vlastní záznamy vaší aplikace jsou druhou polovinou sledovatelnosti: právě ony odpoví na otázku „který uživatel spustil toto volání?“. Pro každé volání API zaznamenejte časové razítko, ID uživatele, který volání inicioval, použitý model a koncový bod, počet vstupních a výstupních tokenů, stavovou odpověď HTTP, latenci a ID API klíče v maskované verzi.

Opačná disciplína je stejně důležitá, protože upovídaný záznam se sám stává únikem dat. Nikdy nezaznamenávejte obsah promptů obsahujících osobní údaje, ani odpovědi obsahující citlivé informace, ani API klíče v prostém textu, ani efemérní tokeny. Soubor záznamů obsahující prompty vašich uživatelů je zamaskovanou osobní databází – se všemi povinnostmi GDPR, které to obnáší, včetně práva na výmaz.

Pět metrik, které činí monitorování čitelným

Pro upevnění této lekce shromážděte svá monitorovací data na jediném panelu, místo abyste násobili obrazovky. První dvě metriky popisují běžnou aktivitu: denní spotřeba na klíč a model a míra chyb (4xx, 5xx) na koncový bod, což odhaluje jak chybu v nasazení, tak klíč se špatně nastavenými oprávněními. Další dvě popisují tření: spuštěné pokusy o moderaci, které vám řeknou, co se vaši uživatelé snaží dělat, a klíče blížící se vypršení platnosti, abyste obnovy předvídali, místo abyste je řešili nečekaně.

Pátá metrika je ta, která dělá rozdíl: srovnání s historickými průměry. Surové číslo nic neříká – osm milionů tokenů minule v noci, je to hodně? Odchylka od normy však říká vše a právě na tuto odchylku by měla vaše alerta reagovat.

Klíčové poznatky

  • Konzole xAI (console.x.ai) centralizuje monitorování, správu klíčů a fakturaci
  • Koncový bod usage umožňuje programovou analýzu s flexibilní agregací (od SUM po P99, od MINUTE po MONTH)
  • Nakonfigurujte alerty s prahovými hodnotami na spotřebu: abnormální nárůst je prvním znakem kompromitace
  • Nastavte limity útrat přes Management API pro omezení jakéhokoli překročení
  • Na straně aplikace zaznamenávejte pouze metadata, nikdy citlivý obsah nebo klíče v prostém textu