工作表是为统计信息绘制图形的 BUI 屏幕。可以同时绘制多项统计信息,并可以为工作表指定一个标题并保存该工作表供以后查看。保存工作表这一操作将自动对所有打开的统计信息执行归档操作,这意味着将继续读取并永久归档任何打开的统计信息。工作表命令可用于管理从 BUI 中获得的工作表。
下表显示了 Analytics 工作表中使用的属性。
|
列出当前配置的所有 Analytics 工作表。
请求示例:
GET /api/analytics/v1/worksheets HTTP/1.1 Authorization: Basic ab6rt4psMWE= Host: zfs-storage.example.com:215 Accept: application/json
响应示例:
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 237
X-Zfssa-Analytics-Api: 1.0
{
"worksheets": [{
"href": "/api/analytics/v1/worksheets/ab59bcbc...",
"uuid": "ab59bcbc-080a-cf1a-98c9-9f485bc3a43d"
}, {
"href": "/api/analytics/v1/worksheets/bb3ee729...",
"uuid": "bb3ee729-080a-cf1a-98c9-9f485bc3a43d"
}]
}
获取单个 Analytics 工作表。
请求示例:
GET /api/analytics/v1/worksheets/ab59bcbc-080a-cf1a-98c9-9f485bc3a43d
HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: zfs-storage.example.com:215
Accept: application/json
响应示例:
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 237
X-Zfssa-Analytics-Api: 1.0
{
"worksheet": {
"ctime": "Thu Jun 13 2013 02:17:14 GMT+0000 (UTC)",
"href": "/api/analytics/v1/worksheets
/ab59bcbc-080a-cf1a-98c9-9f485bc3a43d",
"mtime": "Sun Jun 23 2013 16:22:01 GMT+0000 (UTC)",
"name": "myworksheet",
"owner": "root",
"uuid": "ab59bcbc-080a-cf1a-98c9-9f485bc3a43d"
}
}
创建新的 Analytics 工作表。
请求示例:
POST /api/analytics/v1/worksheets HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json
Content-Length: 26
{"name": "myworksheet"}
结果示例:
HTTP/1.1 201 Created
Content-Length: 280
Location: /api/analytics/v1/worksheets/bb3ee729-4480-4609-89b2-fae2dc016bec
{
"worksheet": {
"uuid": "bb3ee729-4480-4609-89b2-fae2dc016bec",
"name": "myworksheet",
"owner": "root",
"ctime": "Fri Aug 23 2013 20:35:00 GMT+0000 (UTC)",
"mtime": "Fri Aug 23 2013 20:35:00 GMT+0000 (UTC)",
"href": "/api/analytics/v1/worksheets
/bb3ee729-4480-4609-89b2-fae2dc016bec"
}
}
重命名保存的工作表。
请求示例:
PUT /api/analytics/v1/worksheets/a442e761-4048-4738-b95f-be0824d7ed09
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json
Content-Length: 26
{"name": "test"}
响应示例:
HTTP/1.1 202 Accepted
Date: Tue, 20 Dec 2016 00:33:06 GMT
Server: TwistedWeb/192.0.2
Content-Length: 279
X-Zfssa-Version: user/generic@2013.06.05.7.0,1-1.12
X-Zfssa-Analytics-Api: 1.1
X-Zfssa-Api-Version: 1.0
Content-Type: application/json; charset=utf-8
{
"worksheet": {
"href": "/api/analytics/v1/worksheets/a442e761-4048-4738-b95f-be0824d7ed09",
"uuid": "a442e761-4048-4738-b95f-be0824d7ed09",
"name": "test",
"owner": "root",
"ctime": "Wed Dec 14 2016 03:58:28 GMT+0000 (UTC)",
"mtime": "Tue Dec 20 2016 00:25:57 GMT+0000 (UTC)"
}
}
销毁 Analytics 工作表。在此示例中,工作表名称用作工作表标识符,但也可以使用 href 中标识的 uuid。此命令的行为与可销毁工作表的 CLI 命令的行为相匹配。
请求示例:
DELETE /api/analytics/v1/worksheets/name=myworksheet HTTP/1.1 Authorization: Basic ab6rt4psMWE= Content-Type: application/json Content-Length: 26
响应示例:
HTTP/1.1 204 No Content X-Zfssa-Analytics-Api: 1.0
列出指定的工作表中的所有数据集。
下表显示了数据集配置中使用的属性。
|
请求示例:
GET /api/analytics/v1/worksheets/name=myworksheet/datasets HTTP/1.1 Authorization: Basic ab6rt4psMWE= Host: zfs-storage.example.com:215 Accept: application/json
创建工作表数据集。
请求示例:
POST /api/analytics/v1/worksheets/name=myworksheet/datasets HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json
Content-Length: 26
{"name": "nfs4.ops", "seconds": 300}
结果示例:
HTTP/1.1 201 Created
Content-Type: application/json
X-Zfssa-Analytics-Api: 1.0
Location: /api/analytics/v1/worksheets/name=me/datasets/nfs4.ops
Content-Length: 162
{
"dataset": {
"href": "/api/analytics/v1/worksheets/name=me/datasets/dataset-008",
"name": "nfs4.ops",
"width": 0,
"drilldowns": [],
"seconds": 300,
"time": ""
}
}
修改现有的工作表数据集。
请求示例:
PUT /api/analytics/v1/worksheets/name=myworksheet/datasets/dataset-008
HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json
Content-Length: 26
{"seconds": 60}
结果示例:
HTTP/1.1 202 Accepted
Content-Type: application/json
Content-Length: 161
X-Zfssa-Analytics-Api: 1.0
{
"dataset": {
"href": "/api/analytics/v1/worksheets/name=me/datasets/dataset-008",
"name": "nfs4.ops",
"width": 0,
"drilldowns": [],
"seconds": 60,
"time": ""
}
}