Dartastic開源
Dartastic.io致力於守護Dart和Flutter的OpenTelemetry標準。除了將開源的dartastic_opentelemetry捐贈給CNCF之外,我們的創辦人也是OpenTelemetry Dart與Flutter SIG的Maintainer。我們維護數百個OTel整合套件,以及關於在Dart和Flutter上使用OpenTelemetry的豐富文件和範例示範。我們邀請社群一同參與,攜手為Dart和Flutter打造一流的開源OpenTelemetry。
關於OpenTelemetry
OpenTelemetry(OTel)是Cloud Native Computing Foundation(CNCF)中活躍程度僅次於Kubernetes的專案。它提供一組API、SDK和工具,用於收集及匯出遙測資料(指標、記錄和追蹤),協助分析軟體的效能和行為。
OpenTelemetry規格
我們的Dart和Flutter實作遵循官方OpenTelemetry規格,該規格定義了所有OTel實作的跨語言需求和預期行為。詳情請參閱:
捐贈給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特別興趣小組
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提供的最大價值,或許也是其立足的基礎,就是維護一套一致的套件:開源與原生套件、示範,以及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真正運作。
Flutter應用程式、Dart後端服務、CLI,或任何使用Dart的地方都能使用此SDK。它可在所有Dart和Flutter平台上執行,包括行動裝置、桌面和Web,也包括WASM。
此SDK讓OTel易於使用,以熟悉的Dart風格提供標準的OTel程式設計方式。使用方式從OTel類別的靜態方法開始。第一個呼叫是OTel.initialize(),而OTel.getTracer用來建立Span。
此SDK已可用於正式環境,有數千個組織在使用。它有完整的文件和優異的測試涵蓋率。目前仍有一些合規缺口,團隊正在補齊,但在一般使用中很少造成問題。
Dart OTel Reference Demo
Dart OTel Reference Demo是Dart和Flutter OTel範例與最佳做法的首選資源,適合人類和AI參考。文件和範例都相當完整。範例使用在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之上的小型套件。但這些功能改為落在其他地方:有些在Dartastic中,有些則由Contrib套件(例如otel_go_router)取代。
Wondrous OTel Demo
Wondrous OTel Demo也需要一些關注。它已經過時,目標是成為另一個以gskinner的Wondrous應用程式為基礎的Flutter OTel示範。它在Wondrous應用程式中加入天氣widget,更新後就能與Dart OTel Reference的分散式天氣追蹤一致。歡迎貢獻者參與。這是學習OTel、支持社群的有趣方式。
Dartastic Labs開源(Contrib)
Dartastic Labs為常用套件提供可傳送遙測資料的開源套件,讓採用OpenTelemetry變得簡單。每個otel_*包裝套件都會為第三方套件加入span、語意慣例屬性和context傳遞,讓您無需重寫應用程式,就能取得追蹤、指標和記錄。所有開源的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 LabsBeta
採用OTel,不必等待廠商。
- 650個
otel_*整合套件,依OpenTelemetry標準和最新的OpenTelemetry語意慣例,作為一致的整套套件維護。 - 50多個開源整合位於pub.dev:熱門的Dart和Flutter套件,包括shelf、dio、狀態管理和記錄工具。
- 600個Pro整合位於您的私有Dartastic Pub:Anthropic、OpenAI、AWS、Azure、GCP、Kafka、Okta、Stripe、Supabase等。
- 適用於Sentry、Datadog、New Relic的可觀測性廠商整合:我們有辦法讓它們改用OTel。
+其他96個類別
每個OTel訂閱都包含Dartastic Labs:OTel Dev、OTel Pro和所有Dartastic Observatory訂閱。Dartastic Labs讓OTel的移轉與整合更輕鬆,簡單就能檢測您已在使用的Dart和Flutter套件。Dartastic.io在pub.dev上維護50多個開源的otel_*包裝函式(Apache 2.0,永久免費),另有600個Pro套件放在您的私有Dartastic Pub上,可為Auth、AI API、Stripe、Geo和許多雲端服務等商用套件自動產生符合標準的OpenTelemetry。
而且持續更新:隨著Dart和Flutter生態系演進,我們不斷推出新的otel_*包裝函式,讓您的檢測跟上技術堆疊的腳步。類別如下。
我們誠摯邀請開源維護者和廠商與我們合作,為Dart和Flutter生態系提供功能完整的標準OpenTelemetry。
101個類別,共649個套件