Manuale utente Volta Monitor

Transcript

1 Manuale utente Vlta Mnitr 1

2 Smmari 1 Vlta Mnitr Prerequisiti di sistema Utilizz di Vlta Mnitr Manuale Utente Cnnessini ad Apache Cassandra Creazine nuva cnnessine Cnfigurazine Cnnessini Aiut Lingua Sezine Hme Sezine Ndi Sezine Perfrmance Sezine Keyspace Licenza Vlta Mnitr

3 1 Vlta Mnitr Vlta Mnitr è un tl che permette il mnitraggi di database Cassandra tramite interfaccia grafica. Grazie a quest strument si ha la pssibilità di pter mnitrare gni singl nd del Cluster a cui si è cllegati e reperire infrmazini su keyspace e tabelle dei vari ndi del cluster. Per maggiri infrmazini sul tl Vlta Mnitr (manuali, nuve versini, ecc.) e sul prgett Satellite Vlta, visitare il sit ppure, per il supprt tecnic, inviare una a supprt@satellitevlta.cm. 2 Prerequisiti di sistema Per l'utilizz di Vlta Mnitr è necessari aver installat la JRE (Java Runtime Envirnment) versine 7 superire ( Inltre è richiesta una risluzine minima dell scherm di 1280x

4 3 Utilizz di Vlta Mnitr Vlta Mnitr è dispnibile sul sit sia cme pacchett di distribuzine nei frmati.zip per sistemi Windws e.tar.gz per sistemi Linux, sia cme pacchett autinstallante nei frmati.deb per distribuzini Debian e Ubuntu e.rpm per distribuzini CentOS. Se si è scelt di scaricare il pacchett di distribuzine, per lanciare il tl Vlta Mnitr ccrre seguire i passi di seguit indicati: Scmpattare il pacchett di distribuzine di Vlta Mnitr (sl la prima vlta). Lanciare Vlta Mnitr cn dppi click sul file vlta-mnitr-x.y.z.jar ppure, da linea di cmand, eseguire il seguente cmand: java -jar vlta-mnitr-x.y.z.jar N.B. cn x.y.z si indica una generica versine di Vlta Mnitr. Se si è scelt di scaricare il pacchett autinstallante, per installare il tl Vlta Mnitr ccrre lanciare da terminale un dei cmandi stt indicati, a secnda della distribuzine scelta: - Su Debian/Ubuntu: sud dpkg i vlta-mnitr_x.y.z-k_all.deb - Su CentOS: sud rpm i vlta-mnitr_x.y.z-k_narch.rpm N.B.: cn x.y.z-k si indica una generica versine di Vlta Mnitr. Al termine dell installazine, per avviare il tl, lanciare il cmand vlta-mnitr Al prim avvi l'applicazine crea la cartella.vlta-mnitr all'intern della cartella hme dell utente; in tale cartella verrann memrizzati i dati delle cnnessini, i lg, le preferences, ecc. 4

5 4 Manuale Utente Di seguit viene descritt il manuale utente di Vlta Mnitr, rganizzandl in paragrafi e sttparagrafi in base ai pannelli grafici del tl e alle funzinalità in essi cntenute. 4.1 Cnnessini ad Apache Cassandra Lanciand il tl Vlta Mnitr, appare il pannell grafic delle cnnessini ai ndi Apache Cassandra che sn state via via definite dall utente. Ciascuna cnnessine è rappresentata da una scheda rettanglare in cui sn indicate le infrmazini caratterizzanti la cnnessine ad un nd di Apache Cassandra: nme cnnessine, username, indirizz IP e prta. Facend click su una scheda di cnnessine, si effettua la cnnessine al nd Apache Cassandra e si apre la hme dell'applicazine. 5

6 4.2 Creazine nuva cnnessine Dal pannell delle cnnessini ad Apache Cassandra, facend click sul bttne Crea nuva cnnessine in alt a destra, viene apert il pannell per la creazine e la cnfigurazine di una nuva cnnessine ad un nd Apache Cassandra. 6

7 Una vlta valrizzati i campi del frm che specifican la cnnessine al nd Apache Cassandra, è pssibile eseguire una delle seguenti azini, facend click sul relativ bttne presente nel pannell grafic: Test Verifica la crrettezza dei dati inseriti effettuand un test di cnnessine al nd Apache Cassandra specificat. Salva Salva i dati della cnnessine al nd Apache Cassandra. Annulla Annulla le perazini di gestine cnnessini nn ancra salvate. 7

8 4.3 Cnfigurazine Cnnessini Dal pannell delle cnnessini ad Apache Cassandra, facend click sul bttne Cnfigura cnnessini in alt a destra, viene apert il pannell per la gestine delle cnnessini ai ndi Apache Cassandra. Nel riquadr a sinistra è indicata la lista delle cnnessini e facend click su una cnnessine, il frm a destra diventa editabile ed è pssibile mdificare i dati della cnnessine al nd Apache Cassandra. Dpdiché è pssibile eseguire una delle seguenti azini, facend click sul relativ bttne presente in bass a destra nel pannell grafic: Test Verifica la crrettezza dei dati inseriti effettuand un test di cnnessine al nd Apache Cassandra specificat. Salva Salva i dati della cnnessine al nd Apache Cassandra. 8

9 Annulla Annulla le perazini di gestine cnnessini nn ancra salvate. In bass a sinistra nel pannell grafic sn presenti dei bttni che cnsentn di effettuare le seguenti perazini per la gestine delle cnnessini: 4.4 Aiut Nuva Crea una nuva cnnessine; ccrre valrizzare i campi del frm a destra che specifican la cnnessine al nd Apache Cassandra e salvare l perazine stessa facend click sul bttne Salva. Elimina Elimina la cnnessine al nd Apache Cassandra crrentemente selezinata nel riquadr delle cnnessini. Dal pannell delle cnnessini ad Apache Cassandra, facend click sul bttne Aiut in alt a destra, viene apert un menu cn le vci Licenza Vlta Mnitr e Infrmazini su Vlta Mnitr, da cui è pssibile avere dettagli rispettivamente sulla licenza d us e sulla versine di Vlta Mnitr. L stess menu Aiut è presente anche all intern del pannell hme. 4.5 Lingua Dal pannell delle cnnessini ad Apache Cassandra, facend click sul bttne Lingua in alt a destra, viene apert un menu cn le vci di scelta della lingua di Vlta Mnitr. L stess menu Lingua è presente anche all intern del pannell hme. 4.6 Sezine Hme 9

10 Facend click su una scheda di cnnessine del pannell Cnnessini ad Apache Cassandra, si effettua la cnnessine al nd Apache Cassandra e si apre la relativa Hme. 10

11 La hme riprta le infrmazini di base del cluster e la sua tplgia. Nella tlbar in alt sn presenti, tra gli altri, i seguenti pulsanti: Cnfigurazine cnnessini Si apre il pannell per la gestine delle cnnessini (vedere paragraf Cnnessini ad Apache Cassandra) Perfrmance Apre il Pannell per la visualizzazine delle perfrmance per il cluster, singli ndi e keyspace (vedere paragraf Sezine Perfrmance) Keyspace Apre il pannell per visualizzare le infrmazine dei keyspace e relative tabelle (vedere paragraf Sezine Keyspaces) Alcuni altri pulsanti (per la gestine dei ndi) vengn descritti in seguit. Aggirna Effettua l aggirnament dei dati presenti nella sezine hme Sulla sinistra viene visualizzat l'alber dei ndi; espandend gni singl nd è pssibile visualizzare le seguenti infrmazini: Datacenter di appartenenza Hstname Dimensini dei dati cntenuti nel nd Status (UP, DOWN, JOINING, LEAVING, MOVING) In bass a sinistra vengn visualizzate le seguenti infrmazini: Il nme del cluster Il nme del datacenter a cui si è cnnessi La versine di Cassandra Installata Inizialmente sulla parte centrale della hme vengn visualizzati il numer di ndi divisi per stat e un grafic in cui viene visualizzat per gni nd le dimensini dei dati in MB. Cliccand su gni singl nd dell'alber a sinistra scmpare il grafic ed appare il pannell per visualizzare i dettagli del nd stess. E' pssibile ri-visualizzare il 11

12 pannell principale cn il grafic cliccand sulla rt dell'alber dei ndi avente il nme del cluster Sezine Ndi Cliccand su gni nd del cluster sulla sinistra, verrà visualizzata una sezine dedicata che mstrerà alcuni dettagli del nd. Nell specific: Status del nd e dei seguenti servizi necessari per Cassandra: Server Thrift Native Transprt Gssip Prtcl Infrmazini sull utilizz dell heap memry Infrmazini sull status dei thread divisi per categrie Elenc dei drpped messages Inltre su gni nd sarà pssibile effettuare le seguenti azini utilizzand i pulsanti che si trvan nella tlbar in alt: 12

13 Cleanup Clean di una più tabelle di un keyspace: si aprirà una schermata cn la lista dei keyspace e relative tabelle; selezinare le tabelle interessate di un singl keyspace tenend premut CTRL e fare click su Ok. Cmpactin Cmpactin di una più tabelle di un keyspace: si aprirà una schermata cn la lista dei keyspace e relative tabelle; selezinare le tabelle interessate di un singl keyspace tenend premut CTRL e fare click su Ok. (vedere figura precedente) 13

14 Flush Flush di una più tabelle di un keyspace: si aprirà una schermata cn la lista dei keyspace e relative tabelle; selezinare le tabelle interessate di un singl keyspace tenend premut CTRL e fare click su Ok. (vedere figura precedente) Repair Repair di una più tabelle di un keyspace: si aprirà una schermata cn la lista dei keyspace e relative tabelle; selezinare le tabelle interessate di un singl keyspace tenend premut CTRL e fare click su Ok. (vedere figura precedente) Decmmissin Decmmissin sul nd a cui si è cnnessi: prima di prcedere verrà chiesta una cnferma. Drain Drain sul nd a cui si è cnnessi: prima di prcedere verrà chiesta una cnferma. 14

15 4.6.2 Sezine Perfrmance Facend click sul pulsante Perfrmance presente nella tlbar in alt a sinistra si aprirà il pannell che cnterrà tutte le infrmazini sulle perfrmance del cluster. In particlare, le kpi visualizzate sarann le seguenti: Numer di task pendenti Latenza delle perazini in scrittura Latenza delle perazini in lettura Numer di perazini in scrittura Numer di perazini in lettura È pssibile visualizzare queste infrmazini per il cluster, per il singl nd e per il singl keyspace. Facend click su gni singla riga della struttura ad alber sulla 15

16 sinistra le infrmazini che sn sulla destra si aggirnerann visualizzand le perfrmance del cmpnente selezinat Sezine Keyspace Facend click sul pulsante Keyspace presente nella tlbar in alt a sinistra si aprirà il pannell che cnterrà tutte le infrmazini riguardanti la struttura dei keyspace salvati nel cluster. In particlare: 16

17 Elenc dei keyspace cn relative prprietà: Nme del keyspace Effective Ownership pes del keyspace su gni nd (valre percentuale) Ring Descriptin Descrizine dell anell del cluster in base alla suddivisine delle chiavi per gni nd Per gni keyspace, elenc delle tabelle e relative prprietà: Nme della tabella Nme del keyspace a cui la tabella appartiene Cmpactin Strategy nme della classe che gestisce la Cmpactin Strategy Cmpressin Parameters 5 Licenza Vlta Mnitr mappa dei parametri di cmpressine cn relativi valri Vlta Mnitr Cpyright Sgetel S.r.l. All rights reserved. Vlta Mnitr è dispnibile gratuitamente stt i termini della licenza Satellite Vlta Sftware License, Versin 1.0, September Per maggiri dettagli visitare il sit Vlta Mnitr include sftware distribuit stt le licenze descritte di seguit. 17

18 - apache-cassandra jar Cpyright , DataStax Licensed under the Apache License, Versin 2.0 (the "License") - guava jar Cpyright 2015 The Guava Authrs Licensed under the Apache License, Versin 2.0 (the "License") - jcmmn jar Cpyright JFree.rg. All rights reserved. Licensed under the GNU General Public License, Versin 3 - jfreechart jar Cpyright JFree.rg. All rights reserved. Licensed under the GNU General Public License, Versin 3 - jsn-simple jar Cpyright All Rights Reserved. Licensed under the Apache License, Versin 2.0 (the "License") - lg4j-api jar Cpyright Apache Sftware Fundatin Licensed under the Apache License, Versin 2.0 (the "License") - lg4j-cre jar Cpyright Apache Sftware Fundatin Licensed under the Apache License, Versin 2.0 (the "License") 18

19 - metrics-cre jar Cpyright Cda Hale, Yammer.cm Licensed under the Apache License, Versin 2.0 (the "License") - netty final.jar Cpyright 2015 The Netty prject Licensed under the Apache License, Versin 2.0 (the "License") - slf4j-api jar Cpyright QOS.ch All rights reserved. Permissin is hereby granted, free f charge, t any persn btaining a cpy f this sftware and assciated dcumentatin files (the "Sftware"), t deal in the Sftware withut restrictin, including withut limitatin the rights t use, cpy, mdify, merge, publish, distribute, sublicense, and/r sell cpies f the Sftware, and t permit persns t whm the Sftware is furnished t d s, subject t the fllwing cnditins: The abve cpyright ntice and this permissin ntice shall be included in all cpies r substantial prtins f the Sftware. The sftware is prvided "as is", withut warranty f any kind, Express r implied, including but nt limited t the warranties f Merchantability, fitness fr a particular purpse and Nninfringement. In n event shall the authrs r cpyright hlders be Liable fr any claim, damages r ther liability, whether in an actin Of cntract, trt r therwise, arising frm, ut f r in cnnectin With the sftware r the use r ther dealings in the sftware. 19

20 - snakeyaml-1.11.jar Cpyright , Licensed under the Apache License, Versin 2.0 (the "License") 20