Mã nguồn mở tại Dartastic
Dartastic.io cam kết gìn giữ và phát triển tiêu chuẩn OpenTelemetry cho Dart và Flutter. Không chỉ hiến tặng dartastic_opentelemetry mã nguồn mở cho CNCF, nhà sáng lập của chúng tôi còn là Maintainer trong SIG OpenTelemetry Dart và Flutter. Chúng tôi duy trì hàng trăm package tích hợp OTel, tài liệu phong phú và các demo mẫu cho OpenTelemetry trên Dart và Flutter. Chúng tôi mời cộng đồng cùng tham gia, chung tay xây dựng OpenTelemetry mã nguồn mở hàng đầu cho Dart và Flutter.
Về OpenTelemetry
OpenTelemetry (OTel) là dự án sôi động thứ hai của Cloud Native Computing Foundation (CNCF), chỉ sau Kubernetes. Dự án cung cấp bộ API, SDK và công cụ để thu thập và export dữ liệu telemetry (metric, log và trace), giúp phân tích hiệu năng và hành vi của phần mềm.
Đặc tả OpenTelemetry
Các bản triển khai cho Dart và Flutter của chúng tôi tuân theo đặc tả OpenTelemetry chính thức, nơi định nghĩa các yêu cầu và kỳ vọng chung cho mọi bản triển khai OTel ở mọi ngôn ngữ. Tìm hiểu thêm tại:
Hiến tặng cho CNCF
Các package API và SDK Dartastic OpenTelemetry cho Dart và Flutter đang trong quá trình được hiến tặng cho Cloud Native Computing Foundation (CNCF). Nếu được chấp nhận, chúng trở thành SDK OpenTelemetry chính thức cho ngôn ngữ Dart.
Việc hiến tặng được theo dõi trong issue OpenTelemetry “[Donation Proposal]: Dart SDK and API for OpenTelemetry”. Quá trình đã đi được một chặng dài và đúng tiến độ, có đại diện từ Ủy ban Quản trị (Governance Committee) và Ủy ban Kỹ thuật (Technical Committee) của OpenTelemetry, cùng các maintainer, approver và contributor giàu kinh nghiệm về OTel, Dart và Flutter.
Chúng tôi đang ở vị thế vững chắc nhưng vẫn còn những trở ngại cần vượt qua. Quan trọng nhất: Ủy ban Kỹ thuật xem xét mức tuân thủ đặc tả, mức độ áp dụng rộng hơn trong ngành, và đội ngũ contributor tiếp tục lớn mạnh.
Nhóm chuyên trách (SIG) OpenTelemetry Dart & Flutter
OpenTelemetry tổ chức công việc cho từng ngôn ngữ và nền tảng thành các Special Interest Group (SIG). Lời kêu gọi contributor cho OpenTelemetry Dart và Flutter đang mở! Cộng đồng OpenTelemetry cho Dart và Flutter còn non trẻ và đang lớn mạnh. Chúng tôi tìm kiếm những contributor cam kết xây dựng một bản triển khai OpenTelemetry chất lượng cao, tuân thủ đặc tả cho Dart và Flutter. Nỗ lực này mang tính toàn cầu, cởi mở và tôn trọng lẫn nhau. Chúng tôi có contributor từ khắp thế giới, từ sinh viên đại học đến những người sắp nghỉ hưu. Xem Hướng dẫn cho contributor mới và Quy tắc ứng xử.
Chiến lược mã nguồn mở
Chiến lược mã nguồn mở của Dartastic.io đơn giản và có đạo đức. Đã có nhiều vụ “quay xe” với mã nguồn mở từ các nhà cung cấp thương mại, một số trong lĩnh vực observability. Dartastic.io không bao giờ chơi trò đó với mã nguồn mở. Michael Bushe, nhà sáng lập Dartastic.io, là người thực hành Yoga suốt đời và đã thiền mỗi ngày trong nhiều thập kỷ. Ông xem đạo đức là việc của bản thân và của nghiệp. Ông sống theo Yamas, các nguyên tắc đạo đức của Yoga, trong mọi việc cá nhân và kinh doanh, bao gồm chân thật, chân thành, không trộm cắp và không chiếm hữu. Chúng tôi tự hào hỗ trợ cộng đồng Dart, Flutter và OpenTelemetry, và biết ơn cơ hội được đóng góp lại. Dartastic.io cung cấp Free Private Pub cho cộng đồng để giúp các dự án Dart và Flutter khởi đầu với khả năng cộng tác nhóm.
Các sản phẩm của Dartastic.io có giá trị riêng và bổ trợ cho khối lượng lớn công việc mã nguồn mở đã hiến tặng cho cộng đồng. Các SDK Dartastic Native OTel vượt xa những gì Dart làm được. Chúng là nền để triển khai các tính năng ngoài đặc tả, và đóng góp ngược lại cho cộng đồng OpenTelemetry. Dartastic Observatory và Dartastic Symbolizer tự thân là những sản phẩm tốt và bổ trợ cho phần mã nguồn mở.
Cuối cùng, OpenTelemetry chuẩn hơn hầu hết các tiêu chuẩn: API gần như giống nhau giữa các ngôn ngữ. Đầu ra, tức telemetry, giống nhau giữa các SDK ngôn ngữ và các nền tảng OTel. Cấu trúc các thư viện Contrib trong Dartastic Labs cũng tương tự. Semantic Conventions xuyên suốt tất cả. Có lẽ giá trị lớn nhất mà Dartastic.io mang lại, cũng là nền tảng của chính nó, là duy trì một bộ package nhất quán (mã nguồn mở và native, các demo và công cụ như Dartastic Observatory và Dartastic Symbolizer) luôn được cập nhật và nhất quán với đặc tả OpenTelemetry.
Các dự án mã nguồn mở
OpenTelemetry API
Đặc tả OpenTelemetry tách API khỏi SDK. dartastic_opentelemetry_api thường không được nhà phát triển ứng dụng dùng trực tiếp. Mọi symbol liên quan đều được SDK dartastic_opentelemetry export. Với nhà phát triển ứng dụng, phần quan trọng nhất của API là Semantic Conventions.
Ví dụ, nếu bạn làm một ứng dụng có định vị địa lý, bạn có thể gắn cho span các thuộc tính chuẩn theo Geo Telemetry Semantics . Bạn có thể dùng các enum của API Geo.geoLocationLat ('geo.location.lat') và Geo.geoLocationLon ('geo.location.lon'), hoặc có thể là Geo.geoCountryIsoCode ('geo.country.iso_code').
API có thể được cài mà không cần SDK, nhưng tự nó chỉ cung cấp bản triển khai noop. dartastic_opentelemetry_api là một OpenTelemetry API cho Dart, cung cấp các lớp OTel noop cốt lõi. Mọi lớp API đều được SDK export lại, nên không cần thêm API vào pubspec.yaml.
OpenTelemetry SDK
SDK dartastic_opentelemetry hiện thực hóa OTel API bằng cách triển khai exporter, sampler và metric của OTel.
SDK dùng được cho ứng dụng Flutter, service backend Dart, CLI hoặc bất cứ đâu dùng Dart. SDK chạy trên mọi nền tảng Dart và Flutter: di động, desktop và web, kể cả WASM.
SDK giúp dùng OTel dễ dàng, mang lại cách lập trình OTel chuẩn với cảm giác Dart quen thuộc. Bắt đầu với các phương thức static của lớp OTel. OTel.initialize() là lệnh gọi đầu tiên, và OTel.getTracer dùng để tạo Span.
SDK đã sẵn sàng cho production và được hàng nghìn tổ chức sử dụng. SDK có tài liệu đầy đủ và độ bao phủ kiểm thử rất tốt. Hiện còn một số khoảng trống về tuân thủ mà nhóm đang khắc phục, nhưng chúng hiếm khi gây vấn đề khi dùng thông thường.
Dart OTel Reference Demo
Dart OTel Reference Demo là nơi tìm đến cho các ví dụ và phương pháp tốt nhất về OTel trên Dart và Flutter, dành cho cả con người lẫn AI. Tài liệu và ví dụ rất kỹ lưỡng. Các ví dụ dùng một backend observability mã nguồn mở chạy cục bộ trong Docker, kèm các dashboard bổ sung để nhà phát triển thấy trace, metric và log khi chạy từng ví dụ.
Demo chính là một demo thời tiết với tracing phân tán trải dài toàn bộ stack Dart: ứng dụng máy chủ Dart, CLI, ứng dụng Flutter và Cloud Run / Cloud Functions đã được instrument, cùng một dịch vụ thời tiết truyền một trace qua mọi chặng.
Demo có đầy đủ các mẫu kiểm thử dùng SDK thật thay vì mock, để minh họa cách viết test cho mã dùng OTel.
Dart OTel Reference Demo khác với Dartastic OTel Reference Demo của Dartastic.io, một demo tương tự nhưng lớn hơn nhiều và tải về được từ Control Room. Demo đó trình diễn mọi tính năng của Dartastic Native OTel và dẫn đến các dashboard chỉ có trong Dartastic Observatory.
Flutterrific OTel SDK
Flutterrific OTel SDK hiện đang thay đổi. Dartastic OTel SDK dùng được cho Flutter, và thực tế Dart OTel Reference Demo có ví dụ dùng dartastic_opentelemetry với Flutter.
Định hướng mới của Flutterrific OTel là theo đặc tả Client OTel đang hình thành. Vì đặc tả cần thời gian, chúng tôi không khuyến nghị dùng, trừ những người đang làm việc trên đặc tả Client OTel. Có thể, thậm chí nhiều khả năng, đặc tả Client OTel được gộp vào dartastic_opentelemetry.
Ban đầu, Flutterrific được định hướng là một package nhỏ trên nền dartastic_opentelemetry. Thay vào đó, các tính năng đang được đưa vào nơi khác: một số trong Dartastic, một số được thay bằng các package Contrib như otel_go_router.
Wondrous OTel Demo
Wondrous OTel Demo cũng cần được chăm chút. Demo đã lỗi thời, nhưng là một demo OTel khác cho Flutter, dựa trên ứng dụng Wondrous của gskinner. Demo bổ sung một widget thời tiết vào ứng dụng Wondrous, để khi được cập nhật, demo khớp với trace thời tiết phân tán của Dart OTel Reference Demo. Rất hoan nghênh contributor. Đây là cách thú vị để tìm hiểu OTel và hỗ trợ cộng đồng.
Dartastic Labs mã nguồn mở (Contrib)
Dartastic Labs giúp áp dụng OpenTelemetry dễ dàng với các package mã nguồn mở gửi telemetry cho những package thường dùng. Mỗi wrapper otel_* thêm span, thuộc tính theo semantic convention và lan truyền context cho các package bên thứ ba, để bạn có trace, metric và log mà không phải viết lại ứng dụng. Mọi package Dartastic Labs mã nguồn mở đều theo giấy phép Apache 2.0, miễn phí mãi mãi, và được publisher đã xác minh dartastic.io xuất bản trên pub.dev.
Dartastic Labs còn có hơn 600 wrapper cho các package thương mại, đi kèm hầu hết các gói đăng ký Dartastic. Nhiều wrapper trong số này đang được chuyển sang mã nguồn mở trên pub.dev.
| Package | pub.dev | Kho mã |
|---|---|---|
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 |
THƯ VIỆN INSTRUMENTATION
Dartastic LabsBeta
Dùng OTel mà không cần chờ nhà cung cấp.
- 650 package tích hợp
otel_*, được duy trì thành một bộ nhất quán theo tiêu chuẩn OpenTelemetry và OpenTelemetry Semantic Conventions mới nhất. - Hơn 50 tích hợp mã nguồn mở trên pub.dev: các package Dart và Flutter phổ biến như shelf, dio, quản lý state, logger.
- 600 tích hợp Pro trên kho Dartastic Pub riêng tư của bạn: Anthropic, OpenAI, AWS, Azure, GCP, Kafka, Okta, Stripe, Supabase và nhiều hơn nữa.
- Tích hợp nhà cung cấp O11y cho Sentry, Datadog, New Relic: chúng tôi có cách bắt họ phải nói OTel.
+ 96 danh mục khác
Dartastic Labs đi kèm mọi gói đăng ký OTel: OTel Dev, OTel Pro và mọi gói đăng ký Dartastic Observatory. Dartastic Labs giúp việc chuyển sang và tích hợp OTel dễ dàng hơn. Instrument các package Dart và Flutter bạn đang dùng một cách đơn giản. Dartastic.io duy trì hơn 50 wrapper otel_* mã nguồn mở trên pub.dev (Apache 2.0, miễn phí mãi mãi), cùng 600 package Pro trên kho Dartastic Pub riêng tư của bạn, tự động tạo OpenTelemetry đúng chuẩn cho các package thương mại như Auth, AI API, Stripe, Geo và nhiều dịch vụ cloud.
Và luôn cập nhật: chúng tôi phát hành wrapper otel_* mới khi hệ sinh thái Dart và Flutter phát triển, để instrumentation của bạn theo kịp stack. Danh mục ở bên dưới.
Chúng tôi mời những người duy trì mã nguồn mở và các nhà cung cấp cùng hợp tác để mang OpenTelemetry chuẩn, đầy đủ tính năng đến hệ sinh thái Dart và Flutter.
649 package trong 101 danh mục
Sẵn sàng thêm observability vào ứng dụng của bạn?
Đăng ký tài khoản miễn phí và bắt đầu giám sát ứng dụng Flutter của bạn ngay hôm nay.