ISVforce Guide

Introduction
ISVforce Quick Start
Designing and Building Your App
Packaging and Testing Your App
Passing the Security Review
Publish Your Offering on the AppExchange
Manage Orders
Managing Licenses
Provide a Free Trial
Supporting Your AppExchange Customers
Subscriber Support Console
Usage Metrics
Setting up Usage Metrics
Accessing Usage Metrics Data
MetricsDataFile
Usage Metrics Visualization
Upgrading Your App
Appendices
Glossary
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Usage Metrics Visualization

The Usage Metrics Visualization app, available from Salesforce Labs on the AppExchange, enables you to visualize trends in usage metrics data for your app. You can use the Usage Metrics Visualization app to generate charts showing changes in various app metrics, over a specified duration, for one or more customer organizations.

The app must be installed in your Usage Metrics reporting organization and requires Usage Metrics to be enabled in advance, so some data is available for analysis. You can analyze data going back a maximum of 30 days. If Usage Metrics wasn’t enabled for the entire time period that you specify, only partial data is plotted.

The app is intended as a reference implementation, for illustration purposes only. It’s distributed as an unmanaged package, so you can review its components and extend or customize it to meet your requirements. If your visualization needs are more complex, you can export the raw metrics data from the reporting organization and analyze it by using custom code or a third-party tool .

To install the Usage Metrics Visualization app:
  1. Go to the AppExchange and search for the Usage Metrics Visualization app.
  2. Click Get It Now.
  3. Enter the credentials for your reporting organization, and then click the login button.
  4. Click Install.

You’ll see a message describing the progress and a confirmation message after the installation is complete.

The Usage Metrics Visualization app showing data for the top five Visualforce pages. Usage Metrics visualization app
To visualize the usage metrics data:
  1. Specify the app whose metrics you want to view by selecting it from the App menu.

    You should have enabled Usage Metrics for your app at least a few days before, so some usage data is available to analyze.

    Note

  2. Specify the organization(s) that you want to view metrics for by choosing one of these options.
    • For a single organization, enter its Organization ID in the Single Organization field.
    • For a group of organizations, select one of the following from the All Organizations menu.
      • Any Status
      • All Active: These are organizations used by paying customers.
      • All Free: These are Developer Edition (DE) organizations.
      • All Trial: These are trial organizations, which expire after a specified period.
  3. Specify the type of metric that you want to visualize by selecting one of these values from the Show menu.
    • Total Visualforce Page Views
    • Top 5 Visualforce Pages
    • Total Record Count
    • Top 5 Objects by Record Count
  4. Specify the time period to cover by selecting one of these values from the Date Range menu.
    • Last 30 Days
    • Last 7 Days
    • Last 2 Days

    If the volume of usage data is too large, you might get an error message. In that case, choose a smaller date range and try again.

    Note

  5. Click View Metrics.

The data you specified is displayed on the page as a chart and as a table. To visualize a different data set, change the parameters, and then click View Metrics again.