Problemas de Sincronización
CLARITY sincroniza automáticamente los datos de sus proveedores de nube conectados en un horario regular. Esta guía ayuda a diagnosticar y resolver problemas relacionados con la sincronización.
Entendiendo el Ciclo de Sincronización
CLARITY ejecuta sincronizaciones automáticas de datos en un horario periódico:
- Las sincronizaciones automáticas se ejecutan por proveedor: AWS cada 24 horas, Azure y GCP cada 6 horas. AWS es deliberadamente menos frecuente porque Cost Explorer cobra $0.01 por solicitud contra tu propia cuenta.
- Las sincronizaciones manuales pueden activarse desde el panel de control en cualquier momento
- Período de espera — hasta 1 hora entre sincronizaciones manuales de la misma cuenta. El período se libera antes si la ejecución resultó no costar nada, así que en la práctica solo afecta a cuentas que realmente incurren en cargos de API del proveedor.
- La primera sincronización se ejecuta inmediatamente cuando agrega nuevas credenciales de nube
Cada sincronización recopila datos de costos, inventarios de recursos, métricas de uso y recomendaciones de optimización de las APIs del proveedor de nube.
Indicadores de Estado de Sincronización
El estado de la sincronización se muestra en el encabezado del panel de control y en la página de cuentas:
| Estado | Significado |
|---|---|
| In Progress | La sincronización se está ejecutando activamente. Puede tomar varios minutos. |
| Completed | La sincronización finalizó exitosamente. Los datos están actualizados. |
| Failed | La sincronización encontró un error. Revise los detalles del error a continuación. |
Fallas Comunes de Sincronización
Credenciales Inválidas
Síntomas: La sincronización falla inmediatamente con un error de autenticación.
Causas:
- La clave de acceso de AWS fue desactivada o eliminada
- El secreto del Service Principal de Azure expiró
- La clave de la cuenta de servicio de GCP fue rotada
Solución: Actualice las credenciales en la página de cuentas con claves válidas y activas.
Permisos Insuficientes
Síntomas: La sincronización se completa parcialmente pero faltan algunas categorías de datos.
Causas:
- El rol o política de IAM fue modificado después de la configuración inicial
- Se eliminaron permisos requeridos del Service Principal
- Se agregó un nuevo servicio de AWS pero la política de IAM no lo cubre
Solución: Revise los permisos requeridos para su proveedor en la Guía de Inicio Rápido y restaure cualquier permiso faltante.
Limitación de Tasa de API
Síntomas: La sincronización falla a mitad de proceso con errores de tiempo de espera o limitación.
Causas:
- Se excedieron los límites de tasa de la API del proveedor de nube (especialmente Azure, que devuelve errores 429)
- Múltiples herramientas o usuarios consultando la misma cuenta de nube simultáneamente
Solución: Espere a que pase el período de espera y active una nueva sincronización. CLARITY maneja la limitación de tasa con reintentos automáticos, pero una limitación sostenida puede causar que la sincronización falle.
Conectividad de Red
Síntomas: La sincronización falla con errores de tiempo de espera de conexión.
Causas:
- La instancia de CLARITY no puede alcanzar las APIs del proveedor de nube (reglas de firewall, problemas de DNS)
- Implementación detrás de un proxy corporativo restrictivo
Solución: Verifique que la instancia de CLARITY pueda alcanzar los siguientes endpoints:
- AWS:
ce.us-east-1.amazonaws.com,ec2.*.amazonaws.com,monitoring.*.amazonaws.com - Azure:
management.azure.com,login.microsoftonline.com - GCP:
bigquery.googleapis.com,compute.googleapis.com,monitoring.googleapis.com
Activar una Sincronización Manual
Para activar manualmente una sincronización:
- Navegue al Panel de Control o la página de Cuentas
- Haga clic en el botón Sync junto a la cuenta que desea actualizar
- Espere a que la sincronización se complete (el indicador de estado se actualizará)
INFO
Las sincronizaciones manuales respetan el período de espera de 1 hora. Si activó una sincronización recientemente, deberá esperar antes de activar otra.
Qué Hacer Si la Sincronización Está Atascada
Si una sincronización parece atascada en el estado "In Progress" por más de 15 minutos:
- Espere — Las cuentas grandes con miles de recursos pueden tomar hasta 10-15 minutos
- Revise los logs — Si tiene acceso a los logs de la aplicación, busque mensajes de error o tiempos de espera
- Reinicie la aplicación — Si la sincronización realmente está atascada, reiniciar la aplicación limpiará el estado en progreso
- Active una nueva sincronización — Después del reinicio, active una nueva sincronización manual
Próximos Pasos
- Revise Problemas Comunes para otros problemas
- Consulte el Glosario para la terminología