Class Reference
IRIS for UNIX 2019.2
InterSystems: The power behind what matters   
Documentation  Search
  [ENSLIB] >  [Ens] >  [Util] >  [Statistics]
Private  Storage   

class Ens.Util.Statistics extends %RegisteredObject

Container the queries used by Ensemble statistics page. Also contains methods to record activity statistics for given dimensions.

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
38 5


Summary

Methods
%AddToSaveSet %ClassIsLatestVersion %ClassName %ConstructClone
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Extends
%GetParameter %IsA %IsModified %New
%NormalizeObject %ObjectModified %OriginalNamespace %PackageName
%RemoveFromSaveSet %SerializeObject %SetModified %ValidateObject
DisableStatsForConfig DisableStatsForProduction EnableStatsForConfig EnableStatsForProduction
EnumerateCountersClose EnumerateCountersExecute EnumerateCountersFetch EnumerateHostStatusClose
EnumerateHostStatusExecute EnumerateHostStatusFetch EnumerateJobStatusClose EnumerateJobStatusExecute
EnumerateJobStatusFetch EnumerateMetricPropsClose EnumerateMetricPropsExecute EnumerateMetricPropsFetch
EnumerateMetricsClose EnumerateMetricsExecute EnumerateMetricsFetch GetCounterValues
GetStatsUserDimension GetTempStatsDaystoKeep InitStats PurgeUncollectedStats
RecordStats ReportItemsEnabledForStats SetStatsCounterInterval SetStatsUserDimension
SetTempStatsDaystoKeep StatsActive StatsCounterInterval StatsStarted


Methods

• classmethod DisableStatsForConfig(pConfigName As Ens.DataType.ConfigName = "", Output pPrevious As %Boolean) as %Status
This method disable statistics recording for the configuration item passed in.
The code within the method is subject to change.
• classmethod DisableStatsForProduction(pProduction As %String = "", Output pPrevious As %Boolean) as %Status
This method disables statistics recording for all items running in a production in this namespace.
The first parameter is included to allow for future use.
The code within the method is subject to change.
• classmethod EnableStatsForConfig(pConfigName As Ens.DataType.ConfigName = "", Output pPrevious As %Boolean, pOn As %Boolean = 1) as %Status
This method enables or disables statistics recording for the configuration item passed in.
The second parameter returned is the value of the setting prior to the change.
The third parameter specifies if enabled or disabled. The default is enabled.
The code within the method is subject to change.
• classmethod EnableStatsForProduction(pProduction As %String = "", Output pPrevious As %Boolean, pOn As %Boolean = 1) as %Status
This method enables statistics recording for all items running in a production in this namespace.
The first parameter is included to allow for future use.
The second parameter returned is the value of the setting prior to the change.
The third parameter specifies if enabled or disabled. The default is enabled.
The code within the method is subject to change.
• classmethod EnumerateCountersClose(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateCountersExecute(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateCountersFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) as %Status
• classmethod EnumerateHostStatusClose(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateHostStatusExecute(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateHostStatusFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) as %Status
• classmethod EnumerateJobStatusClose(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateJobStatusExecute(ByRef qHandle As %Binary, pHostName As %String = "") as %Status
• classmethod EnumerateJobStatusFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) as %Status
• classmethod EnumerateMetricPropsClose(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateMetricPropsExecute(ByRef qHandle As %Binary, pName As %String = "") as %Status
• classmethod EnumerateMetricPropsFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) as %Status
• classmethod EnumerateMetricsClose(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateMetricsExecute(ByRef qHandle As %Binary) as %Status
• classmethod EnumerateMetricsFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) as %Status
• classmethod GetCounterValues(pHost As %String, ByRef pValues As %Integer, pCount As %Integer, pIntervalSize As %Integer, pSumOnly As %Boolean = 0) as %Integer
For a host pHost, return an array of count counter values in pValues subscripted by slot number. The final slot is the most recent values.
pCount is the number of values (intervals) to return. pIntervalSize is the size, in seconds of each slot (this should be a multiple of 10 and not greater than 3600).
If pSumOnly is true, then do not fill in pValues.
Returns the total number in all the slots.
• classmethod GetStatsUserDimension(pConfigName As %String = "", pConfigType As %Integer = 0) as %String
This returns the User Dimension from the in memory array.
• classmethod GetTempStatsDaystoKeep() as %Integer
This method returns the maximum days to keep the statistics in temporary storage.
If statistics are not moved from temporary to permanent storage this is a safety
measure to prevent the temporary data growing.
This method returns the interval recording time.
The default if not set is 31 days.
• classmethod InitStats(pConfigName As %String = "", pOverrideConfigSetting As %Boolean = 0) as %Boolean
Used to check if statistics ought to be collected and initializes if needed.
The code within the method is subject to change.
• classmethod PurgeUncollectedStats(pDaysToKeep As %Integer = -1, Output pEntriesDeleted As %Integer = 0) as %Status
Counters and Duration are stored in a pure global structure before being moved for analysis.
This method is to be used if necessary to remove this data. It will not be available for analysis after.
• classmethod RecordStats(pConfigType As %Integer = 0, pConfigName As %String = "", pUserDimension As %String = "", pCleanupAfter As %Boolean = 1, pCount As %Integer = 1, pDuration As %Numeric)
This method will record the count and duration statistics to the temporary global.
Passing in pCount will override default count of 1.
Passing in pDuration will override calculated duration and override checking if stats have been started.
Negative Duration (calculated or passed in) is not used.
• classmethod ReportItemsEnabledForStats(ByRef pItems, Output pAllItems As %Boolean = 0) as %Status
This method reports which items are enabled for statistics gathering.
The parameter is passed back an array if there are any items enabled/disabled individually.
The second parameter AllItems will indicate if all items are enabled.
• classmethod SetStatsCounterInterval(pInterval As %Integer = 10) as %Integer
This method set the default interval recording time in seconds.
The minimum is 1 second.
It returns the interval used.
• classmethod SetStatsUserDimension(pConfigName As %String = "", pUserDimension As %String = $$$StatsDefaultDimension)
This sets the User Dimension in the in memory array.
• classmethod SetTempStatsDaystoKeep(pDaysToKeep As %Integer = 31) as %Integer
This method set the maximum days to keep the statistics in temporary storage.
The minimum is 1 day. Default is 31 days.
It returns the interval used.
• classmethod StatsActive(pConfigName As %String = "") as %Boolean
Used to check if statistics are to be gathered.
The code within the method is subject to change.
• classmethod StatsCounterInterval() as %Integer
This method returns the interval recording time.
• classmethod StatsStarted(pConfigName As %String = "") as %Integer
This method tests if statistics gathering has started.

Queries

• query EnumerateCounters()
Selects Category As %String, Item As %String, Count As %Integer
Returns a set of pre-defined counters
• query EnumerateHostStatus()
Selects Name As %String, Type As %String, Status As %String, AdapterState As %String, LastActivity As %TimeStamp, ElapsedTime As %Integer, Queue As %Integer, Count As %Integer
Returns status for a set of hosts
Name is the name of the host item.
Type is the type (Service, Operation, etc.) of the host item.
Status is last reported status for the item.
AdapterState is connected status of jobs for this host.
LastActivity is local time of last activity on this host.
ElapsedTime is number of seconds from time of last activity on this host to now.
Queue is the current number of items in the queue associated with this item.
Count is the number of activities processed since it was started.
• query EnumerateJobStatus(pHostName As %String)
Selects Name As %String, Job As %String, Status As %String, AdapterState As %String, LastActivity As %TimeStamp, Count As %Integer, Method As %String, Retry As %Integer, ActiveMessage As %String
Returns job status for a specific host
• query EnumerateMetricProps(pName As %String = "")
Selects Instance As %String, Property As %String, Value As %String, History As %String
Returns values within a specific BusinessMetric cache
• query EnumerateMetrics()
Selects Name As %String, LastUpdate As %TimeStamp, IsRunning As %Boolean
Returns contents of BusinessMetric cache


Copyright (c) 2019 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.