Dashboard: A collection of one or more grid resources. The grouping of grids into a dashboard as defined by the creator of the dashboard resource."
Template: /maddash/dashboards
Docs: https://docs.perfsonar.net/maddash_api_dashboards.html#retrieving-the-list-of-dashboards
Example
{
"dashboards": [
{
"name": "AURA: Huechuraba to La Serena",
"grids": [
{
"name": "AURA: Huechuraba to La Serena - BW: Huechuraba - La Serena (10 Gbps) - Throughput",
"uri": "/maddash/grids/AURA%3A+Huechuraba+to+La+Serena+-+BW%3A+Huechuraba+-+La+Serena+%2810+Gbps%29+-+Throughput"
},
{
"name": "AURA: Huechuraba to La Serena - Latency: Huechuraba - La Serena - Loss",
"uri": "/maddash/grids/AURA%3A+Huechuraba+to+La+Serena+-+Latency%3A+Huechuraba+-+La+Serena+-+Loss"
},
{
"name": "AURA: Huechuraba to La Serena - RTT: Huechuraba - La Serena - Ping Loss",
"uri": "/maddash/grids/AURA%3A+Huechuraba+to+La+Serena+-+RTT%3A+Huechuraba+-+La+Serena+-+Ping+Loss"
}
]
},
{
"name": "AmLight Backbone: loss and delay",
"grids": [
{
"name": "AmLight Backbone: loss and delay - MIA - BCT - SPO (Monet - 100 Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+MIA+-+BCT+-+SPO+%28Monet+-+100+Gbps%29+-+Loss"
},
{
"name": "AmLight Backbone: loss and delay - MIA - FOR - SPO (FIU030 FIU034 - 100 Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+MIA+-+FOR+-+SPO+%28FIU030++FIU034+-+100+Gbps%29+-+Loss"
},
{
"name": "AmLight Backbone: loss and delay - MIA - FOR - SPO - SCL (FIU030 FIU034 FIU033 - 100 Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+MIA+-+FOR+-+SPO+-+SCL+%28FIU030+FIU034+FIU033+-+100+Gbps%29+-+Loss"
},
{
"name": "AmLight Backbone: loss and delay - MIA - SCL (FIU026 - 10 Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+MIA+-+SCL+%28FIU026+-+10+Gbps%29+-+Loss"
},
{
"name": "AmLight Backbone: loss and delay - MIA - SJU - PTY (FIU035 FIU031 - 100 Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+MIA+-+SJU+-+PTY+%28FIU035+FIU031+-+100+Gbps%29+-+Loss"
},
{
"name": "AmLight Backbone: loss and delay - MIA - SJU - PTY - SCL (FIU035 FIU031 FIU036 - 100 Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+MIA+-+SJU+-+PTY+-+SCL+%28FIU035+FIU031+FIU036+-+100+Gbps%29+-+Loss"
},
{
"name": "AmLight Backbone: loss and delay - PTY - SCL (FIU036 - 100Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+PTY+-+SCL+%28FIU036+-+100Gbps%29+-+Loss"
},
{
"name": "AmLight Backbone: loss and delay - SCL - SPO (FIU033 - 100 Gbps) - Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+loss+and+delay+-+SCL+-+SPO+%28FIU033+-+100+Gbps%29+-+Loss"
}
]
},
{
"name": "AmLight Backbone: rtt",
"grids": [
{
"name": "AmLight Backbone: rtt - MIA - BCT - SPO (Monet - 100 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+MIA+-+BCT+-+SPO+%28Monet+-+100+Gbps%29+-+Ping+Loss"
},
{
"name": "AmLight Backbone: rtt - MIA - FOR - SPO (FIU030 FIU034 - 100 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+MIA+-+FOR+-+SPO+%28FIU030++FIU034+-+100+Gbps%29+-+Ping+Loss"
},
{
"name": "AmLight Backbone: rtt - MIA - FOR - SPO - SCL (FIU030 FIU034 FIU033 - 100 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+MIA+-+FOR+-+SPO+-+SCL+%28FIU030+FIU034+FIU033+-+100+Gbps%29+-+Ping+Loss"
},
{
"name": "AmLight Backbone: rtt - MIA - SCL (FIU026 - 10 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+MIA+-+SCL+%28FIU026+-+10+Gbps%29+-+Ping+Loss"
},
{
"name": "AmLight Backbone: rtt - MIA - SJU - PTY (FIU035 FIU031 - 100 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+MIA+-+SJU+-+PTY+%28FIU035+FIU031+-+100+Gbps%29+-+Ping+Loss"
},
{
"name": "AmLight Backbone: rtt - MIA - SJU - PTY - SCL (FIU035 FIU031 FIU036 - 100 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+MIA+-+SJU+-+PTY+-+SCL+%28FIU035+FIU031+FIU036+-+100+Gbps%29+-+Ping+Loss"
},
{
"name": "AmLight Backbone: rtt - PTY - SCL (FIU036 - 100 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+PTY+-+SCL+%28FIU036+-+100+Gbps%29+-+Ping+Loss"
},
{
"name": "AmLight Backbone: rtt - SCL - SPO (FIU033 - 100 Gbps) - Ping Loss",
"uri": "/maddash/grids/AmLight+Backbone%3A+rtt+-+SCL+-+SPO+%28FIU033+-+100+Gbps%29+-+Ping+Loss"
}
]
},
{
"name": "AmLight Backbone: tcp throughput",
"grids": [
{
"name": "AmLight Backbone: tcp throughput - MIA - BCT - SPO (Monet - 100 Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+MIA+-+BCT+-+SPO+%28Monet+-+100+Gbps%29+-+Throughput"
},
{
"name": "AmLight Backbone: tcp throughput - MIA - FOR - SPO (FIU030 FIU034 - 100 Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+MIA+-+FOR+-+SPO+%28FIU030++FIU034+-+100+Gbps%29+-+Throughput"
},
{
"name": "AmLight Backbone: tcp throughput - MIA - FOR - SPO - SCL (FIU030 FIU034 FIU033 - 100 Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+MIA+-+FOR+-+SPO+-+SCL+%28FIU030+FIU034+FIU033+-+100+Gbps%29+-+Throughput"
},
{
"name": "AmLight Backbone: tcp throughput - MIA - SCL (FIU026 - 10 Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+MIA+-+SCL+%28FIU026+-+10+Gbps%29+-+Throughput"
},
{
"name": "AmLight Backbone: tcp throughput - MIA - SJU - PTY (FIU035 FIU031 - 100Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+MIA+-+SJU+-+PTY+%28FIU035+FIU031+-+100Gbps%29+-+Throughput"
},
{
"name": "AmLight Backbone: tcp throughput - MIA - SJU - PTY - SCL (FIU035 FIU031 FIU036 - 100 Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+MIA+-+SJU+-+PTY+-+SCL+%28FIU035+FIU031+FIU036+-+100+Gbps%29+-+Throughput"
},
{
"name": "AmLight Backbone: tcp throughput - PTY - SCL (FIU036 - 100Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+PTY+-+SCL+%28FIU036+-+100Gbps%29+-+Throughput"
},
{
"name": "AmLight Backbone: tcp throughput - SCL - SPO (FIU033 - 100 Gbps) - Throughput",
"uri": "/maddash/grids/AmLight+Backbone%3A+tcp+throughput+-+SCL+-+SPO+%28FIU033+-+100+Gbps%29+-+Throughput"
}
]
},
{
"name": "RubinObs-LS: Huechuraba to La Serena",
"grids": [
{
"name": "RubinObs-LS: Huechuraba to La Serena - BW: Huechuraba - La Serena (10 Gbps) - Throughput",
"uri": "/maddash/grids/RubinObs-LS%3A+Huechuraba+to+La+Serena+-+BW%3A+Huechuraba+-+La+Serena+%2810+Gbps%29+-+Throughput"
},
{
"name": "RubinObs-LS: Huechuraba to La Serena - Latency: Huechuraba - La Serena - Loss",
"uri": "/maddash/grids/RubinObs-LS%3A+Huechuraba+to+La+Serena+-+Latency%3A+Huechuraba+-+La+Serena+-+Loss"
},
{
"name": "RubinObs-LS: Huechuraba to La Serena - RTT: Huechuraba - La Serena - Ping Loss",
"uri": "/maddash/grids/RubinObs-LS%3A+Huechuraba+to+La+Serena+-+RTT%3A+Huechuraba+-+La+Serena+-+Ping+Loss"
}
]
}
]
}
Grid: A two-dimensional representation of one or more rows and columns of checks that measure some value between entities represented by the column value (x) and row value (y).
Template : /maddash/grids/<grid-name>
Docs: https://docs.perfsonar.net/maddash_api_grids.html#retrieving-a-single-grid
Example
{
"name": "RubinObs-LS: Huechuraba to La Serena - BW: Huechuraba - La Serena (10 Gbps) - Throughput",
"statusLabels": [
"Throughput >= 5Gbps",
"Throughput < 5Gbps",
"Throughput <= 1Gbps",
"Unable to find test data",
"Check has not run yet"
],
"lastUpdateTime": 1595531492,
"columnNames": ["AmLight Huechuraba", "RubinObs La Serena"],
"columnProps": [{}, {}],
"checkNames": ["Throughput"],
"grid": [
[
null,
[
{
"message": " Average throughput is 9.897Gbps ",
"status": 0,
"prevCheckTime": 1595531492,
"uri": "/maddash/grids/RubinObs-LS:+Huechuraba+to+La+Serena+-+BW:+Huechuraba+-+La+Serena+(10+Gbps)+-+Throughput/10.7.26.1/10.7.26.2/Throughput"
}
]
],
[
[
{
"message": " Average throughput is 9.896Gbps ",
"status": 0,
"prevCheckTime": 1595531411,
"uri": "/maddash/grids/RubinObs-LS:+Huechuraba+to+La+Serena+-+BW:+Huechuraba+-+La+Serena+(10+Gbps)+-+Throughput/10.7.26.2/10.7.26.1/Throughput"
}
],
null
]
],
"rows": [
{
"name": "AmLight Huechuraba",
"uri": "/maddash/grids/RubinObs-LS:+Huechuraba+to+La+Serena+-+BW:+Huechuraba+-+La+Serena+(10+Gbps)+-+Throughput/10.7.26.1",
"props": {
"map": {
"default": { "host_id": "AmLight_Huechuraba", "address": "10.7.26.1" }
},
"label": "AmLight Huechuraba",
"added_by_psconfig": "1"
}
},
{
"name": "RubinObs La Serena",
"uri": "/maddash/grids/RubinObs-LS:+Huechuraba+to+La+Serena+-+BW:+Huechuraba+-+La+Serena+(10+Gbps)+-+Throughput/10.7.26.2",
"props": {
"map": {
"default": { "host_id": "RubinObs_La_Serena", "address": "10.7.26.2" }
},
"label": "RubinObs La Serena",
"added_by_psconfig": "1"
}
}
],
"report": {
"mesh": {
"name": "RubinObs-LS: Huechuraba to La Serena - BW: Huechuraba - La Serena (10 Gbps) - Throughput"
},
"global": {
"stats": [2, 0, 0, 0, 0, 0],
"severity": 0,
"problems": [
{
"name": "Entire grid has OK status.",
"severity": 0,
"category": "PERFORMANCE",
"solutions": []
}
]
},
"sites": {
"RubinObs La Serena": { "stats": [2, 0, 0, 0, 0, 0], "severity": 0 },
"AmLight Huechuraba": { "stats": [2, 0, 0, 0, 0, 0], "severity": 0 }
}
}
}
Row: A collection of checks that share a common y value
Template: /maddash/grids/<grid-name>/<row-name>
Docs: https://docs.perfsonar.net/maddash_api_rows.html#retrieving-a-row
Example
{
"cells": [
{
"name": "10.7.26.2",
"uri": "/maddash/grids/RubinObs-LS:+Huechuraba+to+La+Serena+-+BW:+Huechuraba+-+La+Serena+(10+Gbps)+-+Throughput/10.7.26.1/10.7.26.2"
}
]
}
Cell: A collection of checks that share a common x and y value
Template: /maddash/grids/<grid-name>/<row-name>/<cell-name>
Docs: https://docs.perfsonar.net/maddash_api_cells.html#retrieving-a-cell
Example
{
"checks": [
{
"name": "Throughput",
"uri": "/maddash/grids/RubinObs-LS:+Huechuraba+to+La+Serena+-+BW:+Huechuraba+-+La+Serena+(10+Gbps)+-+Throughput/10.7.26.1/10.7.26.2/Throughput"
}
]
}
Check: The output of a task performed using the column value (x) and the row value (y) as input.
Template: /maddash/grids/<grid-name>/<row-name>/<column-name>/<check-name>
Docs: https://docs.perfsonar.net/maddash_api_checks.html#retrieving-a-single-check
Example
{
"gridName": "RubinObs-LS: Huechuraba to La Serena - BW: Huechuraba - La Serena (10 Gbps) - Throughput",
"rowName": "10.7.26.1",
"colName": "10.7.26.2",
"checkName": "Throughput",
"description": "Queries an esmond MA for throughput data and alerts on response",
"prevCheckTime": 1595531492,
"nextCheckTime": 1595545892,
"status": 0,
"returnCode": 0,
"message": " Average throughput is 9.897Gbps ",
"returnCodeCount": 0,
"type": "net.es.maddash.checks.PSNagiosCheck",
"params": {
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=%row.map.address&dest=%col.map.address&displaysetdest=%col.displayset&url=%maUrl&reverseurl=%maUrlReverse&displaysetsrc=%row.displayset",
"command": "/usr/lib64/nagios/plugins/check_throughput.pl -u %maUrl -s %row.map.address -p tcp -4 -d %col.map.address -r 86400 -c 1: -w 5: -t 60",
"maUrl": {
"10.7.26.1": {
"default": "https://ma.ampath.net/esmond/perfsonar/archive"
},
"10.7.26.2": {
"default": "https://ma.ampath.net/esmond/perfsonar/archive"
}
}
},
"checkInterval": 14400,
"retryInterval": 300,
"retryAttempts": 1,
"statusShortName": "OK",
"historyPageCount": 5,
"historyResultPerPage": 10,
"history": [
{
"time": 1595531492,
"returnCode": 0,
"message": " Average throughput is 9.897Gbps ",
"returnParams": {
"Count": "4",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.900660021",
"Standard_Deviation": "0.00237778039103923",
"Average": "9.897137058",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895507734"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595517091,
"returnCode": 0,
"message": " Average throughput is 9.896Gbps ",
"returnParams": {
"Count": "4",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.896416755",
"Standard_Deviation": "0.000371226364121228",
"Average": "9.8959580285",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895507734"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595502672,
"returnCode": 0,
"message": " Average throughput is 9.896Gbps ",
"returnParams": {
"Count": "3",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.896416755",
"Standard_Deviation": "0.000454633873335457",
"Average": "9.89595613066667",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895507734"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595488253,
"returnCode": 0,
"message": " Average throughput is 9.898Gbps ",
"returnParams": {
"Count": "4",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.90126941",
"Standard_Deviation": "0.00262741846191986",
"Average": "9.89767666175",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895507734"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595473832,
"returnCode": 0,
"message": " Average throughput is 9.898Gbps ",
"returnParams": {
"Count": "4",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.90126941",
"Standard_Deviation": "0.00237940562120655",
"Average": "9.89793892625",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895943903"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595459412,
"returnCode": 0,
"message": " Average throughput is 9.897Gbps ",
"returnParams": {
"Count": "5",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.90126941",
"Standard_Deviation": "0.00232350570947265",
"Average": "9.897458822",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895538405"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595444995,
"returnCode": 0,
"message": " Average throughput is 9.897Gbps ",
"returnParams": {
"Count": "6",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.90126941",
"Standard_Deviation": "0.00224282056714522",
"Average": "9.89711451083333",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895392955"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595430575,
"returnCode": 0,
"message": " Average throughput is 9.897Gbps ",
"returnParams": {
"Count": "6",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.90126941",
"Standard_Deviation": "0.00225271849743478",
"Average": "9.897099175",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895392955"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595416155,
"returnCode": 0,
"message": " Average throughput is 9.897Gbps ",
"returnParams": {
"Count": "7",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.90126941",
"Standard_Deviation": "0.00210205680600184",
"Average": "9.89693455757143",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895392955"
},
"returnCodeCount": 0,
"status": 0
},
{
"time": 1595401734,
"returnCode": 0,
"message": " Average throughput is 9.897Gbps ",
"returnParams": {
"Count": "6",
"graphUrl": "/perfsonar-graphs/graphWidget.cgi?source=10.7.26.1&dest=10.7.26.2&displaysetdest=&url=https://ma.ampath.net/esmond/perfsonar/archive&reverseurl=https://ma.ampath.net/esmond/perfsonar/archive&displaysetsrc=",
"Max": "9.902754695",
"Standard_Deviation": "0.00284460165442179",
"Average": "9.89700693133334",
"maUrl": "https://ma.ampath.net/esmond/perfsonar/archive",
"Min": "9.895392955"
},
"returnCodeCount": 0,
"status": 0
}
],
"globalReport": {
"stats": [2, 0, 0, 0, 0, 0],
"severity": 0,
"problems": [
{
"name": "Entire grid has OK status.",
"severity": 0,
"category": "PERFORMANCE",
"solutions": []
}
]
},
"rowReport": { "stats": [2, 0, 0, 0, 0, 0], "severity": 0 },
"colReport": { "stats": [2, 0, 0, 0, 0, 0], "severity": 0 }
}
???
Docs: https://docs.perfsonar.net/maddash_api_reports.html
Template: /maddash/report?grid=<encoded-grid-name>
Example
{
"mesh": { "name": "RubinObs-LS: Huechuraba to La Serena - BW: Huechuraba - La Serena (10 Gbps) - Throughput" },
"global": {
"stats": [2, 0, 0, 0, 0, 0],
"severity": 0,
"problems": [{ "name": "Entire grid has OK status.", "severity": 0, "category": "PERFORMANCE", "solutions": [] }]
},
"sites": {
"RubinObs La Serena": { "stats": [2, 0, 0, 0, 0, 0], "severity": 0 },
"AmLight Huechuraba": { "stats": [2, 0, 0, 0, 0, 0], "severity": 0 }
}
}