TOCPREVNEXTINDEX

Lund Performance Solutions

SOSLOGD

The Historical Performance Data Logging Utility

The SOS Performance Advisor application suite includes a data logging utility called SOSLOGD. SOSLOGD enables the user to collect historical system performance data for analysis of performance problems and trends.
Data can be logged three ways:
  • A single, one-time-only, session.
    • The length of the data collection period is determined by the user.
  • Continuously, 24 hours a day.
    • The logging job must be stopped manually with the lpskill command.
  • Scheduled, using the cron facility.
    • For example, Monday through Friday, 06:30 AM to 6:30 PM.
    The data is collected and stored in SL (system log) files for later use by SOSLOGX.

    SL Files

    SOSLOGD creates one logical file record for every batch interval. The default interval is 10 minutes (600 seconds). The log file is saved in the SOS Performance Advisor log directory (/var/ opt/lps/log is the default location) and named using the format SLyyjjjs.
  • SL represents the SOS log file.
  • yy represents the current year.
  • jjj represents the Julian day of the year.
  • s represents the sequence of the log (up to 26 characters, from a through z).

    • Starting the Logging Process

    To begin the collection process, enter soslogd at the shell prompt of your home directory. It is assumed that your path statements are set up properly.

    Command Line Switches

    Use command line switches to modify the SOSLOGD configuration. Enter soslogd -h at the shell prompt of your home directory to view all available command line switches. The effects of the command line switches vary depending on whether you are using the default or advanced configuration parameters.The functions of each command line switch is summarized in the next table.
    Table 29.1 SOSLOGD command line switch functions
    Switch
    Default Configuration
    Advanced Configuration
    -c
    Log continuously by restarting at 00:00 hours.
    Log continuously until midnight.
    -o
    Display the default configuration.
    Display the configuration parameters in the .soslogdrc file.

    Viewing Default Configuration Parameters

    To view the default configuration parameters for your system, type soslogd -o from your home directory. The default parameters are described in Table 29.2.
    Table 29.2 SOSLOGD default configuration parameters
    Parameter
    Description
    Enter duration of job in minutes (0)
    The duration of the job is 24 hours.
    Interval time in seconds (600)
    The program will take a sample and write a log record every 10 minutes.
    Company name ( )
    The company name is blank, by default.
    Display advice messages (Y)
    SOSLOGD will display advice messages.

    Setting Advanced Configuration Parameters

    To create a custom configuration parameter file:
  • Create a custom file (soslogrc) with your editing program, listing the parameters as described:
  • RunTime
    		•
    The amount of time (minutes) SOS Performance Advisor will monitor your system’s processes.
  • CycleTime
    		•
    The amount of time (seconds) between samples.
  • CompanyName
    		•
    Your company name (added to the title of each log report). (This can be the name of your system or another subheading, if desired.)
    • All parameters listed above are optional, and their order in the .soslogdrc file is not important.
  • Place the .soslogdrc file in your home directory to enable batch logging parameters.
  • To change the configuration, edit the parameters in the .soslogdrc file. For example:
  • To collect data in one-hour batches, change the batch run time to 60 minutes by typing RunTime=60.
  • To shorten the interval time to five minutes (300 seconds), type CycleTime=300.
  • To add the name of your company (or another subheading) to the title of each log report, type CompanyName=<your company’s name>.

    • Configuration Variables

    The configurations outlined in Table 29.3 can be found in the .soslogdrc file.
    Table 29.3 SOSLOGD default configuration variables
    Variable
    Type
    Min
    Max
    Description
    RunTime
    integer
    0
    1440
    Duration of job in minutes
    CycleTime
    integer
    10
    3600
    Interval time in seconds
    CompanyName
    string
    N/A
    N/A
    Company name
    DisplayAdvice
    Y/N
    N/A
    N/A
    Display advice messages
    ProcLog
    Y/N
    N/A
    N/A
    Log processes
    ProcCPUThreshold
    integer
    0
    100
    CPU percentage required for process display
    LogOnlyActProc
    Y/N
    N/A
    N/A
    Log only active processes
    LogInteractProc
    Y/N
    N/A
    N/A
    Display attached processes
    LogNonInteractProc
    Y/N
    N/A
    N/A
    Log non-interactive processes, including daemons and batch processes).
    LogDeadProc
    Y/N
    N/A
    N/A
    Log processes that died
    ProcLogonFilter
    reg exp
    N/A
    N/A
    Process logon filter
    ProcSortOpt
    integer
    1
    8
    Process sort options:
    1 - sort by PID#
    2 - sort by Logon Terminal
    3 - sort by Workload group
    4 - sort by CPU time
    5 - sort by Disc I/O
    6 - sort by Term reads
    7 - sort by Priority
    8 - sort by Wait State
    ProcSortAscend
    Y/N
    N/A
    N/A
    Log processes sorted in ascending order
    ProcLogLimit
    integer
    1
    127
    Maximum number of processes to be logged per interval
    Lund Performance Solutions
     www.lund.com
    Voice: (541) 812-7600
    Fax: (541) 81207611
    info@lund.com
    TOCPREVNEXTINDEX