Estas páginas muestran las URL de Cloud. Inicie sesión en Dedicated y muestran las de su servidor.

Descripción general

Dartastic le muestra lo que sus apps Dart y Flutter hacen realmente en manos de sus usuarios, y le ayuda a corregir lo que falla. Esta página es el mapa. Léala una vez y luego siga Primeros pasos paso a paso.

La plataforma

Cada página de Ayuda muestra esta misma imagen, con las partes que trata resaltadas, para que siempre sepa dónde está.

DESARROLLOARQUITECTURA DE DARTASTICUSUARIOStokensticketstoken de Pubpushintercambio de CIlas apps llegan a los usuarios: tiendas de apps, la web, servidoressímboloscrashespilas de llamadascódigo fuentetelemetríaEquipo del desarrolladorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcrear tokens · control de acceso por rolesPlano de controlorganizaciones · roles · tokensDartastic Pubpaquetes · código fuenteObservatorysesiones · trazas · logsSymbolizercrashes → líneas de códigoDartastic AIrespuestas a partir de ambosGestor de ticketsGitHub · Jira · LinearApps móviles y de escritorioteléfonos · tabletas · equiposenvía con un token OTLPApps weben navegadoresenvía con un token Browser OTLPServidores Dartbackends · serviciosenvía con un token OTLP
  1. Usted compila en su equipo y en su CI. Su app obtiene los paquetes de Dartastic desde Dartastic Pub, igual que obtiene paquetes de pub.dev.
  2. Su app se ejecuta en teléfonos y equipos de escritorio, en navegadores y como servidores Dart. Los paquetes Dartastic OTel que lleva dentro registran lo que sucede y lo envían al Observatory.
  3. Cuando algo falla, el Symbolizer convierte el crash de nuevo en su archivo y su línea, con los símbolos que publicó en Dartastic Pub junto con su app.
  4. Cuando quiere saber por qué, le pregunta a Dartastic AI. Lee la telemetría y su código fuente en Dartastic Pub, y responde con la causa y una corrección.
  5. El Control Room es donde configura todo esto: crea los tokens que abren cada flecha del diagrama.

Las piezas

PiezaQué haceDónde la encuentra
Control RoomSu cuenta. Aquí crea tokens, invita a compañeros de equipo, elige su plan y descarga la Reference Demo.dartastic.io/control-room, después de iniciar sesión
Dartastic PubUn repositorio de paquetes privado que funciona como pub.dev. Obtiene de él los paquetes de Dartastic, guarda en él sus propios paquetes privados y publica en él el código fuente de su app.dart pub get, dart pub publish
Dartastic OTelLos paquetes que agrega a su app. Registran lo que sucede en ella (pantallas, toques, llamadas de red, errores, crashes, rendimiento) como OpenTelemetry y lo envían.Su pubspec.yaml y su main()
ObservatoryDonde usted mira. Sesiones con reproducción, trazas, logs, métricas, crashes, dashboards y alertas de todo lo que envían sus apps.Se abre desde el Control Room
SymbolizerConvierte las pilas de llamadas ilegibles de una compilación de versión ofuscada de nuevo en sus nombres de archivo y números de línea. Funciona por su cuenta a medida que llegan los crashes.No hay nada que llamar: lee los símbolos que usted publica en Dartastic Pub
Dartastic AIResponde preguntas sobre su app en lenguaje natural. Lee su telemetría y su código fuente en Dartastic Pub, encuentra la causa y propone la corrección.El botón “Ask” del Observatory y del Control Room

Lo que verá

Este es el Observatory. Cada sesión de sus usuarios aparece en la lista con sus pantallas, toques, errores y señales de frustración:

La lista “Sessions” del Observatory, una fila por sesión de usuario

Abra una y reprodúzcala. Bajo el cabezal de reproducción ve la traza, los logs y el error de ese momento, y puede saltar directamente a la línea de código:

Una reproducción de sesión con su línea de tiempo, la traza bajo el cabezal de reproducción y sus logs

Los tokens conectan las piezas

Cada flecha del diagrama necesita su propio tipo de token. Los crea en el Control Room, y cada uno se le muestra una sola vez, así que cópielo al crearlo. La mayoría de los desarrolladores nunca ha usado un token con dart pub; la página Pub le guía paso a paso.

TokenDesdeHaciaPermite
Token de PubSu equipoDartastic PubQue dart pub get descargue los paquetes de Dartastic y los suyos privados; que dart pub publish los suba.
Intercambio de CISu CIDartastic PubQue su CI lea y publique paquetes sin ningún token guardado en ella.
Token OTLPSu app en un teléfono o equipo de escritorio, su servidor DartObservatoryQue su app envíe telemetría.
Token Browser OTLPSu app web FlutterObservatoryQue su app web envíe telemetría, solo desde los sitios web que usted indique.

Todos los tokens que tiene aparecen en una sola pantalla. Tokens explica cada tipo y cómo revocar o reemplazar uno.

Dónde se ejecuta: su plan

  • Cloud se ejecuta en infraestructura que Dartastic comparte entre clientes. Su Dartastic Pub es pub.dartastic.io.
  • Dedicated da a su organización su propio servidor, en un subdominio que usted elige: su Dartastic Pub es pub.<subdomain>.dartastic.io.
  • Self-Hosted ejecuta toda la plataforma dentro de su propia red.

Los pasos son los mismos en todos los planes. Donde una URL cambia, estas páginas muestran ambas. Comparar los planes.

Lo que necesita

  • Flutter 3.44 y Dart 3.12 o posteriores para todas las funciones; Flutter 3.22 y Dart 3.4 para todas menos las métricas de Flutter. Qué versiones necesita cada paquete.
  • Una cuenta de Dartastic: registrarse es gratis. Al registrarse, su organización empieza en Cloud Free, sin tarjeta.
  • Solo para el backend meteorológico de la Reference Demo: Docker.

Cómo aprenderlo

Use lo que mejor le funcione; cubren lo mismo.

  • Lea estas páginas en orden. “Anterior” y “Siguiente”, al pie de cada página, le guían.
  • Ejecute la Dartastic OTel Reference Demo. Es la versión comercial ampliada de la Dart OTel Reference Demo de código abierto: muchas más demos, apps Flutter que funcionan y muestran cómo usar cada función de Dartastic, con la configuración ya hecha. Lea su código, copie de él o indíquele a su asistente de programación con IA que lo use. Obtener la Reference Demo.
  • Pregunte: Soporte responde preguntas.

Términos usados en estas páginas

OpenTelemetry (OTel)
El estándar abierto para registrar lo que hace el software. Dartastic lo habla de extremo a extremo, así que nada de lo que escriba queda atado a Dartastic.
OTLP
El formato de transmisión de OpenTelemetry: cómo su app envía lo que registró.
Traza y span
Un span es una unidad de trabajo cronometrada (un toque, una llamada de red, una consulta a la base de datos). Una traza es el árbol de spans de una operación, incluso entre su app y su servidor.
Log
Una línea de texto que escribió su app, vinculada a la traza en la que ocurrió.
Métrica
Un número medido a lo largo del tiempo: tiempos de fotograma, memoria, cantidad de solicitudes.
Sesión
La visita de una persona a su app, desde que la abre hasta que la deja, con cada pantalla, toque, error y traza.
Reproducción
Volver a ver una sesión. Usted elige cuánto se captura: una línea de tiempo de eventos, un wireframe o los píxeles reales.
RUM
Real User Monitoring (monitoreo de usuarios reales): telemetría de las personas que realmente usan su app, a diferencia de las pruebas.
Ofuscación y símbolos
Una compilación de versión puede codificar sus nombres (flutter build --obfuscate). El archivo de símbolos que escribe (--split-debug-info) es la clave para decodificarlos.
Token
Una cadena secreta larga que permite que una cosa se comunique con otra. Cada tipo abre un camino del diagrama de arriba.