Analytics 워크시트

언어:

워크시트는 통계가 그래프로 표시되는 BUI 화면입니다. 동시에 여러 가지 통계를 그릴 수 있으며 워크시트에 제목을 지정하고 나중에 보도록 저장할 수 있습니다. 워크시트를 저장하면 열려 있는 모든 통계에 대해 아카이브 작업이 자동으로 실행됩니다. 즉, 열려 있는 모든 통계를 읽고 아카이브하는 작업이 영원히 계속됩니다. 워크시트 명령은 BUI에서 사용할 수 있는 워크시트를 관리하는 데 사용할 수 있습니다.

다음 표에서는 Analytics 워크시트에서 사용되는 등록 정보를 보여줍니다.

등록 정보	설명
`ctime`	이 워크시트가 생성된 시간 및 날짜
`mtime`	이 워크시트가 마지막으로 수정된 시간 및 날짜
`name`	이 워크시트의 이름
`owner`	이 워크시트의 소유자
`uuid`	이 워크시트에 대한 범용 고유 식별자

워크시트 나열

현재 구성된 모든 Analytics 워크시트를 나열합니다.

요청 예:

GET /api/analytics/v1/worksheets HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
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 워크시트 가져오기

단일 Analytics 워크시트를 가져옵니다.

요청 예:

GET /api/analytics/v1/worksheets/ab59bcbc-080a-cf1a-98c9-9f485bc3a43d
    HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
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 Tm8gcGVla2luZyE=
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 Tm8gcGVla2luZyE=
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-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 Tm8gcGVla2luZyE=
Content-Type: application/json
Content-Length: 26

결과 예:

HTTP/1.1 204 No Content
X-Zfssa-Analytics-Api: 1.0

워크시트 데이터 세트 나열

지정된 워크시트의 모든 데이터 세트를 나열합니다.

다음 표에서는 데이터 세트 구성에서 사용되는 등록 정보를 보여줍니다.

등록 정보	설명
`name`	이 데이터 세트에 대한 기본 통계의 이름
`drilldowns`	현재 강조 표시된 드릴다운(있는 경우)
`seconds`	이 데이터 세트에 대해 표시되는 시간(초)

요청 예:

GET /api/analytics/v1/worksheets/name=myworksheet/datasets HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

워크시트 데이터 세트 추가

워크시트 데이터 세트를 만듭니다.

요청 예:

POST /api/analytics/v1/worksheets/name=myworksheet/datasets HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
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 Tm8gcGVla2luZyE=
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": ""
    }
}