Visão geral
A Dartastic mostra o que seus apps Dart e Flutter realmente fazem nas mãos dos seus usuários e ajuda você a corrigir o que dá errado. Esta página é o mapa. Leia uma vez e depois siga Primeiros passos passo a passo.
A plataforma
Toda página de Ajuda mostra esta mesma imagem, com as partes que ela aborda em destaque, para você sempre saber onde está.
- Você faz o build no seu computador e no seu CI. Seu app obtém os packages da Dartastic do Dartastic Pub, do mesmo jeito que obtém packages do pub.dev.
- Seu app roda em celulares e desktops, em navegadores e como servidores Dart. Os packages Dartastic OTel dentro dele registram o que acontece e enviam tudo para o Observatory.
- Quando algo quebra, o Symbolizer transforma o crash de volta no seu arquivo e na sua linha, usando os símbolos que você publicou no Pub com seu app.
- Quando você quer saber o porquê, você pergunta à Dartastic AI. Ela lê a telemetria e seu código-fonte no Pub e responde com a causa e uma correção.
- O Control Room é onde você configura tudo isso: ele cria os tokens que abrem cada seta do diagrama.
As peças
| Peça | O que faz | Onde você encontra |
|---|---|---|
| Control Room | Sua conta. Aqui você cria tokens, convida colegas de equipe, escolhe seu plano e baixa o Reference Demo. | dartastic.io/control-room, depois de fazer login |
| Dartastic Pub | Um repositório de packages privado que funciona como o pub.dev. Você obtém dele os packages da Dartastic, mantém nele seus próprios packages privados e publica nele o código-fonte do seu app. | dart pub get, dart pub publish |
| Dartastic OTel | Os packages que você adiciona ao seu app. Eles registram o que acontece nele (telas, toques, chamadas de rede, erros, crashes, desempenho) como OpenTelemetry e enviam esses dados. | Seu pubspec.yaml e seu main() |
| Observatory | Onde você olha. Sessões com replay, traces, logs, métricas, crashes, dashboards e alertas de tudo o que seus apps enviam. | Aberto pelo Control Room |
| Symbolizer | Transforma os stack traces ilegíveis de um build de release ofuscado de volta nos nomes dos seus arquivos e nos números de linha. Ele roda sozinho, à medida que os crashes chegam. | Nada para chamar: ele lê os símbolos que você publica no Pub |
| Dartastic AI | Responde a perguntas sobre seu app em linguagem natural. Ela lê sua telemetria e seu código-fonte no Pub, encontra a causa e propõe a correção. | O botão “Ask” no Observatory e no Control Room |
O que você vê
Este é o Observatory. Cada sessão dos seus usuários aparece na lista com suas telas, toques, erros e sinais de frustração:

Abra uma e assista ao replay. Sob o indicador de reprodução você vê o trace, os logs e o erro daquele momento, e pode ir direto para a linha de código:

Tokens conectam as peças
Cada seta do diagrama precisa do seu próprio tipo de token. Você os cria no Control Room, e cada um é mostrado uma única vez, então copie-o assim que criá-lo. A maioria dos desenvolvedores nunca usou um token com o dart pub; a página Pub mostra o passo a passo.
| Token | De | Para | O que permite |
|---|---|---|---|
| Token do Pub | Seu computador | Dartastic Pub | dart pub get pode baixar os packages da Dartastic e os seus privados; dart pub publish pode fazer upload. |
| Troca no CI | Seu CI | Dartastic Pub | Seu CI lê e publica packages sem nenhum token armazenado nele. |
| Token OTLP | Seu app em um celular ou desktop, seu servidor Dart | Observatory | Seu app pode enviar telemetria. |
| Token Browser OTLP | Seu app Flutter web | Observatory | Seu app web pode enviar telemetria, apenas a partir dos sites que você listar. |
Todos os seus tokens aparecem em uma única tela. Tokens explica cada tipo e como revogar ou substituir um token.
Onde roda: seu plano
- O Cloud roda em uma infraestrutura que a Dartastic compartilha entre clientes. Seu Pub é
pub.dartastic.io. - O Dedicated dá à sua organização um servidor próprio, em um subdomínio que você escolhe: seu Pub é
pub.<subdomain>.dartastic.io. - O Self-Hosted roda a plataforma inteira dentro da sua própria rede.
Os passos são os mesmos em todos os planos. Onde uma URL muda, estas páginas mostram as duas. Comparar os planos.
Do que você precisa
- Flutter 3.44 e Dart 3.12 ou mais recentes para todos os recursos; Flutter 3.22 e Dart 3.4 para todos, exceto as métricas do Flutter. Quais versões cada package exige.
- Uma conta Dartastic: o cadastro é gratuito. O cadastro inicia sua organização no Cloud Free, sem cartão.
- Apenas para o backend de clima do Reference Demo: Docker.
Como aprender
Use o que for melhor para você; todos cobrem o mesmo conteúdo.
- Leia estas páginas em ordem. Os links “Anterior” e “Próxima”, no fim de cada página, guiam você.
- Rode o Dartastic OTel Reference Demo. Ele é a versão comercial ampliada do Dart OTel Reference Demo open source: muito mais demos, apps Flutter funcionais que mostram como usar cada recurso da Dartastic, com a configuração já feita. Leia o código, copie trechos dele ou aponte seu assistente de programação com IA para ele. Obter o Reference Demo.
- Pergunte: o Suporte responde às suas perguntas.
Termos usados nestas páginas
- OpenTelemetry (OTel)
- O padrão aberto para registrar o que um software faz. A Dartastic segue esse padrão de ponta a ponta, então nada do que você escreve fica preso à Dartastic.
- OTLP
- O formato de transmissão do OpenTelemetry: como seu app envia o que registrou.
- Trace e span
- Um span é uma unidade de trabalho cronometrada (um toque, uma chamada de rede, uma consulta ao banco de dados). Um trace é a árvore de spans de uma operação, mesmo quando ela atravessa seu app e seu servidor.
- Log
- Uma linha de texto que seu app escreveu, ligada ao trace em que aconteceu.
- Métrica
- Um número medido ao longo do tempo: tempos de frame, memória, contagem de requisições.
- Sessão
- A visita de uma pessoa ao seu app, da abertura até a saída, com cada tela, toque, erro e trace dela.
- Replay
- Assistir de novo a uma sessão. Você escolhe quanto é capturado: uma linha do tempo de eventos, um wireframe ou os pixels reais.
- RUM
- Real User Monitoring (monitoramento de usuários reais): telemetria das pessoas que realmente usam seu app, e não de testes.
- Ofuscação e símbolos
- Um build de release pode embaralhar seus nomes (flutter build --obfuscate). O arquivo de símbolos que ele grava (--split-debug-info) é a chave para desembaralhá-los.
- Token
- Uma string secreta longa que permite que uma coisa converse com outra. Cada tipo abre um caminho no diagrama acima.