open-telemetry
/
semantic-conventions
mirror of https://github.com/open-telemetry/semantic-conventions.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
semantic-conventions/docs/mobile/events.md

4.2 KiB
Raw Blame History

Semantic Conventions for mobile events

Status: Experimental

This document defines semantic conventions for instrumentations that emit events on mobile platforms. All mobile events MUST use a namespace of device in the event.name property.

Lifecycle instrumentation

This section defines how to apply semantic conventions when instrumenting application lifecycle. This event is meant to be used in conjunction with os.name resource semantic convention to identify the mobile operating system (e.g. Android, iOS).

iOS

The event name MUST be device.app.lifecycle.

Attribute Type Description Examples Requirement Level Stability
ios.state string This attribute represents the state the application has transitioned into at the occurrence of the event. [1] active Required Experimental

[1]: The iOS lifecycle states are defined in the UIApplicationDelegate documentation, and from which the OS terminology column values are derived.

ios.state MUST be one of the following:

Value Description Stability
active The app has become active. Associated with UIKit notification applicationDidBecomeActive. Experimental
inactive The app is now inactive. Associated with UIKit notification applicationWillResignActive. Experimental
background The app is now in the background. This value is associated with UIKit notification applicationDidEnterBackground. Experimental
foreground The app is now in the foreground. This value is associated with UIKit notification applicationWillEnterForeground. Experimental
terminate The app is about to terminate. Associated with UIKit notification applicationWillTerminate. Experimental

Android

The event name MUST be device.app.lifecycle.

Attribute Type Description Examples Requirement Level Stability
android.state string This attribute represents the state the application has transitioned into at the occurrence of the event. [1] created Required Experimental

[1]: The Android lifecycle states are defined in Activity lifecycle callbacks, and from which the OS identifiers are derived.

android.state MUST be one of the following:

Value Description Stability
created Any time before Activity.onResume() or, if the app has no Activity, Context.startService() has been called in the app for the first time. Experimental
background Any time after Activity.onPause() or, if the app has no Activity, Context.stopService() has been called when the app was in the foreground state. Experimental
foreground Any time after Activity.onResume() or, if the app has no Activity, Context.startService() has been called when the app was in either the created or background states. Experimental