errpt – Run the AIX errpt command to report logged system errors.
Synopsis
Enables Ansible to invoke AIX’s errpt utility with extensive flag support for log filtering.
Requirements
The below requirements are needed on the host that executes this module.
AIX >= 7.1
Parameters
- detailed (optional, bool, False)
Displays information about errors in the error log file in detailed format .
- short_detail (optional, bool, False)
Show shortened version of detailed error .
- error_class (optional, str, None)
Limits the error report to certain types of error records specified by the valid ErrorClassList variable .
The error records in the ErrorClassList variable can be separated by a , (comma), or enclosed in “ “ (double quotation marks)
And separated by a , (comma), or a space character.
H
hardware
S
software
O
errlogger command messages
U
undetermined- consolidate_duplicates (optional, bool, False)
Consolidate duplicate errors .The detailed error report, obtained with the -a flag, reports the number, and first and last times of the duplicates
- end_date (optional, str, None)
Specifies all records posted prior to and including the EndDate variable, where the EndDate variable has the form mmddhhmmyy.
- ascii_format (optional, bool, False)
Displays the ASCII representation of unformatted error-log entries..
- input_log (optional, str, None)
Use specified error log file. If this flag is not specified, the value from the error log configuration database is used
- diag_log (optional, str, None)
Use specified diagnostic log file. If this flag is not specified, the default pathname, /var/adm/ras/diag_log, is used.
- include_errids (optional, str, None)
Includes only the error-log entries specified by the ErrorID.
The ErrorID variables can be separated by a , (comma), or enclosed in “ “ (double quotation marks) and separated by a , (comma), or a space character
- exclude_errids (optional, str, None)
Excludes the error-log entries specified by the ErrorID.
The ErrorLabel variable values can be separated by commas or enclosed in double-quotation marks and separated by commas or blanks
- include_labels (optional, str, None)
Includes the error log entries specified by the ErrorLabel.
The ErrorLabel variable values can be separated by commas or enclosed in double-quotation marks and separated by commas or blanks
- exclude_labels (optional, str, None)
Excludes the error log entries specified by the ErrorLabel.
The ErrorLabel variable values can be separated by commas or enclosed in double-quotation marks and separated by commas or blanks
- sequence_number (optional, str, None)
Selects a unique error-log entry specified by the sequence_number variable.
The sequence_number variable can be separated by a , (comma), or enclosed in “ “ (double quotation marks)
And separated by a , (comma), or a space character.
- machine (optional, str, None)
Includes error-log entries for the specified Machine variable .
- node (optional, str, None)
Includes error-log entries for the specified Node variable .
- resource_names (optional, str, None)
Generates a report of resource names specified by the resource_names.
The resource_names is a list of names of resources that have detected errors.
The resource_names variable can be separated by a , (comma), or enclosed in “ “ (double quotation marks)
And separated by a , (comma), or a space character.
- start_date (optional, str, None)
Specifies all records posted on and after the StartDate, where the StartDate variable has the format mmddhhmmyy.
- error_types (optional, str, None)
Limits the error report to error types specified by the valid error_types variables.
The error types can be each separated by a , (comma), or enclosed in “ “ (double quotation marks) and separated by a , or a space character
INFO
Information
PEND
Pending
PERF
Performance related entries
PERM
Permanent
TEMP
Temporary
UNKN
Unknown- recorded_output (optional, str, None)
Folder path to command output in machine.
- concatenated_output (True, bool, None)
Controls whether the output of the vmstat command is appended to the output file or is overwrited.
If set to true, output will be appended to the file.
If set to false, the file will be overwritten with fresh output.
Notes
Note
You can refer to the IBM documentation for additional information on the vmstat command at https://www.ibm.com/docs/en/aix/7.3.0?topic=v-vmstat-command.
Examples
- name: Get detailed error report
errpt:
detailed: true
- name: Get error report for specific error IDs
errpt:
include_errids: "A924A5FC,DEADBEEF"
recorded_output: "/tmp/errpt.log"
Return Values
- msg (always, str, Group: foo SUCCESSFULLY created.)
The execution message.
- cmd (always, str, )
The command executed.
- rc (When the command is executed., int, )
The command return code.
- stdout’ (If the command failed., str, )
The standard output.
- stderr’ (If the command failed., str, )
The standard error.
Status
This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by community.