Datadog SDK for iOS

Bug Fixes

• Fixed app extension compilation issue for UIApplication.shared symbol (#374), solves #370 (thanks @SimpleApp).

IMPORTANT! This is an alpha version: public API is likely to change in the next versions

IMPORTANT! This is an alpha version: public API is likely to change in the next versions

This release brings the Real User Monitoring for iOS apps.

Features

• Added RUM monitoring feature: manual and auto instrumentation for tracking user sessions, interactions, visited UIViewControllers, network resources and errors.
• Added support for GovCloud endpoints (#235).
• Added single .set(endpoint:) API to configure all features at once (#322).
• Added span.setActive() API for indirect referencing Spans (#187).
• Added Global.sharedTracer.startRootSpan(...) API (#236).
• Added support for extra user attributes in Datadog.setUserInfo(...) (#315).
• Added option for logging custom Swift Errors with Logger (#303), solves #276 (thanks @sdejesusF)

Bug Fixes

• Fixed compilation issue for Mac Catalyst (#277), solves #274 (thanks @Hengyu).
• Fixed crash with serviceName containing space characters (#317), solves #316 (thanks @philtre).
• Fixed issue with data being not uploaded when battery status was undefined (#320).

Improvements

• Tracing auto instrumentation now supports URLSessionTasks created with no completion handler (#262).
• Extended the allowed characters set for the environment setting (#246).
• Improved data upload performance (#249).

More in iOS RUM Collection.

This beta release brings the Real User Monitoring for iOS apps.

Features

• Added RUM monitoring feature: manual and auto instrumentation for tracking user sessions, interactions, visited UIViewControllers, network resources and errors.
• Added support for GovCloud endpoints (#235).
• Added span.setActive() API for indirect referencing Spans (#187).
• Added Global.sharedTracer.startRootSpan(...) API (#236).

Bug Fixes

• Fixed compilation issue for Mac Catalyst (#277), solves #274 (thanks @Hengyu).

Improvements

• Tracing auto instrumentation now supports URLSessionTasks created with no completion handler (#262).
• Extended the allowed characters set for the environment setting (#246).
• Improved data upload performance (#249).

More in iOS RUM Collection guide.

Bug fixes

• Compilation issues of DatadogObjC when used with Swift Package Manager (🍻 to @TsvetelinVladimirov)
• Compilation issues for Xcode 11.3.1 (🏅 to @provTheodoreNewell)

This release brings Distributed Tracing for iOS 🚀.

Features

• By using a new Tracer API, it is now possible to send traces to Datadog.

// register the Tracer:
Global.sharedTracer = Tracer.initialize(configuration: configuration)

// start the Span:
let span = Global.sharedTracer.startSpan(operationName: "something I measure")

// finish it when the measured operation is done:
span.finish()

• If you use Datadog instrumentation on the backend, the trace can be propagated across the hosts.

Read more in iOS Trace Collection guide.

Bug Fixes

• Fixed out-of-memory crash when doing extremely intensive logging (#185), solves #178 (@hyling 🍻)

Bug Fixes

• Fixed memory leak in logs upload (#180), solves #178 (thanks @hyling)
• Fixed App Store Connect validation issues for Objective-C SDK (#182), solves #177 (thanks again, @hyling 🚀)

Features

• Auto-Instrumentation for Tracing 🤖 • Tracing for Objective-C 🧓

How to use auto-instrumentation: Step 1: Set Datadog.Configuration.tracedHosts to your domains Step 2: Set tracingEnabled Step 3: Set Global.sharedTracer to a Datadog.Tracer instance 🚀 Your network requests are automatically traced now!

IMPORTANT! Auto-tracing is disabled by default If auto-tracing is NOT enabled swizzling does not happen Enabling auto-tracing by following the steps above results in swizzling URLSession.dataTaskWithURL:completion: and URLSession.dataTaskWithRequest:completion: methods. You can look at how we swizzle methods here and/or what the new implementations of those methods are here and here.

This beta brings more to Distributed Tracing for iOS apps 🚀.

Features

• The span.setBaggageItem(key:value:) is now available (#144). This enables attributes propagation from parent span to its children.

Bug Fixes

• Fixed a set of NSFileHandle crashes on iOS 13.0 - 13.3 in -beta1 (#152) caused by Apple bug.

Upgrade From 1.3.0-beta1

• Starting from -beta2, we embed the Open Tracing interfaces in Datadog module (#154). DDTracer is renamed to Tracer:

import Datadog

Global.sharedTracer = Tracer.initialize(...)

• This (#154) also means less hassle in Podfile as now it only requires pod DatadogSDK.

More in iOS Trace Collection guide.

Features

• This release brings the -beta1 version of Distributed Tracing for iOS apps ⭐. From now, you'll be able to send traces to Datadog and let us visualise the timings of your code execution. If you're using Datadog instrumentation on backend, this also includes full-stack trace propagation.

Instantiate DDTracer:

import Datadog
import OpenTracing

Global.sharedTracer = DDTracer.initialize(
    configuration: DDTracer.Configuration(
        sendNetworkInfo: true
    )
)

and start instrumenting your code:

let span = Global.sharedTracer.startSpan(operationName: "something I measure")
// do something you want to measure ...
// ... then, when the operation is finished:
span.finish()

Read more in iOS Trace Collection guide.

Improvements

• typealias DDLogger = Datadog.Logger is introduced, to help avoiding compiler ambiguity in projects defining their own Logger class (#143), solves #127 and #142 (thanks @krzysztofzablocki , @amyslies)

Bug Fixes

• Fixes the problem with logs being occasionally malformed when seen at app.datadoghq.com (#133)

Bug Fixes

• Fixed ISO8601DateFormatter crash on iOS 11.0 and iOS 11.1 - the milliseconds precision won't be available on iOS 11.0 and iOS 11.1 till next regular release (#129), solves #126 (thanks @lgaches, @Britton-Earnin)

Features

• The serviceName default value is changed to app bundle identifier + can be customized globally (#102)

Bug Fixes

• Fixed family of NWPathMonitor crashes (#110), solves #110, #70 (thanks @LeffelMania, @00FA9A, @jegnux)

Improvements

• Milliseconds precision for logs (#96), solves #95 (thanks @flobories)
• Improved logs delivery for app extensions (#84), solves #52 (thanks @lmramirez)

Other Changes

• The in-build source value was changed from mobile to ios (#111)
• Package.swift is updated to link the SDK as dynamic framework (#82)

Upgrade Steps

Datadog.Configuration builder now requires the environment value to be passed along with clientToken:

Datadog.Configuration
    .builderUsing(clientToken: "<client-token>", environment: "<environment>")

Eventual Breaking Changes in Dashboards and Pipelines

If any of your app.datadoghq.com dashboards or pipelines depends on service or source attribute, you may need to update them.

🐛 #80 : missing required module fix ⏲️ #65 : Syncing logs time with server

🐞 Fix "'module.modulemap' should be inside the 'include' directory" Carthage error, fixes #71

🐞 Fix "device out of memory" crash, fixes #58

🚀 1.0.0 release of the logging feature.

Datadog.initialize(...)

let logger = Logger.builder.build()
logger.info("Hello from 1.0.0 👋")

• 🚀 Add iOS 11 support #53
• ↘️ Drop macOS/Catalyst support #55

• 🚀 Add Carthage support #39
• 🐞 Crash when logging a debug level event via Logger #47

Datadog logging feature.

+ Datadog.podspec
+ DatadogObjc.podspec