Input Name	Range	Type	Description
tag		string	Tag from a previous perf-assoc-view-list-iter-start.

Errno	Description
EINVALIDTAG

Returns objects from a previous call to perf-assoc-view-list-iter-start

Input Name	Range	Type	Description
maximum		integer	The maximum number of entries to retrieve. Range: [1..2^31-1]
tag		string	Tag from a previous perf-view-list-info-iter-start.
Output Name	Range	Type	Description
records		integer	The number of records actually returned. Range: [1..2^31-1]
views		perf-view[]	A list of views

Errno	Description
EINVALIDTAG
EINVALIDINPUTERROR

Initiates a query for a list of performance views.

Input Name	Range	Type	Description
assoc-obj-type		perf-assoc-obj-type optional	If specified, only views with a matching associated object type will be returned. This is ignored if object-name-or-id is specified. Otherwise, all performance views will be returned (subject to the other optional parameters).
include-empty-views		boolean optional	If false, the following will be removed from the output views: lines without any data source charts without any lines views without any charts By default, this is false.
object-name-or-id		obj-name-or-id optional	Name or identifier of an object to list views for. If not specified, all views will be returned (subject to the other optional parameters). The allowed object types for this argument are Resource Group Dataset Resource Pool Host vFiler Aggregate Volume Qtree Lun
verbose		boolean optional	If this is set to false, only a few fields for each view is returned instead of the entire metadata Default is true The following fields will be returned for each view view-name view-type assoc-obj-type
view-type		view-type optional	Indicates the type of views to be returned. If not specified, all types of views will be returned (subject to the other optional parameters).
Output Name	Range	Type	Description
records		integer	Number indicating how many items are available for future retrieval via calls to perf-view-list-iter-next
tag		string	Tag to be used in subsequent calls to perf-view-list-iter-next or perf-view-list-iter-end

Errno	Description
EOBJECTNOTFOUND
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR
EOBJECTAMBIGUOUS
EINVALIDINPUTERROR

Ends an iteration started by perf-client-stats-list-info-iter-start

Input Name	Range	Type	Description
tag		string	The tag from a previous call to perf-client-stats-list-info-iter-start

Errno	Description
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR
EINVALIDTAG

Returns the per-client statistics loaded in a previous call to perf-client-stats-list-info-iter-start

Input Name	Range	Type	Description
maximum		integer optional	The number of records to retrieve in this iteration. If not specified, a default value of 20 is assumed. Range: [ 1 .. 2^31 - 1 ]
tag		string	The tag from a previous call to perf-client-stats-list-info-iter-start
Output Name	Range	Type	Description
hosts-client-stats		host-client-stats[]	The per-client operation statistics.
records		integer	The number of records returned. Range: [ 0 .. 2^31 - 1 ]

Errno	Description
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR
EINVALIDTAG

Iterates over the historical data of stored client statistics for storage systems. If no input filters are specified, all the available collections of statistics will be returned.

Input Name	Range	Type	Description
end-time		timestamp optional	If specified, only client statistics retrieved at or before this time will be returned. The time is specified in seconds from Epoch.
last-only		boolean optional	A convenience input to fetch only the last recorded collection for all hosts, if object-name-or-id is not specified, or a specific host if object-name-or-id is specified. If specified, start-time and end-time will be ignored, and this cannot be specified in conjunction with stat-id.
object-name-or-id		obj-name-or-id optional	Specifies the name or id of the object for which historical client statistics are to be retrieved. If not specified, the statistics will be returned for all available objects. The object must be a storage system.
start-time		timestamp optional	If specified, only client statistics retrieved at or after this time will be returned. The time is specified in seconds from Epoch.
stat-id		stat-id optional	If specified, only the collection of statistics with this id will be returned and all other inputs will be ignored.
Output Name	Range	Type	Description
records		integer	The number of records retrieved. Range: [ 0 .. 2^31 - 1 ]
tag		string	The tag to be used in subsequent calls to perf-client-stats-list-info-iter-next or perf-client-stats-list-info-iter-end.

Errno	Description
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR

Remove collected client stats from the database. If no input is specified, all collections for hosts on which the user can perform the DFM.Database.Write operation will be purged.

Input Name	Range	Type	Description
end-time		timestamp optional	If specified, all statistics collection collected before this time will be removed. The timestamp must be specified in seconds from Epoch.
object-name-or-id		obj-name-or-id optional	Specifies the name or id, in the DFM database, of the object for which statistics collections should be purged. The object must be a storage system.
start-time		timestamp optional	If specified, all statistics collection collected after this time will be removed. The timestamp must be specified in seconds from Epoch.
stat-id		stat-id optional	Specifies the id, in the DFM database, of the collection to be removed. If specified, all other inputs will be ignored. The user must have the capability to perform the DFM.Database.Write operation on the storage system for which the collection with this id was collected.
Output Name	Range	Type	Description
deleted-stats-count		integer	Returns the number of collections of statistics purged from the database. Range: [0 .. 2^31-1]

Errno	Description
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR

Collect per-client NFS and CIFS operation statistics for a storage system. The collection of such statistics will be enabled on all vFiler units on the storage system for a short period of time, and the collected values will then be summarized and returned for the storage system as a whole. This ZAPI is synchronous and will not return an error even if there are errors collecting per-client statistics from some or all vFiler units on the storage system.

Input Name	Range	Type	Description
collection-period		integer optional	Specifies, in seconds, the period of time for which the collection of statistics should be enabled on the filer. If not specified, a default value of 15 will be assumed. The API will be blocked for at least this period of time. In case of heavily loaded storage systems, the duration of blocking may be significantly higher. Range: [15 .. 60]
object-name-or-id		obj-name-or-id	The name or id of the object on which the collection of per-client statistics is to be enabled. The object must be a storage system.
Output Name	Range	Type	Description
errors		client-stat-error[] optional	Returns errors encountered while collecting the per-client statistics, if any.
stat-id		stat-id	Returns the id, in the DFM database, of the collection of statistics stored.

Errno	Description
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR
EBADCREDENTIALS

Propagates source host's current data collection settings to destination hosts. When counter configuration is copied to destination hosts, even if it fails for one host, it proceeds further with the next available host in the destination list. Privilege required is DFM.Database.Write.

Input Name	Range	Type	Description
destination-objects		obj-name-or-id[]	Name or identifier of an object, allowed object types for this argument are Host, Resource Group.
preview		boolean optional	If this flag is true, it performs a dry run before actually committing the changes. It returns a list of counters, host details in case of any discrepancies between source, destination hosts. By default true.
source-host-name-or-id		host-name-or-id optional	DFM hostname or id, the allowed value for this argument is a valid storage system.
src-is-default		boolean optional	This flag allows the destination objects to attach to the default configuration. Default value is set to FALSE.
Output Name	Range	Type	Description
copy-result		destination-host-info[]	Result of copy operation. This element will be included irrespective of preview flag settings. On successful copy operation 'copy-result' will include only 'host-name, host-id' elements. In case of failure the output includes additional element 'error-reason'.
missing-host-object-counters		perf-missing-host-object-counter[] optional	List of counters not available with destination hosts. The output will include these elements only if preview flag is set to true and there is a discrepancy between source, destination hosts.
purged-host-object-counters		perf-purged-host-object-counter[] optional	List of counters for which historical data will be purged. The output will include these elements only if preview flag is set to true and there is a discrepancy between source, destination hosts.

Errno	Description
EAPIPRIVILEDGE
EAPIERROR
EINTERNALERROR
EOBJECTNOTFOUND
EACCESSDENIED
EINVALIDINPUTERROR

Creates a counter group. Global DFM.PerfView.Write is required to create historical counter group. To create a real-time counter group Global DFM.PerfView.RealTimeRead is required.

Input Name	Range	Type	Description
counter-group		perf-counter-group	The counter group to create.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE

Destroys a counter group. Privilege to destroy a historical counter group is Global DFM.PerfView.Delete. And to destroy a real-time counter group, Global DFM.PerfView.RealTimeRead is required.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards.
counter-group-name		string	Name of counter group to destroy. All the views that are using the counter group are automatically destroyed.
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id is specified. This field defaults to global group if appliance-name-or-id is not specified.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE

Retrieve a set of data for a set of data sources from a specific counter group. The data is extracted for the given time interval bounded by start-time and end-time. This API is suitable for extracting the data for a single line in a chart (graph). Privilege required is DFM.Database.Read. For viewing real-time data Global DFM.PerfView.RealTimeRead is also required.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards.
counter-group-name		string	Counter group name from which we want to fetch data.
data-group		perf-data-group	A definition of the data source(s) requested, plus an optional consolidation method.
end-time		integer optional	Time stamp marking the end of requested data. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. If unspecified, server should end with the latest available data.
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id is specified. This field defaults to global group if appliance-name-or-id is not specified.
sample-rate		integer optional	The desired interval between samples, in seconds. If the available samples have higher resolution than the one specified, multiple samples are consolidated into one sample to achieve the desired resolution, using the specified time-consolidation-method. If unspecified, the data returned will be at the sample-rate specified upon creation of the counter group.
start-time		integer optional	Time stamp marking the beginning of requested data. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. If unspecified, server should begin with the earliest available data.
time-consolidation-method		string optional	A function to apply across the data to achieve the desired time resolution, if the requested sample-rate is different from the actual sample-rate of the data. The values can be average, min, max, or last. The default is last.
Output Name	Range	Type	Description
counter-data		string	The retrieved data - possibly consolidated, but just a single array. The format is a series of comma-separated timestamp:value pairs. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. The values may have optional decimal extensions, for example 1064439599:127,1064439600:98.6,1064439601:12
unit		string optional	Unit of counter-data. This element will not be present if the unit is not known. Some possible values are per_sec, percent, b_per_sec, kb_per_sec, msecs, usecs. Maximum Length: 32 characters.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE

Retrieve a list of top-n data sources for a counter. Privilege required is read.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards.
counter-group-name		string	Counter group name from which we want to fetch data.
dynamic-data-sources		perf-dynamic-data-sources	Criteria for choosing top-n instances for a counter.
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id is specified. This field defaults to global group if appliance-name-or-id is not specified.
Output Name	Range	Type	Description
data-sources		perf-data-source[]	Identifiers for the data sources correspoing to dynamic instances. Each perf-data-source represents one instance.

Errno	Description
EAPIPRIVILEDGE
EGROUPDOESNOTEXIST
EAPILICENSE

Retrieve one or more counter groups. Privilege required is read.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards. Either appliance-name-or-id or object-name-or-id should be specified, but not both. object-name-or-id is preferred as usage of appliance-name-or-id, group-name-or-id is deprecated.
consolidate-hosts		boolean optional	If true, then information for all the hosts is consolidated and returned instead of information for individual hosts.
counter-group-name		string optional	Counter group name to retrieve. If unspecified, all counter groups will be retrieved.
counter-info-only		boolean optional	If true, the output element perf-counter-group, includes only the list of enabled counters of the host with object type derived from the counter group name. In this case data-sources will not be returned. By default false.
custom-only		boolean optional	If true, returns only custom counter groups, by default false.
disabled-counter-info-only		boolean optional	If TRUE, returns counter information of the presently disabled counters. Default value is FALSE.
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id or object-name-or-id is specified. This field defaults to global group if appliance-name-or-id or object-name-or-id is not specified. object-name-or-id is preferred as usage of group-name-or-id is deprecated.
include-calculated-stats		boolean optional	This option is valid only if either 'counter-info-only' or 'disabled-counter-info-only' is set to TRUE. If this flag is set to TRUE, the counter information will include calculated stats counters otherwise by default it will exclude those counters.
meta-data-only		boolean optional	If true, do not return any perf-data-sources with the perf-counter-group. By default false.
object-name-or-id		obj-name-or-id optional	If specified, output contains the counter-info element with list of enabled counters belonging to supplied counter-group-name. If counter-group-name is not set then output includes counters information for all counter groups of the hosting filer. Either appliance-name-or-id or object-name-or-id should be specified, but not both. object-name-or-id is preferred as usage of appliance-name-or-id, group-name-or-id is deprecated.
Output Name	Range	Type	Description
counter-groups		perf-counter-group[]	Counter group(s) retrieved.

Errno	Description
EAPIPRIVILEDGE
EAPIERROR
EAPILICENSE

Terminate a counter group list iteration and clean up any saved info. Privilege required is read.

Input Name	Range	Type	Description
tag		string	The tag from a previous perf-counter-group-list-iter- call.

Errno	Description
EAPIPRIVILEDGE

Returns items from a previous call to perf-counter-group-list-iter-start. Privilege required is read.

Input Name	Range	Type	Description
maximum		integer	The maximum number of entries to retrieve.
tag		string	The tag from a previous perf-counter-group-list-iter- call.
Output Name	Range	Type	Description
counter-groups		perf-counter-group[]	Counter group(s) retrieved.
records		integer	The number of records actually returned. Range: [1..2^31-1]

Errno	Description
EAPIPRIVILEDGE

Initiates a query for a list of performance counter group names. Privilege required is read.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards.
counter-group-name		string optional	Counter group name to retrieve. If unspecified, all counter groups will be retrieved.
custom-only		boolean optional	if TRUE, only custom groups will be retrieved, by default false
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id is specified. This field defaults to global group if appliance-name-or-id is not specified.
meta-data-only		boolean optional	If TRUE, do not include any perf-data-sources with each perf-counter-groups.

Errno	Description
EAPIPRIVILEDGE

Modify an existing counter group. User can modify the sample-interval, sample-buffer and the counter set of an existing counter group at the individual host level. Modifying a counter set of a counter group means user can selectively enable/disable counters according to the requirement of collecting data. If a counter is disabled data will not be collected for that counter and this gives the flexibility of controlling load on a storage system. This zapi will only enable the counters mentioned in the 'data-sources' part of the input parameter 'perf-counter-group' and rest of the counters of the counter group will be automatically disabled. User can also disable all the counters of a counter group by setting the flag 'is-disable-all' in the input parameter 'perf-counter-group'. Enabling/disabling counters is not allowed for calculated stats counters in default counter groups. Privilege required is DFM.Database.Write.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards.
counter-group		perf-counter-group	The new counter group information. Note that the new counter group name may be different from the old counter group name. If different, the new counter group name must not already exist.
counter-group-name		string	The name of the counter group to modify.
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id is specified. This field defaults to global group if appliance-name-or-id is not specified.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE

Start data collection for one counter group. Privilege required is Global DFM.PerfView.Write for normal views and Global DFM.PerfView.RealTimeRead for real-time views.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards.
counter-group-name		string	Counter group name to start data collection for. This must not be a default counter group.
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id is specified. This field defaults to global group if appliance-name-or-id is not specified.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE

Stop data collection for one counter group. Privilege required is Global DFM.PerfView.Write for normal views and Global DFM.PerfView.RealTimeRead for real-time views.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name (or unique ID) of the source storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next. The API will accept a vfiler name or id from DFM 3.3 onwards.
counter-group-name		string	Counter group name to stop data collection for. This must not be a default counter group.
group-name-or-id		string optional	The name (or unique ID) of the source group. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs. This field is ignored if appliance-name-or-id is specified. This field defaults to global group if appliance-name-or-id is not specified.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE

This API shall troubleshoot the DFM object for performance related issues and provides the recommendations to help resolve them.

Input Name	Range	Type	Description
duration		integer optional	The recent time in seconds for which the data has to be analyzed Either duration or start-time/end-time has be specified but not both. An error will be returned if at least one of them is not supplied.
end-time		integer optional	Time stamp marking the end of diagnosis window The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. Range: [0..(2^32)-1] Either duration or start-time/end-time has to be specified but not both. An error will be returned if at least one of them is not supplied.
object-name-or-id		obj-name-or-id	object-name or id of the following objects that needs troubleshooting. Storage System
start-time		integer optional	Time stamp marking the beginning of diagnosis window The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. Range: [0..(2^32)-1] Either duration or start-time/end-time has to be specified but not both. An error will be returned if at least one of them is not supplied.
Output Name	Range	Type	Description
categories		perf-diag-category[]	List of root causes or performance problems.

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR

Disables DFM performance advisor data collection.

Input Name	Range	Type	Description
is-async		boolean optional	Returns immediately without waiting for DFM performance advisor to disable the data collection completely (when set to true). By default this API is synchronous.
is-persistent		boolean optional	If true the disabling of Performance Advisor is saved in the database. If false, the disbling is temporary and the setting is not saved in the database. If the server restarts the data collection begins again.

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR

Disables any modification to DFM performance advisor views, counter groups and object instances.

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR

Enables DFM performance advisor data collection.

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR

Enables modifications to DFM performance advisor views, counter groups and object instances.

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR

Retrieve data for all the related objects for the given object and the specified performance counters.

Input Name	Range	Type	Description
direction		string optional	This field is used only when duration is specified It is used to derive the time period for which data is to be retrieved. If the value is set to 'forward', then the starting time is the time stamp of the oldest data. The ending time is the sum of time stamp of the oldest data and the duration. If the value is set to 'backward', then the starting time is the difference between time stamp of the most recent data and the duration. The ending time is the time stamp of the most recent data. If the value is set to 'backward-from-now', then the starting time is the difference between current time and the duration. The ending time is the current time. Default value is 'backward'
duration		integer optional	The duration for which the data is to be returned, in seconds. The time period is calculated based on the direction flag. Duration should not be specified when either start-time or end-time is specified. If specfied, EINVALIDINPUTERROR error will be returned. Range: [0..(2^32)-1]
end-time		integer optional	Time stamp marking the end of requested data. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. If unspecified, server should end with the latest available data. Range: [0..(2^32)-1]
instance-counter-info		instance-counter-info	This defines what counter data to be returned for the specified instances.
number-samples		integer optional	The total number of samples to be returned. The sample-rate will be calculated based on the start-time and end-time. If the available samples have higher resolution than the one specified, multiple samples are consolidated into one sample to achieve the desired resolution, using the specified time-consolidation-method. If unspecified, the number of samples returned will be based on the sample-rate specified upon creation of the view. Either sample-rate or number-samples should be specified, but not both. Range: [1..(2^32)-1]
sample-rate		integer optional	The desired interval between samples, in seconds. If the available samples have higher resolution than the one specified, multiple samples are consolidated into one sample to achieve the desired resolution, using the specified time-consolidation-method. If unspecified, the data returned will be at the sample-rate specified in the counter group that the counter is present. Range: [1..(2^32)-1].
start-time		integer optional	Time stamp marking the beginning of requested data. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. If unspecified, server should begin with the earliest available data. Range: [0..(2^32)-1]
time-consolidation-method		string optional	A function to apply across the data to achieve the desired time resolution, if the requested sample-rate is different from the actual sample-rate of the data. Possible values : 'average' 'min' 'max' 'last' Default is 'last'
time-filter		time-filter optional	Time based filter to reading data. This filter will be applied on the range derived from the start-time/end-time/duration/direction fields. This field is used only for metrics calculations, if metrics field is not specified in the input this field will be ignored.
Output Name	Range	Type	Description
invalid-counter-instances		invalid-counter-instance[] optional	A list of invalid counter instance pairs, for which performance data could not be fetched.
perf-instances		perf-instance-counter-data[] optional	List of instances. Each element of this list contains the counter data for an instance.

Errno	Description
EOBJECTNOTFOUND
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR

Find out the Operations Manager reports, Performance Advisor custom views, Performance Advisor threshold templates and Performance Advisor thresholds which depend on the specified performance counters.

Input Name	Range	Type	Description
counters		perf-object-counter[]	The list of counters.
host-name-or-id		host-name-or-id optional	The host name or id. If this parameter is specified, custom views attached to object instances will be returned in addition to the custom views attached with object types.
Output Name	Range	Type	Description
base-counters		perf-object-counter[] optional	The list of counters to which at least one of the input counters are dependent.
dependent-counters		perf-object-counter[] optional	The list of counters dependent on at least one of the input counters. This dependent counter list will contain both the calculated stats as well as the basic counters.
reports		perf-report[] optional	The list of report names that have at least one of the input counters.
threshold-templates		threshold-template[] optional	The list of threshold template names that have at least one of the input counters.
thresholds		perf-threshold[] optional	The list of thresholds that have at least one of the input counters.
views		perf-view[] optional	The list of custom views that have at least one of the input counters.

Errno	Description
EAPIERROR
EACCESSDENIED
EDATABASEERROR
EINVALIDINPUTERROR

Given an array of performance objects and counters, the API will return a list of all counters that are not part of any view.

Input Name	Range	Type	Description
object-counter-list		perf-object-counter-info[]	Array of perf-object-counter-info elements for which information is needed, to know whether they belong to any view or not.
Output Name	Range	Type	Description
orphan-object-counter-list		perf-object-counter-info[]	Array of perf-object-counter-info elements that are not part of any view.

Errno	Description
EINTERNALERROR
EAPIPRIVILEDGE
EOBJECTNOTFOUND
EACCESSDENIED
EINVALIDINPUTERROR

Gets the default view for an object.

Input Name	Range	Type	Description
object-name-or-id		obj-name-or-id optional	Specifies the object for which the view is to be retrieved. If not present, then Global Group is assumed.
Output Name	Range	Type	Description
view-name		string	The view-name which is to be displayed by default for the object. Maximum length is 255 characters

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR

Returns the status of DFM Performance Advisor.

Output Name	Range	Type	Description
perf-server-status		perf-server-status	Specifies the status of Performance Advisor.

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR

Retrieve information about a performance object's counters. (No iterator-based equivalent exists for this API because the number of object counters is fewer than two hundred in number.) Privilege required is read.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name or unique ID for the storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next API. The API will accept a vfiler name or id from DFM 3.3 onwards.
include-calculated-stats		boolean optional	If set to false the output will exclude the calculated stats counters. By default the value is true i.e will always include calculated stats.
object-name		string	Name of the performance object to retrieve counters for. Object names are broad classes of system components and protocols, like NFS, VOLUME, DISK, ...
Output Name	Range	Type	Description
counters		perf-counter[]	Counters retrieved.

Errno	Description
EAPIPRIVILEDGE

Retrieve information about a performance object's dependent counters. Privilege required is read.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	The name or unique ID for the storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next API. The API will accept a vfiler name or id from DFM 3.3 onwards.
object-name		string	Name of the performance object to retrieve dependent counters. Object names are broad classes of system components and protocols, like NFS, VOLUME, DISK, ...
Output Name	Range	Type	Description
dependent-counters		perf-dependent-counter-info[]	List of dependent counters.

Errno	Description
EAPIPRIVILEDGE
EAPIERROR
EINTERNALERROR
EOBJECTNOTFOUND
EACCESSDENIED

Terminate an instance list iteration and clean up any saved info. Privilege required is read.

Input Name	Range	Type	Description
tag		string	The tag from a previous perf-object-instance-list-iter- call.

Errno	Description
EAPIPRIVILEDGE

Returns items from a previous call to perf-object-instance-list-iter-start Privilege required is read.

Input Name	Range	Type	Description
maximum		integer	The maximum number of entries to retrieve.
tag		string	The tag from a previous perf-object-instance-list-iter- call.
Output Name	Range	Type	Description
instances		perf-instance[]	A list of instances.
records		integer	The number of records actually returned. Range: [1..2^31-1]

Errno	Description
EAPIPRIVILEDGE

Initiates a query for a list of performance object instance names. Privilege required is read.

Input Name	Range	Type	Description
appliance-name-or-id		string	Name (or unique ID) of the storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next API. The API will accept a vfiler name or id from DFM 3.3 onwards.
object-name		string	Name of the performance object to retrieve instances for. Object names are broad classes of system components and protocols, like NFS, VOLUME, DISK, ...
Output Name	Range	Type	Description
records		integer	Number indicating how many items are avialble for future retrieval with perf-object-instance-list-iter-next.
tag		string	Tag to be used in subsequent calls to perf-object-instance-list-iter-next or perf-object-instance-list-iter-end.

Errno	Description
EAPIPRIVILEDGE

Get a list of performance objects. (No iterator-based equivalent exists for this API because the number of performance objects is fewer than twenty in number.) Privilege required is read.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	Name (or unique ID) of the storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next API. The API will accept a vfiler name or id from DFM 3.3 onwards.
Output Name	Range	Type	Description
objects		perf-object[]	A list of performance objects.

Errno	Description
EAPIPRIVILEDGE

Sets the default view for an object.

Input Name	Range	Type	Description
object-name-or-id		obj-name-or-id optional	Specifies the object for which the view is to be set. If not specfied, then the Global Group is assumed.
view-name		string	The view-name which is to be displayed by default for the object. Maximum length is 255.

Errno	Description
EINTERNALERROR
EAPIERROR
EACCESSDENIED
EDATABASEERROR

Returns the DFM performance advisor status

Input Name	Range	Type	Description
host-name-or-id		string	DFM name or id of the host
Output Name	Range	Type	Description
data-unavailable-reason		perf-status-error[] optional	This element is included only if is-data-available is set to false and indicates the reason(s) for failure.
is-data-available		boolean	Returns if the performance data can be collected for this host

Errno	Description
EAPIPRIVILEDGE
EAPIERROR

Sets threshold values on one or more objects based on a performance counter. Privilege required is DFM.Database.Write. Threshold will be set only if the User has DFM.Database.Write permission over the object specified.

Input Name	Range	Type	Description
threshold-info		threshold-info	Information about a threshold that needs to be set.
Output Name	Range	Type	Description
threshold-id		threshold-id	If the threshold does not exist and is being created for the first time, then this parameter is present in the output. If a threshold already exists, then an error is returned instead of this parameter.

Errno	Description
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
ETHRESHOLDEXIST
EACCESSDENIED
EOBJECTNOTFOUND

Creates one threshold composed of one or more counters, and optionally applies it to an object. The user must have the capability to perform the DFM.Database.Write operation on the object on which the threshold is applied.

Input Name	Range	Type	Description
object-name-or-id		obj-name-or-id	Specifies the object on which the threshold is to be applied. When applying a threshold to an object, in case of container objects (like groups) or parent objects (like storage systems), if a counter is specified on a child object, the threshold applies to all such children. For example, if aggr:cp_reads is specified as one of the counters in the threshold and there is no counter of an object which is a child of an aggregate (viz. volume or qtree), and the object-name-or-id is that of a storage system, the threshold applies to all present and future aggregates on the storage system.
threshold-info2		threshold-info2	Specifies the attributes of the threshold to be created.
Output Name	Range	Type	Description
threshold-id		threshold-id	Specifies the id of the threshold that is created.

Errno	Description
EACCESSDENIED
EDATABASEERROR
EAPIERROR
EINTERNALERROR
EINVALIDINPUTERROR

Removes threshold set on a counter. The user must have the capability to perform the DFM.Database.Delete operation on the object on which the threshold is directly applied. This ZAPI cannot be used to delete template thresholds, and perf-threshold-template-modify should be used for that purpose.

Input Name	Range	Type	Description
threshold-id		threshold-id	The unique identifier of a threshold that needs to be deleted.

Errno	Description
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
EACCESSDENIED
EDATABASEERROR

Terminate a counter-thresholds-list iteration and clean up any saved info. Privilege required is DFM.Database.Read. Only thresholds on objects over which the user has DFM.Database.Read permissions will be returned.

Input Name	Range	Type	Description
tag		string	The tag from a previous perf-threshold-list-iter call.

Errno	Description
EAPIPRIVILEDGE
EINVALIDTAG

The perf-threshold-list-info-iter-* list of APIs are used to retrieve the list of all counters on which thresholds have been set. It loads the list of counters on which thresholds have been set into a temporary store. The API returns a tag that identifies that temporary store so that subsequent APIs can be used to iterate over the threshold related counters in the temporary store. Privilege required is DFM.Database.Read. Only thresholds on objects over which the user has DFM.Database.Read permissions will be returned.

Input Name	Range	Type	Description
maximum		integer	The maximum number of entries to retrieve. Range: [1..2^31-1]
tag		string	The tag from a previous perf-threshold-list-iter call.
Output Name	Range	Type	Description
attributes-list		threshold-info[]	List of performance thresholds.
records		integer	The number of records actually returned. Range: [0..2^31-1].

Errno	Description
EAPIPRIVILEDGE
EINVALIDTAG

The perf-threshold-list-info-iter-* list of APIs are used to retrieve the list of all counters on which thresholds have been set. It loads the list of counters on which thresholds have been set into a temporary store. The API returns a tag that identifies a temporary store so that subsequent APIs can be used to iterate over the threshold related counters in the temporary store. Privilege required is DFM.Database.Read. Only thresholds on objects over which the User has DFM.Database.Read permissions will be returned.

Input Name	Range	Type	Description
query		threshold-info optional	Attributes of the thresholds that need to be listed. If none of the parameters are specified, then all the thresholds will be listed. If a single threshold-id is specified, then only information relevant to that threshold will be returned and the rest of the parameters will be ignored. If only an object-name-or-id is specified, then only thresholds set on that object will be returned. Ex. if object-name-or-id identifies a volume, thresholds set on that volume only will be returned. If object-name-or-id resolves to more than one volume, thresholds set on all of them will be returned. If no object-name-or-id is provided, all thresholds will be listed. Likewise, if only perf-object-counter is specified, only thresholds that belong to this counter-name and object type will be returned. If no counter-name is specified, thresholds set on any counter is returned. If both object-name-or-id and perf-object-counter is specified, then only thresholds set on a combination of all these parameters will be listed. The rest of the parameters in threshold-info are ignored.
Output Name	Range	Type	Description
records		integer	Number indicating how many items are available for future retrieval via calls to perf-threshold-list-info-iter-next
tag		string	Tag to be used in subsequent calls to perf-threshold-list-info-iter-next. It is an opaque handle used by the DFM station to identify a temporary store.

Errno	Description
EACCESSDENIED
EAPIERROR
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
EOBJECTNOTFOUND

Terminate a perf-thresholds-list-info2 iteration and clean up any saved info.

Input Name	Range	Type	Description
tag		string	The tag from a previous perf-threshold-list-info2-iter-start call.

Errno	Description
EAPIPRIVILEDGE
EINVALIDTAG

The perf-threshold-list-info2-iter-* list of APIs are used to retrieve the list of all objects on which thresholds have been set.

Input Name	Range	Type	Description
maximum		integer	The maximum number of entries to retrieve. Range: [1..2^31-1]
tag		string	The tag from a previous perf-threshold-list-info2-iter-start call.
Output Name	Range	Type	Description
attributes-list		threshold-info2[]	List of performance thresholds.
records		integer	The number of records actually returned. Range: [0..2^31-1].

Errno	Description
EAPIPRIVILEDGE
EINVALIDTAG

The perf-threshold-list-info2-iter-* list of APIs are used to retrieve the list of objects on which thresholds have been set. It loads the list of thresholds into a temporary store. The API returns a tag that identifies the temporary store so that subsequent APIs can be used to iterate over the thresholds in it. The user must have the capability to perform the DFM.Database.Read operation on the object on which the threshold is applied, and only thresholds which are applied on such objects will be returned.

Input Name	Range	Type	Description
object-name-or-id		obj-name-or-id optional	If specified, only thresholds set on this object will be returned. This includes thresholds that apply to this object via inheritance. For example, if there is a threshold on an aggregate counter applied to a filer, and obj-name-or-id identifies an aggregate in that filer, the threshold will be returned.
threshold-id		threshold-id optional	If specified, only information relevant to the threshold with this id will be returned. This parameter takes precedence over all others, and it may not be specified in combination with any of the other arguments.
Output Name	Range	Type	Description
records		integer	Number indicating how many items are available for future retrieval via calls to perf-threshold-list-info2-iter-next
tag		string	Tag to be used in subsequent calls to perf-threshold-list-info2-iter-next. It is an opaque handle used by the DFM station to identify a temporary store.

Errno	Description
EACCESSDENIED
EAPIERROR
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
EOBJECTNOTFOUND

Allows modification of threshold value and threshold interval that have been set before. Privilege required is DFM.Database.Write.

Input Name	Range	Type	Description
attributes		threshold-info	Attributes of a threshold that needs to be modified. If the threshold-id is specified, then object-name-or-id and perf-object-counter are ignored. If the threshold-id is not specified, then object-name-or-id and perf-object-counter are mandatory. The rest of the parameters are optional. If the threshold-value specified is in a different metric, then the threshold-unit needs to be specified for appropriate conversion.

Errno	Description
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
EOBJECTNOTFOUND
EACCESSDENIED
EDATABASEERROR

Modify an existing threshold. This ZAPI should be used only for changing the parameters of a threshold, not for changing the objects it is not applied on. The objects-info structure is ignored in this ZAPI. This ZAPI cannot be used to modify template thresholds, and perf-threshold-template-modify should be used for that purpose. The user must have the capability to perform the DFM.Database.Write operation on the object on which the threshold is applied.

Input Name	Range	Type	Description
threshold-info2		threshold-info2	Information on the threshold to modify. The threshold-id parameter must be specified to modify a threshold.

Errno	Description
EACCESSDENIED
EDATABASEERROR
EAPIERROR
EINTERNALERROR
EINVALIDINPUTERROR

Attach one or more objects to a performance template. Either all input objects get attached or none of them get attached. The specified objects will get associated to the applicable thresholds in the template. Objects cannot be attached if the template has no thresholds. Objects already attached to the template are left unchanged. The user must have the capability to perform the DFM.Database.Write operation on the object to which the template is to be attached.

Input Name	Range	Type	Description
new-objects		object-info[] optional	The list of objects to be attached to the template. At least one object should be specified.
template-name-or-id		string	Name or id of a performance template

Errno	Description
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
EACCESSDENIED
EDATABASEERROR
EOBJECTNOTFOUND

Creates a template for perf thresholds.

Input Name	Range	Type	Description
member-thresholds		threshold-info2[] optional	Specifies the thresholds that are to be part of this template.
template-description		string optional	Description of the template.
template-name		string	Name of the template.
Output Name	Range	Type	Description
template-id		integer	This returns the id of the template that is created Range: [1..2^32-1]

Errno	Description
EACCESSDENIED
EDATABASEERROR
EAPIERROR
EINTERNALERROR
EINVALIDINPUTERROR
EPERFTEMPLATEEXISTS

Deletes a template.

Input Name	Range	Type	Description
template-name-or-id		string	The name or id of the template that is to be deleted.
Output Name	Range	Type	Description
template-id		integer	The id of the deleted template. Range: [1..2^32-1]
template-name		string	The name of the deleted template.

Errno	Description
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
EACCESSDENIED
EDATABASEERROR

Detaches one or more objects from a performance template. Either all or none of the input objects get detached. The user must have the capability to perform the DFM.Database.Write operation on the object which is to be detached from the template.

Input Name	Range	Type	Description
objects		object-info[] optional	The list of objects to be detached from the template. At least one object should be specified.
template-name-or-id		string	Name or id of a performance template

Errno	Description
EAPILICENSE
EAPIPRIVILEDGE
EINTERNALERROR
EINVALIDINPUTERROR
EACCESSDENIED
EDATABASEERROR
EOBJECTNOTFOUND

Terminate a perf-threshold-template-list iteration and clean up any saved information.

Input Name	Range	Type	Description
tag		string	The tag from a previous perf-threshold-template-list-iter-start call.

Errno	Description
EAPIPRIVILEDGE
EINVALIDTAG

The perf-threshold-template-list-info-iter-* list of APIs are used to retrieve the list of all objects on which thresholds have been set.

Input Name	Range	Type	Description
maximum		integer	The maximum number of entries to retrieve. Range: [1..2^31-1]
tag		string	The tag from a previous perf-threshold-template-list-info-iter-start call.
Output Name	Range	Type	Description
records		integer	The number of records actually returned. Range: [0..2^31-1].
threshold-templates		threshold-template-info[]	List of performance thresholds.

Errno	Description
EAPIPRIVILEDGE
EINVALIDTAG

The perf-threshold-template-list-info-iter-* list of APIs are used to retrieve the list of all threshold templates that have been created. It loads the templates into a temporary store. The API returns a tag that identifies a temporary store so that subsequent APIs can be used to iterate over the threshold related counters in the temporary store.

Input Name	Range	Type	Description
include-objects		boolean optional	If true, the output will include objects on which the template(s) apply. Only the direct objects will be returned. Only objects on which the user has the capability to perform the DFM.Database.Read operation will be returned. Default value is false.
include-thresholds		boolean optional	If true, the output will include the thresholds that are part of the template. Default value is false.
template-name-or-id		string optional	Return information of a specific template
Output Name	Range	Type	Description
records		integer	Number indicating how many items are available for future retrieval via calls to perf-threshold-template-list-info-iter-next.
tag		string	Tag to be used in subsequent calls to perf-threshold-template-list-info-iter-next. It is an opaque handle used by the DFM station to identify a temporary store.

Errno	Description
EACCESSDENIED
EAPIERROR
EAPILICENSE
EINTERNALERROR
EINVALIDINPUTERROR
EOBJECTNOTFOUND

The perf-threshold-template-modify zapi is used to modify an existing threshold template. It can be used to add, remove or modify thresholds in the template or modify attributes of the template

Input Name	Range	Type	Description
is-enabled		boolean optional	This specifies if the template is enabled or not. If not specified, the enabled/disabled state of the template is not modified.
member-thresholds		threshold-info2[] optional	Specifies the thresholds that are to be part of this template.
template-description		string optional	A new description for the template, if the description is to be modified.
template-id		integer	Specifies the id of the template that is to be modified. Range: [1..2^32-1]
template-name		string optional	The new name for the template, if the name is to be modified.

Errno	Description
EAPILICENSE
EINTERNALERROR
EINVALIDINPUTERROR
EACCESSDENIED
EDATABASEERROR

List all the objects associated with the view.

Input Name	Range	Type	Description
view-name		string	The view for which to list associated objects
Output Name	Range	Type	Description
objects		object-info[]	The objects that are associated with the view

Errno	Description
EOBJECTNOTFOUND
EINTERNALERROR
EAPIERROR
EDATABASEERROR
EINVALIDINPUTERROR

Create a performance view. A performance view consists of one or more charts, but each view refers to only a single counter group. Global DFM.PerfView.Write RBAC capability is required to create normal views while Global DFM.PerfView.RealTimeRead is required to create real-time view.

Input Name	Range	Type	Description
data-sources		perf-data-source[] optional	Identifiers for the data sources to be retrieved in later queries. The data-sources can not contain 'group' data source. i.e. instance-name must be specified for each perf-data-source. The data-sources should not contain a data source that specifies label-names field. This is because counter group always collects data for the whole counter i.e. for all labels. perf-data-source is not required for default counter groups. The perf-counter-group-modify API ignores this element for default counter groups.
real-time		boolean optional	Designates whether the counter group is real-time, in other words, if no user is getting data from the group, then the counter group will no longer get data. By default FALSE.
view		perf-view	A performance view to create.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE
EPERFUPDATEDISABLED
EINVALIDINPUTERROR

Destroy a performance view. Global DFM.PerfView.Delete is required for destroying normal views while Global DFM.PerfView.RealTimeRead is required for destroying real-time views.

Input Name	Range	Type	Description
appliance-name-or-id		string optional	Name (or unique ID) of the storage system. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in the appliance-info structure from the appliance-list-iter-next API. The API will accept a vfiler name or id from DFM 3.3 onwards.
group-name-or-id		string optional	The group that this view is associated with. If a unique ID is supplied, it should originate from an API such as the 'id' field returned in group-list-iter-next APIs.
is-counter-group-also-deleted		boolean optional	Also destroy the associated counter group. Default is false. This option is ignored if the counter group is default.
view-name		string	Name of the view to be destroyed.

Errno	Description
EAPIPRIVILEDGE
EAPILICENSE

Retrieve data for a single data-source from a specific performance view. The data is extracted for the given time interval bounded by start-time and end-time.

Input Name	Range	Type	Description
direction		string optional	This field is used only when duration is specified It is used to derive the time period for which data is to be retrieved. If the value is set to 'forward', then the starting time is the time stamp of the oldest data. The ending time is the sum of time stamp of the oldest data and the duration. If the value is set to 'backward', then the starting time is the difference between time stamp of the most recent data and the duration. The ending time is the time stamp of the most recent data. If the value is set to 'backward-from-now', then the starting time is the difference between current time and the duration. The ending time is the current time. Default value is 'backward'
duration		integer optional	The duration for which the data is to be returned, in seconds. The time period is calculated based on the direction flag. Duration should not be specified when either start-time or end-time is specified. If specfied, EINVALIDINPUTERROR error will be returned. Range: [0..(2^32)-1]
dynamic-object-info		perf-dynamic-data-sources optional	This defines what objects are to be displayed for dynamic charts like top-N objects
end-time		integer optional	Time stamp marking the end of requested data. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. If unspecified, server should end with the latest available data Range: [0..(2^32)-1]
instance		perf-counter-instance optional	The object instance for which data is to be retrieved
is-dynamic		boolean optional	Indicates if top n data sources should be returned Default is false
number-samples		integer optional	The total number of samples to be returned. The sample-rate will be calculated based on the start-time and end-time If the available samples have higher resolution than the one specified, multiple samples are consolidated into one sample to achieve the desired resolution, using the specified time-consolidation-method. If unspecified, the number of samples returned will be based on the sample-rate specified upon creation of the view. Either sample-rate or number-samples should be specified, but not both Range: [1..(2^32)-1]
sample-rate		integer optional	The desired interval between samples, in seconds. If the available samples have higher resolution than the one specified, multiple samples are consolidated into one sample to achieve the desired resolution, using the specified time-consolidation-method. If unspecified, the data returned will be at the sample-rate specified upon creation of the view Range: [1..(2^32)-1]
start-time		integer optional	Time stamp marking the beginning of requested data. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. If unspecified, server should begin with the earliest available data. Range: [0..(2^32)-1]
time-consolidation-method		string optional	A function to apply across the data to achieve the desired time resolution, if the requested sample-rate is different from the actual sample-rate of the data. Possible values : 'average' 'min' 'max' 'last' Default is 'last'
view-name		string	The view from which data is to be retrieved Maximum length is 255
Output Name	Range	Type	Description
counter-data		string optional	A single array of the retrieved data. The format is a series of comma-separated timestamp:value pairs. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. The values may have optional decimal extensions, for example 1064439599:127,1064439600:98.6,1064439601:12
dynamic-data		dynamic-data[] optional	Contains data for top-N objects
unit		string optional	Unit of counter-data. This element will not be present if the unit is not known. Some possible values are per_sec, percent, b_per_sec, kb_per_sec, msecs, usecs. Maximum Length: 32 characters.