MB-55715 Add support for configuring history_size_warning alert

Change-Id: Id6832c5d4bea70170b4342746d8c33ab42969dd3
Reviewed-on: https://review.couchbase.org/c/couchbase-cli/+/187497
Well-Formed: Restriction Checker
Tested-by: Build Bot <build@couchbase.com>
Reviewed-by: James Lee <james.lee@couchbase.com>

Author: yonsken

cbmgr.py

@@ -2323,12 +2323,14 @@ def __init__(self):
                            help="Alert when the disk analyzer gets stuck")
         group.add_argument("--alert-memory-threshold", dest="alert_memory_threshold",
                            action="store_true", help="Alert when system memory usage exceeds threshold")
+        group.add_argument("--alert-bucket-history-size", dest="alert_bucket_history_size",
+                           action="store_true", help="Alert when history size for a bucket reaches 90%%")
 
     @rest_initialiser(cluster_init_check=True, version_check=True)
     def execute(self, opts):
         if opts.enabled == "1":
             if opts.email_recipients is None:
-                _exit_if_errors(["--email-recipient must be set when email alerts are enabled"])
+                _exit_if_errors(["--email-recipients must be set when email alerts are enabled"])
             if opts.email_sender is None:
                 _exit_if_errors(["--email-sender must be set when email alerts are enabled"])
             if opts.email_host is None:
@@ -2371,6 +2373,8 @@ def execute(self, opts):
             alerts.append('disk_usage_analyzer_stuck')
         if opts.alert_memory_threshold:
             alerts.append('memory_threshold')
+        if opts.alert_bucket_history_size:
+            alerts.append('history_size_warning')
 
         enabled = "true"
         if opts.enabled == "0":

docs/modules/cli/pages/cbcli/couchbase-cli-setting-alert.adoc

@@ -24,7 +24,7 @@ _couchbase-cli setting-alert_ [--cluster <url>] [--username <user>] [--password
     [--alert-meta-overhead] [--alert-meta-oom] [--alert-write-failed]
     [--alert-audit-msg-dropped] [--alert-indexer-max-ram]
     [--alert-timestamp-drift-exceeded] [--alert-node-time] [--alert-disk-analyzer]
-    [--alert-memory-threshold]
+    [--alert-memory-threshold] [--alert-bucket-history-size]
 
 == DESCRIPTION
 
@@ -140,7 +140,11 @@ include::{partialsdir}/cbcli/part-common-options.adoc[]
 
 --alert-memory-threshold::
   Specifies that an email alert should be sent when any node's system memory
-  usage exceeds a threshold
+  usage exceeds a threshold.
+
+--alert-bucket-history-size::
+  Specifies that an email alert should be sent when the size of history for a
+  bucket reaches 90% of the maximum history size.
 
 include::{partialsdir}/cbcli/part-host-formats.adoc[]
 
@@ -172,7 +176,8 @@ following command below:
    --alert-ip-changed --alert-disk-space --alert-meta-overhead \
    --alert-meta-oom --alert-write-failed --alert-audit-msg-dropped \
    --alert-indexer-max-ram --alert-timestamp-drift-exceeded \
-   --alert-node-time --alert-disk-analyzer --alert-memory-threshold
+   --alert-node-time --alert-disk-analyzer --alert-memory-threshold \
+   --alert-bucket-history-size
 
 To disable email alerts run the following command:
 

test/test_cli.py

@@ -1099,7 +1099,8 @@ def setUp(self):
                             '--alert-auto-failover-disable', '--alert-ip-changed', '--alert-disk-space',
                             '--alert-meta-overhead', '--alert-meta-oom', '--alert-write-failed',
                             '--alert-audit-msg-dropped', '--alert-indexer-max-ram', '--alert-timestamp-drift-exceeded',
-                            '--alert-communication-issue', '--alert-node-time', '--alert-disk-analyzer']
+                            '--alert-communication-issue', '--alert-node-time', '--alert-disk-analyzer',
+                            '--alert-bucket-history-size']
         self.server_args = {'enterprise': True, 'init': True, 'is_admin': True}
         super(TestSettingAlert, self).setUp()
 
@@ -1109,7 +1110,8 @@ def test_set_all_alerts(self):
                            '_nodes_down%2Cauto_failover_cluster_too_small%2Cauto_failover_disabled%2Cip%2Cdisk%2' +
                            'Coverhead%2Cep_oom_errors%2Cep_item_commit_failed%2Caudit_dropped_events%2Cindexer_ram_' +
                            'max_usage%2Cep_clock_cas_drift_threshold_exceeded%2Ccommunication_issue' +
-                           '%2Ctime_out_of_sync%2Cdisk_usage_analyzer_stuck', 'enabled=false', 'emailEncrypt=false']
+                           '%2Ctime_out_of_sync%2Cdisk_usage_analyzer_stuck%2Chistory_size_warning', 'enabled=false',
+                           'emailEncrypt=false']
 
         self.assertIn('POST:/settings/alerts', self.server.trace)
         self.rest_parameter_match(expected_params)
@@ -1120,7 +1122,7 @@ def test_set_all_alerts_and_email(self):
                            '_nodes_down%2Cauto_failover_cluster_too_small%2Cauto_failover_disabled%2Cip%2Cdisk%2' +
                            'Coverhead%2Cep_oom_errors%2Cep_item_commit_failed%2Caudit_dropped_events%2Cindexer_ram_' +
                            'max_usage%2Cep_clock_cas_drift_threshold_exceeded%2Ccommunication_issue' +
-                           '%2Ctime_out_of_sync%2Cdisk_usage_analyzer_stuck', 'enabled=true',
+                           '%2Ctime_out_of_sync%2Cdisk_usage_analyzer_stuck%2Chistory_size_warning', 'enabled=true',
                            'emailEncrypt=true', 'sender=email2', 'recipients=email1', 'emailUser=emailuser',
                            'emailPass=emailpwd', 'emailHost=emailhost', 'emailPort=3000']