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

原始碼儲存庫

使用此套件的專案

所在榜單