Dartastic open source
Dartastic.io è impegnata a custodire lo standard OpenTelemetry per Dart e Flutter. Oltre a donare alla CNCF il pacchetto open source dartastic_opentelemetry, il nostro fondatore è maintainer del SIG OpenTelemetry Dart e Flutter. Manteniamo centinaia di pacchetti di integrazione OTel, un’ampia documentazione e demo di esempio per OpenTelemetry su Dart e Flutter. Invitiamo la community a partecipare, per realizzare insieme un OpenTelemetry open source di prim’ordine per Dart e Flutter.
Informazioni su OpenTelemetry
OpenTelemetry (OTel) è il secondo progetto più attivo della Cloud Native Computing Foundation (CNCF) dopo Kubernetes. Fornisce un insieme di API, SDK e strumenti per raccogliere ed esportare dati di telemetria (metriche, log e tracce) utili ad analizzare le prestazioni e il comportamento del software.
Specifica OpenTelemetry
Le nostre implementazioni per Dart e Flutter seguono la specifica ufficiale OpenTelemetry, che definisce i requisiti e le aspettative comuni a tutti i linguaggi per ogni implementazione OTel. Maggiori informazioni:
Donazione alla CNCF
I pacchetti Dartastic OpenTelemetry API e SDK per Dart e Flutter sono in corso di donazione alla Cloud Native Computing Foundation (CNCF). Se accettati, diventano gli SDK OpenTelemetry ufficiali per il linguaggio Dart.
La donazione è seguita in OpenTelemetry Issue [Donation Proposal]: Dart SDK and API for OpenTelemetry. Il processo è in fase avanzata e procede come previsto. Vi sono rappresentati il Governance Committee e il Technical Committee di OpenTelemetry. Conta su maintainer, approver e contributori con una solida esperienza in OTel, Dart e Flutter.
Siamo in una posizione solida, ma restano ostacoli da superare. Soprattutto: la revisione del Technical Committee per la conformità alla specifica, un’adozione più ampia nel settore e la crescita continua del team di contributori.
Special Interest Group OpenTelemetry Dart e Flutter
OpenTelemetry organizza il lavoro su linguaggi e piattaforme in Special Interest Group (SIG). La ricerca di contributori per OpenTelemetry Dart e Flutter è aperta! La community OpenTelemetry di Dart e Flutter è giovane e in crescita. Cerchiamo contributori impegnati a garantire un’implementazione OpenTelemetry per Dart e Flutter di alta qualità e conforme alla specifica. Il lavoro è globale, inclusivo e rispettoso. Abbiamo contributori da tutto il mondo, dagli studenti universitari a chi è vicino alla pensione. Consulti la guida per i nuovi contributori e il codice di condotta.
Strategia open source
La strategia open source di Dartastic.io è semplice ed etica. Ci sono stati molti voltafaccia sull’open source da parte di fornitori commerciali, alcuni nel settore dell’osservabilità. Dartastic.io non fa giochetti con l’open source, mai. Michael Bushe, fondatore di Dartastic.io, pratica lo yoga da tutta la vita e medita ogni giorno da molti decenni. Per lui l’etica è una questione personale e karmica. Vive gli Yama, i principi etici dello yoga, in ogni ambito personale e professionale: tra questi, veridicità, sincerità, non rubare e non possesso. Siamo orgogliosi di sostenere le community di Dart, Flutter e OpenTelemetry e grati per l’opportunità di restituire qualcosa. Dartastic.io offre alla community Free Pub, un repository Pub privato gratuito, per aiutare i progetti Dart e Flutter a partire con la collaborazione in team.
I prodotti di Dartastic.io valgono di per sé e completano l’ampio lavoro open source donato alla community. Gli SDK Dartastic Native OTel vanno oltre ciò che Dart può fare. Servono da terreno per implementare funzionalità al di fuori della specifica, e i risultati tornano upstream alla community OpenTelemetry. Dartastic Observatory e Dartastic Symbolizer sono ottimi prodotti in sé e completano l’offerta open source.
Infine, OpenTelemetry è più standard della maggior parte degli standard: le API sono quasi identiche tra i linguaggi. L’output, cioè la telemetria, è lo stesso tra gli SDK dei vari linguaggi e le piattaforme OTel. La struttura delle librerie Contrib di Dartastic Labs è simile. Le convenzioni semantiche attraversano tutto. Forse il valore più grande che offre Dartastic.io, e la base su cui poggia, è mantenere un insieme coerente di pacchetti (open source e nativi), demo e strumenti come Dartastic Observatory e Dartastic Symbolizer, aggiornati e coerenti con la specifica OpenTelemetry.
Progetti open source
API OpenTelemetry
La specifica OpenTelemetry separa l’API dall’SDK. Il pacchetto dartastic_opentelemetry_api di norma non viene usato direttamente da chi sviluppa applicazioni. Tutti i simboli rilevanti sono esportati dall’SDK dartastic_opentelemetry. Per chi sviluppa applicazioni, gli aspetti più importanti dell’API sono le convenzioni semantiche.
Ad esempio, se sviluppa un’app che usa la geolocalizzazione, può usare negli attributi dello span le convenzioni semantiche per la geolocalizzazione standard. Può usare gli enum dell’API Geo.geoLocationLat ('geo.location.lat') e Geo.geoLocationLon ('geo.location.lon'), o magari Geo.geoCountryIsoCode ('geo.country.iso_code').
Un’API può essere installata senza un SDK, ma da sola fornisce solo un’implementazione noop. dartastic_opentelemetry_api è un’API OpenTelemetry per Dart. Fornisce le classi OTel noop di base. Tutte le classi dell’API sono riesportate dall’SDK, quindi non serve includere l’API nel pubspec.yaml.
SDK OpenTelemetry
L’SDK dartastic_opentelemetry dà vita all’API OTel implementando exporter, campionatori e metriche OTel.
L’SDK può essere usato da app Flutter, servizi backend Dart, CLI o ovunque si usi Dart. Funziona su tutte le piattaforme Dart e Flutter, mobile, desktop e web, incluso WASM.
L’SDK rende semplice usare OTel e offre una programmazione OTel standard dal sapore familiare per chi usa Dart. Si parte dai metodi statici della classe OTel. OTel.initialize() è la prima chiamata e OTel.getTracer serve a creare oggetti Span.
L’SDK è pronto per la produzione e usato da migliaia di organizzazioni. Ha una documentazione completa e un’eccellente copertura dei test. Al momento ci sono lacune di conformità che il team sta colmando, ma raramente causano problemi nell’uso normale.
Dart OTel Reference Demo
La Dart OTel Reference Demo è il punto di riferimento per esempi e best practice OTel per Dart e Flutter, per persone e IA. La documentazione e gli esempi sono molto completi. Gli esempi usano un backend di osservabilità open source locale in Docker, con dashboard aggiuntive che permettono di vedere tracce, metriche e log mentre si esegue ogni esempio.
La demo principale è una demo meteo con tracciamento distribuito che attraversa tutto lo stack Dart: applicazioni server Dart strumentate, CLI, app Flutter e Cloud Run / Cloud Functions, con un servizio meteo che propaga un’unica traccia attraverso ogni passaggio.
La demo include anche pattern di test che usano il vero SDK invece dei mock, per mostrare come scrivere test per codice che usa OTel.
La Dart OTel Reference Demo è distinta dalla Dartastic OTel Reference Demo di Dartastic.io, simile ma molto più ampia, che si scarica dalla Control Room. Mostra tutte le funzionalità di Dartastic Native OTel e rimanda a dashboard disponibili solo in Dartastic Observatory.
Flutterrific OTel SDK
Il Flutterrific OTel SDK è attualmente in evoluzione. Il Dartastic OTel SDK si può usare con Flutter e, anzi, la Dart OTel Reference Demo contiene esempi di uso di dartastic_opentelemetry con Flutter.
Il nuovo obiettivo di Flutterrific OTel è seguire la specifica Client OTel, in via di definizione. Poiché le specifiche richiedono tempo, se ne sconsiglia l’uso a chi non lavora sulla specifica Client OTel. È possibile, forse probabile, che la specifica Client OTel confluisca in dartastic_opentelemetry.
L’intento originale di Flutterrific era essere un piccolo pacchetto basato su dartastic_opentelemetry. Le funzionalità, invece, stanno trovando posto altrove: alcune sono in Dartastic, altre vengono sostituite da pacchetti Contrib come otel_go_router.
Wondrous OTel Demo
Anche la Wondrous OTel Demo ha bisogno di attenzioni. Non è aggiornata; è un’altra demo OTel per Flutter, basata sull’app Wondrous di gskinner. Arricchisce l’app Wondrous con un widget meteo, per allinearsi, una volta aggiornata, alla traccia meteo distribuita della Dart OTel Reference Demo. I contributori sono benvenuti: è un modo divertente per imparare OTel e sostenere la community.
Dartastic Labs open source (Contrib)
Dartastic Labs rende semplice adottare OpenTelemetry offrendo pacchetti open source che inviano telemetria per i pacchetti più diffusi. Ogni wrapper otel_* aggiunge span, attributi delle convenzioni semantiche e propagazione del contesto ai pacchetti di terze parti, così ottiene tracce, metriche e log senza riscrivere la sua app. Tutti i pacchetti open source di Dartastic Labs sono Apache 2.0 e gratuiti per sempre, pubblicati su pub.dev dal publisher verificato dartastic.io.
Dartastic Labs offre anche oltre 600 wrapper per pacchetti commerciali, inclusi nella maggior parte degli abbonamenti Dartastic. Molti di questi sono destinati a diventare open source su pub.dev.
| Pacchetto | pub.dev | Repository |
|---|---|---|
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 |
LIBRERIE DI STRUMENTAZIONE
Dartastic LabsBeta
Adotti OTel senza aspettare i fornitori.
- 650 pacchetti di integrazione
otel_*, mantenuti come un insieme coerente secondo lo standard OpenTelemetry e le più recenti convenzioni semantiche di OpenTelemetry. - Oltre 50 integrazioni open source su pub.dev: i pacchetti Dart e Flutter più diffusi, tra cui shelf, dio, gestione dello stato e logger.
- 600 integrazioni Pro sul suo Dartastic Pub privato: Anthropic, OpenAI, AWS, Azure, GCP, Kafka, Okta, Stripe, Supabase e altro ancora.
- Integrazioni con i fornitori di osservabilità per Sentry, Datadog, New Relic: abbiamo i nostri metodi per farli parlare OTel.
+ altre 96 categorie
Dartastic Labs è incluso in ogni abbonamento OTel: OTel Dev, OTel Pro e tutti gli abbonamenti Dartastic Observatory. Dartastic Labs semplifica la migrazione e l’integrazione con OTel. Strumenti con semplicità i pacchetti Dart e Flutter che usa già. Dartastic.io mantiene oltre 50 wrapper otel_* open source su pub.dev (Apache 2.0, gratuiti per sempre), più 600 pacchetti Pro sul suo Dartastic Pub privato che producono automaticamente OpenTelemetry conforme per pacchetti commerciali come Auth, API di IA, Stripe, Geo e molti servizi cloud.
E resta aggiornato: rilasciamo nuovi wrapper otel_* man mano che l’ecosistema Dart e Flutter si evolve, così la sua strumentazione tiene il passo con il suo stack. Le categorie sono qui sotto.
Invitiamo maintainer open source e fornitori a collaborare con noi per offrire un OpenTelemetry standard e completo all’ecosistema Dart e Flutter.
649 pacchetti in 101 categorie
Vuole aggiungere l’osservabilità alla sua app?
Si registri per un account gratuito e inizi a monitorare le sue app Flutter oggi stesso.