Registros de auditoría y supervisión desde la consola
En esta página
La importancia de la auditoría en un entorno regulado
Cuando un auditor de SOC 2 pregunta: «¿Quién consumió qué, cuándo y cómo lo sabríais en caso de anomalía?», la respuesta no puede ser «lo investigaríamos». Para cualquier organización sujeta a obligaciones de cumplimiento —SOC 2, HIPAA, GDPR—, la trazabilidad de las acciones es un requisito fundamental que debes preparar antes del incidente, no después. La consola de xAI (console.x.ai) proporciona las herramientas de supervisión y auditoría que te permiten rastrear el uso de tus claves de API y detectar anomalías; esta lección te muestra cómo utilizarlas y, a continuación, cómo complementarlas desde el lado de la aplicación.
La consola de xAI: tu panel de seguridad
La consola, accesible en console.x.ai, centraliza cuatro funciones: gestión de claves de API, supervisión del uso, facturación con límites de gasto e información de seguridad de la cuenta. En cuanto a los datos, te ofrece el uso por clave (número de solicitudes, tokens consumidos), el uso por modelo, un historial de facturación detallado por periodo y el estado de cada clave: activa, bloqueada o deshabilitada. Acostúmbrate a revisarla con regularidad: la mayoría de las compromisiones de claves se detectan primero por una curva de uso que ya no se parece a la de las semanas anteriores.
Análisis del uso mediante la API
La consola basta para una visión rápida, pero una supervisión seria debe ser programática: ese es el papel del extremo de análisis.
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"]
}
}
Esta solicitud pide la suma de tokens consumidos, día a día, desglosada por modelo, para el mes de marzo. La flexibilidad proviene de opciones combinables: las unidades de tiempo van desde MONTH hasta MINUTE, incluyendo CALENDAR_WEEK, DAY, HOUR y QUARTER_HOUR; las agregaciones disponibles son SUM, AVG, MIN, MAX, los percentiles P50, P90 y P99, así como COUNT y COUNT_DISTINCT; y puedes agrupar por modelo, periodo o clave.
Estos componentes cubren cuatro necesidades concretas. Primero, la detección de anomalías: un pico repentino en el consumo de una clave que suele manejar un volumen estable es el síntoma clásico de una compromiso; esta es la consulta que tu script de supervisión debería ejecutar cada noche. A continuación, la optimización de costes: al agrupar por modelo, detectas extremos infrautilizados o modelos caros llamados innecesariamente. Informes de cumplimiento: la misma consulta, durante un trimestre, produce las cifras que te pedirá el auditor. Por último, la planificación de capacidad: la tendencia de consumo te indica cuándo recargar tus créditos antes de quedarte sin ellos un domingo.
Construcción de un sistema de alertas
Un panel que no consultas no protege nada; las alertas, en cambio, vienen a ti. Aquí tienes el esqueleto de una comprobación diaria que compara el consumo de las últimas 24 horas con un umbral:
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"Uso anómalo: {total_tokens} tokens en 24 h")
Completa esta configuración con una red de seguridad presupuestaria: el extremo POST /v1/billing/teams/{team_id}/postpaid/spending-limits te permite establecer un límite de gasto mensual; así, el gasto excesivo descontrolado se vuelve imposible, sea cual sea la causa. Y para saber dónde estás en cualquier punto del ciclo de facturación, GET /v1/billing/teams/{team_id}/postpaid/invoice/preview te ofrece una vista previa de los cargos acumulados antes de la factura final.
Registros de la aplicación del lado del cliente
La consola de xAI ve lo que ocurre en xAI; no ve lo que ocurre en tu lado. Los registros de tu propia aplicación son la otra mitad de la trazabilidad: son los que responderán a la pregunta «¿qué usuario desencadenó esta llamada?». Para cada llamada a la API, registra la marca de tiempo, el ID del usuario que inició la llamada, el modelo y el extremo utilizados, el número de tokens de entrada y salida, el estado de la respuesta HTTP, la latencia y el ID de la clave de API en versión enmascarada.
La disciplina inversa es igual de importante, porque un registro verboso se convierte en sí mismo en una fuga de datos. Nunca registres el contenido de prompts que contengan datos personales, ni respuestas con información sensible, ni claves de API en texto plano, ni tokens efímeros. Un archivo de registro que contenga los prompts de tus usuarios es una base de datos personal disfrazada, con todas las obligaciones del GDPR que ello implica, incluido el derecho al suprimir los datos.
Cinco métricas que hacen legible la supervisión
Para consolidar esta lección, reúne tus datos de supervisión en un único panel en lugar de multiplicar las pantallas. Las dos primeras métricas describen la actividad normal: consumo diario por clave y por modelo, y la tasa de errores (4xx, 5xx) por extremo, lo que revela tanto un error de despliegue como una clave con permisos mal configurados. Las dos siguientes describen la fricción: intentos de moderación activados, que te indican qué están intentando hacer tus usuarios, y claves próximas a caducar, para anticipar renovaciones en lugar de enfrentarlas de forma inesperada.
La quinta métrica es la que marca la diferencia: la comparación con las medias históricas. Un número bruto no dice nada: ¿ocho millones de tokens anoche es mucho? Una desviación de la norma, sin embargo, lo dice todo, y es en esa desviación donde deben activarse tus alertas.
Puntos clave
- La consola de xAI (console.x.ai) centraliza la supervisión, la gestión de claves y la facturación
- El extremo usage permite el análisis programático con agregación flexible (de SUM a P99, de MINUTE a MONTH)
- Configura alertas de umbral sobre el consumo: un pico anómalo es el primer signo de compromiso
- Establece límites de gasto mediante la Management API para topar cualquier exceso
- Registra metadatos en el lado de la aplicación, nunca contenido sensible ni claves en texto plano