Manuale utente Vlta Mnitr www.satellitevlta.cm 1
Smmari 1 Vlta Mnitr... 3 2 Licenza Vlta Mnitr... 3 3 Prerequisiti di sistema... 3 4 Utilizz di Vlta Mnitr... 4 5 Manuale Utente... 5 5.1 Cnnessini ad Apache Cassandra... 5 5.2 Cnfigurazine nuva cnnessine... 6 5.3 Gestine Cnnessini... 7 5.4 Sezine Hme... 8 5.4.1 Sezine Ndi... 10 5.5 Sezine Perfrmance... 13 5.6 Sezine Keyspace... 14 www.satellitevlta.cm 2
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 www.satellitevlta.cm ppure, per il supprt tecnic, inviare una e-mail a supprt@satellitevlta.cm. 2 Licenza Vlta Mnitr Vlta Mnitr è dispnibile gratuitamente stt i termini della licenza Satellite Vlta Sftware License, Versin 1.0, September 2014. Per maggiri dettagli visitare il sit www.satellitevlta.cm. Vlta Mnitr include sftware distribuit stt licenza "Apache Sftware License 2.0" (www.apache.rg/licenses/license-2.0.html). 3 Prerequisiti di sistema Per l'utilizz di Vlta Mnitr è necessari aver installat la JRE (Java Runtime Envirnment) versine 7 superire (http://www.java.cm). www.satellitevlta.cm 3
4 Utilizz di Vlta Mnitr Per lanciare il tl Vlta Mnitr seguire i passi di seguit indicati: Scaricare e scmpattare il pacchett di distribuzine di Vlta Mnitr dal sit www.satellitevlta.cm (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. Al prim avvi l'applicazine crea la cartella.vlta-mnitr all'intern della cartella utente che al su intern cnterrà i seguenti file e cartelle: <user_hme>/.vlta-mnitr/cnnectins.jsn In cui vengn salvate tutte le cnnessini tramite i pannelli che descriverem in seguit <user_hme>/.vlta-mnitr/lg dve vengn salvati tutti i lg generati dall'applicazine www.satellitevlta.cm 4
5 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. 5.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. www.satellitevlta.cm 5
5.2 Cnfigurazine nuva cnnessine Dal pannell delle cnnessini a Apache Cassandra, facend click sul bttne Cnfigurazine 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. 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. CANCELLA Annulla l perazine di creazine nuva cnnessine. SALVA Salva i dati della cnnessine al nd Apache Cassandra. www.satellitevlta.cm 6
5.3 Gestine Cnnessini Dal pannell delle cnnessini a Apache Cassandra, facend click sul bttne Gestine 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. www.satellitevlta.cm 7
CANCELLA 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: CREA 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. SALVA Salva i dati delle cnnessini ai ndi Apache Cassandra. 5.4 Sezine Hme Facend click su una scheda di cnnessine del pannell Cnnessini a Apache Cassandra, si effettua la cnnessine al nd Apache Cassandra e si apre la relativa Hme. www.satellitevlta.cm 8
La hme riprta le infrmazini di base del cluster e la sua tiplgia. In alt è presente una tlbar cmpsta da i seguenti pulsanti: Gestine Cnnessini Si apre il pannell per la gestine delle cnnessini (vedere 8.1 Cnnessini ad Apache Cassandra) Perfrmance Apre il Pannell per la visualizzazine delle perfrmance per il cluster, singli ndi e keyspace (vedere 8.5 Sezine Perfrmance) Keyspaces Apre il pannell per visualizzare le infrmazine dei keyspace e relative tabelle (vedere 8.6 Sezine Keyspaces) Più altri pulsanti per la gestine dei ndi e di cui parlerem in seguit. Sulla sinistra viene visualizzat l'alber dei ndi, espandend gni singl nd è pssibile visualizzare le seguenti infrmazini: Hstname Status (UP, DOWN, JOINING, LEAVING, MOVING) Datacenter di appartenenza Dimensini dei dati cntenuti nel nd In bass a sinistra vengn visualizzate le seguenti infrmazini: Il nme del cluster La versine di Cassandra Installata Il nme del datacenter da cui si è cnnessi 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 www.satellitevlta.cm 9
pannell principale cn il grafic cliccand sulla rt dell'alber dei ndi avente il nme del cluster 5.4.1 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 Numer di task pendenti Infrmazini sull utilizz dell heap memry Infrmazini sull status dei thread divisi per categrie Elenc dei drpped messages www.satellitevlta.cm 10
Inltre su gni ndi sarà pssibile effettuare le seguenti azini utilizzand i pulsanti che si trvan nella tlbar in alt: 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. COMPACTION 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) www.satellitevlta.cm 11
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) DRAIN Drain sul nd a cui si è cnnessi: prima di prcedere verrà chiesta una cnferma. DECOMMISSION Decmmissin sul nd a cui si è cnnessi: prima di prcedere verrà chiesta una cnferma. www.satellitevlta.cm 12
5.5 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 perazini in scrittura Numer di perazini in lettura Latenza delle perazini in scrittura Latenza delle perazini in lettura Numer di task pendenti www.satellitevlta.cm 13
È 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 sinistra le infrmazini che sn sulla destra si aggirnerann visualizzand le perfrmance del cmpnente selezinat. 5.6 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. www.satellitevlta.cm 14
In particlare: Elenc dei keyspace cn relative prprietà: Nme del keyspace Ring Descriptin Descrizine dell anell del cluster in base alla suddivisine delle chiavi per gni nd Effective Ownership pes del keyspace su gni nd (valre percentuale) 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 mappa dei parametri di cmpressine cn relativi valri www.satellitevlta.cm 15