wavefront-cli 5.1.1 → 7.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44f481275247e98780e57065df2166e93158382c03dea0d9dbc627b2d1756777
-  data.tar.gz: b225b2ba3668cc00c6e3e873064bcf54b79c1dbc6638009cba09cfb6de7874c8
+  metadata.gz: 65a2455065fbd4b69b42718f7789e4c01cb5245a0015ea7d2977b96581ad0b83
+  data.tar.gz: 2c01e8464589c804271a97dba24a19a62b3f4a1dba9af588216f1d0b911c9ec9
 SHA512:
-  metadata.gz: 42c775a15f3a74a7ffbaa45ebff0d38755996c64afeca494496c4707a26734733e6f18f7469be9ac3b82786697e1d773748057c96789ea470e8a7d8022c851f1
-  data.tar.gz: 1945c8a72ce0cc6fb6c4cdda8a8f8baabad6f020175d25f8109fb240f58c3cf175cd1b846c9fc7830c6bba31356f83975e69eac8736b3cf7aa0fbf7c88d8d7fb
+  metadata.gz: 392ea65a15b94665c5255da837abcaf3a8b69d38db9b675652c5c824627b3436b4b802174283bcdda6d2f95150cb3fce0a21de2dfcb449c64a0a73259d16357b
+  data.tar.gz: f55ffa3998170ee1a3d98f55cdefa9cd27d2f84e39f3c2fcbe3ffb649bcb34eeb96e93e1a486f4edfa030244e4640e3777865eef6f6119380dec7ff273637041

data/.rubocop.yml

@@ -1,14 +1,50 @@
 ---
 
 AllCops:
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.4
 
 Metrics/ClassLength:
   Max: 400
 
+Style/IfUnlessModifier:
+  Enabled: false # because it wants to make lines >80 chars
 Style/HashEachMethods:
     Enabled: true
 Style/HashTransformKeys:
     Enabled: true
 Style/HashTransformValues:
     Enabled: true
+
+# New compatabilities
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+Lint/RaiseException:
+  Enabled: true
+Lint/StructNewOverride:
+  Enabled: true
+Style/ExponentialNotation:
+  Enabled: true
+Style/SlicingWithRange:
+  Enabled: true
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+Style/RedundantRegexpEscape:
+  Enabled: true
+Style/AccessorGrouping:
+  Enabled: true
+Style/BisectedAttrAccessor:
+  Enabled: true
+Style/RedundantAssignment:
+  Enabled: true
+Style/RedundantFetchBlock:
+  Enabled: true
+
+# Is nothing sacred?
+Layout/LineLength:
+  Max: 80

data/HISTORY.md

@@ -1,7 +1,39 @@
 # Changelog
 
-## 5.2.1 (2020-02-20)
-* Say whether `--upsert` did and update or an import.
+## 7.2.0 (2020-08-12)
+* Add `cloudintegration awsid generate` command.
+* Add `cloudintegration awsid delete <external_id>` command.
+* Add `cloudintegration awsid validate <external_id>` command.
+* Require 5.1.x of [the SDK](https://github.com/snltd/wavefront-sdk).
+
+## 7.1.0 (2020-08-07)
+* Remove `user` command. (Breaking change.)
+* Add `account` command.
+* Complete coverage of roles and user groups.
+* Add `alert affected hosts` command to show which hosts are affected by one
+  or all firing alerts.
+* Remove obsolete `group` subcommands. (`grant` and `revoke`).
+* Add `write noise` command to send a flow of random data to an endpoint.
+* Better information when working with cloud integrations.
+
+## 7.0.0 (unreleased)
+
+## 6.1.0 (2020-06-02)
+* Add `-A` flag to `proxy list` command, to only list active proxies
+
+## 6.0.0 (2020-04-07)
+* Remove `cluster` command. (Breaking change.)
+* Add `role` command.
+* Add `--nocache`, `--nostrict` and `--histogram-view` options to `query`
+  command.
+* Require 5.x of [the SDK](https://github.com/snltd/wavefront-sdk).
+
+## 5.1.2 (2020-02-28)
+* Fix regression in HCL dashboard export.
+* Properly handle unavailable port when sending distributions to a proxy.
+
+## 5.1.1 (2020-02-20)
+* Say whether `--upsert` did an update or an import.
 
 ## 5.1.0 (2020-02-20)
 * Add `-U` (`--upsert`) option to `import` sub-commands.

data/README.md

@@ -33,7 +33,6 @@ Commands:
   alert              view and manage alerts
   apitoken           view and your own API tokens
   cloudintegration   view and manage cloud integrations
-  cluster            view and manage monitored clusters
   config             create and manage local configuration
   dashboard          view and manage dashboards
   derivedmetric      view and manage derived metrics
@@ -52,7 +51,6 @@ Commands:
   source             view and manage source tags and descriptions
   spy                monitor traffic going into Wavefront
   usage              view and manage usage reports
-  user               view and manage Wavefront users
   usergroup          view and manage Wavefront user groups
   webhook            view and manage webhooks
   window             view and manage maintenance windows
@@ -104,7 +102,7 @@ $ wf proxy list
 
 You can get more verbose listings with the `-l` flag. Results may be
 paginated. You can progress through pages with the `-L` and `-o`
-options, or user `--all` to get everything in one go.
+options, or use `--all` to get everything in one go.
 
 ### Describing Things
 
@@ -152,7 +150,7 @@ mentioned above, human-readable listings and desctiptions may omit
 data which is not likely to be useful, or which is extremely hard to
 present in a readable way.
 
-If you `describe` an object like a dashboard, user, webhook etc as
+If you `describe` an object like a dashboard, account, webhook etc as
 `json` or `yaml`, and send the output to a file, you can re-import
 that data. The format of the file to be imported is automatically
 detected.

data/lib/wavefront-cli/account.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module WavefrontCli
+  #
+  # CLI coverage for the v2 'account' API.
+  #
+  class Account < WavefrontCli::Base
+    alias do_roles do_describe
+    alias do_groups do_describe
+    alias do_ingestionpolicy do_describe
+    alias do_permissions do_describe
+
+    def do_role_add_to
+      wf_account_id?(options[:'<id>'])
+      wf.add_roles(options[:'<id>'], options[:'<role>'])
+    end
+
+    def do_role_remove_from
+      wf_account_id?(options[:'<id>'])
+      wf.remove_roles(options[:'<id>'], options[:'<role>'])
+    end
+
+    def do_group_add_to
+      wf_account_id?(options[:'<id>'])
+      wf.add_user_groups(options[:'<id>'], options[:'<group>'])
+    end
+
+    def do_group_remove_from
+      wf_account_id?(options[:'<id>'])
+      wf.remove_user_groups(options[:'<id>'], options[:'<group>'])
+    end
+
+    def do_business_functions
+      wf_user_id?(options[:'<id>'])
+      wf.business_functions(options[:'<id>'])
+    end
+
+    def do_grant_to
+      wf.grant(options[:'<account>'], options[:'<permission>'])
+    end
+
+    def do_revoke_from
+      wf.revoke(options[:'<account>'], options[:'<permission>'])
+    end
+
+    def do_ingestionpolicy_add_to
+      wf_account_id?(options[:'<id>'])
+      wf.add_ingestion_policy(options[:'<policy>'], [options[:'<id>']])
+    end
+
+    def do_ingestionpolicy_remove_from
+      wf_account_id?(options[:'<id>'])
+      wf_ingestionpolicy_id?(options[:'<policy>'])
+      wf.remove_ingestion_policy(options[:'<policy>'], [options[:'<id>']])
+    end
+
+    def do_create_user
+      wf_user_id?(options[:'<id>'])
+      wf.user_create(user_body)
+    end
+
+    def do_invite_user
+      wf_user_id?(options[:'<id>'])
+      wf.user_invite([user_body])
+    end
+
+    def do_validate
+      wf.validate_accounts(options[:'<account>'])
+    end
+
+    def extra_validation
+      validate_policy
+      validate_permission
+      validate_roles
+      validate_groups
+      validate_accounts
+    end
+
+    private
+
+    def validate_policy
+      wf_ingestionpolicy_id?(options[:'<policy>']) if options[:'<policy>']
+    end
+
+    def validate_permission
+      wf_permission?(options[:'<permission>']) if options[:'<permission>']
+    end
+
+    def validate_roles
+      options[:'<role>'].each { |r| wf_role_id?(r) }
+    end
+
+    def validate_groups
+      options[:'<group>'].each { |g| wf_usergroup_id?(g) }
+    end
+
+    def validate_accounts
+      options[:'<account>'].each { |a| wf_account_id?(a) }
+    end
+
+    # Object used to create and invite users. We deal with the permissions
+    # seperately because if we don't supply any and they get compacted out,
+    # the user is created with a default set of perms, and we don't want that.
+    #
+    def user_body
+      raw = {
+        emailAddress: options[:'<id>'],
+        roles: options[:roleid],
+        ingestionPolicyId: options[:policyid],
+        userGroups: options[:groupid]
+      }.reject { |_k, v| v&.empty? }.compact
+
+      raw[:groups] = options[:permission]
+      raw
+    end
+  end
+end

data/lib/wavefront-cli/alert.rb

@@ -50,6 +50,14 @@ module WavefrontCli
       wf.history(options[:'<id>'], options[:offset], options[:limit])
     end
 
+    def do_affected_hosts
+      if options[:'<id>']
+        affected_hosts_for_id(options[:'<id>'])
+      else
+        all_affected_hosts
+      end
+    end
+
     def do_currently
       state = options[:'<state>'].to_s
 
@@ -146,5 +154,26 @@ module WavefrontCli
         end
       end.compact
     end
+
+    def all_affected_hosts
+      cannot_noop!
+      in_state(:firing).tap do |r|
+        r.response = r.response.items.each_with_object({}) do |alert, aggr|
+          aggr[alert[:id]] = affected_hosts_for_id(alert[:id]).response
+        end
+      end
+    end
+
+    def affected_hosts_for_id(id)
+      resp = wf.describe(id)
+
+      return if options[:noop]
+
+      return resp unless resp.ok? && resp.response.key?(:failingHostLabelPairs)
+
+      resp.tap do |r|
+        r.response = r.response[:failingHostLabelPairs].map { |h| h[:host] }
+      end
+    end
   end
 end

data/lib/wavefront-cli/base.rb

@@ -485,7 +485,6 @@ module WavefrontCli
     # @param cond [String] a search condition, like "key=value"
     # @return [Hash] of matchingMethod and negated
     #
-    # rubocop:disable Metrics/CyclomaticComplexity
     # rubocop:disable Metrics/MethodLength
     def matching_method(cond)
       case cond
@@ -506,7 +505,6 @@ module WavefrontCli
       end
     end
     # rubocop:enable Metrics/MethodLength
-    # rubocop:enable Metrics/CyclomaticComplexity
 
     # Return a detailed description of one item, if an ID has been
     # given, or all items if it has not.

data/lib/wavefront-cli/cloudintegration.rb

@@ -22,5 +22,17 @@ module WavefrontCli
     def do_disable
       wf.disable(options[:'<id>'])
     end
+
+    def do_awsid_generate
+      wf.create_aws_external_id
+    end
+
+    def do_awsid_delete
+      wf.delete_aws_external_id(options[:'<external_id>'])
+    end
+
+    def do_awsid_confirm
+      wf.confirm_aws_external_id(options[:'<external_id>'])
+    end
   end
 end

data/lib/wavefront-cli/commands/.rubocop.yml

@@ -11,3 +11,37 @@ Style/HashTransformKeys:
     Enabled: true
 Style/HashTransformValues:
     Enabled: true
+
+# new compatabilities
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+Lint/RaiseException:
+  Enabled: true
+Lint/StructNewOverride:
+  Enabled: true
+Style/ExponentialNotation:
+  Enabled: true
+Style/SlicingWithRange:
+  Enabled: true
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+Style/RedundantRegexpEscape:
+  Enabled: true
+Style/AccessorGrouping:
+  Enabled: true
+Style/BisectedAttrAccessor:
+  Enabled: true
+Style/RedundantAssignment:
+  Enabled: true
+Style/RedundantFetchBlock:
+  Enabled: true
+
+# Is nothing sacred?
+Layout/LineLength:
+  Max: 80

data/lib/wavefront-cli/commands/account.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+# Define the account command.
+#
+class WavefrontCommandAccount < WavefrontCommandBase
+  def description
+    "view and manage Wavefront #{things}"
+  end
+
+  def _commands
+    ["list #{CMN} [-sSal] [-O fields] [-o offset] [-L limit]",
+     "describe #{CMN} <id>",
+     "create user #{CMN} [-m permission...] [-g group-id...] " \
+     '[-r role-id...] [-i policy-id] <id>',
+     "invite user #{CMN} [-m permission...] [-g group-id...] " \
+     '[-r role-id...] [-i policy-id] <id>',
+     "delete #{CMN} <id>",
+     "dump #{CMN}",
+     "import #{CMN} [-uU] <file>",
+     "role #{CMN} add to <id> <role>...",
+     "role #{CMN} remove from <id> <role>...",
+     "roles #{CMN} <id>",
+     "ingestionpolicy #{CMN} add to <id> <policy>",
+     "ingestionpolicy #{CMN} remove from <id> <policy>",
+     "ingestionpolicy #{CMN} <id>",
+     "group #{CMN} add to <id> <group>...",
+     "group #{CMN} remove from <id> <group>...",
+     "groups #{CMN} <id>",
+     "grant #{CMN} <permission> to <account>...",
+     "revoke #{CMN} <permission> from <account>...",
+     "permissions #{CMN} <id>",
+     "business functions #{CMN} <id>",
+     "validate #{CMN} [-l] <account>...",
+     "search #{CMN} [-al] [-o offset] [-L limit] [-O fields] <condition>..."]
+  end
+
+  def _options
+    [common_options,
+     "-l, --long               list #{things} in detail",
+     "-a, --all                list all #{things}",
+     "-o, --offset=n           start from nth #{thing}",
+     "-L, --limit=COUNT        number of #{things} to list",
+     '-s, --service            list only service accounts',
+     '-S, --user               list only user accounts',
+     '-O, --fields=F1,F2,...   only show given fields',
+     "-u, --update             update an existing #{thing}",
+     "-U, --upsert             import new or update existing #{thing}",
+     '-m, --permission=STRING  Wavefront permission name',
+     '-g, --groupid=STRING     Wavefront usergroup ID',
+     '-r, --roleid=STRING      Wavefront role ID',
+     '-i, --policyid=STRING    Wavefront ingestion policy ID']
+  end
+
+  def postscript
+    'Service accounts can be partially managed with this command, but ' \
+    "'wf serviceaccount' has more features.\n\nFor a list of permissions, " \
+    "run 'wf settings list permissions'.".fold(TW, 0)
+  end
+end

data/lib/wavefront-cli/commands/alert.rb

@@ -8,6 +8,7 @@ class WavefrontCommandAlert < WavefrontCommandBase
   def _commands
     ["list #{CMN} [-al] [-O fields] [-o offset] [-L limit]",
      "firing #{CMN} [-o offset] [-L limit]",
+     "affected #{CMN} hosts [<id>]",
      "snoozed #{CMN} [-o offset] [-L limit]",
      "describe #{CMN} [-v version] <id>",
      "delete #{CMN} <id>",

data/lib/wavefront-cli/commands/base.rb

@@ -165,6 +165,6 @@ class WavefrontCommandBase
   # @return [String] a full options string which docopt understands
   #
   def docopt
-    commands + "\n\n" + options + "\n" + postscript
+    commands + "\n\n" + options + "\n\n" + postscript
   end
 end