搜索插件、代码仓与 APP 分类

插件详情v0.18.11

opentelemetry_wk

一个用于从应用程序收集 OpenTelemetry 跟踪数据的框架。

Web
近 30 天下载
5万
喜欢数
2
Pub 分数
145

安装插件

flutter pub add opentelemetry_wk

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

opentelemetry_wk 是一个专为 Flutter/Dart 设计的软件包,旨在从应用程序中收集 OpenTelemetry 跟踪数据,从而实现对性能和行为的详细可观测性。该软件包由 Workiva 开发,支持 Web 平台,并与 OpenTelemetry 生态系统集成,以实现标准化遥测数据采集。该软件包允许开发者在其应用中进行探针注入,以捕获跨度、指标和日志,从而在分布式系统中促进调试、监控和分析。它在需要符合可观测性标准的环境中尤为有用。源代码公开托管于 GitHub,以确保透明度并支持贡献。

适合场景

  • 应用性能监控
  • Web 应用中的分布式追踪
  • 调试延迟问题
  • 符合可观测性标准
  • 与后端遥测系统的集成

主要特点

  • Web 平台支持
  • OpenTelemetry 标准合规
  • 跨度收集和传播
  • 与 OpenTelemetry 导出程序的集成
  • 轻量且可扩展的设计

适合对象

  • 基于 Web 的 Flutter 应用
  • 使用 OpenTelemetry 的团队
  • 需要可观测性洞察的开发人员
  • 后端集成的监控工作流
  • 实时应用诊断

使用建议

  • 仅限Web平台
  • 导出器需要额外的设置
  • 无原生移动支持
  • 依赖于 OpenTelemetry 后端基础设施
  • 学习 OpenTelemetry 概念的难度

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

OpenTelemetry for Dart

This repository is the Dart implementation of the OpenTelemetry project. All contributions and designs should follow the OpenTelemetry specification.

Project Status

Signal Status
Traces Beta
Metrics Alpha
Logs Unimplemented

Getting Started

This section will show you how to initialize the OpenTelemetry SDK, capture a span, and propagate context.

Initialize the OpenTelemetry SDK
import 'package:opentelemetry/sdk.dart'
    show
        BatchSpanProcessor,
        CollectorExporter,
        ConsoleExporter,
        SimpleSpanProcessor,
        TracerProviderBase;
import 'package:opentelemetry/api.dart'
    show registerGlobalTracerProvider, globalTracerProvider;

void main(List<String> args) {
  final tracerProvider = TracerProviderBase(processors: [
    BatchSpanProcessor(
        CollectorExporter(Uri.parse('https://my-collector.com/v1/traces'))),
    SimpleSpanProcessor(ConsoleExporter())
  ]);

  registerGlobalTracerProvider(tracerProvider);
  final tracer = globalTracerProvider.getTracer('instrumentation-name');
}
Capture a Span
import 'package:opentelemetry/api.dart' show StatusCode, globalTracerProvider;

void main(List<String> args) {
  final tracer = globalTracerProvider.getTracer('instrumentation-name');

  final span = tracer.startSpan('main');
  try {
    // do some work
    span.addEvent('some work');
  } catch (e, s) {
    span
      ..setStatus(StatusCode.error, e.toString())
      ..recordException(e, stackTrace: s);
    rethrow;
  } finally {
    span.end();
  }
}
Propagate Context
Intra-process

In order to parent spans, context must be propagated. Propagation can be achieved by manually passing an instance of Context or by using Dart Zones.

See the attach detach context examplefor more information.

Inter-process

In order to parent spans between processes, context can be serialized and deserialized using a TextMapPropagator, TextMapSetter, and TextMapGetter.

See the W3C context propagation example for more information.

High Resolution Timestamps

A tracer provider can register a web-specific time provider that uses the browser's performance API instead of DateTime when recording timestamps for a span's start timestamp, end timestamp, and span events.

import 'package:opentelemetry/web_sdk.dart' as web_sdk;

final tracerProvider =
    web_sdk.WebTracerProvider(timeProvider: web_sdk.WebTimeProvider());

Important Note: Span timestamps may be inaccurate if the executing system is suspended for sleep. See https://github.com/open-telemetry/opentelemetry-js/issues/852 for more information.

Contributing

In order to generate protobuf definitions, you must have protoc installed and available in your path.

Publishing New Versions

Only Workiva maintainers can publish new versions of opentelemetry-dart. See Publishing opentelemetry-dart

所属分类

依赖

依赖清单 9 项

源码仓库

使用此插件的项目

暂无相关数据。

所在榜单