Dónde Encontrar los Logs
Navega a la pestaña Herramientas de Desarrollo en tu Plataforma de Anuncios de Topsort para acceder a los logs en tiempo real de tu clave API.Disponibilidad de Logs
| Entorno | Qué se Registra | Retención |
|---|---|---|
| Staging | Todas las solicitudes y respuestas de la API | 30 días |
| Producción | Solo errores y solicitudes fallidas | 30 días |
A medida que aumenta el uso de tu API en producción, las solicitudes exitosas pueden filtrarse de los logs para mejorar el rendimiento. Los errores y la información de depuración siempre estarán disponibles.
Comprender las Entradas de Log
Solicitudes Exitosas
- Estado: Códigos de estado HTTP 200/201/204
- Marca de tiempo: Cuándo se realizó la solicitud
- Endpoint: Qué endpoint de la API fue llamado
- Tiempo de respuesta: Cuánto tiempo tomó la solicitud
- Tamaño de solicitud: Tamaño de los datos de solicitud/respuesta
Entradas de Error
- Estado: Código de error HTTP (400, 401, 403, etc.)
- Detalles del error: Código de error específico y mensaje
- Cuerpo de la solicitud: Qué datos fueron enviados (para depuración)
- Stack trace: Detalles internos del error (cuando estén disponibles)
Patrones Comunes de Log
Problemas de Autenticación
Authorization: Bearer TU_CLAVE_API
Errores de Validación
Limitación de Tasa
Usar Logs para Depuración
1. Eventos que No Aparecen en el Panel
Busca:- Estado 200 en llamadas a
/events - Errores de validación en el payload del evento
- Problemas de marca de tiempo (
occurredAten el futuro o demasiado antiguo)
2. Resultados de Subasta Vacíos
Verifica:- Estado del presupuesto de la campaña
- Disponibilidad del producto en el catálogo
- Formato de la solicitud de subasta
3. Problemas de Atribución
Revisa los logs de eventos para:- Uso consistente del ID de usuario
resolvedBidIdapropiado de las subastas- Tiempo de los eventos de clic/compra
Mejores Prácticas
Monitoreo de Logs
- Revisa los logs después de implementar nuevo código de integración
- Monitorea las tasas de error durante períodos de alto tráfico
- Configura alertas para patrones de error recurrentes
Flujo de Trabajo de Resolución de Problemas
- Reproduce el problema en el entorno de staging
- Revisa los logs recientes en busca de patrones de error
- Verifica el formato de la solicitud contra la documentación de la API
- Prueba con un payload mínimo para aislar el problema
- Contacta al soporte con marcas de tiempo de log para problemas complejos
Privacidad y Manejo de Datos
- Los logs pueden contener datos sensibles de tus solicitudes
- Los logs de producción expiran automáticamente después de 30 días
- El acceso a los logs está restringido solo a usuarios administradores
- Los datos personales en los logs siguen políticas estándar de retención de datos
¿Necesitas Ayuda?
Si estás viendo errores persistentes en tus logs:- Anota la marca de tiempo de las solicitudes problemáticas
- Copia el mensaje de error exacto y los detalles de la solicitud
- Contacta al soporte con esta información para una resolución más rápida