Dartastic开源
Dartastic.io面向Dart和Flutter,致力于守护OpenTelemetry标准。除了将开源的dartastic_opentelemetry捐赠给CNCF之外,我们的创始人还是OpenTelemetry Dart和Flutter SIG的维护者(Maintainer)。我们维护着数百个OTel集成package,以及面向Dart和Flutter上OpenTelemetry的详尽文档和示例演示。我们诚邀社区参与,携手为Dart和Flutter打造一流的开源OpenTelemetry。
关于OpenTelemetry
OpenTelemetry(OTel)是云原生计算基金会(CNCF)中活跃度仅次于Kubernetes的项目。它提供一套API、SDK和工具,用于采集和导出遥测数据(指标、日志和链路),帮助分析软件的性能和行为。
OpenTelemetry规范
我们的Dart和Flutter实现遵循官方OpenTelemetry规范,该规范为所有OTel实现定义了跨语言的要求和预期。了解详情:
捐赠给CNCF
面向Dart和Flutter的Dartastic OpenTelemetry API和SDK package正在捐赠给云原生计算基金会(CNCF)。若获接受,它们即成为Dart语言的官方OpenTelemetry SDK。
捐赠进展在OpenTelemetry的Issue“[Donation Proposal]: Dart SDK and API for OpenTelemetry”中跟踪。流程已进入后期,进展顺利。OpenTelemetry治理委员会和技术委员会均有代表参与。参与者包括在OTel、Dart和Flutter方面经验丰富的维护者、审批者和贡献者。
我们处于有利位置,但仍有一些障碍需要跨越。最重要的是:技术委员会的规范合规性审查、更广泛的行业采用,以及贡献者团队的持续壮大。
OpenTelemetry Dart和Flutter特别兴趣小组
OpenTelemetry将各语言和平台的工作组织为特别兴趣小组(SIG)。Dart和Flutter OpenTelemetry贡献者招募已开放!Dart和Flutter的OpenTelemetry社区刚刚起步,正在成长。我们正在寻找致力于为Dart和Flutter打造高质量、符合规范的OpenTelemetry实现的贡献者。这项工作面向全球,包容且相互尊重。我们的贡献者来自世界各地,从大学生到临近退休的人都有。请参阅新贡献者指南和行为准则。
开源策略
Dartastic.io的开源策略简单而合乎道德。商业厂商在开源上出尔反尔的事例屡见不鲜,其中一些就发生在可观测性领域。Dartastic.io绝不会在开源上玩花样。Dartastic.io的创始人Michael Bushe是一位终身瑜伽修习者,数十年来每天冥想。他将道德视为个人和业力层面的事。在所有个人和商业事务中,他都践行持戒(Yamas),即瑜伽的道德准则,包括真实、真诚、不偷盗和不占有。我们很自豪能够支持Dart、Flutter和OpenTelemetry社区,也感激有机会回馈社区。Dartastic.io向社区提供Free Private Pub,帮助Dart和Flutter项目借助团队协作起步。
Dartastic.io的产品各自独立成立,并与捐赠给社区的大量开源工作相辅相成。Dartastic Native OTel SDK超越了Dart本身的能力。它们是实现规范之外功能的试验场,其成果也回馈给上游的OpenTelemetry社区。Dartastic Observatory和Dartastic Symbolizer本身就是优秀的产品,并与开源产品相辅相成。
最后,OpenTelemetry比大多数标准都更加标准:各语言的API几乎相同。输出(即遥测数据)在各语言SDK和OTel平台之间完全一致。Dartastic Labs中Contrib库的结构也相似。语义约定贯穿其中。Dartastic.io提供的最大价值,也是它赖以立足的基础,或许正是维护一套一致的package(开源package和原生package、演示,以及Dartastic Observatory和Dartastic Symbolizer等工具),并使它们与OpenTelemetry规范保持同步和一致。
开源项目
OpenTelemetry API
OpenTelemetry规范将API与SDK分离。应用开发者通常不会直接使用dartastic_opentelemetry_api。所有相关符号都由dartastic_opentelemetry SDK导出。对应用开发者而言,API最重要的部分是语义约定。
例如,如果您正在开发使用地理定位的应用,可以在Span的属性中使用标准的地理遥测语义约定 。您可以使用API的枚举Geo.geoLocationLat('geo.location.lat')和Geo.geoLocationLon('geo.location.lon'),或者Geo.geoCountryIsoCode('geo.country.iso_code')。
API可以在没有SDK的情况下安装,但单独使用时只提供空操作(noop)实现。dartastic_opentelemetry_api是Dart的OpenTelemetry API,提供核心的noop OTel类。所有API类都由SDK重新导出,因此无需在pubspec.yaml中引入API。
OpenTelemetry SDK
dartastic_opentelemetry SDK实现了OTel导出器、采样器和指标,让OTel API真正运转起来。
该SDK可用于Flutter应用、Dart后端服务、CLI,以及任何使用Dart的地方。它可在所有Dart和Flutter平台上运行:移动端、桌面端和Web,包括WASM。
该SDK让OTel易于使用,以熟悉的Dart风格提供标准的OTel编程方式。使用从OTel类的静态方法开始。OTel.initialize()是第一个调用,OTel.getTracer用于创建Span。
该SDK已可用于生产环境,被数千个组织使用。它有详尽的文档和出色的测试覆盖率。目前仍存在一些合规性差距,团队正在逐步弥补,但在常规使用中很少造成问题。
Dart OTel Reference Demo
Dart OTel Reference Demo是面向人类和AI的Dart和Flutter OTel示例与最佳实践的首选资源。其文档和示例相当详尽。示例使用在Docker中运行的本地开源可观测性后端,并附带额外的仪表板,让开发者在运行每个示例时都能看到链路、指标和日志。
主演示是一个贯穿整个Dart技术栈的分布式链路天气演示:经过插桩的Dart服务器应用、CLI、Flutter应用以及Cloud Run / Cloud Functions,其中的天气服务将一条链路传播到每一跳。
该演示还包含完整的测试模式,它们使用真实的SDK而非mock,演示如何为使用OTel的代码编写测试。
Dart OTel Reference Demo不同于Dartastic.io的Dartastic OTel Reference Demo,后者与之类似但规模大得多,可以从Control Room下载。它演示了Dartastic Native OTel的所有功能,并指向仅在Dartastic Observatory中提供的仪表板。
Flutterrific OTel SDK
Flutterrific OTel SDK目前处于变动之中。Dartastic OTel SDK可以用于Flutter,事实上Dart OTel Reference Demo中就有在Flutter中使用dartastic_opentelemetry的示例。
Flutterrific OTel的新目标是遵循正在形成的Client OTel规范。由于规范的制定需要时间,除参与Client OTel规范工作的人员外,不建议使用它。Client OTel规范有可能(甚至很可能)被并入dartastic_opentelemetry。
Flutterrific最初的目标是成为构建在dartastic_opentelemetry之上的一个小型package。但实际上,这些功能正在落地到其他地方:一些已在Dartastic中,另一些则交由otel_go_router等Contrib package承担。
Wondrous OTel Demo
Wondrous OTel Demo也需要一些关爱。它已经过时,其定位是另一个基于gskinner的Wondrous应用的Flutter OTel演示。它在Wondrous应用中添加了一个天气widget,更新后即可与Dart OTel Reference的分布式天气链路保持一致。欢迎贡献者参与。这是学习OTel、支持社区的一种有趣方式。
Dartastic Labs开源项目(Contrib)
Dartastic Labs提供开源package,为常用package发送遥测数据,让采用OpenTelemetry变得简单。每个otel_*封装都会为第三方package添加Span、语义约定属性和上下文传播,让您无需重写应用即可获得链路、指标和日志。所有开源Dartastic Labs package均采用Apache 2.0许可证,永久免费,由经过验证的发布者dartastic.io发布在pub.dev上。
Dartastic Labs还为商业package提供600多个package封装,大多数Dartastic订阅都包含这些封装。其中许多计划在pub.dev上开源。
| Package | pub.dev | 仓库 |
|---|---|---|
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 |
插桩库
Dartastic LabsBeta
无需等待厂商,即可采用OTel。
- 650个
otel_*集成package,作为一致的整体维护,遵循OpenTelemetry标准和最新的OpenTelemetry语义约定。 - pub.dev上的50多个开源集成:涵盖热门的Dart和Flutter package,包括shelf、dio、状态管理和日志库。
- 您的私有Dartastic Pub中的600个Pro集成:Anthropic、OpenAI、AWS、Azure、GCP、Kafka、Okta、Stripe、Supabase等。
- 面向Sentry、Datadog、New Relic的可观测性厂商集成:我们有办法让它们使用OTel。
另有96个分类
Dartastic Labs包含在每个OTel订阅中:OTel Dev、OTel Pro和所有Dartastic Observatory订阅。Dartastic Labs让OTel迁移和集成更轻松,可简单地为您已在使用的Dart和Flutter package插桩。Dartastic.io在pub.dev上维护着50多个开源otel_*封装(Apache 2.0,永久免费),此外您的私有Dartastic Pub中还有600个Pro package,可为Auth、AI API、Stripe、Geo和众多云服务等商业package自动生成合规的OpenTelemetry。
而且它始终保持最新:随着Dart和Flutter生态系统的发展,我们不断发布新的otel_*封装,让您的插桩与技术栈同步。分类见下方。
我们诚邀开源维护者和厂商与我们合作,为Dart和Flutter生态系统提供功能完整的标准OpenTelemetry。
101个分类,共649个package