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

패키지 상세v0.18.11+1

opentelemetry

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

Web
30일 다운로드
26만
좋아요
47
Pub 점수
140

패키지 설치

flutter pub add opentelemetry

패키지 개요

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

Flutter/Dart 패키지로 애플리케이션에서 관측성을 위해 OpenTelemetry 추적을 수집하고 내보낼 수 있도록 합니다. 웹 플랫폼과 원활하게 통합되어 코드를 표준화된 방식으로 인스트루먼트하고 성능 지표, 지연 데이터 및 분산 추적 정보를 수집할 수 있게 해줍니다. 이 패키지는 서비스 간 추적을 지원하며, 애플리케이션 동작에 대한 자세한 통찰을 제공하여 개발자가 문제를 디버그하는 데 도움을 줍니다. 모니터링과 진단이 중요한 생산 환경에서 사용하도록 설계되었습니다.

사용 사례

  • 응용 프로그램 성능 모니터링
  • 마이크로서비스 간 분산 추적
  • 지연 문제 디버깅
  • 웹 앱에서의 실시간 관측성
  • 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

카테고리

의존성

의존성 목록 1 개

소스 저장소

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

순위