Controlling the size of job logs
To control the amount of data stored in job run logs, you can perform the following configurations through the blasadmin utility:
- Restrict target-related log messages to a certain severity (or log level). You configure the log level separately for each job type or group of job types.
- Set the maximum number of messages to store in the log. Configuration of this log limit depends on the type of messages:
- To limit target-related log messages, you configure the log limit separately for each job type or group of job types.
- To limit messages with job run data, you configure a single limit for all job types.
The job log settings that you configure through blasadmin are saved in the BMC Server Automation database and are applied to all Application Servers during job execution. You do not need to restart the Application Server after performing these tasks.
Before you begin
To help you decide on the changes that you want to make, you can first display the current settings (log level and log limit) for all job types. Run the show
command on the jrelog
component:
show jrelog all
For general help on the jrelog
component, you can use the help command — either help show jrelog
or help set jrelog
.
To restrict target-related log messages to a certain severity
- Start the Application Server Administration console, as described in Starting the Application Server Administration console.
To set the log level for target-related log messages from a specific job type or group of job types, enter the following
set
command:set jrelog LogLevel <severity> <job type group>
For the variables in this command, you can specify the following values:- For severity, the following values are available (in ascending order of severity):
AllInfo
,ErrorsWarnings
, andErrors
All values are case-sensitive. The default isAllInfo
. For job type group, the following table lists all available job groups, along with the specific job types that are included in each group.
Job group value Jobs included GenericJobs
Daal Plugin Distribution Job, Daal Plugin Deregistration Job, Atrium Import Job, Component Discovery Job, Application Discovery Job, Publish Product Catalog Job, and Batch Job PatchingJobs
Various types of jobs involved in Patching Analysis. ProvisioningJobs
Provisioning Job SnapshotAuditJobs
Snapshot Job, Audit Job NSHScriptJobs
NSH Script Job ACLPushJobs
ACL Push Job ComplianceSCAPJobs
Compliance Job and SCAP Compliance Job VirtualJobs
Various types of jobs involved in virtualization. DeployJobs
Agent Installer Job, Deploy Job, and File Deploy Job USPJobs
USP Job
- For severity, the following values are available (in ascending order of severity):
- Repeat step 2 for any additional job types for which you want to set the log level.
- To validate that you have properly configured the log level for the various job types, you can run the
show
command to display current log levels:- For all job groups :
show jrelog all
(This displays both log levels and log limits.) - For just one job group:
show jrelog LogLevel
<job type group>
- For all job groups :
Note
In the case of Deploy Jobs, if a different logging level was set at the user level within the job (as described in Specifying job options), the user-level setting takes precedence over the level set by the blasadmin command.
To set a limit for the number of messages to store in the log
- Start the Application Server Administration console, as described in Starting the Application Server Administration console.
To set the maximum number of target-related log entries a specific job type or group of job types, enter the following
set
command:set jrelog
LogLimit
<log entries> <job type group>
For the variables in this command, note the following guidelines:For number of log entries, the default value is 1000 log entries.
For job type group, see the list of available job groups in the previous task.
- Repeat step 2 for any additional job types for which you want to set the log level.
- To set the maximum number of job run messages in the logs of all types of jobs, enter the following blasadmin command:
set jrelog
This limit is set for all job types, including all types of jobs in the list of available job groups, as well as several other types of jobs that do not require a target (Patch Catalog Jobs, Batch Jobs, Download Jobs, and Type-2 NSH Script Jobs). The default value for job run messages is 1000000 (one million) log entries.LogLimit
<log entries> JobRun - To validate that you have properly configured the log limit for the various job types, you can run the
show
command to display current log limits:- For all job groups and job run messages:
show jrelog all
(This displays both log limits and log levels.) - For just one job group:
show jrelog LogLevel
<job type group>
- For job run messages:
show jrelog LogLevel
JobRun
- For all job groups and job run messages:
Comments