Notifications

System Log

Logs contain information about the system status and system operations at specific points in time. The logs are recorded in the system log (journalctl).

You can:

  • manage and view the type of system messages that will be logged;
  • collect logs into a file;
  • view the latest error messages on the system.

To configure the type of system messages that will be added to the system log, run

# xicli settings log modify <arg>
Table 1. Argument for the log modify subcommand

Required argument

-l

--level

The type of system messages that will be added to the system log.

Possible values: error, warning, info, debug.

Each next type includes the previous one.

The default: debug.

To collect all logs into a file, run

# xicli log collect

The log file will be available in the /tmp directory.

After collecting is complete, the message “xiRAID logs have been collected and saved in: /tmp/xiraid_logs_$hostname_YYYY.MM.DD_hh-mm-ss.tar.gz” shows.

To see the selected type of system messages for the system log, run

# xicli settings log show [optional_arg]
Table 2. Argument for the log show subcommand

Optional argument

-f

--format

Output format:

  • table;
  • json;
  • prettyjson – human-readable json.

The default: table.

To see the latest error messages on the system, run

# xicli log show [optional_arg]
Table 3. Argument for the show subcommand

Optional argument

-l

--lines

The number of error messages in the event log to show, starting from the last entry.

Possible values: integers from 1 to 1000.

The default: 10.

Setting up Email Notifications

Warning:

Make sure the system has configured MTA (Mail Transfer Agent) (for example, Postfix).

To set the receiver’s email and the notification level, run

# xicli mail add <args>
Table 4. Arguments for the add subcommand

Required arguments

-a

--address

 Receiver’s email.

-l

--level

The notification level.

Possible values:

  • info – Info notifications;
  • warning – Error and Warning notifications;
  • error – Error notifications.
Table 5. Notification types:

Info

Warning

Error

Initialization completed on RAID (…)

Initialization not completed on RAID (…)

RAID (…) is offline now

Initialization progress on RAID (…) is (…) percent

RAID (…) is read-only now

RAID (...) is unrecovered now

Initialization started on RAID (…)

System is up after reboot/crash

After reboot/crash, RAID (…) not restored

RAID (…) is healthy now

Reconstruction not completed on RAID (…)

After reboot/crash, RAID (…) has restored in read only mode

RAID (…) is online now

SparePool (…) ran out of drives

RAID (…) is degraded now

Reconstruction completed on RAID (…)

The number of errors on the bdev (...) is increased. The current number is (...)

After reboot/crash, RAID (…) has restored in offline state

Reconstruction progress on RAID (…) is (…) percent

xiRAID license expired

Reconstruction started on RAID (…)

xiRAID license error: number of disks in use exceeds the allowed disks number

Drive (…) was returned to RAID (…)

Drive (…) in RAID (…) is offline now

Drive (…) from SparePool (…) was reconnected

Drive (…) from SparePool (…) was disconnected

Drive (…) in RAID (…) was automatically replaced with drive (…) from SparePool (…)

Could not automatically replace drive (…) in RAID (…) with drive (…) from SparePool (…)

Can't replace the faulty bdev (…). Replacing (…) with null

Could not automatically replace drive (…) in RAID (…) because there was no suitable drive in SparePool (…)

The number of faults on the bdev (…) reached the fault threshold

The bdev (…) has critical wear out (…)%

Example: Add the receiver with the “user2@email.com” email for all notification types:

# xicli mail add -a user2@email.com -l info

To remove the email from the list of email notifications, run

# xicli mail remove <arg>
Table 6. Argument for the remove subcommand

Required argument

-a

--address

The email address to remove from the notifications.

To show the list of the email notifications, run

# xicli mail show
Table 7. Argument for the mail show subcommand

Optional argument
-f --format

Output format:

  • table;
  • json;
  • prettyjson – human-readable json.

The default: table.
To manage email notification settings, run
# xicli settings mail modify <args>
Table 8. Arguments for the mail modify subcommand

At least one argument is required

-pi

--polling_interval

The polling interval for xiRAID RAIDs and the drives in seconds.

Possible values: integers from 0 to 86400 (24 hours).

The default: 10.

-ppi

--progress_polling_interval

Polling interval for the progress of initialization and reconstruction, in minutes.

Possible values: integers from 0 to 1440 (24 hours).

The default: 10.

To show email notification settings, run

# xicli settings mail show
Table 9. Argument for the mail show subcommand

Optional argument
-f --format

Output format:

  • table;
  • json;
  • prettyjson – human-readable json.

The default: table.