Last updated
Last updated
Generates time series line chart from given time series points.
https://api.globadge.com/v1/chartgen/line/time
POST
Returns generated chart SVG content in the response body:
The following example shows body of an example request to generate time series line chart.
https://api.globadge.com/v1/chartgen/line/time
POST
Generates time series line chart from given time series points and returns a link to access hosted chart.
https://api.globadge.com/v1/chartgen/line/time
PUT
Returns id and the link for the hosted chart SVG content in the response body:
Then you can use the provided url
in the response body to access or embed hosted chart SVG content.
The following example shows body of an example request to generate hosted time series line chart.
https://api.globadge.com/v1/chartgen/line/time
PUT
{
"options": {
// [Optional] Width of the chart.
// Min value is "200" and default value is "650"
"width": 1000, .
// [Optional] Heigth of the chart.
// Min value is "150" and default value is "400".
"height": 500,
// [Optional] X axis configs.
"xAxis": {
// [Optional] X axis label
"label": "Time",
// [Optional] X axis (axis line, ticks, label) color
"color": "#4daf4a"
},
// [Optional] Y axis configs.
"yAxis": {
// [Optional] Y axis label
"label": "Network I/O (KB)",
// [Optional] Y axis (axis line, ticks, label) color
"color": "#ff7f00"
},
// [Mandatory] Time ticks.
"timeTicks": {
// [Mandatory] Time tick unit.
// Valid values are:
// - "auto" (sets "interval" and "format" adaptively according to data points and chart width)
// - "year"
// - "month"
// - "week"
// - "day"
// - "hour"
// - "minute"
// - "second"
// - "millisecond"
"unit": "day",
// [Optional] Time tick interval.
// Min value is "1" and default value is "1".
// When "unit" property is specified as "auto",
// this configuration is ignored even though it is specified.
"interval": 7,
// [Optional] Time tick format.
// Some example supported specifiers are:
// - %Y: Year
// - %m: Month
// - %d: Day
// - %H: Hour
// - %S: Second
// See "https://github.com/d3/d3-time-format" for more details.
// When "unit" property is specified as "auto",
// this configuration is ignored even though it is specified.
"format": "%d/%m"
}
},
// [Mandatory] Lines.
// There can be 9 lines at most.
"lines": [
{
// [Optional] Line label
"label": "Read",
// [Optional] Line color
"color": "#be4d25",
// [Mandatory] Points
"points": [
{
// [Mandatory] Time of the point as UNIX epoch timestamp.
"x": 788911200000,
// [Mandatory] Value of the point.
// Min value is "0". Negative values are not supported.
"y": 1
},
{
"x": 791503200000,
"y": 2
},
{
"x": 794095200000,
"y": 3
}
]
},
{
"label": "Write",
"color": "#6c25be",
"points": [
{
"x": 788911200000,
"y": 10
},
{
"x": 791503200000,
"y": 20
},
{
"x": 794095200000,
"y": 30
}
]
}
]
}
<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1000" height="500">
...
</svg>
{
"options": {
"width": 1000,
"height": 500,
"xAxis": {
"label": "Time",
"color": "#4daf4a"
},
"yAxis": {
"label": "Network I/O (KB)",
"color": "#ff7f00"
},
"timeTicks": {
"unit": "day",
"interval": 7,
"format": "%d/%m"
}
},
"lines": [
{
"label": "Read",
"color": "#be4d25",
"points": [
{
"x": 788911200000,
"y": 1
},
{
"x": 791503200000,
"y": 2
},
{
"x": 794095200000,
"y": 3
}
]
},
{
"label": "Write",
"color": "#6c25be",
"points": [
{
"x": 788911200000,
"y": 10
},
{
"x": 791503200000,
"y": 20
},
{
"x": 794095200000,
"y": 30
}
]
}
]
}
{
"options": {
// [Optional] Width of the chart.
// Min value is "200" and default value is "650"
"width": 1000, .
// [Optional] Heigth of the chart.
// Min value is "150" and default value is "400".
"height": 500,
// [Optional] X axis configs.
"xAxis": {
// [Optional] X axis label
"label": "Time",
// [Optional] X axis (axis line, ticks, label) color
"color": "#4daf4a"
},
// [Optional] Y axis configs.
"yAxis": {
// [Optional] Y axis label
"label": "Network I/O (KB)",
// [Optional] Y axis (axis line, ticks, label) color
"color": "#ff7f00"
},
// [Mandatory] Time ticks.
"timeTicks": {
// [Mandatory] Time tick unit.
// Valid values are:
// - "year",
// - "month"
// - "week"
// - "day"
// - "hour"
// - "minute"
// - "second"
// - "millisecond"
"unit": "day",
// [Optional] Time tick interval.
// Min value is "1" and default value is "1"
"interval": 7,
// [Optional] Time tick format.
// Some example supported specifiers are:
// - %Y: Year
// - %m: Month
// - %d: Day
// - %H: Hour
// - %S: Second
// See "https://github.com/d3/d3-time-format" for more details.
"format": "%d/%m"
}
},
// [Mandatory] Lines.
// There can be 9 lines at most.
"lines": [
{
// [Optional] Line label
"label": "Read",
// [Optional] Line color
"color": "#be4d25",
// [Mandatory] Points
"points": [
{
// [Mandatory] Time of the point as UNIX epoch timestamp.
"x": 788911200000,
// [Mandatory] Value of the point.
// Min value is "0". Negative values are not supported.
"y": 1
},
{
"x": 791503200000,
"y": 2
},
{
"x": 794095200000,
"y": 3
}
]
},
{
"label": "Write",
"color": "#6c25be",
"points": [
{
"x": 788911200000,
"y": 10
},
{
"x": 791503200000,
"y": 20
},
{
"x": 794095200000,
"y": 30
}
]
}
]
}
{
"id": "chart_line_time_efdeb1be-e7d2-40bf-90fc-6ab00482f04a",
"url": "https://api.globadge.com/v1/chartgen/line/time/chart_line_time_efdeb1be-e7d2-40bf-90fc-6ab00482f04a"
}
{
"options": {
"width": 1000,
"height": 500,
"xAxis": {
"label": "Time",
"color": "#4daf4a"
},
"yAxis": {
"label": "Network I/O (KB)",
"color": "#ff7f00"
},
"timeTicks": {
"unit": "day",
"interval": 7,
"format": "%d/%m"
}
},
"lines": [
{
"label": "Read",
"color": "#be4d25",
"points": [
{
"x": 788911200000,
"y": 1
},
{
"x": 791503200000,
"y": 2
},
{
"x": 794095200000,
"y": 3
}
]
},
{
"label": "Write",
"color": "#6c25be",
"points": [
{
"x": 788911200000,
"y": 10
},
{
"x": 791503200000,
"y": 20
},
{
"x": 794095200000,
"y": 30
}
]
}
]
}