Getting Started with New Relic Mobiletry.newrelic.com/rs/newrelic/images/NR_Mobile... · Note: The amount of available data depends on your highest subscription level with New Relic.
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Limit the information to a specific version of your app (if available)
Change the time period for data that appears on the dashboard
View details in a table
View details on a chart
Show details about a specific date or time period on a chart
Do this...
Select your choice from the Versions menu below the New Relic title bar at the top.
From the selected app or server dashboard, select an available option from the time picker below the New Relic title bar. (Default is the last 30 minutes, ending now).
Note: The amount of available data depends on your highest subscription level with New Relic. For example, if you have a Lite subscription for your New Relic agent apps and an Enterprise trial subscription for your mobile apps, the Enterprise data retention applies.
Select any row under Slowest Interactions to view additional details.
Point to any place on the chart. Or, select any place on the chart to view this timeframe on its own dashboard.
Drag right or left on any area of the chart to zoom in on the selected range.
If you’re brand new to New Relic, it’ll also be helpful to familiarize yourself with these standard UI functions:
If you want to...
View an app’s dashboard
Filter the list of recent events
View dashboard details about a recent event or alert
Set up an RSS feed for event notifications
Remove or return an app on the list
View a different app on the dashboard
Find out why an app’s “traffic light” is gray
Delete an app from the list
Do this...
From the Mobile list, select the application’s name to go directly to the application’s Overview dashboard. Or, to drill down to specific dashboard details, select the application’s Active Sessions, Interactions/min, Interaction speed, HTTP requests, HTTP error %, or Network failure % data on the application’s row.
Select the icon for specific types of Recent events: All, notifications, critical problems, non-critical problems, or notes.
From the Recent Events list, select the link for the event or alert.
On the Recent Events section of the dashboard, select the orange RSS icon .
To delete an app from the list, select its gear icon , and then select Delete App. To restore a deleted app to the list: scroll to the bottom of the Deleted Apps list, select the app’s gear icon, and select Restore App.
From the app’s menu bar, select the menu arrow next to the current app’s name, and search for another app or select one from the list, or select the Mobile menu to start over.
To view a list of troubleshooting tips if no data is reported for an app, select See Instructions.
To delete an app completely, make sure its traffic light is gray, and then select Delete App.
Create a URL that shows current webpage information
Hide the New Relic title bar and menus (Kiosk mode)
At the bottom of the webpage, select the Permalink icon, and then copy the URL or select the Clipboard icon. This is useful, for example, to copy and paste the Permalink into a support ticket to help troubleshoot any problems at a specific point in time.
At the bottom of the webpage, click the Kiosk mode button.
To restore them, click the Kiosk button at the top of the webpage.
This is useful to hide private information; for example, with demos, advertisements, trade shows, etc.
Any HTTP request that returns a 400 or 500 status code will be captured in New Relic Mobile. If you want to view details about an error
trace, select its request URL link on the Errors dashboard. From here you can:
• View the Response body
• Share the error details with others by email
• File a ticket about it (for example, Lighthouse, Pivotal Tracker, JIRA)
• Delete or hide the error
See an error URL that’s unknown? When your application attempts to connect to a specific URI, New Relic’s servers attempt to parse the URI and
extract the host portion of the URI. If the URI is poorly formed, the host cannot be identified, so it is labeled “Unknown.” For example, a call to
“google,com” (with a comma accidentally used instead of a period) would result in both a network failure on DNS lookup and “Unknown” in the
New Relic user interface.
Each bar on the Errors dashboard shows the percentage of requests to the specific hosts that resulted in errors or failures. The bar chart sorts by
error rate, so 100% errors are always listed first. For example, if there is only one call to a host and that call fails, the chart shows a 100% error rate.
Since all requests to an unparseable URI will fail, the error rate for an “Unknown” host will always be 100%. To solve this problem, try to identify
where the malformed URLs are listed in your app code, and modify them so they no longer fail.
Geography Dashboard
Depending on where your mobile users are located, your app’s performance may vary. The New Relic Mobile Geography dashboard shows
your mobile users’ experience as a world view with color-coded response times, network failure rates, active users, network requests per
minute, or data transfer size. This is where you can drill down into detailed information about each country.
App Code DiagnosticsTrack user activity and create custom metrics
CHAPTER THREE:
You know your code is awesome. Now you can see it in action. With New Relic’s mobile app code diagnostics, you can see exactly how users
are interacting with your app, get alerts when anything abnormal happens, and make sure that everything is working as it should be.
Interactions Dashboard
One of New Relic Mobile’s most useful features is User Interaction Traces. An interaction is any activity that a user performs inside your application—
it could be anything from waiting for a screen or image to load, to posting a photo or updating a profile. All of these individual interactions are
traced to provide a full picture of how they are each affecting the overall performance of your app.
You’ll find a list of your app’s most expensive user interactions in the Interactions Dashboard, which can be sorted by average time,
total time consumed, and view count. You can see code executing on the main thread, as well as code executing on worker threads.
Note: New Relic automatically shows you data for certain interactions (viewloads, image loads, database, JSON parsing, networking) right
out of the box. If there are other interactions you would like to track, use our SDK API to set up your own interactions.
To view interactions for your mobile app:
1. From the New Relic menu bar, select Mobile > (selected app) > App > Interactions.
2. To view information on a particular interaction, select its name from the left column or from the chart.
Custom metrics are great for tracking any business metrics that are not automatically being tracked. For example, let’s say you want to start tracking purchases in your app. You can record a custom metric with the SKU of the particular purchase as the name, and the dollar amount as the value. New Relic will thenstart pulling this data in, giving you a quick and easy way to seehow many purchases are being made in your app.
To view the custom metrics you collect, follow standard procedures to create custom dashboards.
Once you’ve created a custom metric, you’ll be able to view the same details that you get for all other interactions that New Relic automatically
tracks. You can tell which ones they are by taking a look at the category—it’ll be marked as Custom, as seen in the example below.
The weights of lines between your app and its related services indicate their relative throughput: thick, thin, dotted.
Related services include icons to identify them; for example, New Relic apps, webpages, tools, etc.
The service’s label is color coded to indicate its current alert status: Green: LiveYellow: CautionRed: CriticalGray: Inactive
The App Map lists the number of active users for your mobile app for the selected versions and time period. (To change these settings, use the Versions menu and time picker below the New Relic title bar).
To view summary percentages for your mobile app and each related service, from the New Relic menu bar, select Mobile > (selected app) > Mobile > Errors.
The title for each service includes this value.
This value appears below the service’s name.
This appears as a chart below the service’s name.
••••
The following chart will explain everything you’re seeing in the App Map rendering.
Things change, and so will your mobile app and its monitoring needs. Here are a couple tips and tricks for maintaining your monitored
apps in New Relic Mobile.
Renaming an App
You can change your mobile app’s name in the New Relic user interface at anytime, and New Relic will continue to collect, aggregate,
and report data to your app based on the application token used when configuring your mobile app. You do not need to change any code
in your application.
Heads-up: Data reported from your mobile app is tied to a named app based on the application token. All apps with a single application token will
report into the same app in the New Relic Mobile user interface, regardless of the app’s name when installed on a mobile device.
To rename your mobile app:
1. From the New Relic menu bar, select Mobile > (selected app) > Settings > Application.
2. Type a new name.
3. Click Save settings.
Tip: After New Relic Mobile starts to receive data for an app, you can also click its gear icon on the Mobile list to change its name, change its alert settings, or delete it.
Deleting an App
If you decide you’d like to delete an app in New Relic, first be cautioned:
When you delete a mobile app, New Relic Mobile will remove it from your list of available mobile applications, and that name no longer
is available to use. New Relic will also stop collecting data from installed applications that use the deleted app’s application token.
You must be the account’s Admin to delete a mobile app.
1. From the New Relic menu bar, select Mobile.
2. From the list of mobile apps, click the gear icon for the app you want to delete.
3. Select Delete app, and then select OK at the confirmation prompt to continue or select Cancel to keep the app.
Tip: To restore (or completely remove) a deleted mobile app, get support at support.newrelic.com.