Follow these instructions to perform fault domain isolation for your monitored applications from tablet devices.
Applies to NAM 2019
Starting with NAM 2019, the Dynatrace Mobile App will no longer connect to NAM.
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 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.
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.
Tap the Alerts icon 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.
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.
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:
Set up the following properties (username and password can be empty):
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.
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 to access the MobileAPM reporting and settings menu.
The number colors throughout MobileAPM represent the data state:
- Red = Bad
- Yellow = Warning
- Green = Good (all good = 100% green)
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:
- Data Center
- Client/Third Party
- Application Design
- Multiple Reasons
- The Transactions icon represents the transaction health for applications that are performing successfully or problematically. Tap this icon to drill down to the Transactions list.
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.
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 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 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 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
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%.
- 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%
- Red: Less than 80% (custom)
- Green: More than 95%
- Yellow: 80%-95%
- Red: Above 200% (benchmark)
- Green: 50%-200%
- Yellow: Less than 50%
- 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
Tap Alerts for an alerts log that is generated by your connected NAM Server.
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.
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 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 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.
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 . 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 ( or ) to send an email or a text message that contains the alert information.
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.