stattest

Description

Check Point AMON client to query SNMP OIDs.

You can use this command as an alternative to the standard SNMP commands for debug purposes - to make sure the applicable SNMP OIDs provide the requested information.

Notes:

  • You can run this command only in the Expert mode.

  • On a Multi-Domain Server, you must run this command in the context of the applicable Domain Management Server:

    mdsenv <IP Address or Name of Domain Management Server>

Syntax

  • To query a Regular OID:

    stattest get [-d] [-h <Host>] [-p <Port>] [-x <Proxy Server>] [-v <VSID>] [-t <Timeout>] <Regular_OID_1> <Regular_OID_2> ... <Regular_OID_N>

    These are specified in the SNMP MIB files.

    For Check Point MIB files, see sk90470.

  • To query a Statistical OID:

    stattest get [-d] [-h <Host>] [-p <Port>] [-x <Proxy Server>] -l <Polling Interval> -r <Polling Duration> [-v <VSID>] [-t <Timeout>] <Statistical_OID_1> <Statistical_OID_2> ... <Statistical_OID_N>

    Statistical OIDs take some time to "initialize".

    For example, to calculate an average, it is necessary to collect enough samples.

    Check Point statistical OIDs are registered in the $CPDIR/conf/statistical_oid.conf file.

Parameters

Parameter

Description

-d

Runs the command in debug mode.

Use only if you troubleshoot the command itself.

Best Practice - If you use this parameter, then redirect the output to a file, or use the script command to save the entire CLI session.

-h <Host>

Specifies the remote Check Point host to query by its IP address or resolvable hostname.

-p <Port>

Specifies the port number, on which the AMON server listens. Default port is 18192.

-x <Proxy Server>

Specifies the Proxy Server by its IP address or resolvable hostname.

Note - Use only when you query a remote host.

-l <Polling Interval>

Specifies the time in seconds between queries.

Note - Use only when you query a Statistical OID.

-r <Polling Duration>

Specifies the time in seconds, during which to run consecutive queries.

Note - Use only when you query a Statistical OID.

-v <VSID>

On a VSX Gateway, specifies the context of a Virtual Device to query.

-t <Timeout>

Specifies the session timeout in milliseconds.

<Regular_OID_1> <Regular_OID_2> ... <Regular_OID_N>

Specifies the Regular OIDs to query.

Notes:

  • OID must not start with period.

  • Separate the OIDs with spaces.

  • You can specify up to 100 OIDs.

<Statistical_OID_1> <Statistical_OID_2> ... <Statistical_OID_N>

Specifies the Statistical OIDs to query.

Notes:

  • OID must not start with period.

  • Separate the OIDs with spaces.

  • You can specify up to 100 OIDs.

Example - Query a Regular OID

Query the CPU Idle utilization at the OID 1.3.6.1.4.1.2620.1.6.7.2.3 (procIdleTime).

[Expert@HostName]# stattest get 1.3.6.1.4.1.2620.1.6.7.4.2

Example - Query a Statistical OID

Query the CPU Idle utilization at the OID 1.3.6.1.4.1.2620.1.6.7.2.3 (procIdleTime).

Information is collected with intervals of 5 seconds during 5 seconds

[Expert@HostName]# stattest get -l 5 -r 5 1.3.6.1.4.1.2620.1.6.7.2.3