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 performance statistics like launch times, errors, crashes, network traffic, and also custom activities performance, and some surrounding data on the underlying mobile device and user. For more information on embedding monitoring within the app itself, see How To Embed 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 the access rights and privileges for your user includes Edit Configuration privileges.

  • Make a note of the unique package ID of your mobile app.

    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 log in to Aternity.
  2. Step 2 Select the Gear Icon > Managed Applications.
  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 monitored.
    Specify the mobile app details for monitoring
    Field Description
    App Name

    Enter the name of the app to be monitored. This name appears throughout the system's dashboards.

    Package Name

    Enter the ID of the app.

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

    • In Android, this 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 this option 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) is 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 a stronger device ID.

    • Consumer (B2C) is 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: