Log Classes

Logging uses two Solaris Schema classes: Solaris_LogRecord and Solaris_LogService.

Solaris_LogRecord

Solaris_LogRecord is defined in Solaris_Core1.0.mof to model an entry in a log file. When an application or provider calls the Solaris_LogRecord class in response to an event, the Solaris_LogRecord class causes all data generated by the event to be written to a log file. To see the definition of the Solaris_LogRecord class as part of the Solaris Provider, view the Solaris_Core1.0.mof file in a text editor of your choice. The Solaris_Core1.0.mof file is located in /opt/SUNWconn/wbem/schema.

Solaris_LogRecord uses a vector of properties and key qualifiers to specify attributes of the events, system, user, and application or provider that generate data. Read-only qualifier values are generated transparently for use between the application and the CIM Repository. For example, the value RecordID uniquely identifies the log entry but is not displayed as part of the log format when you view generated data.

You can set the values of writeable qualifier values. For example, you can set the qualifier values of properties such as ClientMachineName and ServerMachineName which identify the system on which an event occurs.

Solaris_LogService

The Solaris_LogService class controls the operation of the logging service and defines the ways in which log data is handled. This class has a set of methods that an application can use to distribute data about a particular event to the CIM Object Manager from the issuing application. The data becomes a trigger that generates a response from the CIM Object Manager, such as a retrieval of data from the CIM Repository.

The Solaris_LogService class uses the following methods:

• clearLog - Renames, saves, and archives a current log file or deletes an archived log file

• getNumRecords - Returns the number of lines of data recorded in a particular log file

• listLogFiles - Returns a list of all log files stored in /var/opt/SUNWconn/wbem/log

• getCurrentLogFileName - Returns the name of the most recent log file

• getNumLogFiles - Returns the number of log files stored in /var/opt/SUNWconn/wbem/log

• getLogFileSize - Returns the size, in megabytes, of a particular log file

• getSyslogSwitch - Enables log data to be sent to SysLog, the logging service of the Solaris operating environment

• getLogStorageName - Returns the name of the host computer or device where log files are stored

• getLogFileDir - Returns the path and name of the directory where log files are stored

• setProperties - Enables you to set logging properties

You can view the definition of Solaris_LogService in the Solaris_Core1.0.mof file by opening the file in a text editor of your choice. The Solaris_Core1.0.mof file is located in /opt/SUNWconn/wbem/schema.