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:

Las tres señales

OpenTelemetry registra tres tipos de datos, llamados señales:

Trazas
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.
Métricas
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.
Logs
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.

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. 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.

Llega al Control Room. Organization muestra el nombre y el id de su organización.

2. Descargar la Reference Demo

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.

  1. En el Control Room, vaya a Tokens:
    La pantalla “Tokens” del Control Room: “Generate Token”, con “+ Pub”, “+ Symbolizer”, “+ OTLP” y “+ Browser OTLP”
  2. Cree un token de Pub: pulse + Pub. Se abre la ventana:
    La ventana “Generate Pub Token”: “Name”, lo que concede el token, la organización y “Allow write (publish) access”
    • 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.
  3. Haga clic en Generate. Su token se muestra una sola vez:
    El nuevo token de Pub: su “Token ID”, el token secreto con un botón para copiarlo, el comando dart pub token add y “Granted scopes: Pub”
    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.
  4. 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.
  5. 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:

shell
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer <your OTLP token>"

5. Ejecutar la demo

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