Desde su primer inicio de sesión hasta las respuestas sobre su app en producción.
Estas páginas muestran las URL de Cloud. Inicie sesión en Dedicated y muestran las de su servidor.
Primeros pasos
De un primer vistazo a OpenTelemetry a su propia traza en el Observatory. Cada paso se apoya en el anterior, así que siga el orden.
Acerca de OpenTelemetry
Empiece por OpenTelemetry
Dartastic se basa en OpenTelemetry (OTel), el estándar abierto para registrar lo que hace el software. Dartastic sigue de cerca la especificación de OpenTelemetry: los nombres, los datos y la forma de enviarlos son los del estándar. Lo que aprenda sobre OpenTelemetry se aplica a Dartastic, y lo que construya con Dartastic sigue siendo OpenTelemetry estándar.
La especificación es accesible. Antes de seguir, dedique una hora a la documentación de OpenTelemetry para tener una idea básica:
Qué sucedió, paso a paso, y cuánto tardó cada paso. Una traza es un árbol de spans: un toque, la llamada de red que hizo, el trabajo del servidor detrás de esa llamada, la consulta a la base de datos debajo. Una traza puede pasar de su app a su servidor.
Números medidos a lo largo del tiempo: tiempos de fotograma, memoria, solicitudes por minuto, errores por versión. Conservarlas cuesta poco, así que muestran tendencias y disparan alertas.
Líneas de texto con una hora y una gravedad. En OpenTelemetry, un log lleva la traza en la que se escribió, así que desde un log puede abrir todo lo demás que sucedió en ese momento.
Las tres llevan un recurso: qué app las envió, qué versión y en qué dispositivo. Dartastic agrega encima el monitoreo de usuarios reales (sesiones, pantallas, toques y reproducción), registrado también como señales estándar. La Introducción explica los demás términos que usan estas páginas.
1. Iniciar sesión
Iniciar sesión en dartastic.io. La primera vez, usted configura su organización: la cuenta a la que pertenecen sus tokens, sus compañeros de equipo y su plan. Si un compañero de equipo le envió una invitación, inicie sesión con la dirección de correo electrónico que recibió la invitación y se unirá a la organización de ese compañero en lugar de crear una.
Al registrarse, su organización empieza en Cloud Free, sin tarjeta. Se le pide:
Nombre de la organización y subdominio: su nombre, y el subdominio al que sus apps envían telemetría. El subdominio es suyo para siempre.
Región: dónde se almacena su telemetría. No se puede cambiar más adelante.
Límite de RUM: el nivel de reproducción más alto que su motor puede grabar. Cloud Free llega hasta Wireframe; Shadow y Pixel están en los planes de pago. Su motor se forja con su elección, y nada en el dispositivo puede superarla.
Dartastic AI: funciona con su propia clave de modelo, que puede añadir en ese momento o más adelante.
Solo para Dartastic Pub, elija un plan de Pub en Precios antes de registrarse. Usted da nombre a su organización y elige su región, y no se le pide nada más.
Pulse Reference Demo en la parte superior del Control Room y descomprímala. La ejecutará en el paso 5: es la forma más rápida de ver Dartastic en acción, y su código muestra cómo usar cada función. Más información sobre la Reference Demo.
3. Conectar dart pub a su Dartastic Pub
Los paquetes de Dartastic vienen de su Dartastic Pub, no de pub.dev, y dart pub necesita un token para leer de él. La mayoría de los desarrolladores nunca lo ha hecho; lleva un minuto, una vez en cada máquina.
Dartastic Pub también funciona como intermediario de pub.dev. Defina sus paquetes en pubspec.yaml como siempre: los de pub.dev se resuelven desde pub.dev automáticamente, junto con los paquetes de Dartastic y los suyos privados.
Cree un token de Pub: pulse + Pub. Se abre la ventana:
Name: cualquier nombre que distinga sus tokens; le recomendamos pub-org-read-write.
Organization: la organización cuyos paquetes lee y publica este token.
Allow write (publish) access: márquelo para publicar en su Dartastic Pub con este token. Sin él, el token solo puede leer, que es todo lo que necesita la Reference Demo salvo symbolizer_demo_flutter y crash_demo_flutter, que publican en su Dartastic Pub.
Haga clic en Generate. Su token se muestra una sola vez: Copie el token ahora con su botón de copiar: una vez que cierre esta ventana no se puede volver a mostrar. Granted scopes: Pub significa que este token es solo para Pub: no puede enviar telemetría ni llamar a ningún otro servicio.
En una terminal, entregue el token a dart pub:
shell
dart pub token add https://pub.dartastic.io
Cuando le pida Enter secret token:, pegue el token y pulse Enter. El indicador no muestra nada al pegar; es lo esperado. Responde:
terminal
Enter secret token:
Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
En la carpeta de la Reference Demo, obtenga sus paquetes:
shell
flutter pub get
Si funciona, su Dartastic Pub y su token funcionan.
dart pub guarda el token para ese host y solo lo envía allí. Pub explica cómo listar, reemplazar y quitar tokens, y cómo publicar.
A qué paquetes llega un token de Pub
Un token de Pub llega a los paquetes que su propietario puede usar, y a ninguno más.
Los administradores de la organización tienen acceso a todos los paquetes de la organización, así que sus tokens también.
Los demás compañeros de equipo solo pueden crear tokens para los paquetes que se les asignaron. Un administrador asigna paquetes a un compañero de equipo.
Consulte Invitar a compañeros para los roles y Pub para asignar paquetes a los miembros de la organización.
4. Permitir que su app envíe telemetría
En Tokens, cree un token OTLP y expórtelo en su terminal con la forma estándar de OpenTelemetry. Escriba authorization en minúsculas:
Con Docker en marcha, inicie la demo meteorológica desde la carpeta de la Reference Demo y elija un dispositivo:
shell
tool/launch.sh weather_flutter
Toque para obtener los datos meteorológicos. Ese toque inicia una traza que recorre la app, la API meteorológica, su caché y el servicio meteorológico externo.
6. Verlo en el Observatory
Su toque llega al Observatory en segundos. La app enlaza a lo que envió: siga su enlace para abrir la traza y ver cada paso y cuánto tardó.
Siguiente
Crear su primera app: las versiones de Flutter y Dart que necesita cada paquete.
Usamos cookies esenciales para que este sitio funcione, y cookies de analítica solo con su consentimiento. Consulte nuestra Política de cookies y nuestra Política de privacidad.