パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細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 件

ソースリポジトリ

このパッケージを使用しているプロジェクト

ランキング