Package com.lightstreamer.jmx

Interface SessionMBean

public interface SessionMBean
Multiple SessionMBean instances exist in the system, where each one is related to one Session currently active. Every active Session can be bound to 0 or 1 SessionMBean instances. Each SessionMBean instance is created by Lightstreamer Server right after the creation of a Session and destroyed just before that Session terminates.

SessionMBean name pattern:
"com.lightstreamer:type=Session,sessionId=<sessionId>"

However, the creation of SessionMBeans can be disabled and it is disabled by default configuration (see <disable_session_mbeans>). In that case, only a fake MBean of this type with no associated Session is created, as a reminder that the creation can be enabled.
Alternatively, through the same static configuration, it is possible to disable only the computation of statistics based on periodic sampling.

  • Method Details

    • getSessionId

      java.lang.String getSessionId()
      Returns:
      The sessionId of this Session.

    • getStartTime

      java.util.Date getStartTime()
      Returns:
      The timestamp of the creation of this Session.

    • getLocalPort

      java.lang.Integer getLocalPort()
      Returns:
      The local TCP port of the server socket of the current (or last) Streaming or Polling Connection of this Session.

    • getRemoteIP

      java.lang.String getRemoteIP()
      Returns:
      The remote IP address of the current (or last) Client connected to this Session.

    • getRemoteHostname

      java.lang.String getRemoteHostname()
      Returns:
      The remote hostname of the current (or last) Client connected to this Session. Note that the determination of the host name may cause some delay.

    • getRemotePort

      java.lang.Integer getRemotePort()
      Returns:
      The remote TCP port of the client socket of the current (or last) Streaming or Polling Connection.

    • getUserAgent

      java.lang.String getUserAgent()
      Returns:
      The user agent of the Client bound to this Session. This value is obtained from the "User-Agent" field of the HTTP header of the current (or last) Streaming or Polling Request. A length limit is applied, so as not to store values too long.

    • getClientType

      java.lang.String getClientType()
      Returns:
      The type of client API that was used to open this session. This value is not available for some old clients, in such cases it will be null.

    • getClientVersion

      java.lang.String getClientVersion()
      Returns:
      The signature, including version and build number, of the client API that was used to open this session. This value is not available for some old clients and it may not be available for custom clients; in such cases it will be null. For other old clients, the signature may be only partially complete.

    • getUsername

      java.lang.String getUsername()
      Returns:
      The username of the User owning this Session. It may be null.

    • getAdapterSet

      java.lang.String getAdapterSet()
      Returns:
      The name of the Adapter Set bound to this Session.

    • getSubscriptionList

      java.util.List<java.lang.String> getSubscriptionList​(java.lang.String dataAdapter)
      Parameters:
      dataAdapter - the name of a Data Adapter belonging to the Adapter Set related with the Session, or null; if null, all Data Adapters within the Adapter Set are searched and all subscriptions found are aggregated.
      Returns:
      The list of Items currently subscribed to by the Client on this Session. Expressed as an ArrayList of Strings, where each String contains the itemName of the Item. The list is ordered from the earliest to the latest subscription requests; hence, Items used in multiple subscriptions are reported multiple times.

    • getTotalSubscriptions

      java.lang.Long getTotalSubscriptions()
      Returns:
      The total number of Items currently subscribed to by the Client on this Session. Items used in multiple subscription requests are reported multiple times.

    • getTotalFields

      java.lang.Integer getTotalFields()
      Returns:
      The total number of Fields currently subscribed to by the Client on this Session. The fields are aggregated over all the current subscriptions. Any field used in multiple subscriptions, even for the same Item, is counted multiple times.

    • getSampledStatisticsEnabled

      java.lang.Boolean getSampledStatisticsEnabled()
      Returns:
      true if the collection of statistics based on periodic sampling is enabled. If disabled, some of the properties of this MBean will be null (see the various descriptions for details). This enablement can only be managed through static configuration (see <disable_session_mbeans>).

    • getCumulOutboundBytes

      java.lang.Long getCumulOutboundBytes()
      Returns:
      The total (cumulative) number of bytes sent for this Session. The value aggregates all HTTP contents sent on all the Connections that have been bound to the Session.

    • getCumulItemUpdates

      java.lang.Long getCumulItemUpdates()
      Returns:
      The total (cumulative) number of Item Updates sent for this Session.

    • getItemUpdateFrequency

      java.lang.Double getItemUpdateFrequency()
      Returns:
      The frequency of outbound Item Updates sent for this Session in the last sampling period. It is expressed as updates per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getMaxItemUpdateFrequency

      java.lang.Double getMaxItemUpdateFrequency()
      Returns:
      The maximum frequency of outbound Item Updates reached for this Session. It is expressed as updates per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getIsStreaming

      java.lang.Boolean getIsStreaming()
      Returns:
      true if a Streaming connection is currently attached to this Session.

    • getIsPolling

      java.lang.Boolean getIsPolling()
      Returns:
      true if a Polling Connection is currently attached to this Session or the Session is being kept alive, waiting for a Polling Connection.

    • getIsPrestarted

      java.lang.Boolean getIsPrestarted()
      Returns:
      true if the session is currently in "prestarted" state. By prestarted Session we mean a session for which no related requests have been received yet. Binding a session with a new connection also brings it out of the prestarted state. Prestarted session are not included in various session count statistics.

    • getIsOnHTTP

      java.lang.Boolean getIsOnHTTP()
      Returns:
      true if a HTTP Streaming or HTTP Polling connection is currently attached to this Session (or the Session is being kept alive, after a HTTP connection, waiting for a new Connection). Note that a Session can switch between HTTP and WebSocket during its life.

    • getIsOnWS

      java.lang.Boolean getIsOnWS()
      Returns:
      true if a WS Streaming or WS Polling connection is currently attached to this Session (or the Session is being kept alive, after a WS connection, waiting for a new Connection). Note that a Session can switch between HTTP and WebSocket during its life.

    • getCumulStreamingRequests

      java.lang.Long getCumulStreamingRequests()
      Returns:
      The total (cumulative) number of Streaming Requests received for this Session.

    • getCumulPollingRequests

      java.lang.Long getCumulPollingRequests()
      Returns:
      The total (cumulative) number of Polling Requests received for this Session. Note that Streaming Sessions may, in their initial phase receive Polling Requests; in that case, they will be included in this count.

    • getCumulControlRequests

      java.lang.Long getCumulControlRequests()
      Returns:
      The total (cumulative) number of Control Requests received for this Session. The count includes Requests for subscriptions, unsubscriptions, message submission and change of constraints. Note that single HTTP Requests issued to the Server may specify multiple Control Requests. The count does not include incorrect or late Requests that could not be submitted to the Session.

    • getCumulSubscriptionRequests

      java.lang.Long getCumulSubscriptionRequests()
      Returns:
      The total (cumulative) number of Requests for table subscriptions received for this Session (according with the notes for getCumulControlRequests()). The count may include duplicated requests, that will be ignored.

    • getCumulUnsubscriptionRequests

      java.lang.Long getCumulUnsubscriptionRequests()
      Returns:
      The total (cumulative) number of Requests for table unsubscriptions received for this Session (according with the notes for getCumulControlRequests()). The count may include duplicated requests, that will be ignored.

    • getCumulSendMessageRequests

      java.lang.Long getCumulSendMessageRequests()
      Returns:
      The total (cumulative) number of Requests for message submission received for this Session (according with the notes for getCumulControlRequests()). The count may include duplicated or delayed requests, that will be ignored.

    • getCumulControlRequestsFailed

      java.lang.Long getCumulControlRequestsFailed()
      Returns:
      The total (cumulative) number of Control Requests received for this Session (according with the notes for getCumulControlRequests()) whose processing has failed. This is usually due to authorization restrictions posed by the Metadata Adapter. The count may include asynchronous message submission requests that have eventually failed.

    • getCurrentBandwidthKbps

      java.lang.Double getCurrentBandwidthKbps()
      Returns:
      The current outbound bandwidth used by the Server for this Session (in the last sampling period). The count includes network overheads. It is expressed as Kilobits per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getMaxBandwidthKbps

      java.lang.Double getMaxBandwidthKbps()
      Returns:
      The maximum outbound bandwidth used by the Server for this Session. The count includes network overheads. It is expressed as Kilobits per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getAllocatedBandwidthKbps

      java.lang.Double getAllocatedBandwidthKbps()
      Returns:
      The limit on the outbound bandwidth currently enforced for this Session. The count includes network overheads. It is expressed as Kilobits per second; the value has a three decimal precision; a 0 value means that no limit is set.
      Edition Note:
      Bandwidth control is an optional feature, available depending on Edition and License Type. To know what features are enabled by your license, please check out the com.lightstreamer.Edition bean.

    • getAllocatedMaxBandwidthKbps

      java.lang.Double getAllocatedMaxBandwidthKbps()
      Returns:
      The maximum outbound bandwidth allowed by the Server for this Session. The limit includes network overheads. Note that the client can ask for a smaller bandwidth limit; the currently enforced limit is reported by getAllocatedBandwidthKbps(). It is expressed as Kilobits per second; the value has a three decimal precision; a 0 value means that no limit is set; a -1 value means that no limit can be set because of custom license restrictions.
      Edition Note:
      Bandwidth control is an optional feature, available depending on Edition and License Type. To know what features are enabled by your license, please check out the com.lightstreamer.Edition bean.

    • setAllocatedMaxBandwidthKbps

      void setAllocatedMaxBandwidthKbps​(java.lang.Double bandwidth)
      Parameters:
      bandwidth - The maximum outbound bandwidth to be allowed by the Server for this Session. The limit includes network overheads. Note that the client can ask for a smaller bandwidth limit; the currently enforced limit is reported by getAllocatedBandwidthKbps(). It is expressed as Kilobits per second; a 0 value means that no limit is set.
      Edition Note:
      Bandwidth control is an optional feature, available depending on Edition and License Type. To know what features are enabled by your license, please check out the com.lightstreamer.Edition bean.

    • getCumulMessageBytes

      java.lang.Long getCumulMessageBytes()
      Returns:
      The total (cumulative) number of bytes submitted to the Metadata Adapter, for this Session, in the life of the Server and related to Client Messages associated to sendMessage requests. The count includes the byte length of the String objects carrying the messages, according with their internal UTF-16 encoding.

    • getCumulMessages

      java.lang.Long getCumulMessages()
      Returns:
      The total (cumulative) number of Client Messages submitted to the Metadata Adapter, for this Session, in the life of the Server.

    • getMessageFrequency

      java.lang.Double getMessageFrequency()
      Returns:
      The frequency of Client Messages submitted to the Metadata Adapter, for this Session, in the last sampling period. It is expressed as messages per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getMaxMessageFrequency

      java.lang.Double getMaxMessageFrequency()
      Returns:
      The maximum frequency of Client Messages submitted to the Metadata Adapter, for this Session, reached in the life of the Server. It is expressed as messages per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getCurrentMessageThroughputKbps

      java.lang.Double getCurrentMessageThroughputKbps()
      Returns:
      The current throughput (measured in the last sampling period) related to the submission to the Metadata Adapter, for this Session, of Client Messages associated to sendMessage requests. The count includes the byte length of the String objects carrying the messages, according with their internal UTF-16 encoding. It is expressed as Kilobits per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getMaxMessageThroughputKbps

      java.lang.Double getMaxMessageThroughputKbps()
      Returns:
      The maximum throughput (occurred in the life of the Server) related to the submission to the Metadata Adapter, for this Session, of Client Messages associated to sendMessage requests. The count includes the byte length of the String objects carrying the messages, according with their internal UTF-16 encoding. It is expressed as Kilobits per second; the value has a three decimal precision. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getNewLostEvents

      java.lang.Integer getNewLostEvents()
      Returns:
      The number of lost events in the last sampling period. Events can only be lost because of buffer size restrictions posed for safety purpose. This applies to Items subscribed to in RAW mode, or in any mode with unfiltered dispatching specified. This also applies to items subscribed to in COMMAND mode with filtered dispatching, restricted to "ADD" and "DELETE" events only (note that those events can also be filtered through matching). Any lost event is also notified to the client. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getMaxLostEvents

      java.lang.Integer getMaxLostEvents()
      Returns:
      The max number of lost events (as specified for getNewLostEvents()) in a sampling period. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getCumulLostEvents

      java.lang.Long getCumulLostEvents()
      Returns:
      The total (cumulative) number of lost events (as specified for getNewLostEvents()).

    • getNewFilteredEvents

      java.lang.Integer getNewFilteredEvents()
      Returns:
      The number of filtered events in the last sampling period. Events can be filtered only if this is allowed by the item subscription mode; in that case, no information on the current state of the item is lost and the client is not notified. Events lost as specified for getNewLostEvents() are not considered as filtered. Events discarded because of the application of a "selector" are also included in this count, regardless of the subscription mode. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getMaxFilteredEvents

      java.lang.Integer getMaxFilteredEvents()
      Returns:
      The max number of filtered events (as specified for getNewFilteredEvents()) in a sampling period. However, the returned value is always null if the collection of periodic statistics is disabled (see getSampledStatisticsEnabled()).

    • getCumulFilteredEvents

      java.lang.Long getCumulFilteredEvents()
      Returns:
      The total (cumulative) number of filtered events (as specified for getNewFilteredEvents()).

    • getCumulRealTimeEvents

      java.util.List<java.lang.Long> getCumulRealTimeEvents​(java.lang.String itemName, java.lang.String dataAdapter)
      Parameters:
      itemName - an Item name.
      dataAdapter - the name of a Data Adapter belonging to the Adapter Set related with the Session, or null; if null, all Data Adapters within the Adapter Set are searched and all subscriptions found are aggregated.
      Returns:
      The total (cumulative) number of real-time events (hence, not including snapshot events) disaggregated for each of the current subscriptions of the specified Item requested by the Client. Expressed as a List of Long. The list is ordered from the earliest to the latest subscription request for the Item (as in getSubscriptionList(java.lang.String)).

    • getCumulLostEvents

      java.util.List<java.lang.Long> getCumulLostEvents​(java.lang.String itemName, java.lang.String dataAdapter)
      Parameters:
      itemName - an Item name.
      dataAdapter - the name of a Data Adapter belonging to the Adapter Set related with the Session, or null; if null, all Data Adapters within the Adapter Set are searched and all subscriptions found are aggregated.
      Returns:
      The total (cumulative) number of lost events (as specified for getNewLostEvents()) disaggregated for each of the current subscriptions of the specified Item requested by the Client. Expressed as a List of Long. The list is ordered from the earliest to the latest subscription request for the Item (as in getSubscriptionList(java.lang.String)).

    • getCumulFilteredEvents

      java.util.List<java.lang.Long> getCumulFilteredEvents​(java.lang.String itemName, java.lang.String dataAdapter)
      Parameters:
      itemName - an Item name.
      dataAdapter - the name of a Data Adapter belonging to the Adapter Set related with the Session, or null; if null, all Data Adapters within the Adapter Set are searched and all subscriptions found are aggregated.
      Returns:
      The total (cumulative) number of filtered events (as specified for getNewFilteredEvents()) disaggregated for each of the current subscriptions of the specified Item requested by the Client. Expressed as a List of Long. The list is ordered from the earliest to the latest subscription request for the Item (as in getSubscriptionList(java.lang.String)).

    • destroySession

      java.lang.Boolean destroySession()
      Disconnect the Client and destroys this Session.
      Returns:
      True if operation succeeded. False if operation failed.

    • getIsClosed

      java.lang.Boolean getIsClosed()
      Returns:
      true if the Session has just been closed; this may happen in transient cases, when the MBean is about to be removed. In particular, this is the case until the termination of the invocation of the Session's notifySessionClose; in this condition, all the cumulative statistics provided are still valid.