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

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

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
  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. O Control Room é onde você configura tudo isso: ele cria os tokens que abrem cada seta do diagrama.

As peças

PeçaO que fazOnde você encontra
Control RoomSua 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 PubUm 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 OTelOs 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()
ObservatoryOnde 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
SymbolizerTransforma 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 AIResponde 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:

A lista “Sessions” do Observatory, uma linha por sessão de usuário

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:

Um replay de sessão com sua linha do tempo, o trace sob o indicador de reprodução e seus logs

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.

TokenDeParaO que permite
Token do PubSeu computadorDartastic Pubdart pub get pode baixar os packages da Dartastic e os seus privados; dart pub publish pode fazer upload.
Troca no CISeu CIDartastic PubSeu CI lê e publica packages sem nenhum token armazenado nele.
Token OTLPSeu app em um celular ou desktop, seu servidor DartObservatorySeu app pode enviar telemetria.
Token Browser OTLPSeu app Flutter webObservatorySeu 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.