Dartasticのオープンソース
Dartastic.ioは、DartとFlutterのためのOpenTelemetry標準の発展と維持に取り組んでいます。オープンソースのdartastic_opentelemetryのCNCFへの寄贈に加え、創業者はOpenTelemetry Dart and Flutter SIGのメンテナーを務めています。私たちは、DartとFlutterのOpenTelemetry向けに、数百のOTel連携パッケージ、充実したドキュメント、サンプルデモを保守しています。コミュニティの皆様の参加を歓迎します。一緒に、DartとFlutterのための一流のオープンソースOpenTelemetryを作り上げましょう。
OpenTelemetryについて
OpenTelemetry(OTel)は、Cloud Native Computing Foundation(CNCF)のプロジェクトの中で、Kubernetesに次いで2番目に活発なプロジェクトです。ソフトウェアのパフォーマンスと動作の分析に役立つテレメトリーデータ(メトリクス、ログ、トレース)を収集、エクスポートするための、API、SDK、ツール群を提供します。
OpenTelemetry仕様
私たちのDartとFlutterの実装は、すべてのOTel実装に対する言語横断の要件と期待を定めた、OpenTelemetryの公式仕様に準拠しています。詳しくは以下をご覧ください:
CNCFへの寄贈
DartとFlutter向けのDartastic OpenTelemetryのAPIパッケージとSDKパッケージは、Cloud Native Computing Foundation(CNCF)への寄贈手続き中です。承認されれば、Dart言語の公式OpenTelemetry SDKになります。
寄贈の進捗は、OpenTelemetryのIssue「[Donation Proposal]: Dart SDK and API for OpenTelemetry」で追跡されています。手続きは大きく進んでおり、順調です。OpenTelemetryのガバナンス委員会と技術委員会のメンバーも関わっています。OTel、Dart、Flutterに豊富な経験を持つメンテナー、承認者、コントリビューターがそろっています。
有利な状況にありますが、まだ越えるべきハードルがあります。最も重要なのは、技術委員会による仕様準拠のレビュー、業界でのさらなる採用、コントリビューターチームの継続的な拡大です。
OpenTelemetry Dart & Flutter Special Interest Group
OpenTelemetryは、言語やプラットフォームごとの取り組みを、Special Interest Group(SIG)として組織しています。Dart and Flutter OpenTelemetryのコントリビューター募集を受け付けています!DartとFlutterのOpenTelemetryコミュニティは、生まれたばかりで成長中です。DartとFlutterのための、高品質で仕様に準拠したOpenTelemetry実装に真剣に取り組むコントリビューターを募集しています。この活動はグローバルで、多様な人を受け入れ、互いを尊重して進められています。大学生から定年間近の方まで、世界中からコントリビューターが参加しています。新規コントリビューターガイドと行動規範をご覧ください。
オープンソース戦略
Dartastic.ioのオープンソース戦略は、シンプルで倫理的です。商用ベンダーがオープンソースの条件を途中で変えてしまう例は数多くあり、オブザーバビリティの分野にもあります。Dartastic.ioが、オープンソースで駆け引きをすることは決してありません。Dartastic.ioの創業者Michael Busheは、生涯にわたりヨガを実践し、何十年も毎日瞑想を続けています。彼は倫理を、個人的でカルマに関わる問題と考えています。私生活と仕事のあらゆる場面で、ヨガの倫理であるヤマ(Yamas)を実践しています。それには、正直さ、誠実さ、盗まないこと、所有に執着しないことが含まれます。私たちは、Dart、Flutter、OpenTelemetryのコミュニティを支援できることを誇りに思い、恩返しの機会に感謝しています。Dartastic.ioは、DartとFlutterのプロジェクトをチームでの共同作業で立ち上げられるよう、Free Private Pubをコミュニティに提供しています。
Dartastic.ioの製品は、それ自体で価値があり、コミュニティに寄贈した幅広いオープンソースの成果を補完します。Dartastic Native OTel SDKは、Dartだけではできないことを実現します。仕様外の機能を実装する場となり、その成果はOpenTelemetryコミュニティのアップストリームへ還元されます。Dartastic ObservatoryとDartastic Symbolizerは、それ自体が優れた製品であり、オープンソースの提供を補完します。
最後に、OpenTelemetryはたいていの標準よりも標準的です:APIは言語間でほぼ同じです。出力(テレメトリー)は、言語ごとのSDKやOTelプラットフォームの間で同じです。Dartastic LabsのContribライブラリの形も似ています。セマンティック規約がそのすべてを貫いています。Dartastic.ioが提供する最大の価値であり、その土台となっているのは、おそらく一貫したパッケージ群の保守です:オープンソースとネイティブのパッケージ、デモ、そしてDartastic ObservatoryやDartastic Symbolizerのようなツールを、常に最新に保ち、OpenTelemetry仕様との一貫性を維持しています。
オープンソースプロジェクト
OpenTelemetry API
OpenTelemetry仕様では、APIとSDKが分離されています。dartastic_opentelemetry_apiは通常、アプリ開発者が直接使うものではありません。関連するシンボルはすべて、dartastic_opentelemetry SDKからエクスポートされています。アプリ開発者にとってAPIで最も重要なのは、セマンティック規約です。
たとえば位置情報を使うアプリを作る場合、スパンの属性に標準の位置情報のセマンティック規約 を使えます。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で、OTelの中核となるnoopクラスを提供します。APIのクラスはすべてSDKから再エクスポートされるため、pubspec.yamlにAPIを含める必要はありません。
OpenTelemetry SDK
dartastic_opentelemetry SDKは、OTelのエクスポーター、サンプラー、メトリクスを実装し、OTel APIを実際に機能させます。
SDKは、Flutterアプリ、Dartのバックエンドサービス、CLIなど、Dartが使われるあらゆる場所で利用できます。モバイル、デスクトップ、Web(WASMを含む)の、すべてのDartとFlutterのプラットフォームで動作します。
SDKを使えばOTelを簡単に利用でき、Dartらしい書き心地で、標準的なOTelのプログラミングができます。使い方はOTelクラスの静的メソッドから始まります。最初に呼ぶのはOTel.initialize()で、Spanの作成にはOTel.getTracerを使います。
SDKは本番環境で使える品質で、数千の組織で使われています。ドキュメントは充実しており、テストカバレッジも優れています。現時点では仕様への準拠に一部ギャップがあり、チームが解消を進めていますが、通常の利用で問題になることはほとんどありません。
Dart OTel Reference Demo
Dart OTel Reference Demoは、人とAIの両方に向けた、DartとFlutterのOTelのサンプルとベストプラクティスの定番です。ドキュメントとサンプルは非常に充実しています。サンプルはDocker上のローカルなオープンソースのオブザーバビリティバックエンドを使い、追加のダッシュボードで、各サンプルを実行しながらトレース、メトリクス、ログを確認できます。
メインのデモは、Dartスタック全体にまたがる分散トレーシングの天気デモです:計装されたDartサーバーアプリ、CLI、Flutterアプリ、Cloud Run / Cloud Functionsで構成され、天気サービスが1つのトレースをすべてのホップに伝播します。
このデモには、OTelを使うコードのテストの書き方を示すため、モックではなく実際のSDKを動かすテストパターンも含まれています。
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には、dartastic_opentelemetryをFlutterで使うサンプルがあります。
Flutterrific OTelの新しい目的は、策定が始まったばかりのClient OTel仕様に準拠することです。仕様の策定には時間がかかるため、Client OTel仕様に取り組んでいる方以外にはおすすめしません。Client OTel仕様はdartastic_opentelemetryに統合される可能性があり、その可能性は高いと考えています。
Flutterrificの当初の目的は、dartastic_opentelemetryの上に載る小さなパッケージになることでした。実際には、機能は別の場所に実装されつつあります。一部はDartasticに入り、一部はotel_go_routerなどのContribパッケージに置き換わる予定です。
Wondrous OTel Demo
Wondrous OTel Demoも手入れが必要です。現在は古くなっていますが、gskinnerのWondrousアプリをベースにした、Flutter向けのもう一つのOTelデモになる予定です。Wondrousアプリに天気ウィジェットを追加しているため、更新されれば、Dart OTel Referenceの分散天気トレースと足並みがそろいます。コントリビューターを歓迎します。OTelを学び、コミュニティを支援する楽しい方法です。
Dartastic Labsのオープンソース(Contrib)
Dartastic Labsは、よく使われるパッケージのテレメトリーを送信するオープンソースパッケージを提供し、OpenTelemetryの導入を簡単にします。各otel_*ラッパーは、サードパーティパッケージにスパン、セマンティック規約に沿った属性、コンテキスト伝播を追加するため、アプリを書き直さずにトレース、メトリクス、ログを取得できます。オープンソースのDartastic LabsパッケージはすべてApache 2.0で永久に無料です。認証済みパブリッシャーdartastic.ioによって、pub.devで公開されています。
Dartastic Labsは、商用パッケージ向けに600以上のパッケージラッパーも提供しており、ほとんどのDartasticサブスクリプションに含まれています。その多くは、今後pub.devでオープンソース化される予定です。
| パッケージ | 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 Labsベータ
ベンダーを待たずにOTelを導入。
- 650の
otel_*統合パッケージ。OpenTelemetry標準と最新のOpenTelemetryセマンティック規約に沿って、一貫したセットとしてメンテナンスしています。 - pub.devで50以上のOSS統合:shelf、dio、状態管理、ロガーなど、人気のDart・Flutterパッケージ。
- プライベートな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のパッケージを、簡単に計装できます。Dartastic.ioは、pub.devで50以上のオープンソースのotel_*ラッパー(Apache 2.0、永久に無料)をメンテナンスしています。さらに、プライベートなDartastic Pubでは600のProパッケージを提供しており、認証、AI API、Stripe、位置情報、多くのクラウドサービスといった商用パッケージに対して、仕様に準拠したOpenTelemetryを自動で生成します。
常に最新の状態を保ちます:DartとFlutterのエコシステムの進化に合わせて新しいotel_*ラッパーをリリースしているため、計装もスタックに遅れずについていけます。カテゴリーは以下のとおりです。
オープンソースのメンテナーやベンダーの皆さまと協力し、DartとFlutterのエコシステムに、機能の揃った標準のOpenTelemetryを届けたいと考えています。
101カテゴリー、649件のパッケージ