From b37d7b64dc045c64105e7c4856beaf0dce53cb25 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 10:53:19 +0200 Subject: [PATCH 1/9] Move mobile events to the registry --- docs/attributes-registry/README.md | 1 + docs/attributes-registry/mobile-events.md | 49 ++++++++++++++ docs/mobile/events.md | 8 +-- model/logs/mobile-events.yaml | 68 +------------------ model/registry/mobile-events.yaml | 79 +++++++++++++++++++++++ 5 files changed, 135 insertions(+), 70 deletions(-) create mode 100644 docs/attributes-registry/mobile-events.md create mode 100644 model/registry/mobile-events.yaml diff --git a/docs/attributes-registry/README.md b/docs/attributes-registry/README.md index 07c0d1754a..b2cf026588 100644 --- a/docs/attributes-registry/README.md +++ b/docs/attributes-registry/README.md @@ -50,6 +50,7 @@ Currently, the following namespaces exist: * [Host](host.md) * [HTTP](http.md) * [K8s](k8s.md) +* [Mobile events](mobile-events.md) * [Network](network.md) * [OCI](oci.md) * [OS](os.md) diff --git a/docs/attributes-registry/mobile-events.md b/docs/attributes-registry/mobile-events.md new file mode 100644 index 0000000000..00ac475e1c --- /dev/null +++ b/docs/attributes-registry/mobile-events.md @@ -0,0 +1,49 @@ + + +# Mobile Events + + + +- [iOS Lifecycle Event Attributes](#ios-lifecycle-event-attributes) +- [Android Lifecycle Event Attributes](#android-lifecycle-event-attributes) + + + +## iOS Lifecycle Event Attributes + + +| Attribute | Type | Description | Examples | Stability | +|---|---|---|---|---| +| `ios.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `active` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | + +**[1]:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), 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](https://img.shields.io/badge/-experimental-blue) | +| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. | ![Experimental](https://img.shields.io/badge/-experimental-blue) | +| `background` | The app is now in the background. This value is associated with UIKit notification `applicationDidEnterBackground`. | ![Experimental](https://img.shields.io/badge/-experimental-blue) | +| `foreground` | The app is now in the foreground. This value is associated with UIKit notification `applicationWillEnterForeground`. | ![Experimental](https://img.shields.io/badge/-experimental-blue) | +| `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. | ![Experimental](https://img.shields.io/badge/-experimental-blue) | + + +## Android Lifecycle Event Attributes + + +| Attribute | Type | Description | Examples | Stability | +|---|---|---|---|---| +| `android.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | + +**[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), 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](https://img.shields.io/badge/-experimental-blue) | +| `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](https://img.shields.io/badge/-experimental-blue) | +| `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](https://img.shields.io/badge/-experimental-blue) | + diff --git a/docs/mobile/events.md b/docs/mobile/events.md index dd33a06cdd..8f2322c4fe 100644 --- a/docs/mobile/events.md +++ b/docs/mobile/events.md @@ -23,12 +23,12 @@ mobile operating system (e.g. Android, iOS). ### iOS - + The event name MUST be `device.app.lifecycle`. | Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-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](https://img.shields.io/badge/-experimental-blue) | +| [`ios.state`](../attributes-registry/mobile-events.md) | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `active` | `Required` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | **[1]:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), and from which the `OS terminology` column values are derived. @@ -45,12 +45,12 @@ The event name MUST be `device.app.lifecycle`. ### Android - + The event name MUST be `device.app.lifecycle`. | Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-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](https://img.shields.io/badge/-experimental-blue) | +| [`android.state`](../attributes-registry/mobile-events.md) | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | `Required` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | **[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), and from which the `OS identifiers` are derived. diff --git a/model/logs/mobile-events.yaml b/model/logs/mobile-events.yaml index 7fee308596..0609cf8a85 100644 --- a/model/logs/mobile-events.yaml +++ b/model/logs/mobile-events.yaml @@ -1,49 +1,12 @@ groups: - id: ios.lifecycle.events type: event - prefix: ios name: device.app.lifecycle brief: > This event represents an occurrence of a lifecycle transition on the iOS platform. attributes: - - id: state - stability: experimental + - ref: ios.state requirement_level: "required" - note: > - The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), - and from which the `OS terminology` column values are derived. - brief: > - This attribute represents the state the application has transitioned into at the occurrence of the event. - type: - allow_custom_values: false - members: - - id: active - value: 'active' - brief: > - The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`. - stability: experimental - - id: inactive - value: 'inactive' - brief: > - The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. - stability: experimental - - id: background - value: 'background' - brief: > - The app is now in the background. - This value is associated with UIKit notification `applicationDidEnterBackground`. - stability: experimental - - id: foreground - value: 'foreground' - brief: > - The app is now in the foreground. - This value is associated with UIKit notification `applicationWillEnterForeground`. - stability: experimental - - id: terminate - value: 'terminate' - brief: > - The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. - stability: experimental - id: android.lifecycle.events type: event prefix: android @@ -51,32 +14,5 @@ groups: brief: > This event represents an occurrence of a lifecycle transition on the Android platform. attributes: - - id: state - stability: experimental + - ref: android.state requirement_level: required - brief: > - This attribute represents the state the application has transitioned into at the occurrence of the event. - note: > - The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), - and from which the `OS identifiers` are derived. - type: - allow_custom_values: false - members: - - id: created - value: 'created' - brief: > - Any time before Activity.onResume() or, if the app has no Activity, Context.startService() - has been called in the app for the first time. - stability: experimental - - id: background - value: 'background' - brief: > - 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. - stability: experimental - - id: foreground - value: 'foreground' - brief: > - 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. - stability: experimental diff --git a/model/registry/mobile-events.yaml b/model/registry/mobile-events.yaml new file mode 100644 index 0000000000..d848acf949 --- /dev/null +++ b/model/registry/mobile-events.yaml @@ -0,0 +1,79 @@ +groups: + - id: registry.ios.lifecycle.events + prefix: ios + type: attribute_group + brief: > + This document defines attributes that represents an occurrence of a lifecycle transition on the iOS platform. + attributes: + - id: state + stability: experimental + note: > + The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), + and from which the `OS terminology` column values are derived. + brief: > + This attribute represents the state the application has transitioned into at the occurrence of the event. + type: + allow_custom_values: false + members: + - id: active + value: 'active' + brief: > + The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`. + stability: experimental + - id: inactive + value: 'inactive' + brief: > + The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. + stability: experimental + - id: background + value: 'background' + brief: > + The app is now in the background. + This value is associated with UIKit notification `applicationDidEnterBackground`. + stability: experimental + - id: foreground + value: 'foreground' + brief: > + The app is now in the foreground. + This value is associated with UIKit notification `applicationWillEnterForeground`. + stability: experimental + - id: terminate + value: 'terminate' + brief: > + The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. + stability: experimental + - id: registry.android.lifecycle.events + prefix: android + type: attribute_group + brief: > + This document defines attributes that represents an occurrence of a lifecycle transition on the Android platform. + attributes: + - id: state + stability: experimental + brief: > + This attribute represents the state the application has transitioned into at the occurrence of the event. + note: > + The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), + and from which the `OS identifiers` are derived. + type: + allow_custom_values: false + members: + - id: created + value: 'created' + brief: > + Any time before Activity.onResume() or, if the app has no Activity, Context.startService() + has been called in the app for the first time. + stability: experimental + - id: background + value: 'background' + brief: > + 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. + stability: experimental + - id: foreground + value: 'foreground' + brief: > + 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. + stability: experimental + From cdb8bb9fd7a5fe41e3cd45c8fdc760f1d27a44c1 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 10:53:32 +0200 Subject: [PATCH 2/9] Update issue templates --- .github/ISSUE_TEMPLATE/bug_report.yaml | 1 + .github/ISSUE_TEMPLATE/change_proposal.yaml | 1 + .github/ISSUE_TEMPLATE/new-conventions.yaml | 1 + 3 files changed, 3 insertions(+) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index de2be6b191..50f9ddb558 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -44,6 +44,7 @@ body: - area:http - area:k8s - area:messaging + - area:mobile-events - area:network - area:oci - area:os diff --git a/.github/ISSUE_TEMPLATE/change_proposal.yaml b/.github/ISSUE_TEMPLATE/change_proposal.yaml index 5b1f182e55..1284592791 100644 --- a/.github/ISSUE_TEMPLATE/change_proposal.yaml +++ b/.github/ISSUE_TEMPLATE/change_proposal.yaml @@ -37,6 +37,7 @@ body: - area:http - area:k8s - area:messaging + - area:mobile-events - area:network - area:oci - area:os diff --git a/.github/ISSUE_TEMPLATE/new-conventions.yaml b/.github/ISSUE_TEMPLATE/new-conventions.yaml index da5ba98845..d5c27a6e7e 100644 --- a/.github/ISSUE_TEMPLATE/new-conventions.yaml +++ b/.github/ISSUE_TEMPLATE/new-conventions.yaml @@ -46,6 +46,7 @@ body: - area:http - area:k8s - area:messaging + - area:mobile-events - area:network - area:oci - area:os From 61dbf051c0472a91aebf80522ca2830f2e752fa1 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 11:06:26 +0200 Subject: [PATCH 3/9] yamllint --- model/registry/mobile-events.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/model/registry/mobile-events.yaml b/model/registry/mobile-events.yaml index d848acf949..c1cef8446c 100644 --- a/model/registry/mobile-events.yaml +++ b/model/registry/mobile-events.yaml @@ -76,4 +76,3 @@ groups: 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. stability: experimental - From d8e4c3a91cc522f607ef311d2a6ae9bac822a0f6 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 15:03:58 +0200 Subject: [PATCH 4/9] Move to ios/android files --- .github/ISSUE_TEMPLATE/bug_report.yaml | 2 +- .github/ISSUE_TEMPLATE/change_proposal.yaml | 2 +- .github/ISSUE_TEMPLATE/new-conventions.yaml | 2 +- docs/attributes-registry/android.md | 25 ++++++++++++++ .../{mobile-events.md => ios.md} | 19 +---------- docs/mobile/events.md | 4 +-- model/registry/android.yaml | 34 +++++++++++++++++++ .../registry/{mobile-events.yaml => ios.yaml} | 34 ------------------- 8 files changed, 65 insertions(+), 57 deletions(-) rename docs/attributes-registry/{mobile-events.md => ios.md} (54%) rename model/registry/{mobile-events.yaml => ios.yaml} (54%) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index 50f9ddb558..101d3b9059 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -42,9 +42,9 @@ body: - area:gcp-gce - area:host - area:http + - area:ios - area:k8s - area:messaging - - area:mobile-events - area:network - area:oci - area:os diff --git a/.github/ISSUE_TEMPLATE/change_proposal.yaml b/.github/ISSUE_TEMPLATE/change_proposal.yaml index 1284592791..c29ad052f5 100644 --- a/.github/ISSUE_TEMPLATE/change_proposal.yaml +++ b/.github/ISSUE_TEMPLATE/change_proposal.yaml @@ -35,9 +35,9 @@ body: - area:gcp-gce - area:host - area:http + - area:ios - area:k8s - area:messaging - - area:mobile-events - area:network - area:oci - area:os diff --git a/.github/ISSUE_TEMPLATE/new-conventions.yaml b/.github/ISSUE_TEMPLATE/new-conventions.yaml index d5c27a6e7e..95420b8f67 100644 --- a/.github/ISSUE_TEMPLATE/new-conventions.yaml +++ b/.github/ISSUE_TEMPLATE/new-conventions.yaml @@ -44,9 +44,9 @@ body: - area:gcp-gce - area:host - area:http + - area:ios - area:k8s - area:messaging - - area:mobile-events - area:network - area:oci - area:os diff --git a/docs/attributes-registry/android.md b/docs/attributes-registry/android.md index 65072ef1aa..156f661dc5 100644 --- a/docs/attributes-registry/android.md +++ b/docs/attributes-registry/android.md @@ -1,8 +1,33 @@ # Android + + +- [Android Attributes](#android-attributes) +- [Android Lifecycle Event Attributes](#android-lifecycle-event-attributes) + + + ## Android Attributes | Attribute | Type | Description | Examples | Stability | |---|---|---|---|---| | `android.os.api_level` | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | + +## Android Lifecycle Event Attributes + + +| Attribute | Type | Description | Examples | Stability | +|---|---|---|---|---| +| `android.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | + +**[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), 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](https://img.shields.io/badge/-experimental-blue) | +| `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](https://img.shields.io/badge/-experimental-blue) | +| `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](https://img.shields.io/badge/-experimental-blue) | + \ No newline at end of file diff --git a/docs/attributes-registry/mobile-events.md b/docs/attributes-registry/ios.md similarity index 54% rename from docs/attributes-registry/mobile-events.md rename to docs/attributes-registry/ios.md index 00ac475e1c..e57269c612 100644 --- a/docs/attributes-registry/mobile-events.md +++ b/docs/attributes-registry/ios.md @@ -1,12 +1,11 @@ -# Mobile Events +# iOS - [iOS Lifecycle Event Attributes](#ios-lifecycle-event-attributes) -- [Android Lifecycle Event Attributes](#android-lifecycle-event-attributes) @@ -30,20 +29,4 @@ | `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. | ![Experimental](https://img.shields.io/badge/-experimental-blue) | -## Android Lifecycle Event Attributes - -| Attribute | Type | Description | Examples | Stability | -|---|---|---|---|---| -| `android.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | - -**[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), 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](https://img.shields.io/badge/-experimental-blue) | -| `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](https://img.shields.io/badge/-experimental-blue) | -| `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](https://img.shields.io/badge/-experimental-blue) | - diff --git a/docs/mobile/events.md b/docs/mobile/events.md index 8f2322c4fe..204a8020de 100644 --- a/docs/mobile/events.md +++ b/docs/mobile/events.md @@ -28,7 +28,7 @@ The event name MUST be `device.app.lifecycle`. | Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability | |---|---|---|---|---|---| -| [`ios.state`](../attributes-registry/mobile-events.md) | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `active` | `Required` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | +| [`ios.state`](../attributes-registry/ios.md) | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `active` | `Required` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | **[1]:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), and from which the `OS terminology` column values are derived. @@ -50,7 +50,7 @@ The event name MUST be `device.app.lifecycle`. | Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability | |---|---|---|---|---|---| -| [`android.state`](../attributes-registry/mobile-events.md) | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | `Required` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | +| [`android.state`](../attributes-registry/android.md) | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | `Required` | ![Experimental](https://img.shields.io/badge/-experimental-blue) | **[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), and from which the `OS identifiers` are derived. diff --git a/model/registry/android.yaml b/model/registry/android.yaml index cfdcac8a46..267ad426b0 100644 --- a/model/registry/android.yaml +++ b/model/registry/android.yaml @@ -13,3 +13,37 @@ groups: (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). examples: ['33', '32'] + - id: registry.android.lifecycle.events + prefix: android + type: attribute_group + brief: > + This document defines attributes that represents an occurrence of a lifecycle transition on the Android platform. + attributes: + - id: state + stability: experimental + brief: > + This attribute represents the state the application has transitioned into at the occurrence of the event. + note: > + The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), + and from which the `OS identifiers` are derived. + type: + allow_custom_values: false + members: + - id: created + value: 'created' + brief: > + Any time before Activity.onResume() or, if the app has no Activity, Context.startService() + has been called in the app for the first time. + stability: experimental + - id: background + value: 'background' + brief: > + 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. + stability: experimental + - id: foreground + value: 'foreground' + brief: > + 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. + stability: experimental diff --git a/model/registry/mobile-events.yaml b/model/registry/ios.yaml similarity index 54% rename from model/registry/mobile-events.yaml rename to model/registry/ios.yaml index c1cef8446c..c8c443a4ee 100644 --- a/model/registry/mobile-events.yaml +++ b/model/registry/ios.yaml @@ -42,37 +42,3 @@ groups: brief: > The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. stability: experimental - - id: registry.android.lifecycle.events - prefix: android - type: attribute_group - brief: > - This document defines attributes that represents an occurrence of a lifecycle transition on the Android platform. - attributes: - - id: state - stability: experimental - brief: > - This attribute represents the state the application has transitioned into at the occurrence of the event. - note: > - The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), - and from which the `OS identifiers` are derived. - type: - allow_custom_values: false - members: - - id: created - value: 'created' - brief: > - Any time before Activity.onResume() or, if the app has no Activity, Context.startService() - has been called in the app for the first time. - stability: experimental - - id: background - value: 'background' - brief: > - 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. - stability: experimental - - id: foreground - value: 'foreground' - brief: > - 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. - stability: experimental From 524888361a70097db1c3101c68c2a83ef933bfa0 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 15:04:50 +0200 Subject: [PATCH 5/9] Move to ios/android files --- docs/attributes-registry/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/attributes-registry/README.md b/docs/attributes-registry/README.md index b2cf026588..fc4982f552 100644 --- a/docs/attributes-registry/README.md +++ b/docs/attributes-registry/README.md @@ -49,6 +49,7 @@ Currently, the following namespaces exist: * [Google Compute Engine](gcp-gce.md) * [Host](host.md) * [HTTP](http.md) +* [iOS](ios.md) * [K8s](k8s.md) * [Mobile events](mobile-events.md) * [Network](network.md) From a319b3eaff9e19cfa23ce8588b506eca6b5a0018 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 15:05:09 +0200 Subject: [PATCH 6/9] Move to ios/android files --- docs/attributes-registry/ios.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/attributes-registry/ios.md b/docs/attributes-registry/ios.md index e57269c612..e35fc82b73 100644 --- a/docs/attributes-registry/ios.md +++ b/docs/attributes-registry/ios.md @@ -28,5 +28,3 @@ | `foreground` | The app is now in the foreground. This value is associated with UIKit notification `applicationWillEnterForeground`. | ![Experimental](https://img.shields.io/badge/-experimental-blue) | | `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. | ![Experimental](https://img.shields.io/badge/-experimental-blue) | - - From 9e2a4a004fd90dbdee5745610bcd354755555511 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 15:05:35 +0200 Subject: [PATCH 7/9] Move to ios/android files --- docs/attributes-registry/README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/attributes-registry/README.md b/docs/attributes-registry/README.md index fc4982f552..387d8acf50 100644 --- a/docs/attributes-registry/README.md +++ b/docs/attributes-registry/README.md @@ -51,7 +51,6 @@ Currently, the following namespaces exist: * [HTTP](http.md) * [iOS](ios.md) * [K8s](k8s.md) -* [Mobile events](mobile-events.md) * [Network](network.md) * [OCI](oci.md) * [OS](os.md) From 311c2d7824b531703e1c27216d00baac890523ac Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Wed, 3 Apr 2024 17:18:31 +0200 Subject: [PATCH 8/9] Update model/registry/ios.yaml Co-authored-by: Alexander Wert --- model/registry/ios.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/model/registry/ios.yaml b/model/registry/ios.yaml index c8c443a4ee..3989b4e8e3 100644 --- a/model/registry/ios.yaml +++ b/model/registry/ios.yaml @@ -3,7 +3,7 @@ groups: prefix: ios type: attribute_group brief: > - This document defines attributes that represents an occurrence of a lifecycle transition on the iOS platform. + The iOS platform on which the iOS application is running. attributes: - id: state stability: experimental From d4f7de0a4d0ad159cf7fd2c6db3a531c087900c8 Mon Sep 17 00:00:00 2001 From: Joao Grassi <5938087+joaopgrassi@users.noreply.github.com> Date: Fri, 5 Apr 2024 09:54:47 +0200 Subject: [PATCH 9/9] Remove prefix --- model/logs/mobile-events.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/model/logs/mobile-events.yaml b/model/logs/mobile-events.yaml index 0609cf8a85..6664bd1edb 100644 --- a/model/logs/mobile-events.yaml +++ b/model/logs/mobile-events.yaml @@ -9,7 +9,6 @@ groups: requirement_level: "required" - id: android.lifecycle.events type: event - prefix: android name: device.app.lifecycle brief: > This event represents an occurrence of a lifecycle transition on the Android platform.