Καταγραφές ελέγχου και παρακολούθηση μέσω της κονσόλας
Σε αυτήν τη σελίδα
Η σημασία του ελέγχου σε ένα ρυθμιζόμενο περιβάλλον
Όταν ένας ελεγκτής SOC 2 ρωτάει: «Ποιος κατανάλωσε τι, πότε και πώς θα το γνωρίζατε σε περίπτωση ανωμαλίας;», η απάντηση δεν μπορεί να είναι «θα το εξετάζαμε». Για κάθε οργανισμό που υπόκειται σε υποχρεώσεις συμμόρφωσης—SOC 2, HIPAA, GDPR—η ιχνηλασιμότητα των ενεργειών αποτελεί θεμελιώδη απαίτηση, και την προετοιμάζετε πριν από το περιστατικό, όχι μετά. Η κονσόλα xAI (console.x.ai) παρέχει τα εργαλεία παρακολούθησης και ελέγχου που σας επιτρέπουν να παρακολουθείτε τη χρήση των κλειδιών API σας και να εντοπίζετε ανωμαλίες· αυτό το μάθημα σας δείχνει πώς να τα χρησιμοποιήσετε και στη συνέχεια πώς να τα συμπληρώσετε από την πλευρά της εφαρμογής.
Η κονσόλα xAI: ο πίνακας ελέγχου ασφαλείας σας
Η κονσόλα, προσβάσιμη στη διεύθυνση console.x.ai, συγκεντρώνει τέσσερις λειτουργίες: διαχείριση κλειδιών API, παρακολούθηση χρήσης, χρέωση με όρια δαπανών και πληροφορίες ασφαλείας λογαριασμού. Όσον αφορά τα δεδομένα, σας παρέχει χρήση ανά κλειδί (αριθμός αιτημάτων, tokens που καταναλώθηκαν), χρήση ανά μοντέλο, αναλυτικό ιστορικό χρέωσης ανά περίοδο και την κατάσταση κάθε κλειδιού—ενεργό, αποκλεισμένο ή απενεργοποιημένο. Κάντε συνήθεια να την ελέγχετε τακτικά: οι περισσότερες παραβιάσεις κλειδιών εντοπίζονται αρχικά από μια καμπύλη χρήσης που δεν μοιάζει με εκείνη των προηγούμενων εβδομάδων.
Ανάλυση χρήσης μέσω του API
Η κονσόλα αρκεί για μια γρήγορη ματιά, αλλά η σοβαρή παρακολούθηση πρέπει να είναι προγραμματιστική: αυτός είναι ο ρόλος του τελικού σημείου ανάλυσης.
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"]
}
}
Αυτό το αίτημα ζητά το άθροισμα των tokens που καταναλώθηκαν, ημέρα με την ημέρα, ανά μοντέλο, για τον μήνα Μάρτιο. Η ευελιξία προέρχεται από τις συνδυάσιμες επιλογές: οι χρονικές μονάδες κυμαίνονται από MONTH έως MINUTE, συμπεριλαμβανομένων των CALENDAR_WEEK, DAY, HOUR και QUARTER_HOUR· οι διαθέσιμες συσσωρεύσεις είναι SUM, AVG, MIN, MAX, εκατοστημόρια P50, P90 και P99, καθώς και COUNT και COUNT_DISTINCT· και μπορείτε να ομαδοποιήσετε ανά μοντέλο, περίοδο ή κλειδί.
Αυτά τα στοιχεία καλύπτουν τέσσερις συγκεκριμένες ανάγκες. Πρώτον, εντοπισμός ανωμαλιών: μια ξαφνική αύξηση στην κατανάλωση σε ένα κλειδί που συνήθως διαχειρίζεται σταθερό όγκο είναι το κλασικό σύμπτωμα παραβίασης—αυτό είναι το ερώτημα που πρέπει να εκτελεί το σενάριο παρακολούθησής σας κάθε βράδυ. Στη συνέχεια, βελτιστοποίηση κόστους: ομαδοποιώντας ανά μοντέλο, εντοπίζετε υποχρησιμοποιημένα τελικά σημεία ή ακριβά μοντέλα που καλούνται αδικαιολόγητα. Αναφορές συμμόρφωσης: το ίδιο ερώτημα, σε διάστημα τριμήνου, παράγει τα στοιχεία που θα ζητήσει ο ελεγκτής. Τέλος, σχεδιασμός χωρητικότητας: η τάση κατανάλωσης σας λέει πότε να ανανεώσετε τις πιστώσεις σας πριν εξαντληθούν μια Κυριακή.
Δημιουργία ενός συστήματος ειδοποιήσεων
Ένας πίνακας ελέγχου που δεν κοιτάτε δεν προστατεύει τίποτα· οι ειδοποιήσεις, ωστόσο, έρχονται σε εσάς. Ορίστε η δομή ενός ημερήσιου ελέγχου που συγκρίνει την κατανάλωση των τελευταίων 24 ωρών με ένα όριο:
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")
Συμπληρώστε αυτή τη ρύθμιση με ένα δημοσιονομικό δίχτυ ασφαλείας: το τελικό σημείο POST /v1/billing/teams/{team_id}/postpaid/spending-limits σας επιτρέπει να ορίσετε ένα μηνιαίο όριο δαπανών—η ανεξέλεγκτη υπερβολική δαπάνη καθίσταται τότε αδύνατη, ανεξάρτητα από την αιτία. Και για να γνωρίζετε πού βρίσκεστε σε οποιοδήποτε σημείο του κύκλου χρέωσης, το GET /v1/billing/teams/{team_id}/postpaid/invoice/preview σας παρέχει μια προεπισκόπηση των συσσωρευμένων χρεώσεων πριν από το τελικό τιμολόγιο.
Καταγραφές εφαρμογής στην πλευρά του πελάτη
Η κονσόλα xAI βλέπει τι συμβαίνει στην xAI· δεν βλέπει τι συμβαίνει στη δική σας πλευρά. Οι δικές σας καταγραφές εφαρμογής αποτελούν το άλλο μισό της ιχνηλασιμότητας: αυτές είναι που θα απαντήσουν στην ερώτηση «ποιος χρήστης προκάλεσε αυτή την κλήση;». Για κάθε κλήση API, καταγράψτε τη χρονική σήμανση, το ID του χρήστη που ξεκίνησε την κλήση, το μοντέλο και το τελικό σημείο που χρησιμοποιήθηκαν, τον αριθμό των tokens εισόδου και εξόδου, την κατάσταση απόκρισης HTTP, την καθυστέρηση και το ID του κλειδιού API σε συγκαλυμμένη μορφή.
Η αντίστροφη πειθαρχία είναι εξίσου σημαντική, διότι μια verbose καταγραφή γίνεται η ίδια διαρροή δεδομένων. Μην καταγράφετε ποτέ το περιεχόμενο prompts που περιέχουν προσωπικά δεδομένα, ούτε απαντήσεις που περιέχουν ευαίσθητες πληροφορίες, ούτε κλειδιά API σε απλό κείμενο, ούτε εφήμερα tokens. Ένα αρχείο καταγραφής που περιέχει τα prompts των χρηστών σας είναι μια προσωπική βάση δεδομένων μεταμφιεσμένη—με όλες τις υποχρεώσεις GDPR που αυτό συνεπάγεται, συμπεριλαμβανομένου του δικαιώματος διαγραφής.
Πέντε μετρικές που καθιστούν την παρακολούθηση κατανοητή
Για να εδραιώσετε αυτό το μάθημα, συγκεντρώστε τα δεδομένα παρακολούθησής σας σε έναν ενιαίο πίνακα ελέγχου αντί να πολλαπλασιάζετε τις οθόνες. Οι δύο πρώτες μετρικές περιγράφουν την κανονική δραστηριότητα: ημερήσια κατανάλωση ανά κλειδί και ανά μοντέλο, και ο ρυθμός σφαλμάτων (4xx, 5xx) ανά τελικό σημείο, ο οποίος αποκαλύπτει τόσο ένα σφάλμα ανάπτυξης όσο και ένα κλειδί με εσφαλμένες ρυθμίσεις δικαιωμάτων. Οι επόμενες δύο περιγράφουν την τριβή: προσπάθειες διαμεσολάβησης που ενεργοποιήθηκαν, οι οποίες σας λένε τι προσπαθούν να κάνουν οι χρήστες σας, και κλειδιά κοντά στη λήξη τους, για να προβλέψετε τις ανανεώσεις αντί να τις αντιμετωπίσετε απροειδοποίητα.
Η πέμπτη μετρική είναι αυτή που κάνει τη διαφορά: η σύγκριση με τους ιστορικούς μέσους όρους. Ένας ακατέργαστος αριθμός δεν λέει τίποτα—οκτώ εκατομμύρια tokens χθες το βράδυ, είναι πολλά; Μια απόκλιση από τον κανόνα, ωστόσο, τα λέει όλα, και είναι σε αυτή την απόκλιση που πρέπει να ενεργοποιούνται οι ειδοποιήσεις σας.
Βασικά σημεία
- Η κονσόλα xAI (console.x.ai) συγκεντρώνει την παρακολούθηση, τη διαχείριση κλειδιών και τη χρέωση
- Το τελικό σημείο usage επιτρέπει προγραμματιστική ανάλυση με ευέλικτη συσσώρευση (από SUM έως P99, από MINUTE έως MONTH)
- Ρυθμίστε ειδοποιήσεις ορίου στην κατανάλωση: μια ανώμαλη αύξηση είναι το πρώτο σημάδι παραβίασης
- Ορίστε όρια δαπανών μέσω του Management API για να περιορίσετε οποιαδήποτε υπέρβαση
- Καταγράψτε μεταδεδομένα στην πλευρά της εφαρμογής, ποτέ ευαίσθητο περιεχόμενο ή κλειδιά σε απλό κείμενο