ISOiptables

NetAppQuickStart:InstallingGraphiteandGrafanaChristopherMadden,NetApp7September,2015AbstractThisguidehasbasicinstallationstepsfortheOpenSourcesoftwareGraphiteandGrafana.
ThesesoftwarearecommonlyusedwithOnCommandPerformanceManager(OPM)and/orNetAppHarvestavailableontheToolChest.
2QuickStart:InstallingGraphiteandGrafanaTABLEOFCONTENTS1Introduction.
31.
1AboutGraphite31.
2AboutGrafana.
31.
3AboutOnCommandPerformanceManagerExternalDataProvider.
31.
4AboutNetAppHarvest32InstallationPreparation42.
1SystemRequirements.
42.
2ProtocolandPortRequirements.
53InstallationonUbuntu63.
1Basicserversetup63.
2InstallGraphiteandPrerequisites.
63.
3ConfigureGraphite63.
4InstallGrafana.
83.
5ConfigureGrafana84InstallationonRHEL114.
1Basicserversetup114.
2InstallGraphiteandPrerequisites.
114.
3ConfigureGraphite144.
4InstallGrafana.
164.
5ConfigureGrafana175VerifyOperations.
205.
1Graphite(graphite-webandcarbon-cache)205.
2Grafana.
216Troubleshooting.
236.
1Start,stop,checkstatusofGraphiteandGrafanaservices.
236.
2Whisperstoragedirectoryavailablespace.
236.
3Logfilelocations.
247References258VersionHistory253QuickStart:InstallingGraphiteandGrafana1Introduction1.
1AboutGraphiteGraphiteisanopensourceenterprise-scalemonitoringtoolthatdoestwothings:Storenumerictime-seriesdataRendergraphsorAPIresponsesofthisdataondemandGraphiteconsistsofthreemaincomponents,allwritteninPython:1)carbon–aTwisteddaemonthatlistensfortime-seriesdata2)whisper-asimpledatabaselibraryforstoringtime-seriesdata(similarindesigntoRRD)3)graphitewebapp-ADjangowebappthatrendersgraphson-demandusingCairoandrequiresawebserversuchasApacheornginxGraphiteitselfhasnometricscollectionenginebutratherreceivesmetricssenttoit.
Graphitesupportsvarioustechniquestoscaleupandoutthethreemaincomponentsandisquitepowerful;3millionmetricsperminuteonasinglephysicalserverhasbeenreported!
MetricscanberetainedbyGraphiteforaconfigurableretentionperiodandfrequency.
TheGraphitewebappalsosupportsdozensoffunctionsthatallowforeasymanipulationofcollecteddataintousefulinformation.
1.
2AboutGrafanaGrafanaisanopensourcefeaturerichmetricsdashboardandgrapheditorforGraphite[andothermetricsdatabases].
Itprovidesapowerfulandelegantwaytocreate,share,andexploredataanddashboardsfromyourdisparatemetricdatabases.
Itsupportsawidevarietyofgraphingoptionsforultimateflexibility.
Grafanasupportsauthenticatedloginandabasicrolebasedaccesscontrolimplementation.
GrafanaisdeployedasasinglesoftwareinstallationandincludesawebserverandpresentationlogicandiswritteninGoandJavascript.
1.
3AboutOnCommandPerformanceManagerExternalDataProviderBeginningwithOnCommandPerformanceManager1.
1afeaturetoforwardmetricstoan'ExternalDataProvider'wasintroduced.
ThisintegrationallowsmetricstobeforwardedtoaGraphiteinstallationforlong-termretentionandintegrationintoothermetricsportals.
1.
4AboutNetAppHarvestNetAppHarvestisaflexibledatacollectoravailableontheNetAppToolChestthatcollectsperformancemetricsfromClusteredDataONTAP,DataONTAP7-mode,andcapacitymetricsfromOnCommandUnifiedManager6.
xservers.
ThemetricsarethenforwardedtoaGraphiteinstallationforlong-termretentionandintegrationintoothermetricsportals.
4QuickStart:InstallingGraphiteandGrafana2InstallationPreparationWithenougheffortandexpertiseGraphitecanbeinstalledonprettymuchanyLinuxflavor.
WhiletheoverallstepsaredocumentedintheGraphitedocumentationtheexactcommandsforagivenLinuxflavorandreleasearenot.
ToeaseinstallationwehaveinstalledanddocumentedthestepsforthefollowingLinuxreleases:Ubuntu14.
04RedHatEnterpriseLinux6.
6RedHatEnterpriseLinux7.
1OurexperiencehasshownthatinstallationonUbuntu,usingthenativepackagerepositories,isaneasychoiceforaquickimplementationatzerocost.
WealsoseethatmanyenterpriseshavestandardizedonRedHatEnterpriseLinux(RHEL),andthusprefertodeployonthisLinuxflavor.
ForRHELwehavedocumentedinstructionsforbothonline(installationfrominternetarchives)andoffline(installationviacopyingfiles)scenarios.
Eitherwayyougo,thefeature/functionofthesolutionisthesamesochoosetheLinuxflavorandstepsthatbestmeetyourneeds.
2.
1SystemRequirementsPlatformrequirementsvarybasedonthequantityofnodesbeingmonitored,amountofinstancesmonitored(i.
e.
#vols,luns,lifs,etc),andthefrequencyofmonitoring.
Thisdocumentincludesabasicinstallationcapableofservicingapproximately75,000metricupdatesperminute.
Atypicalmonitorednodemightsubmitanywherefrom500to5000metricsperpollinginterval(1or5mintypically).
IfthisisinsufficientGraphitecanbescaledinvariouswaystosupportmillionsofmetricsupdatesperminuteifneeded.
Discussionofscalinghigherishoweveroutsidethescopeofthisdocument.
Systemrequirements:LinuxOSx86-64,oneof:oUbuntu14.
04LTSoRHEL6.
6oRHEL7.
1CPU:1vCPUMemory:1GBRAMDiskcapacity:2.
5-5GBpermonitorednodeDiskperformance:20-200randomIOPspermonitorednodeoUseNetAppstorage(NFS,LUN,vmdk,vhd,vhdx)orlocalSSDAdditionally,softwarepackagesarerequiredfrom:UbuntuoUbuntupackagerepositoryoGrafanapackagerepositoryRHELoRedHatpackagerepository(InstallISOorRedHatpackagerepository)oPythonPIPpackagerepositoryoGithuboGrafanapackagerepository5QuickStart:InstallingGraphiteandGrafana2.
2ProtocolandPortRequirementsVariousnetworkprotocolsandportreachabilityisrequiredbetweenGraphite,Grafana,andtheclientwebbrowser.
Belowaredetailsoftherequirednetworkconnectivity.
Firewallsmustbeconfiguredtoallowaccess.
Theportnumbersusedintheinstructionstepsarelistedbutanyitemwitha'*'canoptionallybemodifiedtootherportsorprotocol(HTTPtoHTTPS)tomatchyourenvironmentstandards.
Initiatedbythedatacollector(OPM,NetAppHarvest):DestinationProtocolPortDescriptionGraphiteServerIPGraphiteplaintextprotocol2003/TCP*UsedtopostmetricstotheGraphitemetricsDBInitiatedbytheGrafanaserver(inthisguidebothGraphiteandGrafanarunonthesamehost):DestinationProtocolPortDescriptionGraphiteServerIPHTTP*81/TCP*UsestherenderandqueryAPIstofetchJSONformattedmetricsInitiatedbytheClientbrowser(inthisguidebothGraphiteandGrafanarunonthesamehost):DestinationProtocolPortDescriptionGraphiteServerIPHTTP*81/TCP*AccesstheGraphitenativewebGUIGrafanaServerIPHTTPS*443/TCP*AccesstheGrafanadashboardGUI6QuickStart:InstallingGraphiteandGrafana3InstallationonUbuntuToinstallonUbuntufollowthestepsinthischapter.
ForRHELinstallationstepsseethechapterInstallationonRHEL.
3.
1BasicserversetupPerformabasicinstallationofUbuntuServer14.
04LTS.
DuringinstallationbesuretosetyourstaticIPaddressanddefaultgateway,DNSservers,andtimezone.
Alsoensuretimeiscorrectandwillbesyncedwithtruetimebyeither(a)usingthehypervisorguesttoolstosynctheVMclockwiththehostclockthatissync'dtotruetimeor(b)installandconfigureNTPsoftwaretohavetheVMsyncwithtruetime,andthendisableclocksyncinthehypervisorguesttools.
3.
2InstallGraphiteandPrerequisitesGraphiteisveryeasytoinstallusingnativepackagesusingtheshortinstallationinstructionsthatfollow.
Foradditionaldetailsanddiscussionthisblogpostmaybeusefulasitservedasthebasisfortheseinstructions.
First,installallneededpackages:sudoapt-getupdatesudoapt-get–yinstallapache2libapache2-mod-wsgigraphite-webgraphite-carbonAnswerYtoinstallotherprerequisitepackagesAquestionisaskedifyouwanttoremoveyourdatabasefilesifpurginggraphite-carbon.
Answer"No".
Ifyouuninstalllateryoucanalwaysremovethedatadirectory(/var/lib/graphite/whisper)manually.
3.
3ConfigureGraphite3.
3.
1ConfigureCarboncache1.
EdittheCarboncacheservicestartupfile:sudonano/etc/default/graphite-carbona.
FindthelinewithCARBON_CACHE_ENABLEDandmodifyitfromfalsetotruetoenabletheservicetoautostartonboot:CARBON_CACHE_ENABLED=falsechangetoCARBON_CACHE_ENABLED=trueb.
Savethefileandexittothecommandprompt.
2.
EdittheCarboncacheserviceconfigurationfile:sudonano/etc/carbon/carbon.
confa.
FindthelinewithENABLE_LOGROTATIONandmodifyitfromfalsetotruetoenablelogstoberotated:ENABLE_LOGROTATION=FalsechangetoENABLE_LOGROTATION=Trueb.
FindthelinewithMAX_CREATES_PER_MINUTEandmodifyitfrom50to600somorenewmetricfilescanbecreatedperminutespeedingdisplayofnewlyaddedmonitoredhosts:7QuickStart:InstallingGraphiteandGrafanaMAX_CREATES_PER_MINUTE=50changetoMAX_CREATES_PER_MINUTE=600c.
Savethefileandexittothecommandprompt.
3.
Copyadefaultstorage-aggregation.
conffileinplace:sudocp/usr/share/doc/graphite-carbon/examples/storage-aggregation.
conf.
example/etc/carbon/storage-aggregation.
conf4.
StarttheCarboncacheservice:sudoservicecarbon-cachestart3.
3.
2Configuregraphite-web1.
EdittheGraphitewebappconfigurationfile:sudonano/etc/graphite/local_settings.
pya.
FindthelinewithSECRET_KEY,uncommentit,andfillthevaluewithsomelongrandomsetofcharacters:#SECRET_KEY='UNSAFE_DEFAULT'changeto(butfillwithyourownrandomcharacters!
)SECRET_KEY='KJKzzxcviouzxcvytwkdd94944asmdf9ads9ds9dspp83jlkjLKJL98798KLOIK'b.
UncommentandpopulatetheTIME_ZONEvariablewiththetimezonefortheGraphiteUI(seelisthere,useTZcolumnvalues):#TIME_ZONE='America/Los_Angeles'changeto(butreplacewithyourTimezone!
)TIME_ZONE='Europe/Amsterdam'c.
Savethefileandexittothecommandprompt.
2.
InitializetheGraphiteconfigurationDB:sudographite-managesyncdba.
Youwillbepromptedtocreateasuperuseraccount.
Chooseyesandentercredentials.
ThesecanbeusedintheGraphiteinterfacetosavegraphs.
3.
Setownershipforaccessbythe_graphiteuser:sudochown_graphite:_graphite/var/lib/graphite/graphite.
db3.
3.
3ConfigureApache1.
Configurewebsites:sudoa2dissite000-defaultsudocp/usr/share/graphite-web/apache2-graphite.
conf/etc/apache2/sites-availablesudoa2ensiteapache2-graphite2.
Opentheportsconfigurationfileinatexteditor.
8QuickStart:InstallingGraphiteandGrafanasudonano/etc/apache2/ports.
confa.
FindthelinewithListenandsetittoavalueof81Listen80changetoListen81b.
Savethefileandexittothecommandprompt.
3.
OpentheGraphitevhosthttpconfigurationfileinatexteditor.
sudonano/etc/apache2/sites-available/apache2-graphite.
confa.
Findthelinewithandmodifythelinetolistenonport81andthenaddthethreeHeadersetentrieslistedbelow.
changeto4.
ReloadApacheconfiguration:sudoserviceapache2reload3.
4InstallGrafanaGrafanaisveryeasytoinstallbyaddingacustomrepository.
Belowareshortinstallationinstructions.
ForadditionaldetailspleaseseetheGrafanaprojectwebsiteinstructionsInstallingonDebian/Ubuntu.
1.
Edittheapt-getsourcesfile:sudonano/etc/apt/sources.
lista.
AddthelinefortheGrafanaserverrepositorytotheendofthefile:debhttps://packagecloud.
io/grafana/stable/debian/wheezymainb.
Savethefileandexittothecommandprompt.
2.
Addthepackagecloudkeytoallowinstallationofsignedpackages:sudocurlhttps://packagecloud.
io/gpg.
key|sudoapt-keyadd-3.
UpdateAptrepositoriesandinstallGrafana:sudoapt-getupdatesudoapt-getinstallgrafana3.
5ConfigureGrafana1.
ToconfigureGrafanatorunoverHTTPSeitherprovidecertificateandkeyfilesfromatrustedCA,orcreateyourownselfsignedcertificate.
Ifcreatingaself-signedcertificateasamplecommandsyntaxisshown.
Youwillbepromptedwithquestionswhichshouldbeansweredaccordingtoyourenvironment:cd/etc/grafanasudoopensslreq-x509-newkeyrsa:2048-keyoutcert.
key-outcert.
pem-days3650-nodes9QuickStart:InstallingGraphiteandGrafana2.
OpentheGrafanaconfigurationfileinatexteditor.
sudonano/etc/grafana/grafana.
inia.
Findthelinewith;protocol,removethesemi-colon,andsetittoavalueofhttpsasshownbelow:;protocol=httpchangetoprotocol=httpsb.
Findthelinewith;http_port,removethesemi-colon,andsetittoavalueof443asshownbelow:;http_port=3000changetohttp_port=443c.
Findthesectionwithhttpscertificateinformationandremovethesemi-colonsandsetthevaluesofthecertificateandkeyfilescreatedearlier:#httpscerts&keyfile;cert_file=;cert_key=changeto#httpscerts&keyfilecert_file=/etc/grafana/cert.
pemcert_key=/etc/grafana/cert.
keyd.
Savethefileandexittothecommandprompt.
3.
Setgrafana-servertobeabletorunonanyport(shouldyouchooselatertorunonaprivilegedport):sudosetcap'cap_net_bind_service=+ep'/usr/sbin/grafana-server4.
SetGrafanatostartonbootandstartitnow:sudoupdate-rc.
dgrafana-serverdefaults9510sudoservicegrafana-serverstart10QuickStart:InstallingGraphiteandGrafana5.
Openyourwebbrowsertohttps://IP_ADDRESS_OR_HOSTNAMEandyoushouldseetheGrafanaloginpage.
Loginwiththedefaultusernameof'admin'andpasswordof'admin':6.
Changetheadminpasswordbyclickingthelogointhecorner(1)andthentheAdminaccount(2)andthenChangepasswordlink(3):CompletethecurrentandnewpasswordandclicktheChangePasswordbutton.
Ifsuccessfulagreenboxwillbedisplayedthatthepasswordhasbeenchangedsuccessfully.
11QuickStart:InstallingGraphiteandGrafana4InstallationonRHELToinstallonRHELfollowthestepsinthischapter.
ForUbuntuinstallationstepsseethechapterInstallationonUbuntu.
Note:Executeallstepsinthischapterastherootuser.
Loginasrootoruse"sudo-i"toacquirerootprivileges4.
1BasicserversetupPerformabasicinstallationofRHEL6orRHEL7.
DuringinstallationbesuretosetyourstaticIPaddressanddefaultgateway,DNSservers,andtimezone.
Alsoensuretimeiscorrectandwillbesyncedwithtruetimebyeither(a)usingthehypervisorguesttoolstosynctheVMclockwiththehostclockthatissync'dtotruetimeor(b)installandconfigureNTPsoftwaretohavetheVMsyncwithtruetime,andthendisableclocksyncinthehypervisorguesttools.
4.
1.
1DisableSELinux1.
Opentheselinuxconfigurationfileinatexteditor.
nano/etc/sysconfig/selinuxa.
ModifythevalueofSELINUXtobedisabled:SELINUX=enforcingchangeto:SELINUX=disabledb.
Savethefileandexittothecommandprompt.
c.
Rebootthehost:reboot4.
1.
2ModifyFirewallRulesBydefaultincomingtrafficisblockedforremoteaccessbytheLinuxfirewall.
Thesoftwareinstalledinlaterstepswillrunontheseportssowemustopenthem.
Portsopenedare443(Grafana),81(Graphite),and2003(Carboncachemetricsreceiver).
ForRHEL6usethefollowingcommands:iptables-IINPUT-ptcp--dport443-jACCEPTiptables-IINPUT-ptcp--dport81-jACCEPTiptables-IINPUT-ptcp--dport2003-jACCEPTserviceiptablessaveForRHEL7usethefollowingcommands:firewall-cmd--permanent--add-port443/tcpfirewall-cmd--permanent--add-port81/tcpfirewall-cmd--permanent--add-port2003/tcpfirewall-cmd–-reload4.
2InstallGraphiteandPrerequisitesAsopensourcesoftwareGraphiteiseasiesttoinstallwheninternetaccessisavailable.
Ifinternetaccessisnotavailableanalternativesetofofflineinstallationinstructionsisalsoincluded.
Followtheappropriatesectionforyourenvironment.
12QuickStart:InstallingGraphiteandGrafana4.
2.
1Online/InternetbasedinstallationThissectioncontainsinstallationstepstobeusedifyourGraphitehosthasadirectaccesstotheInternet(i.
e.
viaatransparentproxy).
Ifaccessisviaanamedproxyserverconfiguretheproxyfirstusingenvironmentvariableswhichcurl,yum,andgitwilluse:exporthttp_proxy=http://proxy.
myproxy.
com:####exporthttps_proxy=https://proxy.
myproxy.
com:####ForPIPaproxyservercanbeconfiguredusingamodifiedpipinstallsyntaxlike:pipinstall--proxy="user:password@server:port"packagenameRPMpackagesInstallprerequisiteand/orhelpfulsystempackages:yuminstall-ypython-develmod_wsgipycairodejavu-sans-fontsgccgitpytzpython-memcachedncnet-toolslsofunzipPythonpackagesInstallpip,andthenusepiptoinstallprerequisitePythonpackages:cd/tmpcurl-Ohttps://bootstrap.
pypa.
io/get-pip.
pypythonget-pip.
pypipinstallpyparsingpipinstall'Twistedandmodifythelinetolistenonport81andthenaddthethreeHeadersetentrieslistedbelow.
changetoHeadersetAccess-Control-Allow-Origin"*"HeadersetAccess-Control-Allow-Methods"GET,OPTIONS"HeadersetAccess-Control-Allow-Headers"origin,authorization,accept"b.
Findthelinewithandreplacethatsection(includingdirectorypath!
)asshownbelowtakingcarethatthetexttoreplacediffersbetweenRHEL6andRHEL7:Orderdeny,allowAllowfromallchangetoforRHEL6OptionsAllAllowOverrideAllOr,changetoforRHEL7OptionsAllAllowOverrideAllRequireallgrantedc.
Savethefileandexittothecommandprompt.
3.
SetApachetoautostartatsystembootandstartit.
OnthefirststartupsomestructuresarecreatedintheSQLitedbanditispossiblethatduetoaraceconditionitwillbecomelockedforGUIaccess.
Forthisreasonwerestartonceafterthisinitializationshouldhavecompleted:chkconfighttpdonservicehttpdstart;sleep15;servicehttpdrestart4.
4InstallGrafanaAsopensourcesoftwareGraphiteiseasiesttoinstallwheninternetaccessisavailable.
Ifinternetaccessisnotavailableanalternativesetofofflineinstallationinstructionsisalsoincluded.
Followtheappropriatesectionforyourenvironment.
17QuickStart:InstallingGraphiteandGrafana4.
4.
1Online/InternetbasedinstallationGrafanaisveryeasytoinstallbyaddingacustomrepository.
Belowareshortinstallationinstructions.
ForadditionaldetailspleaseseetheGrafanaprojectinstallationinstructionsInstallingonRPM-basedLinux.
1.
CreateanewyumrepositoryforGrafanausingatexteditor.
nano/etc/yum.
repos.
d/grafana.
repoa.
Placethefollowingtextinthefile:.
[grafana]name=grafanabaseurl=https://packagecloud.
io/grafana/stable/el/6/$basearchrepo_gpgcheck=1enabled=1gpgcheck=1gpgkey=https://packagecloud.
io/gpg.
keyhttps://grafanarel.
s3.
amazonaws.
com/RPM-GPG-KEY-grafanasslverify=1sslcacert=/etc/pki/tls/certs/ca-bundle.
crtb.
Savethefileandexittothecommandprompt.
2.
InstallGrafanausingyumyuminstall–ygrafana4.
4.
2Offline/JumphostbasedinstallationGrafanacanalsobeeasilydownloadedandinstalledfromasingleRPM.
1.
DownloadthelatestRPMfromhttp://grafana.
org/download/fromyourhostwithInternetaccess2.
CopythedownloadedfiletotheGraphitehost/tmp/directory.
3.
Installfromthelocalarchivereplacingwithyouractualreleaselevelrpm-i/tmp/grafana-.
x86_64.
rpm4.
5ConfigureGrafana1.
ToconfigureGrafanatorunoverHTTPSeitherprovidecertificateandkeyfilesfromatrustedCA,orcreateyourownselfsignedcertificate.
Ifcreatingaself-signedcertificateasamplecommandsyntaxisshown.
Youwillbepromptedwithquestionswhichshouldbeansweredaccordingtoyourenvironment:cd/etc/grafanaopensslreq-x509-newkeyrsa:2048-keyoutcert.
key-outcert.
pem-days3650-nodes2.
OpentheGrafanaconfigurationfileinatexteditor.
nano/etc/grafana/grafana.
inia.
Findthelinewith;protocol,removethesemi-colon,andsetittoavalueofhttpsasshownbelow:;protocol=httpchangetoprotocol=httpsb.
Findthelinewith;http_port,removethesemi-colon,andsetittoavalueof443asshownbelow:;http_port=300018QuickStart:InstallingGraphiteandGrafanachangetohttp_port=443c.
Findthesectionwithhttpscertificateinformationandremovethesemi-colonsandsetthevaluesofthecertificateandkeyfilescreatedearlier:#httpscerts&keyfile;cert_file=;cert_key=changeto#httpscerts&keyfilecert_file=/etc/grafana/cert.
pemcert_key=/etc/grafana/cert.
keyd.
Savethefileandexittothecommandprompt.
3.
Setgrafana-servertobeabletorunonareservedport:setcap'cap_net_bind_service=+ep'/usr/sbin/grafana-server4.
SetGrafanatoautostartatsystembootandstartit:chkconfig--addgrafana-serverchkconfiggrafana-serveronservicegrafana-serverstart5.
Openyourwebbrowsertohttps://IP_ADDRESS_OR_HOSTNAMEandyoushouldseetheGrafanaloginpage.
Loginwiththedefaultusernameof'admin'andpasswordof'admin':6.
Changetheadminpasswordbyclickingthelogointhecorner(1)andthentheAdminaccount(2)andthenChangepasswordlink(3):19QuickStart:InstallingGraphiteandGrafanaCompletethecurrentandnewpasswordandclicktheChangePasswordbutton.
Ifsuccessfulagreenboxwillbedisplayedthatthepasswordhasbeenchangedsuccessfully.
20QuickStart:InstallingGraphiteandGrafana5VerifyOperations5.
1Graphite(graphite-webandcarbon-cache)OpenawebbrowserandbrowsetoyourGraphiteserver(http://IP_ADDRESS_OR_HOSTNAME:81)andyoushouldseeascreenthatlookslikethis:Next,sendametrictoverifythatcarboncacheisrunning,acceptsit,andthewebgraphitewebUIcandisplayit:echo"test.
metric50`date+%s`"|nc127.
0.
0.
12003Inyourbrowser,reloadthepage(F5)andexpandtheGraphitefolderandyoushouldseeatestfolderandmetricnamedmetric:21QuickStart:InstallingGraphiteandGrafana5.
2GrafanaOpenyourwebbrowsertohttps://IP_ADDRESS_OR_HOSTNAMEandyoushouldseetheGrafanaloginpage.
Loginwiththedefaultusernameof'admin'andthepasswordsetintheconfigurationstepearlier.
1.
AddadatasoucebyclickingDataSources(1)andthenAddNew(2):2.
IntheadddatasourcedialoggiveanameforyourGraphiteserver(1),checktheDefaultcheckbox(2),andentertheURLofthegraphiteserver(3),thenclickAdd:22QuickStart:InstallingGraphiteandGrafana3.
VerifythedatasourceisreachablebyclickingtheTestConnectionbutton:YoushouldseeaGreenSuccessmessage.
Grafanaisnowinstalledandyoucanproceedtocreateorimportdashboards.
23QuickStart:InstallingGraphiteandGrafana6TroubleshootingFulltroubleshootingproceduresfortheGraphiteandGrafanasolutionisoutofscopeofthisdocumentbutinthefollowingsubsectionsaresomehintstogetyoustarted.
6.
1Start,stop,checkstatusofGraphiteandGrafanaservicesCheckstatusofservices:UbuntuRHELsudoservicecarbon-cachestatussudoservicegrafana-serverstatussudoserviceapache2statussudoservicecarbon-cachestatussudoservicegrafana-serverstatussudoservicehttpdstatusStopservices:UbuntuRHELsudoservicecarbon-cachestopsudoservicegrafana-serverstopsudoserviceapache2stopsudoservicecarbon-cachestopsudoservicegrafana-serverstopsudoservicehttpdstopTostartservices:UbuntuRHELsudoservicecarbon-cachestartsudoservicegrafana-serverstartsudoserviceapache2startsudoservicecarbon-cachestartsudoservicegrafana-serverstartsudoservicehttpdstart6.
2WhisperstoragedirectoryavailablespaceWhenametricisfirstreceivedacorrespondingwhisper.
wspfileiscreated.
Thefilesizeofthe.
wspwillcorrespondtotheconfiguredfrequencyandretention;itiscreated'thick'andwillnotgrowovertime.
ThestoragedirectoryisdifferentonUbuntuandRHEL.
SeetheappropriatecommandtocheckdiskspaceontheWhisperstoragedirectory.
ChecksufficientdiskspaceisavailableonUbuntu:df-h/var/lib/graphiteFilesystemSizeUsedAvailUse%Mountedon/dev/sda129G5.
0G23G18%/ChecksufficientdiskspaceisavailableonRHEL:df-h/opt/graphite/storageFilesystemSizeUsedAvailUse%Mountedon/dev/mapper/vg_sdtgraphite2-lv_root45G2.
2G41G6%/24QuickStart:InstallingGraphiteandGrafana6.
3LogfilelocationsEachcomponenthasoneormorelogfileswithdetailsasfoundinthetablebelow:TIP:usels-ltrtoreversesortthefilesbymodificationtimestamp;thelastfileintheoutputisagoodplacetostart!
ComponentLogdirectoryLogfiledescriptionApachewebserverUbuntu:/var/log/apache2RHEL:/var/log/httpderror.
logshowsoverallwebserverstatusmessagesgraphite-web_access.
logshowswebpageviews.
Usethereferrerfieldtoseewhichdashboardsaremostpopular!
graphite-web_error.
logshowserrormessagerelatedtothevirtualhostservingtheGraphitewebappGraphitewebappUbuntu:/var/log/graphiteRHEL:/opt/graphite/storage/log/webappexception.
logshowswebappexceptionsrendering.
logshowsuseoffunctionsandresponsetimeofeach.
Foraslowloadingpagethislogmightgiveanideaofwhichfunction(s)areslowestmetricaccess.
logshowsmetricsrequestedcache.
logshowswebapplookupstocarboncachefordatapointsinfo.
logshowswebappquerydetails(buildingindexformetricsearches)CarboncachemetricsreceiverUbuntu:/var/log/carbonRHEL:/opt/graphite/storage/log/carbon-cache/carbon-cache-alistener.
logshowsTCPsessionsconnectedanddisconnectedfrommetricssendingclientscreates.
logshowsmetricsdbfilecreationdetailssuchasmatchingschemaandfrequencyandretentiontimesused.
GrafanaUbuntuandRHEL:/var/log/grafanagrafana.
logshowsaccessesanderrors25QuickStart:InstallingGraphiteandGrafana7ReferencesThefollowingreferenceswereusedinthispaper:Ubuntuserverdownloadhttp://www.
ubuntu.
com/download/serverRedHathttp://www.
redhat.
com/Graphiteprojectsitehttp://graphite.
readthedocs.
org/en/latest/Grafanaprojectsitehttp://grafana.
orgNetAppOnCommandPerformanceManagerhttp://mysupport.
netapp.
com/NOW/cgi-bin/software/NetAppHarvestDataCollectorhttp://mysupport.
netapp.
com/tools/index.
html8VersionHistoryVersionDateDocumentVersionHistoryVersion1.
0July2015InitialReleaseVersion1.
1July2015AdditionofsizinginformationandminorupdatestoformattingVersion1.
2August2015AddedtroubleshootingsectionVersion1.
3August2015AddedstepsforRedHat6and7Version1.
4September2015Correctedservicestop/startstepsforRedHatNetAppprovidesnorepresentationsorwarrantiesregardingtheaccuracy,reliability,orserviceabilityofanyinformationorrecommendationsprovidedinthispublication,orwithrespecttoanyresultsthatmaybeobtainedbytheuseoftheinformationorobservanceofanyrecommendationsprovidedherein.
TheinformationinthisdocumentisdistributedASIS,andtheuseofthisinformationortheimplementationofanyrecommendationsortechniqueshereinisacustomer'sresponsibilityanddependsonthecustomer'sabilitytoevaluateandintegratethemintothecustomer'soperationalenvironment.
ThisdocumentandtheinformationcontainedhereinmaybeusedsolelyinconnectionwiththeNetAppproductsdiscussedinthisdocument.
2015NetApp,Inc.
Allrightsreserved.
NoportionsofthisdocumentmaybereproducedwithoutpriorwrittenconsentofNetApp,Inc.
Specificationsaresubjecttochangewithoutnotice.
NetAppandtheNetApplogoaretrademarksorregisteredtrademarksofNetApp,Inc.
intheUnitedStatesand/orothercountries.
Allotherbrandsorproductsaretrademarksorregisteredtrademarksoftheirrespectiveholdersandshouldbetreatedassuch.