Solución de problemas
Primero el síntoma y después las comprobaciones, en el orden que encuentra la causa antes. Además, cada agente envía su propio registro a la consola, así que casi todo puede diagnosticarse sin tocar el equipo.
Dónde están los registros #
| Qué | Dónde |
|---|---|
| Una ejecución de tarea: qué hizo, archivo por archivo | Consola → Tareas → ⋮ → Historial de ejecuciones → la ejecución. Los archivos con error aparecen con el motivo de cada uno. |
| El registro del propio agente, desde la consola | Se envía de forma continua (INFO y superior). Puede leerse con la herramienta get_agent_logs, o pregúntenos. |
| Windows, en el equipo | C:\ProgramData\Aurawolf\logs\agent.log (rotación diaria); la aplicación de la bandeja escribe tray.log al lado |
| macOS | sudo launchctl print system/com.caryvane.agent; archivos de registro en /Library/Application Support/Caryvane/logs/ |
| Linux | journalctl -u caryvane-agent |
El agente aparece Sin conexión #
Un agente está En línea mientras haya contactado con la consola en los últimos 90 segundos. Sin conexión significa que la consola no ha sabido nada de él; puede que el equipo simplemente esté apagado. Es normal que los portátiles y los equipos antiguos aparezcan y desaparezcan, y eso no es un fallo. Si debería estar encendido:
- ¿Se está ejecutando el servicio? Windows:
Get-Service CaryvaneAgent. macOS:launchctl print system/com.caryvane.agent. Linux:systemctl status caryvane-agent. - ¿Llega a la consola? Desde el equipo:
curl -sI https://console.caryvane.com/healthz(o ábrala en un navegador). Solo saliente por el 443 (direcciones y reglas de firewall); un proxy que inspeccione TLS debe confiar en la cadena de certificados o excluir el host. - ¿Se está actualizando? El agente se detiene un minuto mientras se instala una versión nueva y vuelve solo. La columna Versión muestra si lo ha hecho.
- Lea el registro. Las últimas líneas de
agent.logdicen qué estaba haciendo. Si se repite «Server rejected the machine token», el registro del agente ya no es válido.
Agente instalado pero ausente de la consola, o la bandeja dice «Registered» y la consola no está de acuerdo #
Tres causas, de la más a la menos probable:
- No registrado. Una instalación desatendida con un token caducado o ya usado deja el agente instalado y a la espera. Haga clic con el botón derecho en el icono de la bandeja → Enroll Agent… (por ahora la bandeja muestra esta opción en inglés) con un token nuevo. En macOS/Linux, escriba
setup.json/agent.jsoncon el token y reinicie el servicio (Implementar el agente). - Registrado en otro sitio. El equipo conserva un registro de otro servidor (un entorno piloto) o de un cliente que se eliminó, y la consola a la que apunta lo rechaza. El agente actual lo detecta, descarta el registro inválido y pide un token nuevo desde la bandeja. Si un equipo con una versión antigua se queda atascado así, instale la versión actual encima, sin desinstalar, y regístrelo después.
- Cliente equivocado. El token decide el cliente. Busque en los demás clientes que puede ver; si se registró en el equivocado, desinstálelo (así olvida el registro) y vuelva a instalarlo con el token correcto.
El instalador y todos los binarios que contiene están firmados. Un aviso con una descarga antigua suele indicar una versión preliminar sin firmar; descargue el instalador actual desde la consola.
La tarea terminó con Advertencia #
Advertencia significa que la ejecución terminó y que se omitieron algunos archivos. El registro de la ejecución los nombra todos, con el motivo. Los más habituales:
| Línea del registro | Causa | Qué hacer |
|---|---|---|
SKIPPED (encrypted with EFS — the agent cannot read it) | Los archivos cifrados con EFS de Windows solo los puede leer el usuario que los cifró; el agente se ejecuta como SYSTEM. | Descífrelos (cipher /d) o excluya la carpeta. Es una advertencia a propósito, no un error. |
Skipped (in use by another program) | Un bloqueo exclusivo, y VSS estaba desactivado o no pudo crear una instantánea del volumen. | Active Incluir archivos abiertos y bloqueados en la tarea (usa VSS); para bases de datos y máquinas virtuales use una tarea coherente con la aplicación (Hacer una copia de seguridad de Hyper-V, SQL Server o Active Directory). |
… contains a virus or potentially unwanted software | Windows Defender bloqueó la lectura. Suele ser un keygen o un crack antiguo en la carpeta de descargas de un usuario. | Exclúyalo o deje que el cliente lo elimine. Caryvane no se salta el antivirus. |
Skipped (stored in the cloud, not on this machine) | Un marcador de posición de OneDrive/Dropbox: el contenido del archivo no está en el disco. | Haga la copia de seguridad de la cuenta en la nube con una tarea de conector o de destino de almacenamiento. |
La tarea terminó con Error #
- «Interrupted: the agent restarted while this run was in progress.» El equipo o el servicio se reiniciaron a mitad de la ejecución (el clásico: Windows Update a las 3 de la madrugada). La siguiente ejecución programada continúa donde lo dejó la incremental. Si se repite cada noche, compare la programación de reinicios del equipo con la de la tarea.
- Errores de almacenamiento (acceso denegado, bucket no encontrado, firma no coincidente): Almacenamiento → Probar en el destino. Una clave rotada, una SAS caducada o un token OAuth revocado por el administrador del cliente aparecen aquí primero; los tokens de Egnyte caducan a los 30 días y solo se renuevan automáticamente mientras la conexión está en uso.
- «Source and destination must be different» / errores de accesibilidad desde la nube: una tarea del Cloud Agent no puede leer un recurso compartido de la LAN ni una carpeta local; ejecútela en un agente.
- «Cancelled: superseded by a newer run.» Se puso en cola un reintento tras el error, pero la siguiente ejecución programada empezó antes. Es solo informativo.
Tareas de Hyper-V #
- «Production checkpoints cannot be created» para una VM: el invitado no puede quedar en estado coherente (Linux sin los servicios de integración, o un invitado Windows con el servicio de integración VSS desactivado). Caryvane crea en su lugar un punto de control coherente ante bloqueos y lo indica en el registro; active Copia de seguridad (instantánea de volumen) en los Servicios de integración de la VM para obtener coherencia con la aplicación.
- Un punto de control que queda en la VM tras una ejecución interrumpida: el agente anota cada punto de control que crea y, al empezar la siguiente ejecución, combina los que encuentre pendientes. Si una VM muestra días después un punto de control de copia de seguridad obsoleto, elimínelo en el Administrador de Hyper-V; la combinación se hace en caliente.
- Va más lenta de lo esperado: una copia de seguridad de la VM completa mueve todo el
.vhdx; el tamaño que aparece en el Historial de ejecuciones es el del archivo, no el tamaño virtual del disco. La copia incremental (bloques modificados) en Server 2016 o posterior lo reduce a lo que cambia cada noche, una vez activada para el agente mediante la API (Hyper-V).
La unidad en la nube no se monta #
- Agente en línea y registrado como el agente al que se añadió la unidad. Las unidades se envían cuando el agente contacta con la consola; un agente sin conexión no tiene nada que montar.
- Windows: el controlador Dokany debe estar instalado (Agregar o quitar programas → Dokan Library). El instalador lo añade; en algunos sistemas, la primera instalación necesita un reinicio para que el controlador se cargue. La letra de unidad elegida debe estar libre.
- macOS: debe haber un usuario con la sesión iniciada (el módulo FSKit se ejecuta en la sesión del usuario) y
Caryvane.appnecesita Acceso total al disco. Compruebe que en Ajustes del Sistema → General → Ítems de inicio y extensiones → Extensiones del sistema de archivos Caryvane aparece activado. - Linux: debe existir
fusermount3y debe poder crearse el punto de montaje; consulte el journal. - La prueba del destino de almacenamiento debe ser correcta: una unidad sobre un destino con credenciales que ya no valen se monta vacía o no se monta.
El conector ha dejado de funcionar #
- Microsoft 365: errores de «consent» o 401: un administrador global quitó la aplicación o sus permisos. En Conectores, vuelva a hacer clic en Conectar Microsoft 365 para dar de nuevo el consentimiento.
- Google Workspace: 403 en un usuario: se cambió la delegación de todo el dominio, o la lista de ámbitos de la consola de administración ya no coincide. Volver a verificar en la página Conectores indica el ámbito que falta.
- No se hace copia de seguridad de los usuarios nuevos: la tarea enumera personas concretas. Edítela y elija para el tipo de recurso la opción Todos… (por ejemplo, Todos los buzones (incl. nuevos)); a partir de entonces los usuarios nuevos se incluyen automáticamente.
Una tarea se ejecutó a la hora equivocada #
Las programaciones cron están en UTC. 0 2 * * * son las 02:00 UTC: en la España peninsular, las 03:00 en horario de invierno y las 04:00 en horario de verano. Ajuste la hora y tenga en cuenta que la hora local se desplaza una hora con el cambio de horario.
¿Sigue sin resolverlo? #
Escriba a hello@caryvane.com indicando el cliente, el nombre del equipo y la hora de la ejecución; podemos leer desde nuestro lado el registro que envía el agente, sin necesidad de capturas de pantalla. Para un equipo que no llega a la consola en absoluto, adjunte las últimas 200 líneas de agent.log.
Para profundizar #
- Notas de la versión — qué cambió en cada versión