Estas páginas mostram as URLs do Cloud. Faça login no Dedicated e elas passam a mostrar as do seu servidor.

Dartastic OTel Reference Demo

Apps Flutter funcionais que mostram cada recurso da Dartastic, com a configuração já feita. Rode-os para ver a Dartastic funcionar de ponta a ponta, depois leia o código e copie trechos dele.

Ele é a versão comercial ampliada do Dart OTel Reference Demo open source, com muito mais demos. Cada app resolve seus packages a partir do seu Dartastic Pub e envia telemetria para o seu Observatory, então, quando o demo roda, fica comprovado que sua conta funciona.

BUILDARQUITETURA DARTASTICUSUÁRIOStokensissuestoken do Pubpushtroca na CIos apps chegam aos usuários: lojas de apps, a web, servidoressímboloscrashesstack tracescódigo-fontetelemetriaComputador do desenvolvedorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcriação de tokens · controle de acesso por papéisPlano de controleorganizações · papéis · tokensDartastic Pubpackages · código-fonteObservatorysessões · traces · logsSymbolizercrashes → linhas do código-fonteDartastic AIrespostas a partir dos doisIssue trackerGitHub · Jira · LinearApps mobile e desktopcelulares · tablets · desktopsenvia com um token OTLPApps webem navegadoresenvia com um token Browser OTLPServidores Dartbackends · serviçosenvia com um token OTLP

Baixar o demo

Faça login no Control Room e clique em Reference Demo no topo de qualquer tela, ao lado de “Help”:

O cabeçalho do Control Room com o botão “Reference Demo”, ao lado de “Help” e “Sign Out”

O download é dartastic-otel-reference-demo-<version>.tar.gz. Descompacte-o onde você guarda seu código:

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

O README.md na raiz é o guia completo. Os passos abaixo levam você até a primeira execução.

No Dedicated: aponte para o seu servidor

O demo já vem apontado para o Dartastic Cloud, então no Cloud não há nada a fazer aqui. No Dedicated, execute isto uma vez com o seu subdomínio:

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

Ele grava seu subdomínio em .env (que o git ignora) e atualiza os pubspecs. Execute de novo com outro subdomínio para trocar, ou com "" para voltar ao Cloud.

Os tokens de que ele precisa

Crie cada um na tela Tokens do Control Room. Cada token é mostrado uma única vez, então copie-o assim que criá-lo.

TokenNecessário para
Token do Pub
dart pub token add (uma vez)
Todos os demos: flutter pub get resolve os packages a partir do seu Dartastic Pub.
Token OTLP
OTEL_EXPORTER_OTLP_HEADERS
Todos os demos: os apps enviam a telemetria para o seu Observatory.
Token do Symbolizer
DARTASTIC_SYMBOLIZER_TOKEN
Apenas symbolizer_demo_flutter.

Um token do Pub somente leitura basta para todos os demos, exceto symbolizer_demo_flutter e crash_demo_flutter, que publicam no seu Pub e precisam de um token de leitura e escrita. Primeiros passos mostra como adicionar o token do Pub e exportar os demais.

Exporte os tokens no seu shell em vez de escrevê-los em .env: um .env compartilhado ou commitado é um caminho comum para o vazamento de segredos.

Rodar um demo

O demo é um único workspace Flutter, então baixe os packages de todos os apps de uma vez a partir da pasta raiz:

shell
flutter pub get

Se der certo, seu Dartastic Pub e seu token do Pub funcionam. Depois, inicie um app; tool/launch.sh pergunta em qual dispositivo rodar:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • O Docker só é necessário para weather_flutter e all_demos_flutter: eles sobem a API de clima na sua máquina para mostrar um único trace atravessando app e servidor.
  • Os demos rodam em Android, iOS, macOS, Windows e Linux, em dispositivos e simuladores. Eles não rodam na web.

O que tem nele

AppO que mostra
weather_flutterUm toque rastreado de ponta a ponta: o app, uma API de clima, o cache dela e o serviço de clima externo, em um único trace.
all_demos_flutterQuase todos os demos, cada um como uma aba em um único app.
rum_demo_flutterSessões, visualizações de tela, toques e sinais de frustração, com replay de sessão.
crash_demo_flutterCrashes registrados e entregues mesmo quando o app morre.
symbolizer_demo_flutterUm build de release ofuscado cujos stack traces voltam como seus arquivos e linhas, e jank rastreado até o widget.
anr_demo_flutterDetecção de “o app não está respondendo” (ANR).
pii_demo_flutterComo manter dados pessoais fora da sua telemetria.
webview_demo_flutterTelemetria de uma página web dentro do seu app, unida ao trace do app.
Métricas vitais da plataformaSaúde das versões, Android Vitals, MetricKit do iOS, inicialização do app, estado do dispositivo, estado térmico, instabilidade de rede, experiência do usuário e métricas vitais de servidor Linux, um app para cada.

Cada app mostra links para o que enviou ao seu Observatory. Para aprender um recurso, rode o app dele e depois leia o código: é o menor exemplo funcional desse recurso. Aponte também seu assistente de programação com IA para ele.

O que você vê no Observatory

Telas de uma execução dos demos. A sua execução gera os próprios números; o que cada tela mostra é o mesmo.

Tempos de build de frame

all_demos_flutter na tela “Metric” de flutter.frame.build, como mapa de calor: quatro minutos de frames, com a linha do p95 subindo ao longo da execução.
all_demos_flutter na tela “Metric” de flutter.frame.build, como mapa de calor: quatro minutos de frames, com a linha do p95 subindo ao longo da execução.

Saúde das versões

Traces filtrados pelos spans flutter.session do demo de saúde das versões, um por sessão. O vermelho é a sessão que teve crash.
Traces filtrados pelos spans flutter.session do demo de saúde das versões, um por sessão. O vermelho é a sessão que teve crash.

Inicialização do app

A tela “Metric” de flutter.app.startup.duration, como mapa de calor: três inicializações a frio de cerca de 2,2 s e duas inicializações a quente de 33 e 63 ms.
A tela “Metric” de flutter.app.startup.duration, como mapa de calor: três inicializações a frio de cerca de 2,2 s e duas inicializações a quente de 33 e 63 ms.

Instabilidade de rede

Traces filtrados por dartastic.network.flaky = true: duas requisições instáveis, uma que levou 6,56 s e outra de 114 ms que terminou em erro.
Traces filtrados por dartastic.network.flaky = true: duas requisições instáveis, uma que levou 6,56 s e outra de 114 ms que terminou em erro.

Interaction to Next Paint

A tela “Metric” de flutter.experience.inp, como mapa de calor: oito interações, duas abaixo de 16 ms e seis entre 200 e 250 ms.
A tela “Metric” de flutter.experience.inp, como mapa de calor: oito interações, duas abaixo de 16 ms e seis entre 200 e 250 ms.

First Contentful Paint

A tela “Metric” de flutter.experience.fcp: uma first contentful paint, em 2,67 s.
A tela “Metric” de flutter.experience.fcp: uma first contentful paint, em 2,67 s.

App Not Responding, como eventos

Logs filtrados pelos eventos dartastic.app.anr de anr_demo_flutter: três ANRs, contados em “Unspecified” porque um evento não tem severidade, e cada linha mostrando o nome do evento.
Logs filtrados pelos eventos dartastic.app.anr de anr_demo_flutter: três ANRs, contados em “Unspecified” porque um evento não tem severidade, e cada linha mostrando o nome do evento.

App Not Responding, duração

Os mesmos três ANRs na tela “Metric” de flutter.anr.duration: cada um de 6,0 a 6,6 s, no momento em que foi exportado.
Os mesmos três ANRs na tela “Metric” de flutter.anr.duration: cada um de 6,0 a 6,6 s, no momento em que foi exportado.

Encerramentos de app no MetricKit do iOS

A tela “Metric” de dartastic.app.exit.count, como barras: 50 encerramentos em um único intervalo de cinco minutos, 43 normais, 3 por falta de memória, 3 por watchdog e 1 por timeout.
A tela “Metric” de dartastic.app.exit.count, como barras: 50 encerramentos em um único intervalo de cinco minutos, 43 normais, 3 por falta de memória, 3 por watchdog e 1 por timeout.