Do seu primeiro login às respostas sobre seu app em produção.
Estas páginas mostram as URLs do Cloud. Faça login no Dedicated e elas passam a mostrar as do seu servidor.
Primeiros passos
Do primeiro contato com o OpenTelemetry até seu próprio trace no Observatory. Cada passo se apoia no anterior, então siga a ordem.
Sobre o OpenTelemetry
Comece pelo OpenTelemetry
A Dartastic é construída sobre o OpenTelemetry (OTel), o padrão aberto para registrar o que um software faz. A Dartastic segue de perto a especificação do OpenTelemetry: os nomes, os dados e a forma de envio são os do padrão. O que você aprende sobre OpenTelemetry vale para a Dartastic, e o que você constrói com a Dartastic continua sendo OpenTelemetry padrão.
A especificação é acessível. Antes de continuar, dedique uma hora à documentação do OpenTelemetry para ter uma compreensão básica:
O que aconteceu, passo a passo, e quanto tempo cada passo levou. Um trace é uma árvore de spans: um toque, a chamada de rede que ele fez, o trabalho do servidor por trás dessa chamada, a consulta ao banco de dados por baixo dele. Um mesmo trace pode atravessar do seu app para o seu servidor.
Números medidos ao longo do tempo: tempos de frame, memória, requisições por minuto, erros por versão. Custam pouco para manter, então mostram tendências e disparam alertas.
Linhas de texto com um horário e uma severidade. No OpenTelemetry, um log carrega o trace em que foi escrito, então a partir de um log você abre tudo o que aconteceu naquele momento.
Os três carregam um recurso: qual app os enviou, qual versão, em qual dispositivo. A Dartastic acrescenta o monitoramento de usuários reais (sessões, telas, toques e replay), registrado também como sinais padrão. A Visão geral explica os outros termos usados nestas páginas.
1. Fazer login
Fazer login no dartastic.io. Na primeira vez, você configura sua organização: a conta à qual pertencem seus tokens, seus colegas de equipe e seu plano. Se um colega convidou você, faça login com o endereço de e-mail que recebeu o convite e você entra na organização dele.
O cadastro inicia sua organização no Cloud Free, sem cartão. Você informa:
Nome da organização e subdomínio: o nome dela, e o subdomínio para o qual seus apps enviam telemetria. O subdomínio é seu para sempre.
Região: onde sua telemetria é armazenada. Não é possível alterar depois.
Limite de RUM: o nível de replay mais alto que seu motor pode gravar. O Cloud Free vai até Wireframe; Shadow e Pixel estão nos planos pagos. Seu motor é forjado com a sua escolha, e nada no dispositivo consegue ultrapassá-la.
Dartastic AI: funciona com sua própria chave de modelo, que você pode adicionar na hora ou depois.
Para usar só o Dartastic Pub, escolha um plano Pub em Preços antes de se cadastrar. Você dá um nome à sua organização e escolhe a região dela, e nada mais é pedido.
Clique em Reference Demo no topo do Control Room e descompacte o arquivo. Você o roda no passo 5: é a forma mais rápida de ver a Dartastic funcionando, e o código dele mostra como usar cada recurso. Mais sobre o Reference Demo.
3. Conectar o dart pub ao seu Dartastic Pub
Os packages da Dartastic vêm do seu Dartastic Pub, não do pub.dev, e o dart pub precisa de um token para ler dele. A maioria dos desenvolvedores nunca fez isso; leva um minuto, uma vez por computador.
O Dartastic Pub também repassa as requisições ao pub.dev. Declare seus packages no pubspec.yaml como sempre, e os do pub.dev são resolvidos automaticamente a partir do pub.dev, junto com os packages da Dartastic e os seus privados.
Crie um token do Pub: clique em + Pub. A janela se abre:
Name: qualquer nome que diferencie seus tokens; recomendamos pub-org-read-write.
Organization: a organização cujos packages este token lê e publica.
Allow write (publish) access: marque esta opção para publicar no seu Dartastic Pub com este token. Sem ela, o token só pode ler, que é tudo de que o Reference Demo precisa, exceto symbolizer_demo_flutter e crash_demo_flutter, que publicam no seu Pub.
Clique em Generate. Seu token é mostrado uma única vez: Copie o token agora com o botão de copiar: depois que você fechar esta janela, ele não pode ser mostrado de novo. Granted scopes: Pub significa que este token serve apenas para o Pub: ele não pode enviar telemetria nem chamar nenhum outro serviço.
Em um terminal, entregue o token ao dart pub:
shell
dart pub token add https://pub.dartastic.io
Quando ele pedir Enter secret token:, cole o token e pressione Enter. O prompt não mostra nada enquanto você cola; isso é esperado. Ele responde:
terminal
Enter secret token:
Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
Na pasta do Reference Demo, baixe os packages:
shell
flutter pub get
Se der certo, seu Pub e seu token funcionam.
O dart pub guarda o token para esse host e o envia somente para ele. A página Pub explica como listar, substituir e remover tokens, e como publicar.
Quais packages um token do Pub alcança
Um token do Pub alcança os packages que seu dono pode usar, e nada mais.
Os administradores da organização têm todos os packages da organização, então os tokens deles também.
Os demais colegas de equipe só podem criar tokens para os packages que receberam. Um administrador concede packages a um colega.
Veja Convidar colegas para os papéis e Pub para conceder packages aos membros da organização.
4. Permitir que seu app envie telemetria
Em Tokens, crie um token OTLP e exporte-o no seu shell na forma padrão do OpenTelemetry. Mantenha authorization em minúsculas:
Com o Docker rodando, inicie o demo de clima a partir da pasta do Reference Demo e escolha um dispositivo:
shell
tool/launch.sh weather_flutter
Toque para buscar o clima. Esse toque inicia um trace que passa pelo app, pela API de clima, pelo cache dela e pelo serviço de clima externo.
6. Ver no Observatory
Seu toque chega ao Observatory em segundos. O app mostra links para o que enviou: siga o link para abrir o trace e ver cada passo e quanto tempo ele levou.
Usamos cookies essenciais para o funcionamento deste site e cookies de análise somente com o seu consentimento. Consulte nossa Política de Cookies e nossa Política de Privacidade.