Mobile APM

Quick tips for tablet devices

Follow these simple tips to perform fault domain isolation for your monitored applications.

Show applications

Tap a row or appropriate number on the Health Summary page to access all, or only problematic, applications from a real user or synthetic test perspective.

Show a list of transactions

Tap the Transactions icon Transaction at the end of an application row to see all of the associated transactions.

Network and data center tiers

Tap a row on the Health Summary page to see application and infrastructure information and trend charts which includes network and data center tier data.

Interact with charts

Tap a row on the Health summary page and tap a KPI row on the Applications page.

Tap and hold

Tap and hold your finger on a chart to select a specific data point. Move your finger left or right on a chart to change the data point selection.

The data point selection remains after you release, and is maintained across all charts.

Reset

When you select a data point, the Reset button appears. Tap Reset to return all data-point selections in the charts to the default last data point.

Alerts

Tap the Alerts icon Alerts in the upper right for a log of events that affect performance or traffic. Tap the alert number to see applications with active alerts. The number represents the number of unacknowledged alerts within the last hour. Alerts older than one hour are automatically acknowledged.

Push notifications

To receive notifications, your device must have full internet access.

iOS: To receive push notifications, an application must register with the Apple Push Notification service (APNs) via a data connection.

Android: To receive push notifications, an application must register with the Google Cloud Messaging service (GCM) via a data connection.

Troubleshooting

If you do not receive notifications, make sure that the NAM Server server is configured to send notifications to mobile devices.

Connect the NAM Server server to UrbanAirship: Configure the master NAM Server server to connect with UrbanAirship (https://go.urbanairship.com/), the third-party push service provider. Set up the configuration in the UserProperties panel, if the NAM Server server does not have a direct connection to the public internet. Additionally, you must configure an HTTP proxy. You do not have to restart the server when you change the configuration.

Use the following URL to configure the connection information on the NAM Server server: http://<server>:<port>/UserPropertiesAdmin .

Set up the following properties (username and password can be empty):

  • mobile.alerts.push.proxy.host
  • mobile.alerts.push.proxy.port
  • mobile.alerts.push.proxy.user.name
  • mobile.alerts.push.proxy.user.password

iOS: Go to iOS Push Notification Information.

Android: If you cannot receive notifications behind a firewall that restricts the traffic to or from the Internet, configure your network to connect with GCM to receive messages. Open these ports: 5228, 5229, and 5230. Typically, GCM uses only 5228, but it sometimes uses 5229 and 5230. GCM does not provide specific IPs, so set your firewall to accept outgoing connections to all IP addresses in the IP blocks of Google's ASN of 15169.

For other issues, refer to the following list:

  • After installation, open the application at least once and select applications for Alert Notifications from the Settings ► Alert notifications menu.

    Note

    For Android version 3.1 and higher, if you perform a force stop on the application, it does not receive notifications until it is re-launched. The application remains in this stopped state even if the device is powered off and on again.

  • For Android version 4.0.4 and lower, verify that the device has a valid Google account.

  • If push notifications arrive only when you are connected to a WiFi network, confirm that Background data is enabled. Refer to Android documentation to ensure that Background Data is enabled for each version of the Android operating system. To enable background data go to Enabling Background Data.

  • For Android version 4.1 and higher, if you disabled notifications from the Android Application management screen by deselecting the Show notifications box, re-enable the setting by selecting the Show notifications box.

If you receive notifications for applications for which you are not registered, refer to the following list:

  • If the application is uninstalled and re-installed, the GCM server may send a notification for an application selected for Alert notifications before it was uninstalled. This situation should correct itself within a reasonable amount of time, but if it continues, uninstall the application, wait approximately one hour for the push server to detect the GCM unregistration, and reinstall.
  • For Android version 4.1 and higher, if you have disabled notifications from the Android Application management screen because you deselected the Show notifications box, make sure that the setting is still deselected.

Configure the app

Tap Menu to configure the app and select the NAM Server server, primary metric, and applications to monitor.

Health summary

The MobileAPM app displays data from the NAM Server. It identifies the applications with performance problems, and how many users are affected. This helps operations teams, service desk teams, and application owners to detect, understand, and solve these problems.

All Monitored Applications lists all of your monitored applications. Tap the row for a list of applications. If you have not configured any applications, you will only see the All Monitored Applications and Network rows. If you configured applications but data is not available, all rows appear without Alerts.

The Application Performance number represents applications with good, bad, and warning statuses, calculated by the primary metric. Choose this metric in the Metric Settings section of the menu. Tap the number for detailed information on warning (yellow) and bad (red) issues. Tap the row for a list of applications.

The Business Impact numbers represent the total number of unique users that experience application performance or availability problems (affected users). Tap the affected users number to see a corresponding chart. Tap the row for a list of applications.

The Alerts number represents the unacknowledged alerts that occur within the time range you select from the menu.

The Network number represents the number of software services.

Tap Menu menu to access the MobileAPM reporting and settings menu.

Status colors

The number colors throughout MobileAPM represent the data state:

  • Red = Bad
  • Yellow = Warning
  • Green = Good (all good = 100% green)

Applications

This is a list of applications or transactions (all or filtered by drilldown type) with the Primary Metric selected in Metric Settings from the Menu.

  • Primary Metric displays the value of the primary metric as defined in the settings. To change this metric, tap Metric Settings from the menu. Other settings for the metric can be Health Index, Availability, Performance, Operation Time, or Operations. The default Health Index metric represents the percentage of operations completed successfully and within the performance threshold. If your NAM Server has data from other end user management sources (Real-User Monitoring – First Mile or Enterprise Synthetic or Backbone), the appropriate source is used based on the application configuration and number of active real users.
  • Business Impact/Affected Users/Visits represents the business impact to application/transaction users. The numbers show the total number of unique users of all monitored applications and users that are experiencing application performance or availability problems (affected users).
  • Slow? (Primary Reason for Slowness) represents charts that show where and why slow pages occur in an application. Tap the associated icon to drill down to the following series of charts:
    • Network network
    • Data Center Server
    • Client/Third Party Client third party
    • Application Design Page design
    • Multiple Reasons Multiple reasons
  • The Transactions Transaction icon represents the transaction health for applications that are performing successfully or problematically. Tap this icon to drill down to the Transactions list.

Application Details

Tap an application or transaction row in Applications and the following detailed data appears. Tap one of these rows and a trend chart appears.

Real Performance and Synthetic represent the monitoring devices you employ in the NAM Server for data from real or synthetic users.

  • Real Performance includes Probe (NAM Probe data), Browser (Dynatrace Application Monitoring data), or Sequential (NAM Probe sequence transactions).
  • Synthetic includes Enterprise Synthetic or Backbone synthetic tests results. The row that is highlighted indicates the current primary source of the application health based on the settings and real user activity (see the Synthetic - Active User Threshold setting the Menu ).

Network Tiers represents the performance of different network segments visualized by network KPIs. Only applications monitored by Probe (NAM Probe data) display these rows. Depending on the configuration and detected traffic, the list can contain:

  • Client Network: Represents network segments between all user locations and monitored infrastructure
  • Network: All other network segments, primarily data center network infrastructure
  • Citrix/WTS (presentation): Network infrastructure that connects users to Citrix or terminal services
  • WAN optimization: Represents data from WAN optimized links

Data Center Tiers represents the primary metric (Performance by default) and other important KPIs over time for all Data Center tiers for a selected application or transaction, as defined by the NAM Server administrator.

Tap the Baseline/Deviation value box to toggle between the baseline and the deviation from the baseline. The arrows indicate the deviation from the norm and if this is good (green), bad (red), or neutral (gray).

Tap an Infrastructure row to open trend charts.

Trend charts

Tap and hold your finger on a chart to select a specific data point. Move your finger left or right on a chart to change the data point selection. This selection is maintained across all charts.

Tap the Details icon Details in the upper right for detailed values of all metrics and their baselines on the selected data points. Tap again to close the details pane. Tap reset to remove data point selection.

The Time Range, and granularity, shown on trend charts depends on the time range selection in application settings. For example, the last one-hour setting results in the last 24 hour by hour trend.

Transactions

Transactions and steps are a group of operations across various tiers that support business tasks for an application. Steps have sequence numbers so you can follow the order of operations for a task.

The transaction icon Transaction represents the percentage of transactions for an application that perform successfully (green) or problematically (red). There must be at least two transactions for the icon to appear.

The color of the icon represents the number of problematic or successful transactions:

  • 100% Green: All transactions are performing successfully
  • 75% Green: 25% of the transactions are problematic
  • 50% Green: 50% of the transactions are problematic
  • 25% Green: 75% of the transaction are problematic
  • 100% Red: All transactions are problematic

Metric thresholds

Customize the metric thresholds for a primary metric by moving the slide back and forth to determine values.

Metric threshold colors serve as a comparison between the current value of the metric and its threshold -- fixed or baseline which is the typical value of the metric. This signifies the high and low deviations from the norm. The associated color changes when the value of the metric rises above, or falls below, the threshold value. You can set a maximum of two thresholds (three colors).

Benchmark threshold values (for Operation Time and Operations) are determined by comparing the metric value by the benchmark value of the same metric, and then relating the comparison result to the threshold. Benchmark values have a range of up to 300%. Click Edit Range to increase this to 550%.

Application Availability

  • Red: Less than 95% (custom)
  • Green: Less than 150%
  • Yellow: 150%-200%

Application Health Index

  • Red: Less than 80% (custom)
  • Green: More than 95%
  • Yellow: 80%-95%

Application Performance

  • Red: Less than 80% (custom)
  • Green: More than 95%
  • Yellow: 80%-95%

Operation Time

  • Red: Above 200% (benchmark)
  • Green: 50%-200%
  • Yellow: Less than 50%

Operations

  • Red: Above 200% (benchmark)
  • Green: 50%-200%
  • Yellow: Less than 50%

Set global MobileAPM metric thresholds on the NAM Server

To make global changes to the MobileAPM metric thresholds on the NAM Server, a NAM Server administrator can go to config/templates/AHSMobileMetricThresholds.xml and make any necessary modifications.

The following lists the metrics and their corresponding identifiers:

  • Application Performance: tierApplPerf
  • Application Availability: tierConn
  • Application Health Index: appHealthIdx
  • Operations: tierOper
  • Operation Time: tierOperTime

Alerts

Tap Alerts Alerts for an alerts log that is generated by your connected NAM Server.

Configure alerts

The NAM Server administrator must configure alerts in the NAM Server first and enable the mobile push notification for mobile recipients. This pertains to alerts that have the application set as a dimension in the NAM Server. This is important if you create unique alerts and do not use the default alerts.

Within MobileAPM, select Notifications from the Menu to choose which applications receive alerts.

Alerts log

Tap Alerts in the Menu for the Alerts log. The Alerts log lists all of the alerts for the selected applications for the time range you select in the menu.

Unacknowledged alerts Alert log remain for one rolling hour before they are automatically acknowledged. All alerts remain in the log for a rolling 24 hours.

The alert icon is grayed out Unacknowledged if an alert occurs while the mobile device is off, or when the alert is acknowledged.

Tap an application in the Alerts log to see Alert details.

Alert details

Tap View application detail to open trend charts that autoselect the time the alert occurred within the context of the hour of the occurrence.

Tap Acknowledge /Acknowledge all to verify receipt of an alert, or all alerts. You can also tap Edit Edit. Tap the link to open the preconfigured NAM Server report for the alert in an external web browser. You must log in to a NAM Server first.

Tap Share (share or share) to send an email or a text message that contains the alert information.

Menu

Click the menu icon or swipe left or right (depending on the device) for the menu.

  • Health summary - see the Health summary description above.
  • Alerts - see the Alerts description above.
  • Time range: Select a time range in which to capture data. Use this to analyze the performance and issues. The default is one hour.
  • Metric settings:
    • Application health index: Percentage of operations completed below threshold and without a failure.
    • Application performance: Percentage of operations completed below threshold time.
    • Availability: Percentage of successful transaction attempts (without a failure).
    • Operation time: Time it takes to complete an operation compared to the baseline.
    • Operations: Real user activity within the application compared to the baseline.
    • Business Impact: You can sort by Business Impact, which displays the data so it represents the business impact to application or transaction users. You can also sort by Primary Metric value.
    • Synthetic - active user threshold: Set the minimum number of users at which Synthetic metrics are replaced by Real User metrics for application or transaction health measurement. The default is five
  • Servers: Lists the available NAM Servers. You must have at least one. Tap Add to add a new server. Enter details for the new server and tap Done. For server details, or to delete the server, tap the arrow at the end of the server row. You can access only one NAM Server at a time.
  • Filters: Choose the applications to appear in the filtered applications list.
  • Notifications: Choose the applications to receive alert notifications. This list is independent of the filtered applications list. To receive notifications the device must have access to the provider's notification service.
  • Metric thresholds - see the Metric thresholds description above.
  • Help: Information about MobileAPM.
  • About: Product and copyright information.