7.3.1 Log type

The types of logs that are acquired can be selected by means of logmasks. Logmasks specify which types of logs are acquired.

The master agent and subagents use different logmasks. Table 7-1 lists the logmasks for the master agent.

Table 7‒1: Logmasks for the master agent

Logmask (value specified for snmpdm -m)			Explanation
Character string	Decimal number	Hexadecimal number
--	0	0x	Log suppression
FACTORY_TRACE	8388608	0x00800000	Trace log output
FACTORY_WARN	268435456	0x10000000	Warning log output
FACTORY_ERROR	536870912	0x20000000	Error log output

If you do not specify any logmasks for the master agent, the master agent collects error and warning logs.

To change, when the master agent is running, the types of the logs to be collected by the master agent, stop the master agent by executing the kill command and restart the master agent with the appropriate logmask(s) specified. For example,

/usr/sbin/snmpdm -m 8388608

The method for specifying multiple log types depends on whether the logmask values are numbers (decimal or hexadecimal) or character strings. If you use decimal or hexadecimal logmask values, add all the logmask values and specify the sum. If you use character string logmask values, enter each logmask value after -m. For example,

/usr/sbin/snmpdm -m FACTORY_TRACE FACTORY_WARN FACTORY_ERROR

If you specify the -m option with a character string in combination with other options, note that the -m option is the last option specified.

Table 7-2 lists the logmasks for subagents.

Table 7‒2: Logmasks for subagents

Logmask (specified as an option of the subagent command)	Explanation
-aperror	Error logs
-apwarn	Error and warning logs
-aptrace	Trace logs
-apconfig	Logs related to the configuration file
-appacket	Logs related to packet assembly or analysis
-aptrap	Logs related to trap messages
-apaccess	Logs related to agent processing
-apemanate	Logs related to the master agent and subagents
-apverbose	Verbose logs
-apuser	User logs
-apall	All types of logs

If you do not specify any logmasks for a subagent, the subagent will not collect any logs. To make an already running subagent collect some type(s) of logs, stop the subagent by executing the kill command, then restart the subagent with the appropriate logmask(s) specified. For example,

/usr/sbin/extsubagt -aperror

If you want to collect two or more types of logs, specify the logmask values in succession after the subagent command. For example,

/usr/sbin/extsubagt -aperror -apwarn -aptrace

To Page Top