搜尋套件、儲存庫與 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 項

原始碼儲存庫

使用此套件的專案

暫無相關資料。

所在榜單