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 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 the access rights and privileges for your user includes Edit Configuration privileges.

  • Make a note of the unique package ID of your mobile app. If you already integrated Aternity monitoring into the app, the system 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 appname.app folder and select Show Package Contents.

    5. Open Info.plist.

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

    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, com.company.mymobileapp.

Procedure

  1. Step 1 Open a browser and sign in to Aternity.
  2. Step 2 View the list of applications already managed by the system 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
  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 to the system, 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.

    Tip

    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: