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:

Os três sinais

O OpenTelemetry registra três tipos de dados, chamados sinais:

Traces
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.
Métricas
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.
Logs
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.

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

Você chega ao Control Room. Organization mostra o nome e o id da sua organização.

2. Baixar o Reference Demo

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.

  1. No Control Room, vá para Tokens:
    A tela “Tokens” do Control Room: “Generate Token”, com “+ Pub”, “+ Symbolizer”, “+ OTLP” e “+ Browser OTLP”
  2. Crie um token do Pub: clique em + Pub. A janela se abre:
    A janela “Generate Pub Token”: “Name”, o que o token concede, a organização e “Allow write (publish) access”
    • 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.
  3. Clique em Generate. Seu token é mostrado uma única vez:
    O novo token do Pub: seu “Token ID”, o token secreto com um botão de copiar, o comando dart pub token add e “Granted scopes: Pub”
    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.
  4. 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.
  5. 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:

shell
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer <your OTLP token>"

5. Rodar o demo

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.

Próximos passos