Juegos de datos de análisis

Tabla 4-1 Propiedades del conjunto de datos.

Nombre	Descripción
name	Nombre de la estadística subyacente.
grouping	Grupo al que pertenece esta estadística.
explanation	Explicación de la estadística subyacente.
incore	Bytes de los datos del conjunto de datos en el núcleo.
size	Bytes de los datos del conjunto de datos en el disco.
suspended	Indicador booleano que muestra si el conjunto de datos está suspendido actualmente.
activity	Indicador de actividad de conjunto de datos pendiente.

Todas las propiedades son inmutables, excepto las suspendidas.

Conjunto de datos disponibles:

arc.accesses[hit/miss]
arc.l2_accesses[hit/miss]
arc.l2_size
arc.size
arc.size[component]
cpu.utilization
cpu.utilization[mode]
dnlc.accesses[hit/miss]
fc.bytes
fc.ops
ftp.kilobytes
http.reqs
io.bytes
io.bytes[op]
io.disks[utilization=95][disk]
io.ops
io.ops[disk]
io.ops[op]
iscsi.bytes
iscsi.ops
ndmp.diskkb
nfs2.ops
nfs2.ops[op]
nfs3.ops
nfs3.ops[op]
nfs4.ops
nfs4.ops[op]
nic.kilobytes
nic.kilobytes[device]
nic.kilobytes[direction]
sftp.kilobytes
smb.ops
smb.ops[op]

Mostrar conjuntos de datos

Muestra todos los conjuntos de datos analíticos configurados.

Ejemplo de solicitud:

GET /api/analytics/v1/datasets HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: example.zfssa.com:215
Accept: application/json

Ejemplo de resultados:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 237
X-Zfssa-Analytics-Api: 1.0

{
    "datasets": [{
        "dataset": "dataset-000",
        "href": "/api/analytics/v1/datasets/arc.accesses[hit/miss]",
        "name": "arc.accesses[hit/miss]"
    }, {
        "dataset": "dataset-001",
        "href": "/api/analytics/v1/datasets/arc.l2_accesses[hit/miss]",
        "name": "arc.l2_accesses[hit/miss]",
    }, {
        "dataset": "dataset-002",
        "href": "/api/analytics/v1/datasets/arc.l2_size",
        "name": "arc.l2_size",
    }, {
        "dataset": "dataset-003",
        "href": "/api/analytics/v1/datasets/arc.size",
        "name": "arc.size",
    }, {
        "dataset": "dataset-004",
        "href": "/api/analytics/v1/datasets/arc.size[component]",
        "name": "arc.size[component]",
    }, {
        ...
    }]
}

Obtener conjunto de datos

Obtiene propiedades del conjunto de datos especificado.

Ejemplo de solicitud:

GET /api/analytics/v1/datasets/nfs4.ops HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: example.zfssa.com:215
Accept: application/json

Ejemplo de resultados:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 237
X-Zfssa-Analytics-Api: 1.0

{
    "dataset": {
        "activity": "none",
        "dataset": "dataset-030",
        "explanation": "NFSv4 operations per second",
        "grouping": "Protocol",
        "href": "/api/analytics/v1/datasets/nfs4.ops",
        "incore": 296128,
        "name": "nfs4.ops",
        "size": 53211540,
        "suspended": false
    }
}

Crear conjuntos de datos

Crea un conjunto de datos nuevo.

Ejemplo de solicitud:

POST /api/analytics/v1/datasets HTTP/1.1
X-Auth-User: root
X-Auth-Key: letmein
Content-Type: application/json
Content-Length: 26

{"statistic": "test.sine"}

Ejemplo de resultados:

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 200
Location: /api/analytics/v1/datasets/test.sine

{
    "dataset":{
        "href": "/api/analytics/v1/datasets",
        "name": "test.sine",
        "grouping": "Test",
        "explanation": "sine per second",
        "incore": 34752,
        "size": 31912,
        "suspended": false,
        "activity": "none"
    }
}

Modificar conjunto de datos

El comando de modificación de conjunto de datos se utiliza para suspender o reanudar la recopilación de datos de un solo conjunto de datos.

Ejemplo de solicitud de suspensión:

POST /api/analytics/v1/datasets/nfs4.ops

{"suspended":true}

Ejemplo de solicitud de reanudación:

POST /api/analytics/v1/datasets/nfs4.ops
        {"suspended":false}

Ejemplo de respuesta:

HTTP/1.1 202 Accepted
Content-Type: application/json
Content-Length: 228
X-Zfssa-Analytics-Api: 1.0

{
    "dataset" {
        ...
        "suspended": false
    }
}

Destruir conjuntos de datos

Destruye un conjunto de datos.

Ejemplo de solicitud:

DELETE /api/analytics/v1/datasets/test.sine HTTP/1.1

Ejemplo de respuesta:

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

Guardar conjunto de datos

Guarda un juego de datos.

Ejemplo de solicitud:

PUT /api/analytics/v1/datasets/nfs4.ops/data

Ejemplo de respuesta:

HTTP/1.1 202 Accepted

Quitar datos de conjunto de datos

Los datos dentro de un conjunto de datos se pueden quitar con un valor de granularidad de segundo, minuto u hora.

Nombre	Descripción
granularity	Granularidad de la quita (segundo, minuto, hora)
endtime	Datos de quita recopilados antes de un tiempo determinado

El tiempo determinado es una cadena de hora/fecha ISO 8601 (p. ej.: 20130531T01:13:58)

Ejemplo de solicitud:

DELETE /api/analytics/v1/datasets/nfs4.ops/data?granularity=hour

Ejemplo de respuesta:

HTTP/1.1 204 No Content

Obtener datos del conjunto de datos

Obtiene los datos de un conjunto de datos de análisis.

Nombre	Descripción
start	La hora para comenzar a recopilar datos de ejemplo
seconds	Cantidad de segundos para recopilar datos de ejemplo (Valor predeterminado = 1)

El valor startTime (hora de inicio) puede ser uno de los siguientes:

Una cadena de hora/fecha ISO 8601 (p. ej.: 20130531T01:13:58)
Un número de índice de muestra
La cadena literal now

Si la hora de inicio no se suministra, este valor se configura según la hora actual, menos la cantidad de segundos deseada para los datos de ejemplo. La hora de inicio no puede ser del futuro. Si la cantidad de segundos para recopilar datos va más allá de la hora actual, el servidor espera a que se tome cada muestra antes de devolver los datos.

Nombre	Descripción
startTime	La hora de devolución de la primera muestra
sample	El índice de muestra de la primera muestra devuelta
data	Matriz de datos de ejemplo

Solicitud de ejemplo (para recopilar 3 segundos de datos en vivo):

GET /api/analytics/v1/datasets/nfs4.ops%5Bfile%5D/data?start=now&seconds=3
    HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: example.zfssa.com:215
Accept: text/x-yaml

Ejemplo de resultados:

HTTP/1.1 200 OK
Content-Type: text/x-yaml
X-Zfssa-Analytics-Api: 1.0
Transfer-Encoding: chunked

---
data:
  - sample: 239024557
    data:
        value:      5
    startTime:      20130912T21:42:38
    samples:        239024558

  - sample: 239024558
    data:
        value:      15
    startTime:      20130912T21:42:39
    samples:        239024559

  - sample: 239024559
    data:
        value:      25
    startTime:      20130912T21:42:40
    samples:        239024560

size:       3
---

Omitir vínculos de navegación
Salir de la Vista de impresión
	Guía de API de RESTful de Oracle^® ZFS Storage Appliance, versión 2013.1.3.0