Would you like to contribute to the Titanium docs? To get started, sign up for an account on the Appcelerator Wiki and sign our CLA.

Skip to end of metadata
Go to start of metadata

This document provides information on how to authorize a browser or device for Dashboard, how to navigate the Dashboard, overviews of the Dashboard home screen and metrics, what and how to use data filters, and how to export data from the Dashboard.

Authorizing a Browser or Device

Each time you login to Appcelerator Dashboard from a new browser or device, or after clearing your browser's cookies, you will be prompted to enter an authorization code to allow the browser to access Dashboard. This code is emailed to the account associated with your Appcelerator Platform credentials and is valid for 30 minutes since it was sent. If you do not receive the code via email, click one of the  links to resend the code again via email, or via SMS.

Dashboard Navigation

Top Navigation Bar

The top navigation bar in Dashboard lets you select an application or API to view or manage, register a new Android or iOS application, change your current organization. Application team members can access information about their own applications. Organization admins can access information about all of the organization's applications. See Managing Organizations for more information.

topnavbar_annotated

Use the following items to navigate through the Dashboard:

  • Navigation menu – Navigate between Appcelerator products.
  • Home – Click to return to the Dashboard home screen.
  • Apps menu – Select an application to manage, or register a new Android or iOS application.
  • Add menu – Register a new Android or iOS app, create a new Mobile Backend Services datasource or add a new organization member
  • Orgs menu (may not be visible) – Select a different organization to which you belong. Dashboard administrators can also select Manage Orgs to manage organizations, its members and applications. If you only belong to one organization, this menu will not appear in the top navigation bar.
  • Profile menu – View your member profile, access the Download Center to download Appcelerator Studio, Insights, and download enterprise Titanium modules.
  • Notifications menu – Displays notifications and latest organization activity.

Bottom Navigation Bar

The bottom navigation bar contains menus for enabling Demo Data mode, viewing documentation and release notes, and sending feedback.

  • Click Demo Data to populate Dashboard with demonstration data to see how Dashboard looks if you had several applications and APIs in production.  
  • Click the Dashboard version number, for example, 4.1.0, to view release notes.
  • Click the copyright to view some boring legal documents and software copyrights.
  • Click Docs view the latest Appcelerator Platform documentation, which contains documentation for Dashboard, Appcelerator Platform, and the Titanium SDK.
  • Click Support to open the Appcelerator Support portal (login required).
  • Click Status to open the Appcelerator Status page.
  • Click Feedback to open a form to report a problem or make a suggestion.

Dashboard Home Screen

The Dashboard home screen displays a live map showing the location and number of active application sessions. A list shows the five applications with the most active sessions.

map2

  • Double-click the map to zoom-in on a region to view more granular session counts by region.

  • Hover over a circle to view an outline of the region represented by the displayed count.

  • To zoom out, shift+click on the map. You can also use the on-screen zoom controls.

Key Metrics

The lower half of the Dashboard home screen displays several key metrics from the Analytics, Cloud, Performance and Test services. These metrics aggregate data from all applications, deployment environments and versions.  Select a metric to open a details page for that metric.

The following metrics are displayed:

  • Installs – Total number of application installations.
  • Sessions – Total number of times an application was used.
  • Average Session Length – Average time spent using an application
  • Mobile Backend Services Requests – Total number of Mobile Backend Services API calls made by all apps
  • Push Notifications – Total number of push notifications sent by all apps
  • Total Crashes – Total number of crashes
  • % Unique Crashes – Percentage of total crashes that were unique.
  • Test Success Rate – Rate of Test cases that completed without errors.

Each displayed metric includes the total and per-platform count (or length, percentage, etc.), and a 7-day trend.

installcounts

Unspecified Metric Names and Values

In some cases, a metric's value may be unknown to the Dashboard analytics engine. In such cases, a placeholder value – "(not set)" – or placeholder icon –  – is displayed instead. The following describes why, when, and where these placeholder values appear.


Platform Icons for Mobile Backend Services Requests

In metrics for Mobile Backend Services Requests, if a Mobile Backend Services API call originated from a source other than a Titanium application or native iOS application using Appcelerator Platform Services SDK, the placeholder (?) icon is displayed. For instance, this icon would appear for calls made to the Mobile Backend Services APIs using a command-line tool, such as cURL.


Version and Environment Values for Crash and Test Metrics

When viewing Test and Crash analytics, the Version and Environment drop-down menus display "(not set)"  since version and environment information is not available. For the same reason, graphs that display a version series of Crash or Test metrics will display "(not set)".


Geographic Analysis

On a metric's Geo tab, if the country could not be determined from the metric's included geographic coordinates, or coordinates were not provided at all, "(not set)" is displayed as the Country name.


Metric Detail Screens

Select a metric on the main Dashboard screen to open a details page for the selected metric. At top, a line chart displays time series of the selected metric; hover your mouse over an inflection point in the chart to view data for that time. Below the chart a table displays additional details for the selected metric. 

Filter the table and chart data by Application, Platform, or Geographic location.

Use the Metric Details drop-down menu in the upper-left to view details for another metric:

You can select from the following metrics:

  • Installs – Total number of application installations.
  • Sessions – Total number of times an application was used.
  • Average Session Length – Average time spent using an application
  • Mobile Backend Services Requests – Total number of Mobile Backend Services API calls made by all applications.
  • Arrow Requests – Total number of Arrow app calls made by all applications.
  • Push Notifications – Total number of push notifications sent by all applications.
  • Total Crashes – Total number of crashes
  • Unique Crashes – Percentage of total crashes that were unique.
  • Test Success Rate – Rate of Test cases that completed without errors.
  • Tests Run – Total number of tests run.

Data Filters

When viewing aggregated data for all applications or data for only one application on the dashboard, you can filter data by the version number of the application, environment (development or production) or time period, depending on the page displayed. Click the appropriate drop-down box and select a filter option.  The data in the dashboard page will be updated based on the new filter setting. Note that the filters you select persist when navigating through the Dashboard.

Custom Date/Time Range Filter

To filter data for a specific time period, either select one of the predefined options or specify a custom start and end date/time.  To use the custom date/time range filter:

  1. Click on the date filter and select Set Custom Date Range or Change (if a Custom Date Range is already in use).  The Custom Date Range dialog opens.
  2. Select a start and end date with the calendar widget.  The date range is capped to one year.
  3. If the dates selected are four days apart, you need to also select a start time and end time with the time picker.
  4. Select a granularity level from the granularity drop-down list.  The options in the list depend on the time range:
    1. Monthly results: aggregate results by month.  Always shown.
    2. Daily results: aggregate results by day.  Shown if the time period is 92 days or less.
    3. Hourly results: aggregate results by hour.  Shown if the time period is four days or less.
  5. Click Set.

The data in the dashboard page will be updated based on the newly set data/time range filter.  Note that the filters you select persist when navigating through the Dashboard.

Export Data

You can export chart and table data to CSV format to use in other programs, such as Microsoft Excel, to analyze offline.

  1. To export data, first select the data you want export, including the environment, time frame, etc.
  2. Click the Export Data drop-down below the chart, then select either:
    1. Export Chart Data to export the data in the chart.  The data frequency is based on the granularity level selected in the custom date/time range filter.
    2. Export Table Data to export the data in the table.

ExportDataMenuAnnotated

Once you select the export option, your data download begins.

If no data is available, the Export Data drop-down will not appear on the page.

In the example below, session data over a custom time period for all the organization's projects were exported.  Since the granularity level for the data/time range file is set to daily, each data point in the table is also daily.

appceleratordemo_sessions_app_chart_day_20140501_20140625_20140625221049.csv
appceleratordemo_sessions_app_table_day_20140501_20140625_20140625221052