Manage alerts using the CLI

This page describes how to manage alerts using the CLI.

Using the CLI, you can:

• Display alert types

• View alerts

• Mute alerts

• Unmute alerts

Display alert types

Command: weka alerts types

Use this command to list all possible types of alerts that the WEKA cluster can return.

Command:weka alerts describe

Use this command to describe all the alert types the WEKA cluster can return, along with possible corrective actions for each alert.

View alerts

Command: weka alerts

Use the following command line to list all alerts (muted and unmuted) in the WEKA cluster:

weka alerts [--severity severity] [--muted]

Parameters

Name	Value
severity	Include event with equal and higher severity, default: WARNING Format: debug, warning, minor, major or critical
muted	List muted alerts alongside unmuted ones.

weka alerts output parameters

Explore the output parameters of the weka alerts command.

Parameter	Description
action	Displays the recommended action to resolve the alert.
active_duration	Indicates the duration for which the alert has been active.
comment	Shows any user-added comments for the alert.
count	Provides the number of times the alert has occurred.
description	Explains the alert in detail.
end_time	Specifies the time when the alert was resolved.
mute_time_remaining	Indicates the remaining time until the alert is unmuted.
muted	Shows whether the alert is currently muted (muted or unmuted).
severity	Defines the severity level of the alert, for example, WARNING.
start_time	Specifies the start time when an alert type first started, not when each individual alert instance was generated.
title	Provides a concise title for the alert.
type	Identifies the unique type of the alert.

Example

$weka alerts
TYPE              SEVERITY  MUTED  START TIME  COUNT  TITLE                                MUTE TIME REMAINING  COMMENT
SystemDefinedTLS  WARNING   Muted  11:30:55h       1  TLS certificate is not user-defined        30d 12:32:37h

$weka alerts --format json
[
    {
        "action": "Replace the auto-generated self-signed certificate with a user-defined certificate by running the command 'weka security tls set'.",
        "active_duration": null,
        "comment": null,
        "count": 1,
        "description": "The system uses an auto-generated self-signed TLS certificate.",
        "end_time": "",
        "mute_time_remaining": 2637140,
        "muted": true,
        "severity": "WARNING",
        "start_time": "2025-08-13T03:33:18.807934Z",
        "title": "TLS certificate is not user-defined",
        "type": "SystemDefinedTLS"
    }
]

Mute alerts

Command: weka alerts mute

Use the following command line to mute an alert type:

weka alerts mute <alert-type> <duration>

The system does not prompt muted alerts when listing active alerts. You must specify the duration in which the alert-type is muted. After the expiry of the specified duration, the system unmutes the alert-type automatically.

Parameters

Name	Value
alert-type*	An alert-type to mute, use weka alerts types to list types.
duration*	Expiration time for muting this alert type. Format: 3s, 2h, 4m, 1d, 1d5h, 1w.

Unmute alerts

Command: weka alerts unmute

Use the following command line to unmute a muted alert-type:

weka alerts unmute <alert-type>

Parameters

Name	Value
alert-type*	An alert-type to unmute, use weka alerts types to list types.