ADC CLI Commands

metrics-profile

The following operations can be performed on “metrics-profile”:

add set unset rm show bind unbind

add metrics profile

Adds a new metrics profile

Synopsis

add metrics profile \[-collector ] \[-outputMode ] \[-metrics \( ENABLED | DISABLED )] \[-serveMode \( Push | Pull )] \[-schemaFile ] \[-metricsExportFrequency <positive\_integer>] \[-metricsAuthToken ] \[-metricsEndpointUrl ]

Arguments

name Name for the metrics profile. Must begin with an ASCII alphabetic or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@), equals (=), and hyphen (-) characters.!

collector The collector should be a HTTP/HTTPS service.

outputMode This option indicates the format in which metrics data is generated

Possible values: avro, prometheus, influx, json Default value: avro,

metrics This option is used enable or disable metrics

Possible values: ENABLED, DISABLED Default value: DISABLED

serveMode This option is to configure metrics pull or push mode. In push mode metricscollector exports metrics to configured collector. In pull mode, metricscollector only generates the metrics which will be pulled by external agent. No collector configuration is required in pull mode and it is applicable only for output mode Prometheus

Possible values: Push, Pull Default value: Push

schemaFile This option is for configuring json schema file containing a list of counters to be exported by metricscollector. Schema file should be present under /var/metrics_conf path Default value: NS_S_ANALYTICS_DEFAULT_SCHEMA_FILE Maximum value: 64

metricsExportFrequency This option is for configuring the metrics export frequency in seconds, frequency value must be in [30,300] seconds range Default value: 30 Minimum value: 30 Maximum value: 300

metricsAuthToken Token for authenticating with the endpoint. If the endpoint requires the Authorization header in a particular format, specify the complete format as the value to this parameter. For eg., in case of splunk, the Authorizaiton header is required to be of the form - Splunk . Maximum value: 512

metricsEndpointUrl The URL at which to upload the metrics data on the endpoint Maximum value: 256

Example

add metrics profile metrics_profile1

set metrics profile

Sets an metrics profile!

Synopsis

set metrics profile \[-collector ] \[-outputMode ] \[-metrics \( ENABLED | DISABLED )] \[-serveMode \( Push | Pull )] \[-schemaFile ] \[-metricsExportFrequency <positive\_integer>] \[-metricsAuthToken ] \[-metricsEndpointUrl ]

Arguments

name Name for the metrics profile. Must begin with an ASCII alphabetic or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@), equals (=), and hyphen (-) characters.!

collector The collector should be a HTTP/HTTPS service.

outputMode This option indicates the format in which metrics data is generated

Possible values: avro, prometheus, influx, json Default value: avro,

metrics This option is used enable or disable metrics

Possible values: ENABLED, DISABLED Default value: DISABLED

serveMode This option is to configure metrics pull or push mode. In push mode metricscollector exports metrics to configured collector. In pull mode, metricscollector only generates the metrics which will be pulled by external agent. No collector configuration is required in pull mode and it is applicable only for output mode Prometheus

Possible values: Push, Pull Default value: Push

schemaFile This option is for configuring json schema file containing a list of counters to be exported by metricscollector. Schema file should be present under /var/metrics_conf path Default value: NS_S_ANALYTICS_DEFAULT_SCHEMA_FILE Maximum value: 64

metricsExportFrequency This option is for configuring the metrics export frequency in seconds, frequency value must be in [30,300] seconds range Default value: 30 Minimum value: 30 Maximum value: 300

metricsAuthToken Token for authenticating with the endpoint. If the endpoint requires the Authorization header in a particular format, specify the complete format as the value to this parameter. For eg., in case of splunk, the Authorizaiton header is required to be of the form - Splunk . Maximum value: 512

metricsEndpointUrl The URL at which to upload the metrics data on the endpoint Maximum value: 256

Example

set metrics profile metrics_profile1 -collector

unset metrics profile

Use this command to remove metrics profile settings.Refer to the set metrics profile command for meanings of the arguments.

Synopsis

unset metrics profile [-collector] [-outputMode] [-metrics] [-serveMode] [-schemaFile] [-metricsExportFrequency] [-metricsAuthToken] [-metricsEndpointUrl]

rm metrics profile

Removes an metrics profile.

Synopsis

rm metrics profile

Arguments

name Name of the profile to remove.

Example

rm metrics profile metrics_profile1

show metrics profile

Displays information about all configured metrics profiles, or about the specified profile.

Synopsis

show metrics profile []

Arguments

name Name of the profile about which to display information.

Output

collector The collector should be a HTTP/HTTPS service.

refCnt The number of references to the profile.

outputMode This option indicates the format in which metrics data is generated

metrics This option is used enable or disable metrics

serveMode This option is to configure metrics pull or push mode. In push mode metricscollector exports metrics to configured collector. In pull mode, metricscollector only generates the metrics which will be pulled by external agent. No collector configuration is required in pull mode and it is applicable only for output mode Prometheus

schemaFile This option is for configuring json schema file containing a list of counters to be exported by metricscollector. Schema file should be present under /var/metrics_conf path

metricsExportFrequency This option is for configuring the metrics export frequency in seconds, frequency value must be in [30,300] seconds range

metricsAuthToken Token for authenticating with the endpoint. If the endpoint requires the Authorization header in a particular format, specify the complete format as the value to this parameter. For eg., in case of splunk, the Authorizaiton header is required to be of the form - Splunk .

metricsEndpointUrl The URL at which to upload the metrics data on the endpoint

entityType Type of the entity bound to the metrics profile.

entityName Name of the entity bound to the metrics profile.

stateflag devno count _nextgenAPIResource

Example

show metrics profile prof1

bind metrics profile

Bind entities to metrics profile.

Synopsis

bind metrics profile

Arguments

name Name for the metrics profile. Must begin with an ASCII alphabetic or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@), equals (=), and hyphen (-) characters.!

entityName Name of the entity bound to the metrics profile.

entityType Type of the entity bound to the metrics profile.

Possible values: lbvserver, csvserver, crvserver, vpnvserver, authvserver, gslbvserver, uservserver, service, servicegroup

unbind metrics profile

Unbind entities from metrics profile.

Synopsis

unbind metrics profile

Arguments

name Name for the metrics profile. Must begin with an ASCII alphabetic or underscore (_) character, and must contain only ASCII alphanumeric, underscore, hash (#), period (.), space, colon (:), at (@), equals (=), and hyphen (-) characters.!

entityName Name of the entity bound to the metrics profile.

entityType Type of the entity bound to the metrics profile.

Possible values: lbvserver, csvserver, crvserver, vpnvserver, authvserver, gslbvserver, uservserver, service, servicegroup

metrics-profile