send-alert

Description

Build a diagnostics report for the cluster, check it for issues, and send an alert if any issues are found.

Use single file for location config and threshold configurations.

sdb-report send-alert --config-file /path/to/config.yaml

Receive only a summary of the results.

sdb-report send-alert --config-file /path/to/config.yaml --summary-only

Receive alerts only when checks fail.

sdb-report send-alert --config-file /path/to/config.yaml --fail-only

Use separate location config and threshold configurations files.

sdb-report send-alert --alert-location /path/to/location-config.yaml --thresholds /path/to/thresholds/config/file

Below is example of config file content:

location:
email:
receivers:
- receiver@example.com
sender: sender@example.com
server:
host: smtp.example.com
port: 25
username: ~
password: ~
thresholds:
leavesNotOnline:
fail: 2
memoryCommitted:
warn: 80

Usage

Usage:
  sdb-report send-alert [flags]

  For flags that can accept multiple values (indicated by VALUES after the name of the flag),
  separate each value with a comma.

Flags:
      --alert-location YAML   Path to the SMTP config file (ADVANCED)
      --config-file YAML      Path to the alerting config YAML file. Specify both the thresholds and this path in the alerting config file
      --fail-only             Send alerts only for failed checks
  -h, --help                  Help for send-alert
      --summary-only          Include only summaries in alerts
      --thresholds YAML       Alert thresholds config YAML or path to YAML (ADVANCED)

Global Flags:
      --backup-cache FILE_PATH                File path for the backup cache
      --cache-file FILE_PATH                  File path for the Toolbox node cache
  -c, --config FILE_PATH                      File path for the Toolbox configuration
      --disable-colors                        Disable color output in console, which some terminal sessions/environments may have difficulty with
      --disable-spinner                       Disable the progress spinner, which some terminal sessions/environments may have issues with
  -j, --json                                  Enable JSON output
      --parallelism POSITIVE_INTEGER          Maximum number of operations to run in parallel
      --runtime-dir DIRECTORY_PATH            Where to store Toolbox runtime data
      --ssh-control-persist SECONDS           Enable SSH ControlPersist and set it to the specified duration in seconds
      --ssh-max-sessions POSITIVE_INTEGER     Maximum number of SSH sessions to open per host, must be at least 3
      --ssh-strict-host-key-checking          Enable strict host key checking for SSH connections
      --ssh-user-known-hosts-file FILE_PATH   Path to the user known_hosts file for SSH connections. If not set, /dev/null will be used
      --state-file FILE_PATH                  Toolbox state file path
  -v, --verbosity count                       Increase logging verbosity: valid values are 1, 2, 3. Usage -v=count or --verbosity=count
  -y, --yes                                   Enable non-interactive mode and assume the user would like to move forward with the proposed actions by default

Remarks

This command is interactive unless you use either --yes or --json flag to override interactive behavior.

Last modified: October 6, 2023

Was this article helpful?