Flash Media Server 
Server Management ActionScript Language Reference > Server Management ActionScript Dictionary > getInstanceStats()

getInstanceStats()

Availability

Usage

getInstanceStats(app_instance)

Parameters

app_instance A string that contains the name of the instance of the application for which you want performance statistics, in the form application_name/instance_name. You must specify both the application name and the instance name, separated by a slash (/), even if you want performance statistics for the default instance of the application.

For example, to specify the default instance for an application named ChatApp, specify ChatApp/_defInst_.

Returns

If the call succeeds, the server sends a reply information object with a level property of status, a code property of NetConnection.Call.Success, and a data property that is an object. The data object has the following properties:

Property

Description

launch_time

ActionScript Date object; time the instance was launched.

up_time

Number; length of time, in seconds, the instance has been running.

msg_in

Number; total number of messages processed by this instance of the application.

msg_out

Number; total number of messages sent by this instance of the application.

msg_dropped

Number; total number of messages dropped by this instance of the application.

bytes_in

Number; total number of bytes read by this instance of the application.

bytes_out

Number; total number of bytes written by this instance of the application.

accepted

Number; total number of connection attempts accepted by this application.

rejected

Number; total number of connection attempts rejected by this application.

connected

Number; total number of connections currently active.

total_connects

Number; total number of socket connections to this instance of the application since the instance was started.

total_disconnects

Number; total number of socket disconnections from this instance of the application since the instance was started.

script

Object that contains script engine performance data. The following are properties of the script object:

time_high_water_mark: Number; maximum amount of time, in seconds, that the script has taken to execute an event.

queue_size: Number; total number of events currently in the script engine queue.

total_processed: Number; total number of events processed by the script engine.

total_process_time: Number; number of seconds taken to process the number of events in total_processed.

queue_high_water_mark: Number; maximum number of events in the queue.

normal_connects

Number; total number of normal connections.

virtual_connects

Number; total number of connections through a remote edge.

group_connects

Number; total number of remote edges that are connected.

service_connects

Number; total number of service connections.

service_requests

Number; total number of services requested.

admin_connects

Number; total number of administrator connections.

debug_connects

Number; total number of debug connections.

If the call fails, the server sends a reply information object with a level property of error and a code property of NetConnection.Call.Failed or a more specific value, if available. Some objects might also have a description property that contains a string describing the cause of the failure.

Description

Gets the performance data for a specified instance of an application.

If you only need information about the performance of a specific script, use the getScriptStats method.

See also

getActiveInstances(), getAppStats(), getScriptStats()