Replaced paging with limit parameter.

Author: Davide Schiera

README.md

@@ -53,7 +53,7 @@ For an example on how to parse this output, take a look at a simple example like
 Methods
 -------
 #### `add_dashboard_panel`
-**`(self, dashboard, name, type, metrics, scope=None, layout=None, sort_by=None, paging=None)`**
+**`(self, dashboard, name, type, metrics, scope=None, layout=None, sort_by=None, limit=None)`**
 
 **Description**  
 Adds a panel to the dashboard. A panel can be a time series, or a top chart (i.e. bar chart), or a number panel.
@@ -68,7 +68,7 @@ Adds a panel to the dashboard. A panel can be a time series, or a top chart (i.e
  - `number`: 1 metric only
 - **scope**: filter to apply to the panel; must be based on metadata available in Sysdig Cloud; Example: _kubernetes.namespace.name='production' and container.image='nginx'_.
 - **sort_by**: Data sorting; The parameter is optional and it's a dictionary of `metric` and `mode` (it can be `desc` or `asc`)
-- **paging**: Data pagination; The parameter is optional and limits the data points returned. The parameter is a dictionary of `from` and `to` with the index of the first and last point respectively
+- **limit**: This parameter sets the limit on the number of lines/bars shown in a `timeSeries` or `top` panel. In the case of more entities being available than the limit, the top entities according to the sort will be shown. The default value is 10 for `top` panels (for `timeSeries` the default is defined by Sysdig Cloud itself). Note that increasing the limit above 10 is not officially supported and may cause performance and rendering issues
 - **layout**: Size and position of the panel. The dashboard layout is defined by a grid of 12 columns, each row height is equal to the column height. For example, say you want to show 2 panels at the top: one panel might be 6 x 3 (half the width, 3 rows height) located in row 1 and column 1 (top-left corner of the viewport), the second panel might be 6 x 3 located in row 1 and position 7. The location is specified by a dictionary of `row` (row position), `col` (column position), `size_x` (width), `size_y` (height).
 
 **Success Return Value**  

examples/dashboard.py

@@ -85,8 +85,8 @@
   { 'id': 'cpu.used.percent', 'aggregations': { 'time': 'avg', 'group': 'avg' } }
 ]
 sort_by = { 'metric': 'cpu.used.percent', 'mode': 'desc' }
-paging = { 'from': 0, 'to': 10 }
-res = sdclient.add_dashboard_panel(dashboard_configuration, panel_name, panel_type, metrics, sort_by=sort_by, paging=paging)
+limit = 10
+res = sdclient.add_dashboard_panel(dashboard_configuration, panel_name, panel_type, metrics, sort_by=sort_by, limit=limit)
 
 # Check the result
 if res[0]:

sdcclient/_client.py

@@ -375,14 +375,12 @@ def create_dashboard(self, name):
         else:
             return [True, r.json()]
 
-    def add_dashboard_panel(self, dashboard, name, type, metrics, scope=None, sort_by=None, paging=None, layout=None):
+    def add_dashboard_panel(self, dashboard, name, type, metrics, scope=None, sort_by=None, limit=None, layout=None):
         panel_configuration = {
             'name':                 name,
             'showAs':               None,
             'showAsType':           None,
-            'format':               None,
             'metrics':              [],
-            'filter':               None,
             'gridConfiguration':    {
                                         'col':      1,
                                         'row':      1,
@@ -448,6 +446,13 @@ def add_dashboard_panel(self, dashboard, name, type, metrics, scope=None, sort_b
         if type == 'timeSeries':
             panel_configuration['showAs'] = 'timeSeries'
             panel_configuration['showAsType'] = 'line'
+
+            if limit != None:
+                panel_configuration['paging'] = {
+                    'from': 0,
+                    'to':   limit - 1
+                }
+
         elif type == 'number':
             panel_configuration['showAs'] = 'summary'
             panel_configuration['showAsType'] = 'summary'
@@ -466,13 +471,16 @@ def add_dashboard_panel(self, dashboard, name, type, metrics, scope=None, sort_b
                     'mode': sort_by['mode']
                 }]
 
-            if paging == None:
+            if limit == None:
                 panel_configuration['paging'] = {
                     'from': 0,
                     'to':   10
                 }
             else:
-                panel_configuration['paging'] = paging
+                panel_configuration['paging'] = {
+                    'from': 0,
+                    'to':   limit - 1
+                }
 
 
         #