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

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.

Authors

  • AIX Development Team (@vivekpandeyibm)