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. The data is collected and stored in SL (system log) files for later use by SOS or SOSLOGX.


Data can be logged three ways:
  • A single, one-time-only, session.
  • The length of the data collection period is determined by the user.
  • Repeatedly, by retreaming the collector.
  • 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.


    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 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.


    Configuring SOSLOGD Run Time

    By default, SOSLOGD will run, collecting host data, until midnight (23:59). The run time can be configured to run repeatedly or at specific intervals by using either the -c command line switch or the cron facility.

    -c Command Line Switch

    Enter soslogd -c at the shell prompt of your home directory to modify the SOSLOGD run time configuration. The effects of the command line switches vary depending on whether you are using the default or advanced configuration parameters (see

    cron

    The -c switch should not be used in conjunction with cron. cron should be used if the user wants soslogd to run only during specific hours. For example, to run soslogd from 8AM to 6PM, configure it to run 10 hours, then configure a cron job to start it every day at 8AM.
    The functions of each command line switch is summarized in the next table.
    Table 43.1 SOSLOGD command line switch functions
    Switch
    Default Configuration
    Advanced Configuration
    -c
    Log continuously (24 hours) by restarting at 00:00 hours.
    Log until the RunTime value has expired, and then automatically restream.
    -h
    Display all available command line switches
     
    -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 43.2.
    Table 43.2 SOSLOGD default configuration parameters
    Parameter
    Description
    Enter duration of job in minutes (0)
    The collector will run until midnight. When used with the -c command switch, the collector will automatically restream itself immediately.
    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 (.soslogdrc) 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.)


  • Place the .soslogdrc file in your home directory (the same directory as soslogd) 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 43.3 can be found in the .soslogdrc file.
    Table 43.3 SOSLOGD default configuration variables
    Variable
    Type
    Min
    Max
    Default
    Description
    RunTime
    integer
    0
    1440
    0
    Duration of job in minutes
    CycleTime
    integer
    10
    3600
    600
    Interval time in seconds
    CompanyName
    string
    N/A
    N/A
    <blank>
    Company name
    DisplayAdvice
    Y/N
    N/A
    N/A
    Y
    Display advice messages
    ProcLog
    Y/N
    N/A
    N/A
    Y
    Log processes
    ProcCPUThreshold
    integer
    0
    100
    0
    CPU percentage required for process display
    ProcOnlyActive
    Y/N
    N/A
    N/A
    Y
    Log only active processes
    LogInteractProc
    Y/N
    N/A
    N/A
    Y
    Display attached processes
    LogNonInteractProc
    Y/N
    N/A
    N/A
    Y
    Log non-interactive processes, including daemons and batch processes).
    LogDeadProc
    Y/N
    N/A
    N/A
    Y
    Log processes that died
    ProcLogonFilter
    reg exp
    N/A
    N/A
    .*
    Process logon filter
    ProcSortOpt
    integer
    1
    8
    4
    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
    N
    Log processes sorted in ascending order
    ProcLogLimit
    integer
    1
    127
    10
    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