Previous Page Contents Page Next Page

3.3 Usage Logging

You may want to keep track of SNAP-IX resource usage, such as the numbers of links and sessions that are active on the local node at any time.

SNAP-IX provides two methods for accessing this information:

3.3.1 Usage Log File

SNAP-IX usually records usage information in the file /var/opt/sna/sna.usage. When this file reaches 1,000,000 bytes, SNAP-IX renames the file to /var/opt/sna/bak.usage (overwriting any existing backup usage log file) and then clears the log file. This means that the maximum amount of log information stored at any one time is twice the specified maximum file size.

You can use the command-line administration program to change the name and location of the usage log file, or the maximum file size, in the same way as for audit and error log files. You can also clear the current contents of the log file at any time (with or without copying the information to the backup file). Use the following commands:

  1. Use the snaadmin set_log_file command to change the log file name or maximum size, or to clear the file.

  2. Use the snaadmin query_log_file command to check the current usage log file settings.

Refer to SNAP-IX Administration Command Reference for more information about issuing these commands.

The format of the usage log file is as follows:

3.3.2 Using Administration Tools to Check Resource Usage

To check resource usage at a particular time, you can use the administration command query_node_limits or the NOF verb QUERY_NODE_LIMITS. Refer to SNAP-IX Administration Command Reference or SNAP-IX NOF Programmer's Guide for more details.

The command or verb returns information about the same resource types as in the usage log file, giving the current and maximum usage of each resource type. It also returns information about the maximum usage of each resource type that is permitted by your SNAP-IX license, and the functions that your SNAP-IX license allows you to use.

Previous Page Contents Page Top of Page Next page