Export (0) Print
Expand All
3 out of 6 rated this helpful - Rate this topic

Monitor apps for SharePoint for SharePoint Server 2013

SharePoint 2013

Published: July 16, 2012

Summary: Learn how administrators and site owners can monitor the health and usage details for apps for SharePoint in SharePoint Server 2013.

Applies to:  SharePoint Server 2013 Standard | SharePoint Server 2013 Enterprise 

You can use the SharePoint Central Administration website to add and remove apps for SharePoint and check details and errors.

Important Important:
  • The steps in this article apply to SharePoint Server 2013 only.

  • App monitoring is not available in SharePoint Foundation 2013.

  • App monitoring is not supported for SharePoint Server 2013 on-premise, multi-tenancy environments.

In this article:

Before you begin

Before you can monitor apps, a member of the Farm Administrators group must configure the environment to support apps for SharePoint. For more information, see Configure an environment for apps for SharePoint (SharePoint 2013).

You must be a member of the Farm Administrators group or the site Owners group to perform the steps in this article.

note Note:

Because SharePoint 2013 runs as websites in Internet Information Services (IIS), administrators and users depend on the accessibility features that browsers provide. SharePoint 2013 supports the accessibility features of supported browsers. For more information, see the following resources:

Selecting apps to monitor in Central Administration

The Monitored Apps page displays the apps for SharePoint that a Farm Administrator monitors. Each app for SharePoint that is listed on this page includes details to help an administrator monitor performance. For example, each app for SharePoint provides the following properties: Name, Status, Source, Licenses in Use, Licenses Purchased, Install Locations, and Runtime Errors. A Farm Administrator chooses to add, remove, and monitor apps for SharePoint.

Important Important:

The Monitor Apps page requires the following search analytics and usage file import timer jobs to be active:

  • ECM analytics timer job name: Usage Analytics timer job for Search Service

  • Usage DB timer job name: Microsoft SharePoint Foundation Usage Data Import

To add an app to the monitor apps list

  1. Verify that the user account that is performing this procedure is a member of the Farm Administrators SharePoint group.

  2. In Central Administration, click General Application Settings.

  3. On the General Application Settings page, in the Apps section, click Monitor Apps.

  4. On the Monitored Apps page, in the Action group of the ribbon, click Add App.

    note Note:

    If the App Catalog is not already created, or if the App Management Service application and app domain settings are not configured correctly the Add App dialog may create an error.

  5. Select the checkbox for the app that you want to monitor, or type a name in the Search for app name box, and then click the Search icon.

  6. On the search results page, select the app that you want to monitor.

    note Note:

    Apps that you add to the Monitored Apps list previously are not displayed in the search results.

  7. Click Add App.

    The app now appears in the list of monitored apps.

To remove an app from the monitor apps list

  1. Verify that the user account that is performing this procedure is a member of the Farm Administrators SharePoint group.

  2. On the Monitored Apps page, select the checkbox next to the app that you want to remove.

  3. In the Manage group of the ribbon, click Remove App.

Monitoring app details in Central Administration

This section explains how farm administrators can monitor and understand the apps for SharePoint details. There are multiple ways that an administrator can view the error and usage details for apps for SharePoint. By selecting an app in the Monitored Apps page, an administrator can use the ribbon to access the error or usage details for that app. An administrator can also click an app in the list on the Monitored Apps page to open the app details page and access the same error or usage details.

The app usage and app error details data that is in the app monitoring pages can be delayed for up to 29 hours. The app details depend on when the ECM analytics timer job is scheduled to run. When the timer job runs, it collects events for the previous day. For example, if the timer job is scheduled to run at 5 A.M., then the most recent events that are collected are from 11:59 P.M. the previous day. An event that occurs at 12:01 A.M. will not appear in the app details pages until up to 29 hours later.

Note that if you view the app error details page for a specific instance of an app, the number of errors for the app is synchronized with the error messages in the list. This occurs because the number of errors appears in the app error details page instead of the events that are processed by the ECM analytics timer job.

note Note:

Be aware that in the Monitored Apps page, the error dialog box can show more errors than are counted. The errors are counted every 24 hours, but the error messages are processed more often. As a result, the error dialog box can show error messages that are generated in the current day before the count is updated at the end of the day.

To view the app usage details in Monitored Apps

  1. Verify that the user account that is performing this procedure is a member of the Farm Administrators SharePoint group.

  2. On the Monitored Apps page, click the app that you want to view.

    A new page opens and displays detailed information about the app, such as the following: licensing, errors, installations, and usage.

    note Note:

    The administrator can also select an app in the monitored apps list and in the App Details group of the ribbon, click View Details.

  3. In the Usage section, click Days, Months, or Years to change the chart to those time frames.

To view the app error details in Monitored Apps

  1. Verify that the user account that is performing this procedure is a member of the Farm Administrators SharePoint group.

  2. On the Monitored Apps page, click the number in the Runtime Errors column for the app you want to view.

    note Note:

    The administrator can also select an app in the monitored apps list and in the App Details group of the ribbon, click View Errors.

  3. The App Monitoring Details dialog appears with information about each error for that app. You can use the Correlation ID to find the errors in the error log.

  4. Click the URL in the Location column to view more error details for this app.

  5. On the App Monitoring Details page, click the number next to Runtime Errors.

  6. The App Monitoring Details dialog appears and includes a list of all Runtime Errors for this app, the time each error occurred, and the Correlation ID.

    note Note:

    The app error list can help you determine if you want to remove the app because there are too many errors or if the app is working as it should.

Monitoring app details in a SharePoint site

This section explains how site owners can monitor and understand the usage of apps for SharePoint. A site owner can view the error and usage details for apps for SharePoint by selecting an app in the Site Contents page and then clicking Monitor in the app dialog box.

note Note:

Be aware that in the app details page, the error dialog box can show more errors than are counted. The errors are counted every 24 hours, but the error messages are processed more often. As a result, the error dialog box can show error messages that are generated in the current day before the count is updated at the end of the day.

To view the app usage details in a SharePoint site

  1. Verify that the user account that is performing this procedure is a member of the site Owners group.

  2. On the Site Contents page, in the quick launch pane, click Apps.

    A new page opens and displays all of the apps that are installed on this site.

  3. On the Apps page click the icon next to the app you want to monitor and then click Details in the callout.

    The App Details page appears for the selected app and the site owner can see the details for licenses, errors Installs and usage.

  4. In the Errors section, click the number next to Install Errors, Runtime Errors, or Upgrade Errors to see the error details.

    For example, click the number next to Runtime Errors and the Runtime Errors dialog appears. This includes a list of all Runtime Errors for this app, the time each error occurred, and the Correlation ID.

    This app error list can help you determine if you want to remove the app because there are too many errors or if the app is working as it should.

    note Note:

    The app errors that appear in this list have occurred within the previous four days.

  5. In the Usage section, click Days, Months, or Years to change the chart to those time frames.

    The chart displays two bars for each time period that represents the number of times the app has been launched and the number of specific users that use this app each day.

    note Note:

    If the app uses connections to external data sources through Business Connectivity Services, a graph that shows the number of calls made to the external data sources is also shown. Dates that appear in the Usage and BCS Calls graphs are in Coordinated Universal Time (UTC).

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.