Class: Wavefront::Dashboard

Inherits:
CoreApi
  • Object
show all
Includes:
Mixin::Acl, Mixin::Tag
Defined in:
lib/wavefront-sdk/dashboard.rb

Overview

View and manage dashboards.

Instance Attribute Summary

Attributes inherited from CoreApi

#api, #creds, #logger, #opts

Instance Method Summary collapse

Methods included from Mixin::Tag

#tag_add, #tag_delete, #tag_set, #tags

Methods included from Mixin::Acl

#acl_add, #acl_delete, #acl_set, #acls

Methods inherited from CoreApi

#api_base, #api_path, #hash_for_update, #initialize, #setup_api, #time_to_ms

Methods included from Mixins

#log, #parse_relative_time, #parse_time, #relative_time, #time_multiplier, #valid_relative_time?

Methods included from Validators

#uuid?, #wf_alert_id?, #wf_alert_severity?, #wf_apitoken_id?, #wf_cloudintegration_id?, #wf_dashboard_id?, #wf_derivedmetric_id?, #wf_distribution?, #wf_distribution_count?, #wf_distribution_interval?, #wf_distribution_values?, #wf_epoch?, #wf_event_id?, #wf_granularity?, #wf_integration_id?, #wf_link_id?, #wf_link_template?, #wf_maintenance_window_id?, #wf_message_id?, #wf_metric_name?, #wf_ms_ts?, #wf_name?, #wf_notificant_id?, #wf_point?, #wf_point_tag?, #wf_point_tags?, #wf_proxy_id?, #wf_savedsearch_entity?, #wf_savedsearch_id?, #wf_source_id?, #wf_string?, #wf_tag?, #wf_ts?, #wf_user_id?, #wf_usergroup_id?, #wf_value?, #wf_version?, #wf_webhook_id?

Constructor Details

This class inherits a constructor from Wavefront::CoreApi

Instance Method Details

#create(body) ⇒ Wavefront::Response

POST /api/v2/dashboard Create a specific dashboard. Refer to the Swagger API docs for valid keys.

Parameters:

  • body (Hash) —

    description of dashboard

Returns:

Raises:

  • (ArgumentError) 


35
36
37
38
 
# File 'lib/wavefront-sdk/dashboard.rb', line 35

def create(body)
  raise ArgumentError unless body.is_a?(Hash)
  api.post('', body, 'application/json')
end

#delete(id) ⇒ Wavefront::Response

DELETE /api/v2/dashboard/id Delete a specific dashboard. Deleting an active dashboard moves it to ‘trash’, from where it can be restored with an #undelete operation. Deleting a dashboard in ‘trash’ removes it for ever.

Parameters:

  • id (String) —

    ID of the dashboard

Returns:



49
50
51
52
 
# File 'lib/wavefront-sdk/dashboard.rb', line 49

def delete(id)
  wf_dashboard_id?(id)
  api.delete(id)
end

#describe(id, version = nil) ⇒ Wavefront::Response

GET /api/v2/dashboard/id Get a specific dashboard / Get a specific historical version of a specific dashboard.

Parameters:

  • id (String) —

    ID of the dashboard

  • version (Integer) (defaults to: nil) —

    version of dashboard

Returns:



62
63
64
65
66
67
68
 
# File 'lib/wavefront-sdk/dashboard.rb', line 62

def describe(id, version = nil)
  wf_dashboard_id?(id)
  wf_version?(version) if version
  fragments = [id]
  fragments += ['history', version] if version
  api.get(fragments.uri_concat)
end

#favorite(id) ⇒ Wavefront::Response Also known as: favourite

POST /api/v2/dashboard/id/favorite Mark a dashboard as favorite

Parameters:

  • id (String) —

    ID of the dashboard

Returns:



97
98
99
100
 
# File 'lib/wavefront-sdk/dashboard.rb', line 97

def favorite(id)
  wf_dashboard_id?(id)
  api.post([id, 'favorite'].uri_concat)
end

#history(id) ⇒ Wavefront::Response

GET /api/v2/dashboard/id/history Get the version history of a dashboard.

Parameters:

  • id (String) —

    ID of the dashboard

Returns:



109
110
111
112
 
# File 'lib/wavefront-sdk/dashboard.rb', line 109

def history(id)
  wf_dashboard_id?(id)
  api.get([id, 'history'].uri_concat)
end

#list(offset = 0, limit = 100) ⇒ Wavefront::Response

GET /api/v2/dashboard Get all dashboards for a customer.

Parameters:

  • offset (Int) (defaults to: 0) —

    dashboard at which the list begins

  • limit (Int) (defaults to: 100) —

    the number of dashboards to return

Returns:



24
25
26
 
# File 'lib/wavefront-sdk/dashboard.rb', line 24

def list(offset = 0, limit = 100)
  api.get('', offset: offset, limit: limit)
end

#undelete(id) ⇒ Wavefront::Response

POST /api/v2/dashboard/id/undelete Move a dashboard from ‘trash’ back into active service.

Parameters:

  • id (String) —

    ID of the dashboard

Returns:



120
121
122
123
 
# File 'lib/wavefront-sdk/dashboard.rb', line 120

def undelete(id)
  wf_dashboard_id?(id)
  api.post([id, 'undelete'].uri_concat)
end

#unfavorite(id) ⇒ Wavefront::Response Also known as: unfavourite

POST /api/v2/dashboard/id/unfavorite Unmark a dashboard as favorite

Parameters:

  • id (String) —

    ID of the dashboard

Returns:



131
132
133
134
 
# File 'lib/wavefront-sdk/dashboard.rb', line 131

def unfavorite(id)
  wf_dashboard_id?(id)
  api.post([id, 'unfavorite'].uri_concat)
end

#update(id, body, modify = true) ⇒ Wavefront::Response

PUT /api/v2/dashboard/id Update a specific dashboard.

Parameters:

  • id (String) —

    a Wavefront alert ID

  • body (Hash) —

    key-value hash of the parameters you wish to change

  • modify (true, false) (defaults to: true) —

    if true, use #describe() to get a hash describing the existing object, and modify that with the new body. If false, pass the new body straight through.

Returns:

Raises:

  • (ArgumentError) 


81
82
83
84
85
86
87
88
89
 
# File 'lib/wavefront-sdk/dashboard.rb', line 81

def update(id, body, modify = true)
  wf_dashboard_id?(id)
  raise ArgumentError unless body.is_a?(Hash)

  return api.put(id, body, 'application/json') unless modify

  api.put(id, hash_for_update(describe(id).response, body),
          'application/json')
end

#update_keys ⇒ Object 



13
14
15
 
# File 'lib/wavefront-sdk/dashboard.rb', line 13

def update_keys
  i[id name url description sections]
end

#valid_id?(id) ⇒ Boolean

Returns:

  • (Boolean) 


137
138
139
 
# File 'lib/wavefront-sdk/dashboard.rb', line 137

def valid_id?(id)
  wf_dashboard_id?(id)
end