Dartastic e o open source
A Dartastic.io está comprometida em zelar pelo padrão OpenTelemetry para Dart e Flutter. Além de doar o dartastic_opentelemetry open source à CNCF, nosso fundador é mantenedor no SIG de Dart e Flutter do OpenTelemetry. Mantemos centenas de packages de integração OTel, uma documentação extensa e demos de exemplo de OpenTelemetry para Dart e Flutter. Convidamos a comunidade a participar, trabalhando juntos para construir um OpenTelemetry open source de primeira linha para Dart e Flutter.
Sobre o OpenTelemetry
O OpenTelemetry (OTel) é o segundo projeto mais ativo da Cloud Native Computing Foundation (CNCF), atrás apenas do Kubernetes. Ele oferece um conjunto de APIs, SDKs e ferramentas para coletar e exportar dados de telemetria (métricas, logs e traces) que ajudam a analisar o desempenho e o comportamento do software.
Especificação do OpenTelemetry
Nossas implementações para Dart e Flutter seguem a especificação oficial do OpenTelemetry, que define requisitos e expectativas comuns a todas as linguagens para todas as implementações do OTel. Saiba mais em:
Doação à CNCF
Os packages API e SDK do Dartastic OpenTelemetry para Dart e Flutter estão em processo de doação à Cloud Native Computing Foundation (CNCF). Se aceitos, eles passam a ser os SDKs oficiais do OpenTelemetry para a linguagem Dart.
A doação é acompanhada na issue do OpenTelemetry “[Donation Proposal]: Dart SDK and API for OpenTelemetry”. O processo está avançado e dentro do previsto. Ele conta com representantes do Governance Committee e do Technical Committee do OpenTelemetry, e com mantenedores, aprovadores e contribuidores com sólida experiência em OTel, Dart e Flutter.
Estamos em uma posição forte, mas ainda há obstáculos a superar. Os principais: a revisão do Technical Committee quanto à conformidade com a especificação, uma adoção mais ampla pelo mercado e o crescimento contínuo da equipe de contribuidores.
Grupo de Interesse Especial (SIG) de Dart e Flutter do OpenTelemetry
O OpenTelemetry organiza o trabalho de cada linguagem e plataforma em Grupos de Interesse Especial (SIGs). A chamada de contribuidores para o OpenTelemetry de Dart e Flutter está aberta! A comunidade OpenTelemetry de Dart e Flutter é jovem e está crescendo. Procuramos contribuidores comprometidos em garantir uma implementação do OpenTelemetry para Dart e Flutter de alta qualidade e em conformidade com a especificação. O esforço é global, inclusivo e respeitoso. Temos contribuidores do mundo todo, de estudantes universitários a pessoas perto da aposentadoria. Veja o Guia para novos contribuidores e o Código de Conduta.
Estratégia open source
A estratégia open source da Dartastic.io é simples e ética. Houve muitos casos de fornecedores comerciais que mudaram as regras do open source no meio do caminho, alguns na área de observabilidade. A Dartastic.io não faz jogo com o open source, nunca. Michael Bushe, fundador da Dartastic.io, pratica yoga a vida toda e medita diariamente há muitas décadas. Ele trata a ética como uma questão pessoal e cármica. Ele vive os Yamas, a ética do yoga, em todos os assuntos pessoais e de negócios. Isso inclui veracidade, sinceridade, não roubar e não possessividade. Temos orgulho de apoiar as comunidades Dart, Flutter e OpenTelemetry e somos gratos pela oportunidade de retribuir. A Dartastic.io oferece o Free Private Pub à comunidade para ajudar projetos Dart e Flutter a sair do papel com colaboração em equipe.
Os produtos da Dartastic.io se sustentam sozinhos e complementam o extenso trabalho open source doado à comunidade. Os SDKs Dartastic Native OTel vão além do que o Dart consegue fazer. Eles servem de base para implementar recursos fora da especificação, e esses recursos voltam para a comunidade OpenTelemetry. O Dartastic Observatory e o Dartastic Symbolizer são ótimos produtos por si mesmos e complementam a oferta open source.
Por fim, o OpenTelemetry é mais padronizado do que a maioria dos padrões: as APIs são quase iguais entre as linguagens. O resultado (a telemetria) é o mesmo entre os SDKs das linguagens e as plataformas OTel. O formato das bibliotecas Contrib no Dartastic Labs é parecido. As convenções semânticas permeiam tudo. Talvez o maior valor que a Dartastic.io oferece, e a base sobre a qual ela se apoia, seja manter um conjunto consistente de packages (open source e nativos), demos e ferramentas como o Dartastic Observatory e o Dartastic Symbolizer, mantidos atualizados e consistentes com a especificação do OpenTelemetry.
Projetos open source
API OpenTelemetry
A especificação do OpenTelemetry separa a API do SDK. O dartastic_opentelemetry_api normalmente não é usado diretamente por desenvolvedores de aplicações. Todos os símbolos relevantes são exportados pelo SDK dartastic_opentelemetry. Para desenvolvedores de aplicações, os aspectos mais importantes da API são as convenções semânticas.
Por exemplo, se você está criando um app que usa geolocalização, pode usar a semântica de telemetria geográfica padrão nos atributos do span. Você pode usar os enums da API Geo.geoLocationLat ('geo.location.lat') e Geo.geoLocationLon ('geo.location.lon'), ou talvez Geo.geoCountryIsoCode ('geo.country.iso_code').
Uma API pode ser instalada sem um SDK, mas sozinha ela oferece apenas uma implementação noop. dartastic_opentelemetry_api é uma API OpenTelemetry para Dart. Ela oferece as classes OTel noop principais. Todas as classes da API são reexportadas pelo SDK, então a API não precisa ser incluída no pubspec.yaml.
SDK OpenTelemetry
O SDK dartastic_opentelemetry dá vida à API OTel ao implementar exporters, amostradores e métricas do OTel.
O SDK pode ser usado por apps Flutter, serviços de backend em Dart, CLIs ou em qualquer lugar onde o Dart é usado. Ele roda em todas as plataformas Dart e Flutter, mobile, desktop e web, incluindo WASM.
O SDK facilita o uso do OTel e oferece a programação OTel padrão com uma cara familiar de Dart. O uso começa pelos métodos estáticos da classe OTel. OTel.initialize() é a primeira chamada, e OTel.getTracer é usado para criar Spans.
O SDK está pronto para produção e é usado por milhares de organizações. Ele tem documentação completa e uma excelente cobertura de testes. No momento, há lacunas de conformidade que a equipe está fechando, mas elas raramente causam problemas no uso normal.
Dart OTel Reference Demo
O Dart OTel Reference Demo é a referência para exemplos e boas práticas de OTel em Dart e Flutter, para pessoas e para IA. A documentação e os exemplos são bem completos. Os exemplos usam um backend de observabilidade open source local no Docker, com dashboards adicionais para que os desenvolvedores vejam os traces, as métricas e os logs enquanto rodam cada exemplo.
A demo principal é uma demo de previsão do tempo com tracing distribuído que percorre toda a stack Dart: aplicações de servidor Dart instrumentadas, CLIs, apps Flutter e Cloud Run / Cloud Functions, com um serviço de previsão do tempo que propaga um único trace por todos os saltos.
A demo inclui padrões de teste que exercitam o SDK real em vez de mocks, para mostrar como escrever testes para código que usa OTel.
O Dart OTel Reference Demo é diferente do Dartastic OTel Reference Demo da Dartastic.io, que é parecido, porém muito maior, e pode ser baixado no Control Room. Ele demonstra todos os recursos do Dartastic Native OTel e aponta para dashboards disponíveis apenas no Dartastic Observatory.
Flutterrific OTel SDK
O Flutterrific OTel SDK está em transformação no momento. O Dartastic OTel SDK pode ser usado com Flutter e, de fato, o Dart OTel Reference Demo tem exemplos de uso do dartastic_opentelemetry com Flutter.
A nova intenção do Flutterrific OTel é acompanhar a especificação Client OTel, que está começando a se formar. Como especificações levam tempo, ele não é recomendado, exceto para quem trabalha na especificação Client OTel. É possível, talvez provável, que a especificação Client OTel seja incorporada ao dartastic_opentelemetry.
A intenção original do Flutterrific era ser um package pequeno sobre o dartastic_opentelemetry. Em vez disso, os recursos estão indo para outros lugares: alguns estão na Dartastic, outros dão lugar a packages Contrib como otel_go_router.
Wondrous OTel Demo
O Wondrous OTel Demo também precisa de atenção. Ele está desatualizado; a ideia é que seja mais uma demo de OTel para Flutter, baseada no app Wondrous da gskinner. Ele melhora o app Wondrous ao adicionar um widget de previsão do tempo, para se alinhar ao trace distribuído de previsão do tempo do Dart OTel Reference Demo depois de atualizado. Contribuições são bem-vindas. É uma forma divertida de aprender sobre OTel e apoiar a comunidade.
Dartastic Labs open source (Contrib)
O Dartastic Labs facilita a adoção do OpenTelemetry com packages open source que enviam telemetria a partir de packages de uso comum. Cada wrapper otel_* adiciona spans, atributos das convenções semânticas e propagação de contexto a packages de terceiros, para que você tenha traces, métricas e logs sem reescrever seu app. Todos os packages open source do Dartastic Labs são Apache 2.0 e gratuitos para sempre, publicados no pub.dev pelo publisher verificado dartastic.io.
O Dartastic Labs também oferece mais de 600 wrappers para packages comerciais, incluídos na maioria das assinaturas da Dartastic. Muitos deles devem passar a ser open source no pub.dev.
| Package | pub.dev | Repositório |
|---|---|---|
otel_amqp | pub.dev | GitHub |
otel_auto_route | pub.dev | GitHub |
otel_bloc | pub.dev | GitHub |
otel_chopper | pub.dev | GitHub |
otel_cloud_firestore | pub.dev | GitHub |
otel_cloud_functions | pub.dev | GitHub |
otel_command_it | pub.dev | GitHub |
otel_connectivity_plus | pub.dev | GitHub |
otel_dio | pub.dev | GitHub |
otel_drift | pub.dev | GitHub |
otel_fimber | pub.dev | GitHub |
otel_firebase_analytics | pub.dev | GitHub |
otel_firebase_auth | pub.dev | GitHub |
otel_flutter_bloc | pub.dev | GitHub |
otel_flutter_command | pub.dev | GitHub |
otel_flutter_local_notifications | pub.dev | GitHub |
otel_flutter_riverpod | pub.dev | GitHub |
otel_flutter_secure_storage | pub.dev | GitHub |
otel_get_it | pub.dev | GitHub |
otel_get_storage | pub.dev | GitHub |
otel_go_router | pub.dev | GitHub |
otel_google_sign_in | pub.dev | GitHub |
otel_graphql | pub.dev | GitHub |
otel_graphql_flutter | pub.dev | GitHub |
otel_grpc | pub.dev | GitHub |
otel_hive | pub.dev | GitHub |
otel_http | pub.dev | GitHub |
otel_isar | pub.dev | GitHub |
otel_logger | pub.dev | GitHub |
otel_logging | pub.dev | GitHub |
otel_loggy | pub.dev | GitHub |
otel_mobx | pub.dev | GitHub |
otel_mongodb | pub.dev | GitHub |
otel_mqtt_client | pub.dev | GitHub |
otel_mysql | pub.dev | GitHub |
otel_postgres | pub.dev | GitHub |
otel_provider | pub.dev | GitHub |
otel_redis | pub.dev | GitHub |
otel_redux | pub.dev | GitHub |
otel_riverpod | pub.dev | GitHub |
otel_serverpod | pub.dev | GitHub |
otel_shared_preferences | pub.dev | GitHub |
otel_shelf | pub.dev | GitHub |
otel_simple_logger | pub.dev | GitHub |
otel_socket_io_client | pub.dev | GitHub |
otel_sqflite | pub.dev | GitHub |
otel_talker | pub.dev | GitHub |
otel_url_launcher | pub.dev | GitHub |
otel_watch_it | pub.dev | GitHub |
otel_web_socket_channel | pub.dev | GitHub |
otel_workmanager | pub.dev | GitHub |
BIBLIOTECAS DE INSTRUMENTAÇÃO
Dartastic LabsBeta
Adote o OTel sem esperar pelos fornecedores.
- 650 packages de integração
otel_*, mantidos como um conjunto coerente segundo o padrão OpenTelemetry e as convenções semânticas mais recentes do OpenTelemetry. - Mais de 50 integrações open source no pub.dev: packages Dart e Flutter populares, incluindo shelf, dio, gerenciamento de estado e loggers.
- 600 integrações Pro no seu Dartastic Pub privado: Anthropic, OpenAI, AWS, Azure, GCP, Kafka, Okta, Stripe, Supabase e mais.
- Integrações com fornecedores de observabilidade para Sentry, Datadog e New Relic: temos como fazê-los falar OTel.
+ 96 categorias
O Dartastic Labs está incluído em todas as assinaturas OTel: OTel Dev, OTel Pro e todas as assinaturas do Dartastic Observatory. O Dartastic Labs facilita a migração e a integração com o OTel. Instrumente de forma simples os packages Dart e Flutter que você já usa. A Dartastic.io mantém mais de 50 wrappers otel_* open source no pub.dev (Apache 2.0, gratuitos para sempre), além de 600 packages Pro no seu Dartastic Pub privado, que produzem automaticamente OpenTelemetry em conformidade para packages comerciais como Auth, APIs de IA, Stripe, Geo e muitos serviços de nuvem.
E ele se mantém atualizado: lançamos novos wrappers otel_* conforme o ecossistema Dart e Flutter evolui, para que sua instrumentação acompanhe sua stack. Categorias abaixo.
Convidamos mantenedores de projetos open source e fornecedores a trabalhar conosco para oferecer OpenTelemetry padrão e completo ao ecossistema Dart e Flutter.
649 packages em 101 categorias
Pronto para adicionar observabilidade ao seu app?
Crie uma conta gratuita e comece a monitorar seus apps Flutter hoje.