morpheus-cli 4.1.4 → 4.1.5

data/lib/morpheus/cli/load_balancers.rb

@@ -39,10 +39,10 @@ class Morpheus::Cli::LoadBalancers
       end
       @load_balancers_interface.setopts(options)
       if options[:dry_run]
-        print_dry_run @load_balancers_interface.dry.get(params)
+        print_dry_run @load_balancers_interface.dry.list(params)
         return
       end
-      json_response = @load_balancers_interface.get(params)
+      json_response = @load_balancers_interface.list(params)
       if options[:json]
         puts as_json(json_response, options, "loadBalancers")
         return 0
@@ -95,7 +95,7 @@ class Morpheus::Cli::LoadBalancers
         if lb_name.to_s =~ /\A\d{1,}\Z/
           print_dry_run @load_balancers_interface.dry.get(lb_name.to_i)
         else
-          print_dry_run @load_balancers_interface.dry.get({name:lb_name})
+          print_dry_run @load_balancers_interface.dry.list({name:lb_name})
         end
         return
       end
@@ -370,7 +370,7 @@ class Morpheus::Cli::LoadBalancers
   end
 
   def find_lb_by_name(name)
-    lbs = @load_balancers_interface.get({name: name.to_s})['loadBalancers']
+    lbs = @load_balancers_interface.list({name: name.to_s})['loadBalancers']
     if lbs.empty?
       print_red_alert "Load Balancer not found by name #{name}"
       return nil

data/lib/morpheus/cli/login.rb

@@ -39,6 +39,10 @@ class Morpheus::Cli::Login
       opts.on( '-t', '--test', "Test credentials only, does not update stored credentials for the appliance." ) do
         options[:test_only] = true
       end
+      opts.on( '--client-id CLIENT', "Used to test authentication with a client_id other than #{Morpheus::APIClient::CLIENT_ID}. Currently behaves like --test, credentials are not stored." ) do |val|
+        options[:client_id] = val.to_s
+        options[:test_only] = true
+      end
       opts.on( '-T', '--token ACCESS_TOKEN', "Use an existing access token to login instead of authenticating with a username and password." ) do |val|
         options[:remote_token] = val
       end

data/lib/morpheus/cli/logs_command.rb

@@ -0,0 +1,132 @@
+require 'optparse'
+require 'morpheus/cli/cli_command'
+require 'morpheus/cli/mixins/logs_helper'
+require 'json'
+
+class Morpheus::Cli::LogsCommand
+  include Morpheus::Cli::CliCommand
+  include Morpheus::Cli::LogsHelper
+  register_subcommands :list
+  set_command_name :'logs'
+
+  def initialize()
+    # @appliance_name, @appliance_url = Morpheus::Cli::Remote.active_appliance
+  end
+
+  def connect(opts)
+    @api_client = establish_remote_appliance_connection(opts)
+    @logs_interface = @api_client.logs
+    @servers_interface = @api_client.servers
+    @containers_interface = @api_client.containers
+    @clusters_interface = @api_client.clusters
+  end
+
+  def usage
+    "Usage: morpheus #{command_name}"
+  end
+
+  def handle(args)
+    # list(args)
+    handle_subcommand(args)
+  end
+
+  def list(args)
+    options = {}
+    params = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[id]")
+      opts.on('--hosts HOSTS', String, "Filter logs to specific Host ID(s)") do |val|
+        params['servers'] = val.to_s.split(",").collect {|it| it.to_s.strip }.select {|it| it }.compact
+      end
+      opts.on('--servers HOSTS', String, "alias for --hosts") do |val|
+        params['servers'] = val.to_s.split(",").collect {|it| it.to_s.strip }.select {|it| it }.compact
+      end
+      opts.on('--vms HOSTS', String, "alias for --hosts") do |val|
+        params['servers'] = val.to_s.split(",").collect {|it| it.to_s.strip }.select {|it| it }.compact
+      end
+      opts.on('--container CONTAINER', String, "Filter logs to specific Container ID(s)") do |val|
+        params['containers'] = val.to_s.split(",").collect {|it| it.to_s.strip }.select {|it| it }.compact
+      end
+      # opts.on('--nodes HOST', String, "alias for --containers") do |val|
+      #   params['containers'] = val.to_s.split(",").collect {|it| it.to_s.strip }.select {|it| it }.compact
+      # end
+      opts.on('--cluster ID', String, "Filter logs to specific Cluster ID") do |val|
+        params['clusters'] = val.to_s.split(",").collect {|it| it.to_s.strip }.select {|it| it }.compact
+      end
+      opts.on('--start TIMESTAMP','--start TIMESTAMP', "Start timestamp. Default is 30 days ago.") do |val|
+        options[:start] = parse_time(val) #.utc.iso8601
+      end
+      opts.on('--end TIMESTAMP','--end TIMESTAMP', "End timestamp. Default is now.") do |val|
+        options[:end] = parse_time(val) #.utc.iso8601
+      end
+      # opts.on('--interval TIME','--interval TIME', "Interval of time to include, in seconds. Default is 30 days ago.") do |val|
+      #   options[:interval] = parse_time(val).utc.iso8601
+      # end
+      build_common_options(opts, options, [:list, :query, :json, :yaml, :csv, :fields, :dry_run, :remote])
+      opts.footer = "List logs for a container.\n" +
+                    "[id] is required. This is the id of a container."
+    end
+    optparse.parse!(args)
+    if args.count != 0
+      raise_command_error "wrong number of arguments, expected 0 and got (#{args.count}) #{args.join(' ')}\n#{optparse}"
+    end
+    connect(options)
+    begin
+      params.merge!(parse_list_options(options))
+      params[:query] = params.delete(:phrase) unless params[:phrase].nil?
+      params['order'] = params['direction'] unless params['direction'].nil? # old api version expects order instead of direction
+      params['startMs'] = (options[:start].to_i * 1000) if options[:start]
+      params['endMs'] = (options[:end].to_i * 1000) if options[:end]
+      params['interval'] = options[:interval].to_s if options[:interval]
+      # could find_by_name_or_id for params['servers'] and params['containers']
+      @logs_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @logs_interface.dry.list(params)
+        return
+      end
+      json_response = @logs_interface.list(params)
+      render_result = render_with_format(json_response, options, 'data')
+      return 0 if render_result
+
+      title = "Morpheus Logs"
+      subtitles = parse_list_subtitles(options)
+      if params[:start]
+        subtitles << "Start: #{params[:start]}".strip
+      end
+      if params[:end]
+        subtitles << "End: #{params[:end]}".strip
+      end
+      if params[:interval]
+        subtitles << "Interval: #{params[:interval]}".strip
+      end
+      if params[:query]
+        subtitles << "Search: #{params[:query]}".strip
+      end
+      if params['servers']
+        subtitles << "Servers: #{params['servers']}".strip
+      end
+      if params['containers']
+        subtitles << "Containers: #{params['containers']}".strip
+      end
+      if params['clusters']
+        subtitles << "Clusters: #{params['clusters']}".strip
+      end
+      if params[:query]
+        subtitles << "Search: #{params[:query]}".strip
+      end
+      print_h1 title, subtitles, options
+      if json_response['data'].empty?
+        puts "#{cyan}No logs found.#{reset}"
+      else
+        puts format_log_records(json_response['data'], options)
+        print_results_pagination({'meta'=>{'total'=>json_response['total'],'size'=>json_response['data'].size,'max'=>(json_response['max'] || options[:max]),'offset'=>(json_response['offset'] || options[:offset] || 0)}})
+      end
+      print reset,"\n"
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+end

data/lib/morpheus/cli/mixins/infrastructure_helper.rb

@@ -44,7 +44,7 @@ module Morpheus::Cli::InfrastructureHelper
   end
 
   def find_group_by_name(name)
-    json_results = groups_interface.get({name: name})
+    json_results = groups_interface.list({name: name})
     if json_results['groups'].empty?
       print_red_alert "Group not found by name #{name}"
       exit 1
@@ -72,7 +72,7 @@ module Morpheus::Cli::InfrastructureHelper
   end
 
   def find_cloud_by_name(name)
-    json_results = clouds_interface.get({name: name})
+    json_results = clouds_interface.list({name: name})
     if json_results['zones'].empty?
       print_red_alert "Cloud not found by name #{name}"
       exit 1

data/lib/morpheus/cli/mixins/logs_helper.rb

@@ -0,0 +1,65 @@
+require 'morpheus/cli/mixins/print_helper'
+
+# Mixin for Morpheus::Cli command classes
+# Provides common methods for fetching log records.
+# The including class must establish @logs_interface, @containers_interface, @servers_interface
+module Morpheus::Cli::LogsHelper
+
+  def self.included(klass)
+    klass.send :include, Morpheus::Cli::PrintHelper
+  end
+
+  def logs_interface
+    # @api_client.logs
+    raise "#{self.class} has not defined @logs_interface" if @logs_interface.nil?
+    @logs_interface
+  end
+
+  def containers_interface
+    ## @api_client.containers
+    raise "#{self.class} has not defined @logs_interface" if @containers_interface.nil?
+    @containers_interface
+  end
+
+  def servers_interface
+    # @api_client.servers
+    raise "#{self.class} has not defined @servers_interface" if @servers_interface.nil?
+    @servers_interface
+  end
+
+  def clusters_interface
+    # @api_client.clusters
+    raise "#{self.class} has not defined @clusters_interface" if @clusters_interface.nil?
+    @clusters_interface
+  end
+
+  def print_log_records(log_records, options={})
+    print format_log_records(log_records, options)
+  end
+  
+  def format_log_records(log_records, options={})
+    out = ""
+    table_color = options.key?(:color) ? options[:color] : cyan
+    log_records.each do |log_entry|
+      log_level = ''
+      case log_entry['level']
+      when 'INFO'
+        log_level = "#{blue}#{bold}INFO#{reset}"
+      when 'DEBUG'
+        log_level = "#{white}#{bold}DEBUG#{reset}"
+      when 'WARN'
+        log_level = "#{yellow}#{bold}WARN#{reset}"
+      when 'ERROR'
+        log_level = "#{red}#{bold}ERROR#{reset}"
+      when 'FATAL'
+        log_level = "#{red}#{bold}FATAL#{reset}"
+      end
+      out << table_color if table_color
+      out << "[#{log_entry['ts']}] #{log_level} - #{log_entry['message'].to_s.strip}"
+      out << table_color if table_color
+      out << "\n"
+    end
+    return out
+  end
+
+end

data/lib/morpheus/cli/mixins/monitoring_helper.rb

@@ -109,13 +109,38 @@ module Morpheus::Cli::MonitoringHelper
     out = ""
     status_string = severity
     if status_string == 'critical'
-      out << "#{red}#{status_string.capitalize}#{return_color}"
+      out << "#{red}#{status_string.upcase}#{return_color}"
     elsif status_string == 'warning'
-      out << "#{yellow}#{status_string.capitalize}#{return_color}"
+      out << "#{yellow}#{status_string.upcase}#{return_color}"
     elsif status_string == 'info'
-      out << "#{cyan}#{status_string.capitalize}#{return_color}"
+      out << "#{cyan}#{status_string.upcase}#{return_color}"
     else
-      out << "#{cyan}#{status_string}#{return_color}"
+      out << "#{cyan}#{status_string.to_s.upcase}#{return_color}"
+    end
+    out
+  end
+
+  def format_health_status(item, return_color=cyan)
+    out = ""
+    if item
+      attrs = {}
+      attrs[:unknown] = item['lastRunDate'] ? false : true
+      attrs[:muted] = item['createIncident'] == false
+      attrs[:failure] = item['lastCheckStatus'] == 'error'
+      attrs[:health] = item['health'] ? item['health'].to_i : 0
+      
+      if attrs[:unknown]
+        out << "#{cyan}UNKNOWN#{return_color}"
+      elsif attrs[:health] >= 10
+        out << "#{green}HEALTHY#{return_color}"
+      elsif attrs[:failure]
+        out << "#{red}ERROR#{return_color}"
+      else
+        out << "#{yellow}CAUTION#{return_color}"
+      end
+      if attrs[:muted]
+        out << "#{cyan} (Muted)#{return_color}"
+      end
     end
     out
   end
@@ -133,12 +158,18 @@ module Morpheus::Cli::MonitoringHelper
   end
 
   def format_monitoring_incident_status(incident)
+    out = ""
+    muted = incident['inUptime'] == false
     status_string = incident['status']
     if status_string == 'closed'
-      "closed ✓"
+      out << "CLOSED ✓"
     else
-      status_string
+      out << status_string.to_s.upcase
+      if muted
+        out << " (MUTED)"
+      end
     end
+    out
   end
 
   def format_monitoring_issue_status(issue)
@@ -153,7 +184,7 @@ module Morpheus::Cli::MonitoringHelper
     columns = [
       {"ID" => lambda {|incident| incident['id'] } },
       {"SEVERITY" => lambda {|incident| format_severity(incident['severity']) } },
-      {"NAME" => lambda {|incident| incident['name'] || 'No Subject' } },
+      {"NAME" => lambda {|incident| incident['displayName'] || incident['name'] || 'No Subject' } },
       {"TIME" => lambda {|incident| format_local_dt(incident['startDate']) } },
       {"STATUS" => lambda {|incident| format_monitoring_incident_status(incident) } },
       {"DURATION" => lambda {|incident| format_duration(incident['startDate'], incident['endDate']) } }
@@ -164,9 +195,25 @@ module Morpheus::Cli::MonitoringHelper
     print as_pretty_table(incidents, columns, opts)
   end
 
+  def print_incident_issues_table(history_items, opts={})
+    columns = [
+      # {"ID" => lambda {|issue| issue['id'] } },
+      {"SEVERITY" => lambda {|issue| format_severity(issue['severity']) } },
+      {"AVAILABLE" => lambda {|issue| format_boolean issue['available'] } },
+      {"TYPE" => lambda {|issue| issue["attachmentType"] } },
+      {"NAME" => lambda {|issue| issue['name'] } },
+      {"DATE CREATED" => lambda {|issue| format_local_dt(issue['startDate']) } }
+    ]
+    if opts[:include_fields]
+      columns = opts[:include_fields]
+    end
+    print as_pretty_table(history_items, columns, opts)
+  end
+
   def print_incident_history_table(history_items, opts={})
     columns = [
       # {"ID" => lambda {|issue| issue['id'] } },
+      # {"SEVERITY" => lambda {|issue| format_health_status(issue) } },
       {"SEVERITY" => lambda {|issue| format_severity(issue['severity']) } },
       {"AVAILABLE" => lambda {|issue| format_boolean issue['available'] } },
       {"TYPE" => lambda {|issue| issue["attachmentType"] } },
@@ -182,21 +229,9 @@ module Morpheus::Cli::MonitoringHelper
   def print_incident_notifications_table(notifications, opts={})
     columns = [
       {"NAME" => lambda {|notification| notification['recipient'] ? notification['recipient']['name'] : '' } },
-      {"DELIVERY TYPE" => lambda {|notification| notification['addressTypes'].to_s } },
+      {"DELIVERY TYPE" => lambda {|recipient| format_recipient_method(recipient['method'] || recipient['addressTypes']) } },
       {"NOTIFIED ON" => lambda {|notification| format_local_dt(notification['dateCreated']) } },
-      # {"AVAILABLE" => lambda {|notification| format_boolean notification['available'] } },
-      # {"TYPE" => lambda {|notification| notification["attachmentType"] } },
-      # {"NAME" => lambda {|notification| notification['name'] } },
-      {"DATE CREATED" => lambda {|notification| 
-        date_str = format_local_dt(notification['startDate']).to_s
-        if notification['pendingUtil']
-          "(pending) #{date_str}"
-        else
-          date_str
-        end
-      } }
     ]
-    #event['pendingUntil']
     if opts[:include_fields]
       columns = opts[:include_fields]
     end
@@ -277,12 +312,43 @@ module Morpheus::Cli::MonitoringHelper
 
   def print_check_history_table(history_items, opts={})
     columns = [
-      # {"ID" => lambda {|issue| issue['id'] } },
-      {"SEVERITY" => lambda {|issue| format_severity(issue['severity']) } },
-      {"AVAILABLE" => lambda {|issue| format_boolean issue['available'] } },
-      {"TYPE" => lambda {|issue| issue["attachmentType"] } },
-      {"NAME" => lambda {|issue| issue['name'] } },
-      {"DATE CREATED" => lambda {|issue| format_local_dt(issue['startDate']) } }
+      {"STATUS" => lambda {|issue| format_health_status(issue) } },
+      {"DATE CHECKED" => lambda {|issue| format_local_dt(issue['lastRunDate']) } },
+      # {"NAME" => lambda {|issue| issue['name'] } },
+      # {"AVAILABLE" => lambda {|issue| format_boolean issue['createIncident'] } },
+      {"RESPONSE TIME" => lambda {|issue| issue["lastTimer"] ? "#{issue['lastTimer']}ms" : "" } }, 
+      {"LAST METRIC" => lambda {|issue| issue["lastMetric"] } }, 
+      {"MESSAGE" => lambda {|issue| 
+        # issue["lastError"].to_s.empty? ? issue["lastMessage"] : issue["lastError"]
+        if issue['lastCheckStatus'] == 'error'
+          issue["lastError"].to_s
+        else
+          issue["lastMessage"]
+        end
+      } },
+    ]
+    if opts[:include_fields]
+      columns = opts[:include_fields]
+    end
+    print as_pretty_table(history_items, columns, opts)
+  end
+
+  def print_check_group_history_table(history_items, opts={})
+    columns = [
+      {"STATUS" => lambda {|issue| format_health_status(issue) } },
+      {"DATE CHECKED" => lambda {|issue| format_local_dt(issue['lastRunDate']) } },
+      {"CHECK" => lambda {|issue| issue['name'] } },
+      # {"AVAILABLE" => lambda {|issue| format_boolean issue['createIncident'] } },
+      {"RESPONSE TIME" => lambda {|issue| issue["lastTimer"] ? "#{issue['lastTimer']}ms" : "" } }, 
+      {"LAST METRIC" => lambda {|issue| issue["lastMetric"] } }, 
+      {"MESSAGE" => lambda {|issue| 
+        # issue["lastError"].to_s.empty? ? issue["lastMessage"] : issue["lastError"]
+        if issue['lastCheckStatus'] == 'error'
+          issue["lastError"].to_s
+        else
+          issue["lastMessage"]
+        end
+      } },
     ]
     if opts[:include_fields]
       columns = opts[:include_fields]
@@ -290,6 +356,10 @@ module Morpheus::Cli::MonitoringHelper
     print as_pretty_table(history_items, columns, opts)
   end
 
+  def print_monitor_app_history_table(history_items, opts={})
+    print_check_group_history_table(history_items, opts)
+  end
+
   def print_check_notifications_table(notifications, opts={})
     columns = [
       {"NAME" => lambda {|notification| notification['recipient'] ? notification['recipient']['name'] : '' } },
@@ -347,7 +417,7 @@ module Morpheus::Cli::MonitoringHelper
     elsif contacts.size > 1
       print_red_alert "#{contacts.size} Contacts found by name #{name}"
       print "\n"
-      puts as_pretty_table(contacts, [{"ID" => "id" }, {"NAME" => "name"}], {color: red})
+      puts as_pretty_table(contacts, [{"ID" => "id" }, {"NAME" => "name"}, {"EMAIL" => "emailAddress"}], {color: red})
       print_red_alert "Try passing ID instead"
       print reset,"\n"
       exit 1 # return nil
@@ -356,6 +426,47 @@ module Morpheus::Cli::MonitoringHelper
     end
   end
 
+  # Monitoring Alerts
+
+  def find_alert_by_name_or_id(val)
+    if val.to_s =~ /\A\d{1,}\Z/
+      return find_alert_by_id(val)
+    else
+      return find_alert_by_name(val)
+    end
+  end
+
+  def find_alert_by_id(id)
+    begin
+      json_response = monitoring_interface.alerts.get(id.to_i)
+      return json_response['alert']
+    rescue RestClient::Exception => e
+      if e.response && e.response.code == 404
+        print_red_alert "Alert not found by id #{id}"
+        exit 1 # return nil
+      else
+        raise e
+      end
+    end
+  end
+
+  def find_alert_by_name(name)
+    json_results = monitoring_interface.alerts.list({name: name})
+    alerts = json_results["alerts"]
+    if alerts.empty?
+      print_red_alert "Alert not found by name #{name}"
+      exit 1 # return nil
+    elsif alerts.size > 1
+      print_red_alert "#{alerts.size} Alerts found by name #{name}"
+      print "\n"
+      puts as_pretty_table(alerts, [{"ID" => "id" }, {"NAME" => "name"}], {color: red})
+      print_red_alert "Try passing ID instead"
+      print reset,"\n"
+      exit 1 # return nil
+    else
+      return alerts[0]
+    end
+  end
 
   # Monitoring Check Groups
 
@@ -429,7 +540,7 @@ module Morpheus::Cli::MonitoringHelper
   def find_monitoring_app_by_id(id)
     begin
       json_response = monitoring_interface.apps.get(id.to_i)
-      return json_response["monitorApp"] || json_response["app"]
+      return json_response['monitorApp'] || json_response['app']
     rescue RestClient::Exception => e
       if e.response && e.response.code == 404
         print_red_alert "Monitor App not found by id #{id}"
@@ -491,4 +602,275 @@ module Morpheus::Cli::MonitoringHelper
     print as_pretty_table(apps, columns, opts)
   end
 
+  def available_severities
+    [
+      [name:'Critical', code:'critical', value:'critical'],
+      [name:'Warning', code:'warning', value:'warning'],
+      [name:'Info', code:'info', value:'info']
+    ]
+  end
+
+  def format_recipient_method(address_types)
+    address_types = address_types.to_s
+    alert_method_names = []
+    if address_types =~ /email/i
+      alert_method_names << "Email"
+    end
+    if address_types =~ /sms/i
+      alert_method_names << "SMS"
+    end
+    if address_types =~ /apn/i
+      alert_method_names << "APN"
+    end
+    # if alert_method_names.empty?
+    #   alert_method_names << "None"
+    # end
+    anded_list(alert_method_names)
+  end
+
+  # server expects "emailAddress" or "smsAddress" or "emailAddress,smsAddress"
+  # todo: just use array, expect server to parse it.
+  def parse_recipient_method(address_types)
+    requested_methods = address_types.to_s
+    alert_methods = []
+    if address_types =~ /email/i
+      alert_methods << "emailAddress"
+    end
+    if address_types =~ /sms/i || address_types =~ /phone/i || address_types =~ /mobile/i
+      alert_methods << "smsAddress"
+    end
+    if address_types =~ /apn/i
+      alert_methods << "apns"
+    end
+    alert_methods.join(',')
+  end
+
+  def prompt_for_recipients(params, options={})
+    #todo
+  end
+
+  def prompt_for_check_groups(params, options={}, api_client=nil, api_params={})
+  # def prompt_for_check_groups(params, options={})
+    # Check Groups
+    check_group_list = nil
+    check_group_ids = []
+    still_prompting = true
+    
+    if params['checkGroups'].nil?
+      while still_prompting
+        v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'checkGroups', 'type' => 'text', 'fieldLabel' => 'Check Groups', 'required' => false, 'description' => 'Check Groups to include in this alert rule, comma separated list of names or IDs.'}], options[:options])
+        unless v_prompt['checkGroups'].to_s.empty?
+          check_group_list = v_prompt['checkGroups'].split(",").collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+        bad_ids = []
+        if check_group_list && check_group_list.size > 0
+          check_group_list.each do |it|
+            found_check = nil
+            begin
+              found_check = find_check_group_by_name_or_id(it)
+            rescue SystemExit => cmdexit
+            end
+            if found_check
+              check_group_ids << found_check['id']
+            else
+              bad_ids << it
+            end
+          end
+        end
+        still_prompting = bad_ids.empty? ? false : true
+      end
+    else
+      check_group_list = params['checkGroups']
+      still_prompting = false
+      bad_ids = []
+      if check_group_list && check_group_list.size > 0
+        check_group_list.each do |it|
+          found_check = nil
+          begin
+            found_check = find_check_group_by_name_or_id(it)
+          rescue SystemExit => cmdexit
+          end
+          if found_check
+            check_group_ids << found_check['id']
+          else
+            bad_ids << it
+          end
+        end
+      end
+      if !bad_ids.empty?
+        return {success:false, msg:"Check Groups not found: #{bad_ids}"}
+      end
+      # return check_group_ids
+      # payload = {'checkGroups':check_group_ids}
+      # return payload
+      return {success:true, data: check_group_ids}
+    end
+  end
+
+  def prompt_for_checks(params, options={}, api_client=nil, api_params={})
+    # Checks
+    check_list = nil
+    check_ids = nil
+    still_prompting = true
+    if params['checks'].nil?
+      still_prompting = true
+      while still_prompting do
+        v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'checks', 'type' => 'text', 'fieldLabel' => 'Checks', 'required' => false, 'description' => 'Checks to include, comma separated list of names or IDs.'}], options[:options])
+        unless v_prompt['checks'].to_s.empty?
+          check_list = v_prompt['checks'].split(",").collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+        check_ids = []
+        bad_ids = []
+        if check_list && check_list.size > 0
+          check_list.each do |it|
+            found_check = nil
+            begin
+              found_check = find_check_by_name_or_id(it)
+            rescue SystemExit => cmdexit
+            end
+            if found_check
+              check_ids << found_check['id']
+            else
+              bad_ids << it
+            end
+          end
+        end
+        still_prompting = bad_ids.empty? ? false : true
+      end
+    else
+      check_list = params['checks']
+      still_prompting = false
+      check_ids = []
+      bad_ids = []
+      if check_list && check_list.size > 0
+        check_list.each do |it|
+          found_check = nil
+          begin
+            found_check = find_check_by_name_or_id(it)
+          rescue SystemExit => cmdexit
+          end
+          if found_check
+            check_ids << found_check['id']
+          else
+            bad_ids << it
+          end
+        end
+      end
+      if !bad_ids.empty?
+        return {success:false, msg:"Checks not found: #{bad_ids}"}
+      end
+    end
+    return {success:true, data: check_ids}
+  end
+
+  def prompt_for_check_groups(params, options={}, api_client=nil, api_params={})
+  # def prompt_for_check_groups(params, options={})
+    # Check Groups
+    check_group_list = nil
+    check_group_ids = nil
+    bad_ids = []
+    if params['checkGroups'].nil?
+      still_prompting = true
+      while still_prompting do
+        v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'checkGroups', 'type' => 'text', 'fieldLabel' => 'Check Groups', 'required' => false, 'description' => 'Check Groups to include, comma separated list of names or IDs.'}], options[:options])
+        unless v_prompt['checkGroups'].to_s.empty?
+          check_group_list = v_prompt['checkGroups'].split(",").collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+        check_group_ids = []
+        bad_ids = []
+        if check_group_list && check_group_list.size > 0
+          check_group_list.each do |it|
+            found_check = nil
+            begin
+              found_check = find_check_group_by_name_or_id(it)
+            rescue SystemExit => cmdexit
+            end
+            if found_check
+              check_group_ids << found_check['id']
+            else
+              bad_ids << it
+            end
+          end
+        end
+        still_prompting = bad_ids.empty? ? false : true
+      end
+    else
+      check_group_list = params['checkGroups']
+      check_group_ids = []
+      bad_ids = []
+      if check_group_list && check_group_list.size > 0
+        check_group_list.each do |it|
+          found_check = nil
+          begin
+            found_check = find_check_group_by_name_or_id(it)
+          rescue SystemExit => cmdexit
+          end
+          if found_check
+            check_group_ids << found_check['id']
+          else
+            bad_ids << it
+          end
+        end
+      end
+      if !bad_ids.empty?
+        return {success:false, msg:"Check Groups not found: #{bad_ids}"}
+      end
+    end
+    return {success:true, data: check_group_ids}
+  end
+
+  def prompt_for_monitor_apps(params, options={}, api_client=nil, api_params={})
+    # Apps
+      
+    monitor_app_list = nil
+    monitor_app_ids = nil
+    if params['apps'].nil?
+      still_prompting = true
+      while still_prompting
+        v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'apps', 'type' => 'text', 'fieldLabel' => 'Apps', 'required' => false, 'description' => 'Monitor Apps to include, comma separated list of names or IDs.'}], options[:options])
+        unless v_prompt['apps'].to_s.empty?
+          monitor_app_list = v_prompt['apps'].split(",").collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+        check_group_ids = []
+        bad_ids = []
+        if monitor_app_list && monitor_app_list.size > 0
+          monitor_app_list.each do |it|
+            found_monitor_app = nil
+            begin
+              found_monitor_app = find_monitoring_app_by_name_or_id(it)
+            rescue SystemExit => cmdexit
+            end
+            if found_monitor_app
+              monitor_app_ids << found_monitor_app['id']
+            else
+              bad_ids << it
+            end
+          end
+        end
+        still_prompting = bad_ids.empty? ? false : true
+      end
+    else
+      monitor_app_list = params['apps']
+      check_group_ids = []
+      bad_ids = []
+      if monitor_app_list && monitor_app_list.size > 0
+        monitor_app_list.each do |it|
+          found_monitor_app = nil
+          begin
+            found_monitor_app = find_monitoring_app_by_name_or_id(it)
+          rescue SystemExit => cmdexit
+          end
+          if found_monitor_app
+            monitor_app_ids << found_monitor_app['id']
+          else
+            bad_ids << it
+          end
+        end
+      end
+      if !bad_ids.empty?
+        return {success:false, msg:"Monitor Apps not found: #{bad_ids}"}
+      end
+    end
+    return {success:true, data: monitor_app_ids}
+  end
 end