Interface de ligne de commande (CLI)

Le contexte analytics datasets permet de gérer les ensembles de données.

Affichage des ensembles de données disponibles

Exécutez la commande show pour afficher la liste des ensembles de données :

caji:analytics datasets> show
Datasets:

DATASET     STATE   INCORE ONDISK NAME
dataset-000 active    674K  35.7K arc.accesses[hit/miss]
dataset-001 active    227K  31.1K arc.l2_accesses[hit/miss]
dataset-002 active    227K  31.1K arc.l2_size
dataset-003 active    227K  31.1K arc.size
dataset-004 active    806K  35.7K arc.size[component]
dataset-005 active    227K  31.1K cpu.utilization
dataset-006 active    451K  35.6K cpu.utilization[mode]
dataset-007 active   57.7K      0 dnlc.accesses
dataset-008 active    490K  35.6K dnlc.accesses[hit/miss]
dataset-009 active    227K  31.1K http.reqs
dataset-010 active    227K  31.1K io.bytes
dataset-011 active    268K  31.1K io.bytes[op]
dataset-012 active    227K  31.1K io.ops
...

Un grand nombre des ensembles de données ci-dessus sont archivés par défaut. Un seul a été ajouté : "dataset-007", dont la taille ONDISK est nulle, ce qui indique qu'il s'agit d'une statistique temporaire qui n'est pas archivée. Les noms des statistiques sont des versions abrégées de ceux visibles dans la BUI : "dnlc.accesses" est la version courte de "Cache : accès DNLC per second".

Après avoir sélectionné un ensemble de données, il est possible d'en afficher certaines propriétés :

caji:analytics datasets> select dataset-007
caji:analytics dataset-007> show
Properties:
                          name = dnlc.accesses
                      grouping = Cache
                   explanation = DNLC accesses per second
                        incore = 65.5K
                          size = 0
                     suspended = false

Lecture d'ensembles de données

Vous pouvez lire les statistiques d'un ensemble de données en saisissant la commande read suivie du nombre de secondes antérieures à afficher :

caji:analytics datasets> select dataset-007
caji:analytics dataset-007> read 10
DATE/TIME                  /SEC       /SEC BREAKDOWN
2009-10-14 21:25:19         137          - -
2009-10-14 21:25:20         215          - -
2009-10-14 21:25:21         156          - -
2009-10-14 21:25:22         171          - -
2009-10-14 21:25:23        2722          - -
2009-10-14 21:25:24         190          - -
2009-10-14 21:25:25         156          - -
2009-10-14 21:25:26         166          - -
2009-10-14 21:25:27         118          - -
2009-10-14 21:25:28        1354          - -

Si des ventilations sont disponibles, elles sont également listées. L'exemple suivant illustre la statistique d'utilisation CPU ventilée par mode CPU (utilisateur/noyau), disponible sous le nom de dataset-006 :

caji:analytics datasets> select dataset-006
caji:analytics dataset-006> read 5
DATE/TIME                 %UTIL      %UTIL BREAKDOWN
2009-10-14 21:30:07           7          6 kernel
                                         0 user
2009-10-14 21:30:08           7          7 kernel
                                         0 user
2009-10-14 21:30:09           0          - -
2009-10-14 21:30:10          15         14 kernel
                                         1 user
2009-10-14 21:30:11          25         24 kernel
                                         1 user

Le récapitulatif est affiché sous "%UTIL" et le détail des éléments sous "%UTIL BREAKDOWN". A 21:30:10, le temps noyau s'élève à 14 % et le temps utilisateur à 1 %. La ligne 21:30:09 affiche 0% dans le récapitulatif "%UTIL", et n'indique donc pas la ventilation ("--").

Pour imprimer des valeurs séparées par des virgules (fichier CSV) pour un certain nombre de secondes de données, exécutez la commande csv :

knife:analytics datasets> select dataset-022
knife:analytics dataset-022> csv 10
Time (UTC),Operations per second
2011-03-21 18:30:02,0
2011-03-21 18:30:03,0
2011-03-21 18:30:04,0
2011-03-21 18:30:05,0
2011-03-21 18:30:06,0
2011-03-21 18:30:07,0
2011-03-21 18:30:08,0
2011-03-21 18:30:09,0
2011-03-21 18:30:10,0
2011-03-21 18:30:11,0

Suspension et reprise de tous les ensembles de données

La CLI dispose d'une fonction qui n'est pas encore disponible dans la BUI : la possibilité de suspendre et de reprendre tous les ensembles de données. Elle peut s'avérer utile lors de l'évaluation des performances de l'appareil pour déterminer ses performances maximales absolues. Etant donné que l'archivage de certaines statistiques peut solliciter des ressources de CPU et de disque importantes, les tests d'évaluation réalisés alors que ces statistiques sont actives ne sont pas valides.

Pour suspendre tous les ensembles de données, exécutez suspend :

caji:analytics datasets> suspend
This will suspend all datasets. Are you sure? (Y/N) y 
caji:analytics datasets> show
Datasets:

DATASET     STATE   INCORE ONDISK NAME
dataset-000 suspend   638K   584K arc.accesses[hit/miss]
dataset-001 suspend   211K   172K arc.l2_accesses[hit/miss]
dataset-002 suspend   211K   133K arc.l2_size
dataset-003 suspend   211K   133K arc.size
...

Pour reprendre tous les ensembles de données, exécutez resume :

caji:analytics datasets> resume
caji:analytics datasets> show
Datasets:

DATASET     STATE   INCORE ONDISK NAME
dataset-000 active    642K   588K arc.accesses[hit/miss]
dataset-001 active    215K   174K arc.l2_accesses[hit/miss]
dataset-002 active    215K   134K arc.l2_size
dataset-003 active    215K   134K arc.size
...

Exclusion de données d'un ensemble de données

Pour supprimer le niveau de granularité de la minute dans un ensemble de données, exécutez la commande prune :

caji:analytics dataset-001> prune minute
This will remove per-second and minute data collected prior to 2012-4-02
16:56:52.

Are you sure? (Y/N)

Remarque : cette commande supprime également les niveaux de granularité des données inférieurs. Par exemple, la commande prune hour supprime également les données par seconde et par minute.