Soporte
Conectar tu cuenta
Crear un token
- En Sentry, abre User settings → Personal Tokens (en un servidor autoalojado: los ajustes equivalentes de tokens de autenticación) y crea un token nuevo.
-
Elige los scopes. Para consultar en modo solo lectura:
org:read,project:read,event:read. Para gestionar issues desde la app, añadeevent:write(resolver, archivar, asignar) ymember:read(elegir responsables). - Copia el token y pégalo en la pantalla de conexión de Tracebell. Los scopes no se pueden cambiar después de crear el token: si elegiste menos de los necesarios, crea un token nuevo.
Servidores autoalojados
Elige «Autoalojado» en la pantalla de conexión y escribe la URL de tu servidor. La app usa las mismas rutas de API que sentry.io. Tu servidor debe ser accesible desde tu iPhone (directamente o por VPN) mediante HTTPS.
Problemas habituales
- «El token fue rechazado» justo después de pegarlo: comprueba que no esté cortado ni tenga espacios de más; los tokens son largos. En un servidor autoalojado, confirma además que la URL no tenga ninguna ruta después del nombre del host.
- Botones atenuados (resolver/asignar): a tu token le
falta
event:writeomember:read. Crea un token nuevo con esos scopes. - Todo funcionaba y de repente dejó de hacerlo: probablemente el token se revocó o cambió tu pertenencia a la organización. Vuelve a conectar con un token nuevo.
- Las listas van lentas o dejan de actualizarse: Sentry aplica límites de solicitudes por endpoint. La app espera automáticamente y continúa cuando el límite se restablece.
Notificaciones push
En el plan gratuito, los dispositivos registrados reciben un resumen diario de issues nuevas (hacia las 22:00 UTC), y todos los dispositivos registrados reciben un resumen semanal. Tracebell Advanced sustituye el resumen diario por la entrega en tiempo real de cada evento (creación, reaparición, resolución) y sus filtros. La configuración es la misma en ambos casos:
- En Tracebell, abre Perfil → Notificaciones, toca Activar notificaciones y permite las notificaciones.
- Toca Configurar notificaciones push. En Sentry, abre Settings → Developer Settings → Custom Integrations y crea una Internal Integration: pon Issue & Event en Read (Sentry lo exige para suscribirse a los webhooks de issues), deja los demás permisos en «No Access», activa Alert Rule Action y suscribe el webhook a los eventos issue.
- Copia el Client Secret de la integración, pégalo en la app y toca Registrar este dispositivo. La app muestra entonces tu URL personal del webhook.
- Pega esa URL en el campo Webhook URL de la integración en Sentry y guarda. Si quieres, añade «Send a notification via Tracebell» a tus reglas de alerta.
- De vuelta en la app, envía una notificación de prueba. Con Advanced, elige qué tipos de evento te avisan en tiempo real y, si quieres, limítalos a los Proyectos seleccionados (hasta 50) y a un Nivel mínimo (Info, Warning, Error o Fatal).
Crear una Internal Integration suele requerir el rol Admin, Manager u Owner en la organización. Si eres Member, pídele a un Owner que la configure o usa la app sin notificaciones push.
Nota de privacidad: el relé nunca tiene tu token de Sentry y no guarda los títulos de las issues: solo pasan por él hacia el servicio push de Apple para entregar la notificación. Consulta la política de privacidad.
Cómo funcionan los filtros
- Se aplican a las notificaciones push en tiempo real y al inicio automático de actividades en vivo. El resumen diario (plan gratuito) y el resumen semanal siguen contando todas las issues nuevas, y las issues que sigues en la pantalla de bloqueo no se filtran.
- Las alertas de métricas se filtran solo por proyecto. Cuando Sentry no indica el proyecto o el nivel de un evento, este se entrega en lugar de descartarse.
Actividad en vivo (Advanced)
Abre una issue sin resolver y toca Seguir en la pantalla de bloqueo. La actividad en vivo muestra la fase, los eventos, los usuarios y las alertas de la issue, y cuándo se vio por última vez, en la pantalla de bloqueo y en la Dynamic Island. Termina cuando la issue se resuelve o se archiva, y puedes dejar de seguirla en cualquier momento.
- Las actualizaciones en segundo plano llegan a través del relé push, así que requieren tener configuradas las notificaciones (arriba) para la organización de la issue. Llegan cuando Sentry envía un webhook de la issue, no a intervalos fijos; añadir «Send a notification via Tracebell» a una regla de alerta de issues las hace más frecuentes. Sin notificaciones, la actividad en vivo solo se actualiza mientras Tracebell está abierto y muestra «Abre Tracebell para actualizar» al cabo de 30 minutos.
- Volver a empezar: la actividad en vivo de una issue que sigues puede volver a empezar cuando la issue reaparece o se dispara una alerta.
- Tras forzar el cierre: si cierras Tracebell deslizándolo en el selector de apps, o si el modo de bajo consumo está activado o la actualización en segundo plano está desactivada para Tracebell, puede que iOS no permita a la app iniciar actividades en vivo ni enviar al relé su token de actualización en segundo plano. Una actividad en vivo iniciada en esas condiciones muestra «Abre Tracebell para actualizar» al cabo de 30 minutos, incluso con las notificaciones configuradas. Abre Tracebell y las actualizaciones se reanudan.
- Iniciar automáticamente (Perfil → Notificaciones, desactivado por defecto): una issue que reaparece en los proyectos que vigilas, con tu nivel mínimo o uno superior, puede iniciar sola una actividad en vivo, pero solo mientras no haya ninguna actividad en vivo de Tracebell en curso.
- Límites: puede haber hasta 3 actividades en vivo en curso a la vez; al seguir una cuarta, termina la que lleva más tiempo sin actualizarse. iOS decide con qué frecuencia una app puede iniciar actividades en vivo en segundo plano, y el relé envía como máximo 4 inicios por hora, así que un inicio puede omitirse. iOS termina todas las actividades en vivo a las 8 horas.
- ¿No aparece nada? Comprueba que las actividades en vivo estén activadas para Tracebell en la app Ajustes de iOS, luego usa Enviar actividad en vivo de prueba en Perfil → Notificaciones y bloquea tu iPhone: en unos 10 segundos aparece una actividad en vivo de prueba.
- En modo demo puedes seguir una issue de ejemplo; muestra actualizaciones de ejemplo mientras la app está abierta.
Iconos de la app (Advanced)
Abre Perfil → Apariencia → Icono de la app y elige Papel, Mono, Señal, Ámbar o Menta; Clásico está siempre disponible. iOS confirma cada cambio con un breve aviso. Sin Advanced, y en modo demo, al tocar un icono se muestra una vista previa y el icono de la pantalla de inicio no cambia. Si Advanced termina, el icono que elegiste se queda hasta que vuelvas a Clásico.
Compras
- Planes: Tracebell Advanced está disponible como plan mensual (¥500 / $2.99), anual (¥4,000 / $24.99, 14 días de prueba gratis) o como compra única de por vida (¥9,700 / $99.99). Las propinas de la app apoyan el desarrollo y no desbloquean nada.
- Restaurar: Perfil → Plan → Restaurar compras (usa la misma cuenta de Apple).
- Cancelar: las suscripciones se gestionan en los ajustes de tu cuenta del App Store, no en la app.
- Los reembolsos los gestiona Apple en reportaproblem.apple.com.
Peticiones de funciones y errores
Escribe a [email protected] y cuenta qué esperabas y qué pasó. Las capturas de pantalla ayudan, pero antes difumina cualquier dato sensible.