Go to main content
Guide RESTful API des systèmes Oracle® ZFS Storage Appliance, version OS8.6.x

Quitter la vue de l'impression

Mis à jour : Septembre 2016
 
 

Jeux de données analytiques

Table 27  Propriétés de l'ensemble de données.
Nom
Description
name
Nom des statistiques sous-jacentes.
grouping
Groupe auquel appartiennent ces statistiques.
explanation
Explication des statistiques sous-jacentes
incore
Taille en octets de l'ensemble de données sur le coeur
size
Quantité de données en octets de l'ensemble de données sur le disque
suspended
Indicateur booléen spécifiant si l'ensemble de données est actuellement suspendu
activity
Indicateur de l'activité de l'ensemble de données en cours

Toutes ces propriétés sont inaltérables, à l'exception de "suspended".

Ensembles de données 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]

List Datasets

Répertorie tous les ensembles de données d'analyse configurés.

Exemple de demande :

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

Exemple de résultats :

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]",
    }, {
        ...
    }]
}

Get Dataset

Obtient les propriétés de l'ensemble de données spécifié.

Exemple de demande :

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

Exemple de résultats :

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
    }
}

Create Datasets

Crée un ensemble de données.

Exemple de demande :

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"}

Exemple de résultats :

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"
    }
}

Modify Dataset

Cette commande permet de suspendre ou de reprendre la collecte de données d'un seul ensemble de données.

Exemple de demande de suspension :

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

{"suspended":true}

Exemple de demande de reprise :

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

Exemple de réponse :

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

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

Destroy Datasets

Détruit un ensemble de données.

Exemple de demande :

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

Exemple de réponse :

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

Save Dataset

Enregistre un ensemble de données.

Exemple de demande :

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

Exemple de réponse :

HTTP/1.1 202 Accepted

Prune Dataset Data

Les données d'un ensemble de données peuvent être élaguées selon une valeur de granularité exprimée en seconde, en minute ou en heure.

Nom
Description
granularity
Granularité de l'élagage (seconde, minute, heure)
endtime
Les données élaguées sont collectées avant l'heure de fin donnée

L'heure de fin est une chaîne d'heure/de date conforme à la norme ISO 8601 (par exemple, 20130531T01:13:58)

Exemple de demande :

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

Exemple de réponse :

HTTP/1.1 204 No Content

Get Dataset Data

Obtient des données à partir d'un ensemble de données d'analyse. L'extraction des données par seconde et granulaires est prise en charge.

Table 28  Paramètres de requête
Nom
Description
start
Heure de début de la collecte des échantillons de données
seconds
Nombre de secondes pendant laquelle la collecte des échantillons de données est effectuée (valeur par défaut = 1)
span
Durée de collecte des données d'échantillon (minute, heure, jour, mois)
interval
Intervalle dans une période donnée à partir duquel la moyenne des points de données est indiquée (minute, heure, jour, mois)

Si le paramètre start n'est pas indiqué, l'heure de début est définie avec l'heure actuelle moins le nombre de seconds des échantillons de données spécifiés. L'heure de début ne peut pas être située dans le futur. Si le nombre de secondes nécessaires à la collecte de données dépasse l'heure actuelle, le serveur attend chaque échantillon avant de renvoyer les données.

Pour extraire les données granulaires, utilisez une combinaison de paramètres span et interval, comme indiqué dans le tableau ci-dessous. Lorsque ces paramètres sont utilisés, le paramètre seconds est ignoré, même s'il est défini.

Table 29  Combinaisons des commandes span et interval
Span
Interval
Minute
Heure
Jour
Semaine
Mois
Année
Minute
x
Heure
x
x
Jour
x
x
x
Semaine
x
x
x
Mois
x
x
x
Année
x
x
x

Si l'un des paramètres est mal saisi, la demande est ignorée et le paramètre seconds est utilisé à la place. Une demande incorrecte ou non prise en charge entraîne l'affichage du message d'erreur "Input span and granularity are not supported."

Le tableau suivant affiche les propriétés d'ensemble de données qui sont renvoyées.

Table 30  Propriétés des données de l'ensemble de données.
Nom
Description
startTime
Heure à laquelle le premier échantillon est renvoyé
sample
Index d'échantillon du premier échantillon renvoyé
data
Baie des échantillons de données
min
Valeur minimale par seconde dans l'intervalle spécifié
max
Valeur maximale par seconde dans l'intervalle spécifié

La propriété startTime peut avoir l'un des formats suivants :

  • Une chaîne d'heure/de date conforme à la norme ISO 8601 (par exemple, 20130531T01:13:58)

  • Un numéro d'index d'échantillon

  • La chaîne littérale now

Exemple de demande (collecter les données en direct pendant trois secondes) :

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

Exemple de résultats :

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
---

Exemple de demande (collecter sept jours de données en direct sur une période d'une semaine) :

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

Exemple de résultats :

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     
    max:        79     
    min:        0
    startTime:      20130912T21:42:38     
    samples:        240074328
 
  - sample: 239110957     
    data:         
        value:      15
     max:        150     
     min:        1    
     startTime:      20130913T21:42:38     
     samples:        240074328

    ... 

   - sample: 239629357     
     data:         
         value:      25
     max:        120     
     min:        2    
     startTime:      20130914T21:42:38     
     samples:        240074328

size:       7
Copyright © 2015, 2016, Oracle et/ou ses affiliés. Tous droits réservés. Mentions légales
Précédent
Suivant