4 description: 'Real time monitoring for linux, over the web!'
14 summary: 'Get a list of all charts available at the server'
15 description: 'The charts endpoint returns a summary about all charts stored in the netdata server.'
18 description: 'An array of charts'
22 $ref: '#/definitions/chart_summary'
25 summary: 'Get info about a specific chart'
26 description: 'The Chart endpoint returns detailed information about a chart.'
30 description: 'The id of the chart as returned by the /charts call.'
33 format: 'as returned by /charts'
36 description: 'A javascript object with detailed information about the chart.'
38 $ref: '#/definitions/chart'
40 description: 'No chart with the given id is found.'
43 summary: 'Get collected data for a specific chart'
45 The Data endpoint returns data stored in the round robin database of a chart.
49 description: 'The id of the chart as returned by the /charts call.'
52 format: 'as returned by /charts'
53 allowEmptyValue: false
56 description: 'zero, one or more dimension ids, as returned by the /chart call.'
61 collectionFormat: pipes
62 format: 'as returned by /charts'
63 allowEmptyValue: false
66 description: 'This parameter can either be an absolute timestamp specifying the starting point of the data to be returned, or a relative number of seconds, to the last collected timestamp. Netdata will assume it is a relative number if it is smaller than the duration of the round robin database for this chart. So, if the round robin database is 3600 seconds, any value from -3600 to 3600 will trigger relative arithmetics. Netdata will adapt this parameter to the boundaries of the round robin database.'
70 allowEmptyValue: false
74 description: 'This parameter can either be an absolute timestamp specifying the ending point of the data to be returned, or a relative number of seconds, to the last collected timestamp. Netdata will assume it is a relative number if it is smaller than the duration of the round robin database for this chart. So, if the round robin database is 3600 seconds, any value from -3600 to 3600 will trigger relative arithmetics. Netdata will adapt this parameter to the boundaries of the round robin database.'
78 allowEmptyValue: false
82 description: 'The number of points to be returned. If not given, or it is <= 0, or it is bigger than the points stored in the round robin database for this chart for the given duration, all the available collected values for the given duration are returned.'
86 allowEmptyValue: false
90 description: 'The grouping method. If multiple collected values are to be grouped in order to return fewer points, this parameters defines the method of grouping. Two methods are supported, "max" and "average". "max" is actually calculated on the absolute value collected (so it works for both positive and negative dimesions to return the most extreme value in either direction).'
93 enum: [ 'max', 'average' ]
95 allowEmptyValue: false
98 description: 'The format of the data to be returned.'
101 enum: [ 'json', 'jsonp', 'csv', 'tsv', 'tsv-excel', 'ssv', 'ssvcomma', 'datatable', 'datasource', 'html', 'array' ]
103 allowEmptyValue: false
106 description: 'Options that affect data generation.'
111 enum: [ 'nonzero', 'flip', 'jsonwrap', 'min2max', 'seconds', 'milliseconds', 'abs', 'absolute', 'absolute-sum', 'null2zero', 'objectrows', 'google_json' ]
112 collectionFormat: pipes
114 allowEmptyValue: false
117 description: '[Google Visualization API](https://developers.google.com/chart/interactive/docs/dev/implementing_data_source?hl=en) formatted parameter.'
120 allowEmptyValue: false
123 description: 'The call was successful. The response should include the data.'
125 $ref: '#/definitions/chart'
127 description: 'Bad request - the body will include a message stating what is wrong.'
129 description: 'No chart with the given id is found.'
131 description: 'Internal server error. This usually means the server is out of memory.'
138 description: 'The hostname of the netdata server.'
141 description: 'The default update frequency of the netdata server. All charts have an update frequency equal or bigger than this.'
144 description: 'An object containing all the chart objects available at the netdata server. This is used as an indexed array. The key of each chart object is the id of the chart.'
147 $ref: '#/definitions/chart'
153 description: 'The unique id of the chart'
156 description: 'The name of the chart'
159 description: 'The type of the chart. Types are not handled by netdata. You can use this field for anything you like.'
162 description: 'The family of the chart. Families are not handled by netdata. You can use this field for anything you like.'
165 description: 'The title of the chart.'
168 description: 'The relative priority of the chart. NetData does not care about priorities. This is just an indication of importance for the chart viewers to sort charts of higher priority (lower number) closer to the top. Priority sorting should only be used among charts of the same type or family.'
171 description: 'True when the chart is enabled. Disabled charts do not currently collect values, but they may have historical values available.'
174 description: 'The unit of measurement for the values of all dimensions of the chart.'
177 description: 'The absolute path to get data values for this chart. You are expected to use this path as the base when constructing the URL to fetch data values for this chart.'
180 description: 'The chart type.'
181 enum: [ 'line', 'area', 'stacked' ]
184 description: 'The duration, in seconds, of the round robin database maintained by netdata.'
187 description: 'The UNIX timestamp of the first entry (the oldest) in the round robin database.'
190 description: 'The UNIX timestamp of the latest entry in the round robin database.'
193 description: 'The update frequency of this chart, in seconds. One value every this amount of time is kept in the round robin database.'
195 description: 'The dimensions of the chart.'
197 description: 'An object containing all the chart dimensions available for the chart. This is used as an indexed array. The key of the object the id of the dimension.'
200 $ref: '#/definitions/dimension'
206 description: 'The name of the dimension'