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

Dartastic OTel Reference Demo

Apps Flutter que funcionan y muestran cada función de Dartastic, con la configuración ya hecha. Ejecútelas para ver Dartastic funcionar de extremo a extremo; luego lea su código y copie de él.

Es la versión comercial ampliada de la Dart OTel Reference Demo de código abierto, con muchas más demos. Cada app resuelve sus paquetes desde su Dartastic Pub y envía a su Observatory, así que cuando la demo se ejecuta, queda comprobado que su cuenta funciona.

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

Descargarla

Inicie sesión en el Control Room y pulse Reference Demo en la parte superior de cada pantalla, junto a “Help”:

El encabezado del Control Room con el botón “Reference Demo”, junto a “Help” y “Sign Out”

Se descarga dartastic-otel-reference-demo-<version>.tar.gz. Descomprímalo donde guarde su código:

shell
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*

El README.md de su carpeta principal es la guía completa. Los pasos de abajo le llevan hasta su primera ejecución.

En Dedicated: apúntela a su servidor

La demo empieza apuntando a Dartastic Cloud, así que en Cloud no hay nada que hacer aquí. En Dedicated, ejecute esto una vez con su subdominio:

shell
tool/set-hosted-slug.sh <subdomain>

Escribe su subdominio en .env (que git ignora) y actualiza los pubspecs. Vuelva a ejecutarlo con otro subdominio para cambiar, o con "" para volver a Cloud.

Los tokens que necesita

Cree cada uno en la pantalla Tokens del Control Room. Cada token se muestra una sola vez, así que cópielo al crearlo.

TokenNecesario para
Token de Pub
dart pub token add (una vez)
Todas las demos: flutter pub get resuelve los paquetes desde su Dartastic Pub.
Token OTLP
OTEL_EXPORTER_OTLP_HEADERS
Todas las demos: las apps envían su telemetría a su Observatory.
Token de Symbolizer
DARTASTIC_SYMBOLIZER_TOKEN
Solo symbolizer_demo_flutter.

Un token de Pub de solo lectura basta para todas las demos salvo symbolizer_demo_flutter y crash_demo_flutter, que publican en su Dartastic Pub y necesitan un token de lectura y escritura. Primeros pasos explica paso a paso cómo agregar el token de Pub y exportar los demás.

Exporte los tokens en su terminal en lugar de escribirlos en .env: un .env compartido o confirmado en el repositorio es una vía habitual de filtración de secretos.

Ejecutar una demo

La demo es un único workspace de Flutter, así que obtenga los paquetes de todas las apps de una vez desde su carpeta principal:

shell
flutter pub get

Si funciona, su Dartastic Pub y su token de Pub funcionan. Luego inicie una app; tool/launch.sh le pregunta en qué dispositivo ejecutarla:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker solo hace falta para weather_flutter y all_demos_flutter: levantan la API meteorológica en su equipo para mostrar una sola traza entre la app y el servidor.
  • Las demos se ejecutan en Android, iOS, macOS, Windows y Linux, en dispositivos y simuladores. No se ejecutan en la web.

Qué contiene

AppQué muestra
weather_flutterUn toque trazado de extremo a extremo: la app, una API meteorológica, su caché y el servicio meteorológico externo, en una sola traza.
all_demos_flutterCasi todas las demos como pestañas de una sola app.
rum_demo_flutterSesiones, vistas de pantalla, toques y señales de frustración, con reproducción de sesiones.
crash_demo_flutterCrashes registrados y entregados incluso cuando la app se cierra.
symbolizer_demo_flutterUna compilación de versión ofuscada cuyas pilas de llamadas vuelven como sus archivos y líneas, y el jank trazado hasta el widget.
anr_demo_flutterDetección de App Not Responding (ANR).
pii_demo_flutterMantener los datos personales fuera de su telemetría.
webview_demo_flutterTelemetría de una página web dentro de su app, unida a la traza de la app.
Métricas vitales de la plataformaSalud de las versiones, Android Vitals, MetricKit de iOS, inicio de la app, estado del dispositivo, estado térmico, inestabilidad de la red, experiencia de usuario y métricas vitales de servidores Linux, una app para cada uno.

Cada app enlaza a lo que envió en su Observatory. Para aprender una función, ejecute su app y luego lea su código: es el ejemplo funcional más pequeño de esa función. Indíquele también a su asistente de programación con IA que lo use.

Lo que ve en el Observatory

Pantallas de una ejecución de las demos. Su propia ejecución da sus propias cifras; lo que muestra cada pantalla es lo mismo.

Tiempos de construcción de fotogramas

all_demos_flutter en la pantalla “Metric” para flutter.frame.build, como mapa de calor: cuatro minutos de fotogramas, con la línea p95 subiendo a lo largo de la ejecución.
all_demos_flutter en la pantalla “Metric” para flutter.frame.build, como mapa de calor: cuatro minutos de fotogramas, con la línea p95 subiendo a lo largo de la ejecución.

Salud de las versiones

Trazas filtradas por los spans flutter.session de la demo de salud de las versiones, uno por sesión. El de rojo es la sesión que tuvo un crash.
Trazas filtradas por los spans flutter.session de la demo de salud de las versiones, uno por sesión. El de rojo es la sesión que tuvo un crash.

Inicio de la app

La pantalla “Metric” para flutter.app.startup.duration, como mapa de calor: tres inicios en frío de unos 2,2 s y dos inicios en caliente de 33 y 63 ms.
La pantalla “Metric” para flutter.app.startup.duration, como mapa de calor: tres inicios en frío de unos 2,2 s y dos inicios en caliente de 33 y 63 ms.

Inestabilidad de la red

Trazas filtradas por dartastic.network.flaky = true: dos solicitudes inestables, una que tardó 6,56 s y otra de 114 ms que terminó en error.
Trazas filtradas por dartastic.network.flaky = true: dos solicitudes inestables, una que tardó 6,56 s y otra de 114 ms que terminó en error.

Interaction to Next Paint

La pantalla “Metric” para flutter.experience.inp, como mapa de calor: ocho interacciones, dos por debajo de 16 ms y seis de 200 a 250 ms.
La pantalla “Metric” para flutter.experience.inp, como mapa de calor: ocho interacciones, dos por debajo de 16 ms y seis de 200 a 250 ms.

First Contentful Paint

La pantalla “Metric” para flutter.experience.fcp: un First Contentful Paint, a los 2,67 s.
La pantalla “Metric” para flutter.experience.fcp: un First Contentful Paint, a los 2,67 s.

App Not Responding, como eventos

Logs filtrados por los eventos dartastic.app.anr de anr_demo_flutter: tres ANR, contados en “Unspecified” porque un evento no lleva gravedad, y cada fila muestra su nombre de evento.
Logs filtrados por los eventos dartastic.app.anr de anr_demo_flutter: tres ANR, contados en “Unspecified” porque un evento no lleva gravedad, y cada fila muestra su nombre de evento.

App Not Responding, cuánto duró

Los mismos tres ANR en la pantalla “Metric” para flutter.anr.duration: cada uno de 6,0 a 6,6 s, en el momento en que se exportó.
Los mismos tres ANR en la pantalla “Metric” para flutter.anr.duration: cada uno de 6,0 a 6,6 s, en el momento en que se exportó.

Salidas de la app en MetricKit de iOS

La pantalla “Metric” para dartastic.app.exit.count, como barras: 50 salidas en un intervalo de cinco minutos, 43 normales, 3 por falta de memoria, 3 por el watchdog y 1 por tiempo de espera agotado.
La pantalla “Metric” para dartastic.app.exit.count, como barras: 50 salidas en un intervalo de cinco minutos, 43 normales, 3 por falta de memoria, 3 por el watchdog y 1 por tiempo de espera agotado.