Dartastic y el código abierto
Dartastic.io está comprometido con la custodia del estándar OpenTelemetry para Dart y Flutter. Además de donar el dartastic_opentelemetry de código abierto a la CNCF, nuestro fundador es mantenedor en el SIG de OpenTelemetry para Dart y Flutter. Mantenemos cientos de paquetes de integración OTel, una documentación extensa y demos de ejemplo de OpenTelemetry para Dart y Flutter. Invitamos a la comunidad a participar y a trabajar juntos para lograr un OpenTelemetry de código abierto de primer nivel para Dart y Flutter.
Acerca de OpenTelemetry
OpenTelemetry (OTel) es el segundo proyecto más activo de la Cloud Native Computing Foundation (CNCF), después de Kubernetes. Ofrece un conjunto de API, SDK y herramientas para recopilar y exportar datos de telemetría (métricas, logs y trazas) que ayudan a analizar el rendimiento y el comportamiento del software.
Especificación de OpenTelemetry
Nuestras implementaciones para Dart y Flutter siguen la especificación oficial de OpenTelemetry, que define los requisitos y expectativas comunes a todos los lenguajes para todas las implementaciones de OTel. Más información en:
Donación a la CNCF
Los paquetes API y SDK de Dartastic OpenTelemetry para Dart y Flutter están en proceso de donación a la Cloud Native Computing Foundation (CNCF). Si se aceptan, pasan a ser los SDK oficiales de OpenTelemetry para el lenguaje Dart.
La donación se sigue en el issue de OpenTelemetry “[Donation Proposal]: Dart SDK and API for OpenTelemetry”. El proceso está avanzado y va según lo previsto. Cuenta con representación del Comité de Gobernanza y del Comité Técnico de OpenTelemetry, y con mantenedores, aprobadores y colaboradores con amplia experiencia en OTel, Dart y Flutter.
Estamos en una posición sólida, pero aún quedan obstáculos por superar. Los más importantes: la revisión del Comité Técnico sobre el cumplimiento de la especificación, una adopción más amplia en la industria y el crecimiento continuo del equipo de colaboradores.
Grupo de Interés Especial de OpenTelemetry para Dart y Flutter
OpenTelemetry organiza su trabajo por lenguajes y plataformas en Grupos de Interés Especial (SIG). ¡La convocatoria de colaboradores para OpenTelemetry en Dart y Flutter está abierta! La comunidad de OpenTelemetry para Dart y Flutter es incipiente y está creciendo. Buscamos colaboradores comprometidos con lograr una implementación de OpenTelemetry de alta calidad y conforme a la especificación para Dart y Flutter. El esfuerzo es global, inclusivo y respetuoso. Tenemos colaboradores de todo el mundo, desde estudiantes universitarios hasta personas cerca de la jubilación. Consulte la Guía para nuevos colaboradores y el Código de conducta.
Estrategia de código abierto
La estrategia de código abierto de Dartastic.io es simple y ética. Ha habido muchos casos de cambios repentinos de licencia de código abierto por parte de proveedores comerciales, algunos en el ámbito de la observabilidad. Dartastic.io nunca juega con el código abierto. Michael Bushe, fundador de Dartastic.io, practica yoga desde hace toda una vida y medita a diario desde hace muchas décadas. Considera la ética un asunto personal y kármico. Vive los Yamas, la ética del yoga, en todos los asuntos personales y de negocios. Eso incluye la veracidad, la sinceridad, no robar y no acaparar. Nos enorgullece apoyar a las comunidades de Dart, Flutter y OpenTelemetry, y agradecemos la oportunidad de retribuirles. Dartastic.io ofrece Free Private Pub a la comunidad para ayudar a poner en marcha proyectos de Dart y Flutter con colaboración en equipo.
Los productos de Dartastic.io tienen valor propio y complementan el extenso trabajo de código abierto donado a la comunidad. Los SDK Dartastic Native OTel van más allá de lo que Dart puede hacer. Sirven de terreno para implementar funciones fuera de la especificación, y lo aprendido vuelve a la comunidad de OpenTelemetry. Dartastic Observatory y Dartastic Symbolizer son buenos productos por sí mismos y complementan la oferta de código abierto.
Por último, OpenTelemetry es más estándar que la mayoría de los estándares: las API son casi iguales en todos los lenguajes. La salida (la telemetría) es la misma en los SDK de todos los lenguajes y en todas las plataformas OTel. La forma de las bibliotecas Contrib de Dartastic Labs es similar. Las convenciones semánticas atraviesan todo. Quizá el mayor valor que aporta Dartastic.io, y la base sobre la que se apoya, es mantener un conjunto coherente de paquetes: de código abierto y nativos, demos y herramientas como Dartastic Observatory y Dartastic Symbolizer, al día y coherentes con la especificación de OpenTelemetry.
Proyectos de código abierto
API de OpenTelemetry
La especificación de OpenTelemetry separa la API del SDK. Los desarrolladores de aplicaciones no suelen usar la dartastic_opentelemetry_api directamente. El SDK dartastic_opentelemetry exporta todos los símbolos relevantes. Para los desarrolladores de aplicaciones, lo más importante de la API son las convenciones semánticas.
Por ejemplo, si crea una app que usa geolocalización, puede usar la semántica de telemetría geográfica estándar en los atributos del span. Puede usar los enums de la API Geo.geoLocationLat ('geo.location.lat') y Geo.geoLocationLon ('geo.location.lon'), o quizá Geo.geoCountryIsoCode ('geo.country.iso_code').
Una API se puede instalar sin un SDK, aunque por sí sola solo ofrece una implementación noop. dartastic_opentelemetry_api es una API de OpenTelemetry para Dart. Ofrece las clases OTel noop básicas. El SDK vuelve a exportar todas las clases de la API, así que no hace falta incluir la API en pubspec.yaml.
SDK de OpenTelemetry
El SDK dartastic_opentelemetry da vida a la API de OTel implementando exportadores, muestreadores y métricas de OTel.
El SDK se puede usar en apps Flutter, servicios backend en Dart, CLI o en cualquier lugar donde se use Dart. Funciona en todas las plataformas de Dart y Flutter, móviles, de escritorio y web, incluido WASM.
Su SDK facilita el uso de OTel y ofrece la programación OTel estándar con un estilo familiar de Dart. Se empieza con los métodos estáticos de la clase OTel. OTel.initialize() es la primera llamada y OTel.getTracer se usa para crear instancias de Span.
El SDK está listo para producción y lo usan miles de organizaciones. Tiene una documentación completa y una cobertura de pruebas excelente. Por ahora quedan brechas de cumplimiento que el equipo está cerrando, pero rara vez causan problemas en el uso habitual.
Dart OTel Reference Demo
La Dart OTel Reference Demo es la referencia para ejemplos y buenas prácticas de OTel en Dart y Flutter, tanto para personas como para IA. La documentación y los ejemplos son muy completos. Los ejemplos usan un backend de observabilidad local de código abierto en Docker, con dashboards adicionales para que los desarrolladores vean las trazas, métricas y logs mientras ejecutan cada ejemplo.
La demo principal es una demo meteorológica de trazas distribuidas que abarca todo el stack de Dart: aplicaciones de servidor Dart instrumentadas, CLI, apps Flutter y Cloud Run / Cloud Functions, con un servicio meteorológico que propaga una sola traza a través de cada salto.
La demo incluye patrones de pruebas que ejercitan el SDK real en lugar de mocks, para mostrar cómo escribir pruebas para código que usa OTel.
La Dart OTel Reference Demo es distinta de la Dartastic OTel Reference Demo de Dartastic.io, que es similar pero mucho más grande y se puede descargar desde el Control Room. Esta última muestra todas las funciones de Dartastic Native OTel y remite a dashboards disponibles solo en Dartastic Observatory.
Flutterrific OTel SDK
El Flutterrific OTel SDK está actualmente en evolución. El Dartastic OTel SDK se puede usar con Flutter y, de hecho, la Dart OTel Reference Demo tiene ejemplos de uso de dartastic_opentelemetry con Flutter.
El nuevo propósito de Flutterrific OTel es seguir la especificación Client OTel, que se está formando. Como las especificaciones llevan tiempo, no se recomienda su uso salvo para quienes trabajan en la especificación Client OTel. Es posible, quizá probable, que la especificación Client OTel acabe integrada en dartastic_opentelemetry.
El propósito original de Flutterrific era ser un paquete pequeño sobre dartastic_opentelemetry. En cambio, sus funciones están llegando a otros lugares: algunas están en Dartastic y otras se sustituyen por paquetes Contrib como otel_go_router.
Wondrous OTel Demo
La Wondrous OTel Demo también necesita atención. Está desactualizada, pero es otra demo de OTel para Flutter, basada en la app Wondrous de gskinner. Mejora la app Wondrous con un widget del tiempo, para alinearla con la traza meteorológica distribuida de Dart OTel Reference al actualizarla. Los colaboradores son bienvenidos. Es una forma divertida de aprender OTel y apoyar a la comunidad.
Código abierto de Dartastic Labs (Contrib)
Dartastic Labs facilita la adopción de OpenTelemetry con paquetes de código abierto que envían telemetría de paquetes de uso habitual. Cada wrapper otel_* agrega spans, atributos de convenciones semánticas y propagación de contexto a paquetes de terceros, para que obtenga trazas, métricas y logs sin reescribir su app. Todos los paquetes de código abierto de Dartastic Labs tienen licencia Apache 2.0, son gratuitos para siempre y los publica en pub.dev el publicador verificado dartastic.io.
Dartastic Labs también ofrece más de 600 wrappers para paquetes comerciales, incluidos en la mayoría de las suscripciones de Dartastic. Está previsto que muchos de ellos pasen a código abierto en pub.dev.
| Paquete | pub.dev | Repositorio |
|---|---|---|
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 |
BIBLIOTECAS DE INSTRUMENTACIÓN
Dartastic LabsBeta
Adopte OTel sin esperar a los proveedores.
- 650 paquetes de integración
otel_*, mantenidos como un conjunto coherente conforme al estándar OpenTelemetry y a las últimas convenciones semánticas de OpenTelemetry. - Más de 50 integraciones de código abierto en pub.dev: paquetes populares de Dart y Flutter, como shelf, dio, gestión de estado y loggers.
- 600 integraciones Pro en su Dartastic Pub privado: Anthropic, OpenAI, AWS, Azure, GCP, Kafka, Okta, Stripe, Supabase y más.
- Integraciones con proveedores de o11y para Sentry, Datadog y New Relic: tenemos maneras de hacer que hablen OTel.
+ 96 categorías más
Dartastic Labs está incluido en todas las suscripciones OTel: OTel Dev, OTel Pro y todas las suscripciones a Dartastic Observatory. Dartastic Labs facilita la migración a OTel y la integración. Instrumente de forma sencilla los paquetes Dart y Flutter que ya usa. Dartastic.io mantiene más de 50 wrappers otel_* de código abierto en pub.dev (Apache 2.0, gratuitos para siempre), además de 600 paquetes Pro en su Dartastic Pub privado que producen automáticamente OpenTelemetry conforme al estándar para paquetes comerciales como Auth, API de IA, Stripe, Geo y muchos servicios en la nube.
Y se mantiene al día: publicamos nuevos wrappers otel_* a medida que evoluciona el ecosistema de Dart y Flutter, para que su instrumentación siga el ritmo de su stack. Las categorías, a continuación.
Invitamos a los mantenedores de código abierto y a los proveedores a trabajar con nosotros para ofrecer OpenTelemetry estándar y completo al ecosistema de Dart y Flutter.
649 paquetes en 101 categorías
¿Todo listo para agregar observabilidad a su app?
Regístrese para obtener una cuenta gratuita y empiece hoy a monitorear sus apps Flutter.