Viewing historical trends

The history view provides a way to track daily average resource usage of the functions in your service. You can also configure the view to display, or to hide, specific functions.

To open the history view, click History :

Display of the filter bar.

As illustrated in the following screenshot, the history view displays a filter bar, a pair of radio buttons, and two charts:

Display of the default history view.

To close the history view, click Close.

Understanding the charts

Each line in a chart displays the history of resource usage for a specific function. The charts display 30 days of data. The most recent data point on the charts is for the previous day.

The Value type menu lets you display the profile data as a percentage of the resource usage for all functions or as the absolute value in the metric's native units. The absolute usage for a function is determined by computing the ratio of its total resource usage across all profiles in a 24-hour period to the number of profiles in that period.

The Show up to menu lets you configure the maximum number of functions to display. By default, this value is set to 5 functions.

The chart title indicates whether the chart displays the self usage or the total usage. The title also identifies the resource whose history data is displayed. In the previous screenshot, the chart titles indicate that CPU time data is shown.

The chart legend lists the names of the functions whose resource usage is displayed.

Manipulating the chart

To highlight data for a specific function, hold the pointer over the function name in the legend.

To view detailed information about a data point, hold the pointer over the data point to activate the tooltip:

Display of the default history view tooltip.

As illustrated in the previous screenshot, the tooltip displays all of the following:

  • Function name
  • Function filename
  • Date
  • Absolute usage and percentage usage
  • Number of profiles used to generate the data point

Filtering the charts

To show or hide functions, you use filters. The filters accept a regular expression as the filter value and the matches are case-sensitive. The regular expression is compared against all function names and all filenames.

To add a filter, click Add history filter, select an option from the list, and then enter the value for the filter.

Filter Description
Show

To display functions whose name or whose filename matches a RE2 regular expression, add this filter with the value set to the regular expression.

If you add multiple Show filters, then they are joined with a logical OR.

Hide

To hide from the display all functions whose name or whose filename matches a regular expression, add this filter with value set to the regular expression.

If you add multiple Hide filters, then they are joined with a logical OR.

Troubleshooting

This section lists issues that are specific to the history view. For help with other Profiler problems, see the general Troubleshooting section.

Behavior Cause Solution
One or more functions are missing some data points. The charts display historical data for a period of 30 days. If data isn't available for a day, no datapoint is added to the chart. This can result in a partially empty chart. This is not an error condition.
The charts blank and the message No data is available for the filter selections.

For a newly deployed service, no historical data is available to be displayed.

If filters have been applied, then it's possible that the combination of filters eliminates the display of data for all functions in the service. For example, if the filters Show:sort and Hide:sort are applied, then no data is displayed. The Show filter requires that only functions with sort in the name are displayed while the Hide filter forces those same functions to be hidden.

For a newly deployed service, the history view is expected to be empty.

If filters have been applied, then ensure that the combination of filters doesn't eliminate all possible functions.

What's next