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

插件详情v0.18.11+1

opentelemetry

一个用于从应用程序中收集 OpenTelemetry 跟踪信息的框架。

Web
近 30 天下载
26万
喜欢数
47
Pub 分数
140

安装插件

flutter pub add opentelemetry

插件介绍

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

一个 Flutter/Dart 包,可让应用程序收集和导出 OpenTelemetry 跟踪数据以实现可观测性。它与 Web 平台无缝集成,提供一种标准化的方法来对代码进行探针检测,并收集性能指标、延迟数据和分布式跟踪信息。该包支持跨服务的跟踪,帮助开发者通过深入了解应用行为来调试问题。专为生产环境设计,其中监控和诊断至关重要。

适合场景

  • 监控应用程序性能
  • 跨微服务的分布式追踪
  • 调试延迟问题
  • Web 应用中的实时可观测性
  • 与 OpenTelemetry 后端集成

主要特点

  • Web 平台支持
  • 标准化的 OpenTelemetry 仪器
  • 跟踪收集和导出
  • 轻量且模块化的设计
  • 与 OpenTelemetry 生态系统的兼容性

适合对象

  • 将可观测性集成到Web应用中的开发人员
  • 使用 OpenTelemetry 进行监控的团队
  • 需要分布式跟踪的应用程序
  • 后端服务集成
  • 生产环境调试

使用建议

  • 需要后端 OpenTelemetry 收集器
  • 仅限Web平台
  • 跟踪传播的额外设置
  • 可能会略微增加应用包大小
  • 依赖外部遥测基础设施

原始 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

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目

所在榜单