]> arthur.barton.de Git - netdata.git/commitdiff
Update /charts at API definition.
authorSimon Nagl <simonnagl@aim.com>
Sun, 12 Feb 2017 08:21:41 +0000 (09:21 +0100)
committerSimon Nagl <simonnagl@aim.com>
Sun, 12 Feb 2017 08:22:10 +0000 (09:22 +0100)
web/netdata-swagger.json
web/netdata-swagger.yaml

index ad424abad8726d93f94bdb0412d08bf9e823b608..404944d1206f3a003b47ffb6ad23a206c067d433 100644 (file)
@@ -3,7 +3,7 @@
     "info": {
         "title": "NetData API",
         "description": "Real time data collection and graphs...",
-        "version": "1.4.1_master"
+        "version": "1.5.1_rolling"
     },
     "host": "registry.my-netdata.io",
     "schemes": [
                     }
                 }
             }
+        },
+        "/allmetrics": {
+            "get": {
+                "summary": "Get a value of all the metrics maintained by netdata",
+                "description": "The charts endpoint returns the latest value of all charts and dimensions stored in the netdata server.",
+                "parameters": [
+                    {
+                        "name": "format",
+                        "in": "query",
+                        "description": "The format of the response to be returned",
+                        "required": true,
+                        "type": "string",
+                        "enum": [
+                            "shell",
+                            "prometheus"
+                        ],
+                        "default": "shell"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "All the metrics returned in the format requested"
+                    },
+                    "400": {
+                        "description": "The format requested is not supported"
+                    }
+                }
+            }
         }
     },
     "definitions": {
                     "type": "string",
                     "description": "The hostname of the netdata server."
                 },
+                "version": {
+                    "type": "string",
+                    "description": "netdata version of the server."
+                },
+                "os": {
+                    "type": "string",
+                    "description": "The netdata server host operating system.",
+                    "enum": [
+                        "macos",
+                        "linux",
+                        "freebsd"
+                    ]
+                },
+                "history": {
+                    "type": "number",
+                    "description": "The duration, in seconds, of the round robin database maintained by netdata."
+                },
                 "update_every": {
                     "type": "number",
                     "description": "The default update frequency of the netdata server. All charts have an update frequency equal or bigger than this."
                             "$ref": "#/definitions/chart"
                         }
                     }
+                },
+                "charts_count": {
+                    "type": "number",
+                    "description": "The number of charts."
+                },
+                "dimensions_count": {
+                    "type": "number",
+                    "description": "The total number of dimensions."
+                },
+                "alarms_count": {
+                    "type": "number",
+                    "description": "The number of alarms."
+                },
+                "rrd_memory_bytes": {
+                    "type": "number",
+                    "description": "The size of the round robin database in bytes."
                 }
             }
         },
                             "$ref": "#/definitions/dimension"
                         }
                     }
+                },
+                "green": {
+                    "type": "number",
+                    "description": "Chart health green threshold"
+                },
+                "red": {
+                    "type": "number",
+                    "description": "Chart health red trheshold"
                 }
             }
         },
index 00a038ce75cdcc19f010aded72dd582d80b6e2a9..a74d66f5dc03c042890ef5f94b594339f877c1b8 100644 (file)
@@ -2,7 +2,7 @@ swagger: '2.0'
 info:
   title: NetData API
   description: 'Real time data collection and graphs...'
-  version: 1.4.1_master
+  version: 1.5.1_rolling
 host: registry.my-netdata.io
 schemes:
   - http
@@ -283,6 +283,16 @@ definitions:
       hostname:
         type: string
         description: 'The hostname of the netdata server.'
+      version:
+        type: string
+        description: 'netdata version of the server.'
+      os:
+        type: string
+        description: 'The netdata server host operating system.'
+        enum: [ 'macos', 'linux', 'freebsd' ]
+      history:
+        type: number
+        description: 'The duration, in seconds, of the round robin database maintained by netdata.'
       update_every:
         type: number
         description: 'The default update frequency of the netdata server. All charts have an update frequency equal or bigger than this.'
@@ -292,6 +302,18 @@ definitions:
         properties:
           key:
               $ref: '#/definitions/chart'
+      charts_count:
+        type: number
+        description: 'The number of charts.'
+      dimensions_count:
+        type: number
+        description: 'The total number of dimensions.'
+      alarms_count:
+        type: number
+        description: 'The number of alarms.'
+      rrd_memory_bytes:
+        type: number
+        description: 'The size of the round robin database in bytes.'
   chart:
     type: object
     properties:
@@ -344,13 +366,19 @@ definitions:
         properties:
           key:
               $ref: '#/definitions/dimension'
+      green:
+        type: number
+        description: 'Chart health green threshold'
+      red:
+        type: number
+        description: 'Chart health red trheshold'
   dimension:
     type: object
     properties:
       name:
         type: string
         description: 'The name of the dimension'
+        
   json_wrap:
     type: object
     properties: