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.
Baixar o demo
Faça login no Control Room e clique em Reference Demo no topo de qualquer tela, ao lado de “Help”:

O download é dartastic-otel-reference-demo-<version>.tar.gz. Descompacte-o onde você guarda seu código:
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:
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.
| Token | Necessário para |
|---|---|
Token do Pubdart pub token add (uma vez) | Todos os demos: flutter pub get resolve os packages a partir do seu Dartastic Pub. |
Token OTLPOTEL_EXPORTER_OTLP_HEADERS | Todos os demos: os apps enviam a telemetria para o seu Observatory. |
Token do SymbolizerDARTASTIC_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:
flutter pub getSe der certo, seu Dartastic Pub e seu token do Pub funcionam. Depois, inicie um app; tool/launch.sh pergunta em qual dispositivo rodar:
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_fluttereall_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
| App | O que mostra |
|---|---|
weather_flutter | Um 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_flutter | Quase todos os demos, cada um como uma aba em um único app. |
rum_demo_flutter | Sessões, visualizações de tela, toques e sinais de frustração, com replay de sessão. |
crash_demo_flutter | Crashes registrados e entregues mesmo quando o app morre. |
symbolizer_demo_flutter | Um build de release ofuscado cujos stack traces voltam como seus arquivos e linhas, e jank rastreado até o widget. |
anr_demo_flutter | Detecção de “o app não está respondendo” (ANR). |
pii_demo_flutter | Como manter dados pessoais fora da sua telemetria. |
webview_demo_flutter | Telemetria de uma página web dentro do seu app, unida ao trace do app. |
| Métricas vitais da plataforma | Saú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

Saúde das versões

Inicialização do app

Instabilidade de rede

Interaction to Next Paint

First Contentful Paint

App Not Responding, como eventos

App Not Responding, duração

Encerramentos de app no MetricKit do iOS
