Add a Monitored Mobile App as a Managed App to Monitor Custom Activities

You can report custom activities from your monitored mobile app by adding it as a managed application in Aternity. Even before you add it as a managed application, a monitored app automatically reports a wealth of performance and usage data to Aternity, but it cannot report custom activities.

A monitored mobile app is a regular iOS or Android app which has Aternity's monitoring functionality inside, enabling it to report app performance like launch times, errors, crashes, network traffic, and also custom activities performance, and some mobile device data. For more information on embedding monitoring within the app itself, see Start Embedding Monitoring in a Mobile App.

Adding a mobile app for monitoring

Before you begin

Before adding a mobile app to Aternity to monitor custom activities, verify the following:

  • Verify that the access rights and privileges for your user include Edit Configuration privileges.

  • Make a note of the unique package ID of your mobile app. If you already integrated Aternity monitoring into the app, it offers to auto-complete the package name for you.

    Locating iOS Bundle Identifier Locating Android Package Name
    1. Obtain the .ipa file. For example, appname.ipa.

    2. Right-click the file and select Open with > Archive Utility.

    3. Open the Payload folder.

    4. Right-click the folder and select Show Package Contents.

    5. Open Info.plist.

    6. Look for CFBundleidentifier and make a note of the value. For example,

    1. Obtain the .apk file. For example, appname.apk.

    2. Open the Terminal/shell on a computer which has the Android SDK installed.

    3. Navigate to the build-tools folder: %ANDROID_HOME%/build-tools/<version>/

    4. Enter the following command:

      On Windows: aapt dump badging appname.apk

      On Mac: aapt dump badging path/to/appname.apk | grep package

    5. Look for a line starting with package: name=' and make a note of the package name (without the quotes). For example,


  1. Step 1 Open a browser and sign in to Aternity.
  2. Step 2 View the list of applications already managed by Aternity by selecting the Gear Icon > Managed Applications.

    Aternity has several predefined managed applications, and discovers all others in use. You can add new applications as managed if they do not already appear here.

    List of managed applications
    Field Description

    Displays the type of application, which can be a desktop (), web () or mobile app ().

    Application Name

    Displays the name of the application as it appears in the dashboards. Select the name to view or edit its activities. It displays a lock for predefined applications, as you cannot removed or edit them.

    Process Name

    Displays the name of the Windows process, base URL or package name, which Aternity is monitoring as a managed application.


    Displays the group of devices which monitor this entry:

    • Test Group indicates that Aternity only monitors this entry for users or devices in the test group.

    • All Users indicates that Aternity monitors this entry for all reporting devices.

    • Custom indicates that Aternity monitors this entry for users or devices in a custom group that you created.

    • Multiple indicates that Aternity monitors this application for several different groups, which are assigned to different activities of the application.

    To see the number of unique users who have been running the application in the past hour, go to the row's context menu on the right > Go to Monitor Application and see the User Trend section in that dashboard.


    The number of business activities defined for this application.

    This not a measure of the number of activities performed at present. It is only the number of defined activities for this application.

    If several activities for the same application have the same name, they are counted as one business activity. For example, two Open activities, one for each version of your application, are counted as one in this field.

    Last Modified

    Displays the date and time when this entry in the list of monitored applications was last changed.

  3. Step 3 Select Add Application > Mobile Application.
    Add a mobile app as a managed application
  4. Step 4 Enter the details of the mobile app to be managed.

    If you earlier integrated Aternity monitoring into your app and already reports its performance, it auto-completes the package details when you start typing.

    Specify the mobile app details for monitoring
    Field Description
    App Name

    Enter the name of the application as you want it to be displayed in Aternity.


    If you change an existing name, the dashboards display the new name as a separate entry, starting its own new history. For a week since the change, you can continue to view its previous data under the old name.

    Package Name

    Enter the ID of the app which you want to add as a managed application.

    If the app is already reporting performance to Aternity, select the app from the drop-down list.

    • In iOS, the ID is known as the Bundle Identifier, located in the app's info.plist file.

    • In Android, it is the package name.

    For more information on how to find this value, see the Before You Begin section above.

    + Add Multiple Package Names

    Select to add more than one app (package ID) to be monitored together as the same app.

    For example, if you have several versions of an app, each with their own package name, like a smartphone and tablet version, or if you want to monitor your Android and iOS apps together, use this option.

    Target Users

    Select the target audience of this monitored app. There are some minor differences in the extent of monitoring for iOS mobile apps:

    • Workforce (B2E) apps are aimed at employees of your company, and made available through your private enterprise app store. These apps can track additional metrics in iOS like the device's signal strength, or its unique hardware-based device ID.

    • Consumer (B2C) apps are aimed at a general audience, and uploaded to the official App Store. These apps have monitoring capabilities which conform to the store's rules.

  5. Step 5 Embed monitoring functionality in the app itself (if you haven't already done so), using any of the following methods: