Swiftpack.co - open-telemetry/opentelemetry-swift as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
open-telemetry/opentelemetry-swift
OpenTelemetry API for Swift
.package(url: "https://github.com/open-telemetry/opentelemetry-swift.git", from: "1.0.6")

opentelemetry-swift

CI codecov

A swift OpenTelemetry client

Installation

This package includes several libraries. The OpenTelemetryApi library includes protocols and no-op implementations that comprise the OpenTelemetry API following the specification. The OpenTelemetrySdk library is the reference implementation of the API.

Libraries that produce telemetry data should only depend on OpenTelemetryApi, and defer the choice of the SDK to the application developer. Applications may depend on OpenTelemetrySdk or another package that implements the API.

Adding the dependency

opentelemetry-swift is designed for Swift 5. To depend on the opentelemetry-swift package, you need to declare your dependency in your Package.swift:

.package(url: "https://github.com/open-telemetry/opentelemetry-swift", from: "1.0.0"),

and to your application/library target, add OpenTelemetryApi or OpenTelemetrySdkto your dependencies, e.g. like this:

.target(name: "ExampleTelemetryProducerApp", dependencies: ["OpenTelemetryApi"]),

or

.target(name: "ExampleApp", dependencies: ["OpenTelemetrySdk"]),

Current status

Currently Tracing, Metrics and Baggage API's and SDK are implemented, also OpenTracing shim, for compatibility with existing Opentracing code.

Implemented traces exporters: Stdout, Jaeger, Zipkin, Datadog and OpenTelemetry collector

Implemented metrics exporters: Prometheus, Datadog, and OpenTelemetry collector

Examples

The package includes some example projects with basic functionality:

  • Datadog Sample - Shows the Datadog exporter used with a Simple Exporter, showing how to configure for sending.
  • Logging Tracer - Simple api implementation of a Tracer that logs every api call
  • Network Tracer - Shows how to use the URLSessionInstrumentation instrumentation in your application
  • Simple Exporter - Shows the Jaeger an Stdout exporters in action using a MultiSpanExporter. Can be easily modified for other exporters
  • Prometheus Sample - Shows the Prometheus exporter reporting metrics to a Prometheus instance
  • OTLP Exporter - Shows the OTLP exporter reporting traces to Zipkin and metrics to a Prometheus via the otel-collector

GitHub

link
Stars: 63
Last commit: 2 days ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Release Notes

1.0.6
3 days ago

Package

  • Fix: Xcode 13.0 building for macOS #247
  • Update swift-atomics minimum version to 1.0.0 #240
  • Remove experimental name from targets based on Metrics

General

  • Fix: Resources were not properly updated from environment variables #242

Metrics

  • New: Add support for Histogram metrics. Currently only OTLP exporter is supported. #244

Traces

  • Added a method to SpanBuilder to start span directly as active. #245

Datadog Exporter

  • Allow disabling payload compression

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics