Adding, editing, or deleting a Mobile App Monitoring (MAM) measurement

Adding a MAM measurement

In order to schedule a test case to run at regular intervals and collect monitoring data, you must provision it in the Keynote Service Center (KSC). You can only provision measurements on private agents (devices) in KSC.

  1. Log in to KSC. All the measurements provisioned using your agreement ID are listed.

  2. Select Add to bring up the Enter Agreement ID screen. Enter your ID and click OK.

  3. Select the Mobile App Monitoring product and click Continue.

  4. Fill out measurement details as follows:

    1. Enter an Alias (80 characters or less) to identify your measurement. For example, use a combination of agent MCD (number), test case, and device type, e.g., 10012eBaySearchingGS4 or 10008CheckBalanceiPhone5.

    2. Select an Agent on which to run the measurement.

    3. Select a Measurement Interval. This determines the maximum number of measurements per hour. The maximum number of runs per hour is 12, at intervals of 5 minutes.

    4. Be sure to check the run time of your test case in Studio before choosing a measurement interval. Be sure to choose an interval that is longer than your total test case execution time + a minute’s buffer for acquiring/releasing the device. If your script runs for 8 minutes, you must choose an interval of 15 minutes or more. If your total execution time is 4 minutes, you can schedule measurements at 5-minute intervals.

    5. Specify a Max Run Time in seconds. This is a maximum run time after which execution is cut off with a maximum time exceeded error. Note that reducing the maximum run time does not result in a greater number of monitor runs. Use this value instead as the maximum acceptable monitor run time. Script runs that exceed this time are stopped.

    6. Set an Expiration date. Your monitor will continue at the specified interval until this date.

    7. Click Choose from Script Library to select a script. Each script is listed with its project name, publication timestamp, and the name of the user who edited and published it. You can Filter the list by any string.

      There can be several entries for a script if it has been edited and published by several users. In the image below, the script “Beta” has been published at different times by three different users and therefore has three entries.

    8. Select a radio button, scroll to the bottom of the list and click Select.

    9. Your selections are listed on the measurement configuration page. Click Continue.

  5. Select your script from the first available drop-down list next to a relative time slot.

  6. Other slots at your chosen time interval (every 15 minutes in this case) are automatically populated with your script. Click Submit.

  7. A confirmation screen appears. Click Continue at the bottom to exit to the measurements list.

Editing a measurement

  1. To edit a measurement, go to the measurements list (Measurements > View).

  2. Click Edit.

  3. Enter an Agreement ID.

  4. Select a measurement and make changes (e.g., Change Script), Save/Discard Changes.

    Modify Target Directly applies changes to an existing measurement; else a new measurement of the same name is created. The older measurement will be retired but data points will still be available in MyKeynote.

Deleting a measurement

  1. To delete a measurement, you must first select it from the list of measurements go to the measurements list (Measurements > View).

  2. Click Edit.

  3. Enter an Agreement ID.

  4. Select measurement and click Expire in the measurement details page.

  5. Click OK in the confirmation box that appears.

  6. You will see a message confirming that the measurement has been expired.