패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.18.11

opentelemetry_wk

응용 프로그램에서 OpenTelemetry 추적 데이터를 수집하기 위한 프레임워크입니다.

Web
30일 다운로드
5만
좋아요
2
Pub 점수
145

패키지 설치

flutter pub add opentelemetry_wk

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

opentelemetry_wk은 애플리케이션에서 OpenTelemetry 추적 데이터를 수집하도록 설계된 Flutter/Dart 패키지로, 성능과 동작에 대한 세부적인 관측성을 제공합니다. Workiva가 개발했으며 웹 플랫폼을 지원하고 OpenTelemetry 생태계와 통합되어 표준화된 텔레메트리 데이터 수집을 가능하게 합니다. 이 패키지는 개발자가 앱에 스팬, 메트릭 및 로그를 캡처할 수 있도록 인스트루먼트링을 가능하게 하여 분산 시스템 내에서 디버깅, 모니터링 및 분석을 용이하게 합니다. 특히 관측성 기준 준수를 요구하는 환경에서 특히 유용합니다. 소스 코드는 GitHub에서 공개되어 있어 투명성과 기여를 보장합니다.

사용 사례

  • 응용 프로그램 성능 모니터링
  • 웹 앱에서의 분산 추적
  • 지연 문제 디버깅
  • 관측성 기준 준수
  • 백엔드 원격 측정 시스템과의 통합

주요 기능

  • 웹 플랫폼 지원
  • OpenTelemetry 표준 준수
  • 스팬 수집 및 전파
  • OpenTelemetry 내보내기 도구와의 통합
  • 경량이고 확장 가능한 설계

적합한 대상

  • 웹 기반 플러터 애플리케이션
  • OpenTelemetry를 사용하는 팀
  • 관측성 인사이트가 필요한 개발자
  • 백엔드 통합 모니터링 워크플로우
  • 실시간 애플리케이션 진단

고려 사항

  • 웹 플랫폼에 한정
  • 내보내기 도구에 대한 추가 설정이 필요합니다
  • 네이티브 모바일 지원 없음
  • 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 개

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.

순위