ArcObjects Library Reference (Server)  

IServerTimeRange Interface

Provides access to members that report the actual time range for GIS server statistics reported by IServerStatstics to administrators.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.


Read-only property EndTime The end time for the period that the statistics represent.
Read-only property StartTime The start time for the period that the statistics represent.

CoClasses that implement IServerTimeRange

CoClasses and Classes Description
ServerStatisticsArray The ServerStatisticsArray object which returns an array of a specific statistic over a range of time periods.
ServerStatisticsResults The ServerStatisticsResults object which returns a set of statistics, such as count, min, max, mean, for a single time period.


The IServerTimeRange is used to get a report of the actual time period that the results of a statistics query on the GIS server reflects.

As the GIS server creates and destroys server objects, handles client requests and so on, statistics about these events are logged in the GIS server's logs. In addition to the log, statistics are also kept in memory and can be queried using the IServerStatistcs interface. The IServerStatistics interface is a supported interface on ServerObjectAdmin.

While the GIS server's logs maintain a record of all events in the server, the set of statistics that are in memory and that can be queried are accumulated summaries of time slices since the GIS server was started. The granularity of these time slices is more coarse the futher back in time you go. These statistics can be queried for the following time intervals:

Each time period is an accumulated total of the statistics for that time period. For example, if you query for the total number of request to create server contexts for the last 30 days, you would get statistics from now to the begning of the day 30 days ago (not to the current time on that day). This is because the in memory statistcs have been combined for that entire day.

This means that you may actually get statistics for a longer period that you speficied in your query. When you query the GIS server for statistics, you can use the IServerTimeRange interface to get a report of the actual time period that your queries results reflect.

The StartTime property indicates the start of the time period that the server statistics represent.

The EndTime property indicates the end of the time period that the server statistics represent.