IBM Operations Analytics Predictive Insights Mediation Pack for multiple technologies - AppDynamics, Dynatrace, DCRUM, Aternity, Splunk, CA APM, CA UIM, MF (HP) APM, NetIQ AppManager, ExtraHop, New Relic and Oracle OEM Version 1.4
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity and Splunk
IBM Operations Analytics Predictive Insights MediationPackformultipletechnologies-AppDynamics,Dynatrace,DCRUM,Aternity,Splunk,CAAPM,CAUIM,MF(HP)APM,NetIQAppManager,ExtraHop,NewRelicandOracleOEM
Version 1.4
Mediation Pack for multiple technologies - AppDynamics, Dynatrace, DCRUM, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM,NetIQ AppManager, New Relic and OracleOEM
ii
Mediation Pack for multiple technologies - AppDynamics, Dynatrace, DCRUM, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
Edition notice
ThiseditionappliestoIBMOperationsAnalyticsPredictiveInsights1.3.3andtoallsubsequentreleasesandmodificationsuntilotherwiseindicatedinneweditions.Pleaserefertothelicensefilesinthedeliveredmediationpackfortermsofuse.AlsoreferencetheIBMOperationsAnalyticsTechnicalCommunity(https://developer.ibm.com/itoa/)foradditionalinformationandforumsonPredictiveInsights.ThismediationpackwasprovidedincooperationwithJ9Technologies,Inc.ReferencethefollowingforadditionalinformationaboutJ9Technologies:http://info.j9tech.com/ibm-mediation
Mediation Pack for multiple technologies - AppDynamics, Dynatrace, DCRUM, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM,NetIQ AppManager, New Relic and OracleOEM
iv
CONTENTS
TableofContents
MEDIATIONPACKFORMULTIPLETECHNOLOGIES-APPDYNAMICS,DYNATRACE,DCRUM,ATERNITY,SPLUNK,CAAPM,CAUIM,MF(HP)APM,NETIQAPPMANAGER,EXTRAHOP,NEWRELICANDORACLEOEM I
CONTENTS IV
OVERVIEW 7
PREREQUISITEINFORMATION 9
MEDIATORSOVERVIEW 11
KEYSTEPSTOSETTINGUPMEDIATORS 11
INSTALLINGANDCONFIGURING 12
ZIPFILECONTENTS 12INSTALLPROCEDURE 12NEWINSTALLATION 12UPGRADEINSTALLATION 13DEPLOYEDDIRECTORYCONTENTS 13JAVA 14PREDICTIVEINSIGHTS1.3.3-1.3.5 14PREDICTIVEINSIGHTS1.3.6ORLATER 14ACCESSINGTHEMEDIATIONSYSTEM 15
APPDYNAMICSMEDIATOR 16
PRIMARYCONFIGURATION 16CHECKTHECONNECTION 18AUTO-CONFIGUREAPPLICATION 19RUNNINGMETRICEXTRACTIONTASK 20REMOVINGAPPLICATIONSFROMMETRICEXTRACTIONSCOPE 21
DYNATRACEMEDIATOR 22
OVERVIEW 22MEDIATORCREATIONANDCONFIGURATION 22INSTALLINGSAMPLE‘PREDICTIVEINSIGHTSDASHBOARD’ 25CONFIGURINGMETRICEXTRACTIONUSINGDEFINEDDYNATRACEDASHBOARDS 29
ATERNITYMEDIATOR 31
MEDIATORCREATIONANDCONFIGURATION 31CHECKTHECONNECTION 32
Mediation Pack for multiple technologies - AppDynamics, Dynatrace, DCRUM, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM,NetIQ AppManager, New Relic and OracleOEM
v
RUNMETRICEXTRACTIONTASK 33
SPLUNKMEDIATOR 33
CREATENEWSPLUNKMEDIATOR 33CHECKCONNECTION 34SELECTMETRICSANDMAPPINGS 35RUNMETRICEXTRACTIONTASK 39
DCRUMMEDIATOR 40
PRIMARYCONFIGURATION 40
CAAPM(INTROSCOPE)MEDIATOR 50
OVERVIEW 50MEDIATORCREATIONANDCONFIGURATION 50CONFIGURINGMETRICEXTRACTION 52
EXTRAHOPMEDIATOR 57
OVERVIEW 57BEFOREYOUBEGIN-EXTRAHOPPRE-REQS 57MEDIATORCREATIONANDCONFIGURATION 58CONFIGURINGMETRICEXTRACTION 60EXTRAHOPOPENDATASTREAM 61EXTRAHOPTRIGGERS 63TRIGGERASSIGNMENT 64TRIGGERENABLEMENT 66METRICCOLLECTION-LASTPOINTS 66
CAUIMMEDIATOR 68
PRIMARYCONFIGURATION 68CHECKTHECONNECTION 70CONFIGUREMETRICSELECTION 71RUNNINGMETRICEXTRACTIONTASK 72
MICROFOCUSAPMMEDIATOR 74
PRIMARYCONFIGURATION 74CHECKTHECONNECTION 76RUNNINGMETRICEXTRACTIONTASK 79
NETIQAPPMANAGERMEDIATOR 80PRIMARYCONFIGURATION 80CONFIGUREMETRICEXTRACTION 83RUNNINGMETRICEXTRACTIONTASK 85
NEWRELICMEDIATOR 86
PRIMARYCONFIGURATION 86
Mediation Pack for multiple technologies - AppDynamics, Dynatrace, DCRUM, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM,NetIQ AppManager, New Relic and OracleOEM
vi
CHECKTHECONNECTION 88METRICCONFIGURATION 89RUNNINGMETRICEXTRACTIONTASK 90
ORACLEOEMMEDIATOR 92
PRIMARYCONFIGURATION 92CHECKTHECONNECTION 93METRICCONFIGURATION 95RUNNINGMETRICEXTRACTIONTASK 97
PREDICTIVEINSIGHTSOUTPUT 99
CSVFILEOUTPUT 99TIMESTAMPS 99CONFIGURINGPREDICTIVEINSIGHTSOUTPUT 99
PREDICTIVEINSIGHTS‘MODEL’FILES 101
GROUPINFORMATION 102METRICINFORMATION 102
MISCELLANEOUS 103
SEPARATEFILESBYPREDICTIVEINSIGHT’S‘GROUP’ 104TRANSFERRINGFILESFROMMEDIATORSTOPREDICTIVEINSIGHTS 104ADD‘SCADMIN’TO‘J9ACCELERATORS’GROUP 104CRONJOB 105LOGS 105REMOVINGAPPLICATIONSFROMMETRICEXTRACTIONSCOPE 106
SUPPORT 106
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
7
Overview
IBMOperationsAnalyticsPredictiveInsightsanalyzesdataandlearnsthenormalbehaviorofasystemthroughKPImetricdatastreams. This includesdata fromvarioussourcesincludingmetricsgatheredbyindustryperformanceandnetworkmonitoringsolutions.AmediationpackhelpsusersquicklyintegratetheKPIdatastreamsbyprovidingadefaultmodeltointegrateaparticularperformancemanager.
IBMOperationsAnalyticsPredictiveInsightsMediationPackforAppDynamics,Dynatrace,DCRum,Aternity,Splunk,CAAPM,ExtraHop,CAUIM,MFAPM,andNetIQAppManagerknownintherestofthisdocumentasthe‘MediationPack’,providesapre-builtmodelasa startingpoint to facilitate data ingestion. Predictive Insights creates a performancemodelthatitusestodetectorforecastbehavioroutsidethemodeledrange, includinggeneratinganalarmwhenananomalousbehavioroccurs.Doingsoenablesorganizationstopro-activelyavoidsystemandsolutionoutagesbeforeusersareimpacted.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
8
TheMediationPackprovidesthecapabilitytoextractperformancedataandmetricsfromthefollowingsources:
• AppDynamics• Dynatrace• DCRUM• Aternity• Splunk• CAAPM• ExtraHop• CAUIM• MFAPM(FormerlyHPAPM)• NetIQAppManager• NewRelic• OracleOEM
anddeliverthatdatatoIBMOperationsAnalyticsPredictiveInsightstoperformanalysis.Thisdocumentwill cover the installationand setupofMediationPack foreachof thesupportedsource-datatechnologies.Thefigureshowsanoverallviewofthemediationsolutionincontext.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
9
Prerequisite Information
Item Description
Name MediationPackforAppDynamics,Dynatrace,DCRum,Aternity,Splunk,CAAPM,ExtraHop,CAUIM,MFAPM,NetIQAppManager,NewRelic,OracleOEM
PredictiveInsightssupportedversions
V1.3.3,v1.3.5,v1.3.6andhigher.
PredictiveInsightsInformation
IBMOperationsAnalytics(demo,trial,resources)https://www.ibm.com/us-en/marketplace/it-operations-analyticsIBMOperationsAnalyticsCommunity(docs,videos,mediationpacks)https://developer.ibm.com/itoa/IBMOperationsAnalyticsPredictiveInsightsdocumentationhttps://www.ibm.com/support/knowledgecenter/SSJQQ3
SolutionNamesupportedversions
Minversion MaxVersion
Aternity 8.x 8.0.6
AppDynamics 4.1 4.2.8.0
DynatraceAppMon 6.3 6.5DynatraceDCRUM 12.3.2.40 12.4
Splunk 6.2 6.5.1CAAPM(Introscope) 9.x 10.5
ExtraHop 6.2 6.2
CAUIM 8.5.1 8.5.1MFAPM 9.x 9.x
NetIQAppManager 9.x 9.x
NewRelic 2.xRESTAPI 2xRESTAPIOracleOEM 12.x 13.x
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
10
SolutionNameInformation
MediationPackforAppDynamics,Dynatrace,DCRum,Aternity,Splunk,CAAPM,ExtraHop,CAUIM,MFAPM,NetIQAppManager,NewRelicandOracleOEM
Filename Spl_AppD_Dyna_Ater_MedPack_v1.4.0.zip
SupportedOperatingSystems
Linux-RHEL6,7
Java Java1.8+isrequired.ThisisavailablewhenPredictiveInsights136+isinstalled.IfPredictiveInsights135orearlierisused,thentheOracleserverJava1.8willneedtobeinstalledforusebytheMediators.
WebBrowsers AmodernHTML5/CSS3/Javascriptbrowser.VersionsofChrome,FirefoxorSafarisince2012shouldwork.Previousbrowserversionsmaynotworkwell,oratall.Note:SomeversionsofInternetExplorer(i.e.9orearlier)haveexhibitedissues.Pleaseconsideramoremodernbrowsertoensurefullfunctionalityoftheproduct.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
11
MediatorsOverviewThemetricdataflowisgenerallyfromacollectionmechanismknownasa‘Mediator’(or‘accelerator’)toaCoreoutputcomponentcalled‘PredictiveInsights’whichthenwritesmetricstostandardIBMOperationsAnalyticsPredictiveInsightsCSVfiles.WhilsteachMediatorrequiresconfigurationspecifictoitssource,allthedataflowsthroughtoanoutputstageknownasPredictiveInsights‘core’.Theconfigurationsapproachforeachofthesourceswillbedescribedinthisdocument.TheMediators,aspartoftheMediationpack,usuallywillbeinstalledonthesamehostasPredictiveInsights.ThismakesiteasiertodeliverthedatafromtheMediatorstoPredictiveInsights.IftheMediationpackisinstalledonadifferenthostthenmechanismsmustbeputinplacetoensurethatPredictiveInsightscangetatthatdatae.g.shareddiskdrives/NFS,FTP-typejobsrunonascheduletoretrievefiles.Howtoestablishsuchmechanismsisbeyondthescopeofthisdocument.
Key steps to setting up Mediators
• Installation
• Configure one or more ‘Mediators’ which extract the data from the supportedsources
• ConfigurethesingleCore‘PredictiveInsights’foroutput
• Startthedesiredmetricextraction‘tasks’foreachofthedatasources.ThisshouldresultinPredictiveInsightsCSVfilesbeingproduced
• ConfigurePredictiveInsightsforingestionusingits‘MediationTool’inthenormalway.SamplePredictiveInsights‘model’filesareprovidedasastartingpoint.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
12
InstallingandConfiguring
Zip file contents The file Spl_AppD_Dyna_Ater_MedPack_v1.4.0.zipcontainsthefollowing
• Spl_AppD_Dyna_Ater_MedPack_v1.4.0.rpm
• /docs containing the User Guide and a README.txt
• /license containing license files
Install procedure
New Installation ThefollowingsectionprovidesinformationforinstallingandconfiguringtheMediationPackonyourIBMOperationsAnalyticsPredictiveInsightssystem. Normal‘rpm’conventionsarefollowed.ThemediationpackinstallationcreatesaLinuxservicecalled‘j9accelerators’1. InstallJava
2. unzipSpl_AppD_Dyna_Ater_MedPack_v1.4.0.ziptoaccesstheRPMfile
3. Installtherpm“rpm-iSpl_AppD_Dyna_Ater_MedPack_v1.4.0.rpm”
4. Afterinstallation,anewservice,‘j9accelerators’shouldberunningasacontrolled
service.
5. Usechkconfigcommandtocontrolrunlevel,getstatus,start,stop:
chkconfig j9accelerators 0:off 1:off 2:on 3:on 4:on 5:on 6:off
6. Verifythatinstallationoccurredcorrectlybycheckingthesedirectoriesforcontent:
Installation Folders /var/log/j9accelerators /var/cache/j9accelerators /usr/share/j9accelerators
7. Themediators/accelerators are installed as Linux service and can be started andstoppedinthestandardwaye.g.
a. service j9accelerators start
b. service j9accelerators stop
c. service j9accelerators status
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
13
Upgrade installation 1. StoptheMediators
service j9accelerators stop
2. UnzipthepackagetoaccesstheRPMfiles
unzip Spl_AppD_Dyna_Ater_MedPack_v1.4.0.
3. Upgradetherpm
rpm -ivh -replacepkgs -replacefiles
Spl_AppD_Dyna_Ater_MedPack_v1.4.0.rpm
4. StarttheMediators
service j9accelerators start
Deployed directory contents
Themaindirectoriesarecreatedaspartoftheinstallation
/usr/share/j9accelerators/
/confVariousconfigfilesandthemainREADME.txt
ibm/docsUsersGuide(thisdocument)
ibm/licenseTextlicensefilesforgoverningtheuseoftheMediationpack.
ibm/pamodelCorefilesusedintheMediationPackrepresentingthePredictiveInsightsmodelconsistingofallattributesandmetricdefinitions.
/binExecutablesusedbyPack
/var/db/j9accelerators/Various‘database’(configuration)files
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
14
/var/cache/j9accelerators/Metricdataextractedtohere
/var/log/j9accelerators/Logfiles,usefulformonitoringanddebuggingsystembehavior
Java Mediators require Java JVM 1.8. Depending on which version of Predictive Insights you are using, you may have to carry out some additional Java JVM setup
Predictive Insights 1.3.3-1.3.5 PredictiveInsights1.3.3-1.3.5comeswithIBMJavaJVM1.7bundled.ThisisnotusablebytheMediatorscomponentandaseparateJavaJVM1.8willneedtobeavailableintheenvironmentforthe‘j9accelerators’user.TherecommendedJVMinthisiscaseis‘OracleServerJRE8’-availablefromOracle.Thefollowingisonewaytoachievethis:
• LocateanddownloadtheLinuxx64versiontotheserverhostingMediators/PI
• InstallthatJVMtoalocationthatisaccessiblebythe‘j9accelerators’usere.g.
/usr/jre/jdk1.8.0_131
• Theeditthej9acceleratorsstartupscript /usr/share/j9accelerators/bin/j9accelerators andsetJAVA_HOMEatthetopofthisscripttoenablethemediatorstolocatethedesiredJVM
• exportJAVA_HOME=/usr/jre/jdk1.8.0_131
Youshouldnowbeabletostartthemeditorintheusualwayie
• servicej9acceleratorsstart
Predictive Insights 1.3.6 or later
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
15
IfusingPredictiveInsights136+,thentheMediatorscanusetheIBMJVM1.8whichcomeswithPredictiveInsights.NofurtherJavasetupisrequired
Accessing the Mediation system Onceinstalled,youcaninteractwiththeMediationsystemviaweb-browser.Bydefault,theMediationsystemlistensonport7457,soforexample,pointyourweb-browsertohttp://<server>:7457
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
16
AppDynamicsMediator
Primary Configuration SelectMediatorsandthe‘Create’option:
Thenselectthedesired‘MediationPackType’.Inthiscase,AppDynamics,andprovideaninstancenamee.g.‘appd1’:
Thenpressthebutton‘CreateMediator’ThenewmediatorforAppDynamicswillbecreatedandyouwillbepresentedwiththemainconfigurationscreen.
SelectthecheckboxtoautomaticallystarttherepeatingmetriccollectiononMediatorStartUp.Thisisdesirableonceyouaresatisfiedthatyouhaveacorrectconfigurationinplace:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
17
FillintheAppDynamicscontrollerdetailsandcredentials:
NOTE:Onthisscreen,besuretoticktheboxforHTTPScommunicationsifneeded.SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.PredictiveInsightsCSVistheonlyoutputoption.
CacheRefreshScheduledoesnotapplyatthistime–ignore.AcceptthedefaultsettingsforThreadPoolConfiguration:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
18
ClickonConfiguretocompletetheconfiguration:
Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,credentials,routestotheAppDserveretc.
CheckConnectionSucceedediswhatyouareafter
Nowproceedtometricconfiguration.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
19
Auto-Configure Application
YouractualchoiceofmetricswilldependonwhatisavailableinyourupstreamAppDsystem.Thisnextsectionissimplyanexampleofhowtocarryoutsuchselection.Intheleftmenuclick[Do]andselect“Auto-ConfigureApplication”:
SelecttheApplicationthatyouwouldliketoAuto-Configureandclickthe[ChooseApplication]button:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
20
SelecttheTiersthatyouwouldliketoAuto-Configureandclickthe[ChooseTiers]button:
Youwillseetheresultofentriesaddedhighlightedingreenasshownbelow:
Running Metric extraction Task Note:priortorunningthemetricextraction,youshouldensurethatyou’veconfiguredPredictiveInsightsoutputfromthe‘Core’menu(SeeSection0)Underthemainmenus,select‘Tasks’andFetchMetrics
Choose‘Schedule’toschedulemetricextraction.Thescreenwillgiveyoudetailsonthetaskstatus.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
21
‘RunOnceNow’isusefulforinitialtestingtoconfirmthatyouaregettingsomedataout.
Removing applications from metric extraction scope
ToremovetheApplicationfromtheAccelerator,performthefollowingstepsfromwithintheAccelerator.ClickonDo->RemoveMetricPathsSelecttheapplicationthatyouwouldliketoremove.SelectalltheMetricPathsthatarelistedinMetricPathsToRemove.ClickRemovePathsiconatthebottom.ToverifyRemovalofApplicationclickonshow->metricchoicesandverifythattheapplicationthatwasremovedisnolongervisible.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
22
DynatraceMediator
Overview MetricextractionfromDynatraceisbasedupontheuseofDynatrace‘Dashboards’.SuchDashboardsareconfiguredwithinDynatraceandtheMediatorsselectandextractdatafromthosedashboards.TheMediationsystemexpectstofinddashboardsdefinedinthesourceDynatracesystemcontainingthemetricstobeextracted.FordetailsoncreatingsuchDynatraceDashboards,pleaseseetheDynatracedocumentation.AsampledashboardisprovidedwiththeMediationplatformtogetyoustarted(See0)
Mediator creation and configuration TocreateanewDynatracemediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
23
Fromthe[Do]SideMenu,select“Configure”.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
24
EntertheinformationforthedynaTraceControllerHost,ControllerPort,AccountName,Username,andPassword.
SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.TheMetricsOutputDestinationisfixed.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
25
TesttheconfigurationbyselectingCheck->RESTConnectionfromtheleftSideBar.
Iftheconnectionissuccessful,thefollowingwilldisplayonthescreenastheresultoftheRESTCheck.
Asmentionedabove,theMediatorexpectstofindadashboarddefinedinDynatrace,fromwhichtoextractmetricdata.Thisnextsectiondescribeshowtoinstallthesample‘PredictiveInsightsDashboard’.Ifyoualreadyhavesuchdashboardsinplace,thenskipoverthenextsection
Installing sample ‘Predictive Insights Dashboard’ NavigatetotheMediatorsinterfaceandthenclick‘dynaTrace’intheleftmenuoftheAccelerator’shomepageUI(inthiscase,bothanAppDynamicsanddynaTracemediatorisconfigured):
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
26
SelectthedynaTracemediatorinstanceandfromthere,select‘DynatraceDashboardforPredictiveInsightsanddownloadthedashboardzipfileandnotethelocation:
Then,toimportthedashboardintodynatrace,logintothedynaTraceClient,navigatetoDashboardopenoption,selectthesamplePredictiveInsightsDashboard,openit,thensaveittotheserver(seeDynatraceDocumentationfordetailsonimporting‘dashboards’).Hereistheapproach:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
27
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
28
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
29
Configuring Metric extraction using defined dynaTrace Dashboards OnceyouhavesuccessfullyconnectedtoDynatraceandconfirmedthatyouhaveadashboardwiththedesiredmetricsinplace,youcanconfigureMetricextraction.(Note,youwillnotsee‘SelectDashboard’optionbelowwithouthavingsuccessfullyconnected)
Selectthedesireddashboardsandsystemprofilestoextract
TheselectedDashboardsmovetotheright
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
30
RunmetricextractionTaskIntheleftpaneclick[Tasks]andthenclick[FetchMetrics].
WhentheTaskStatuscompletesforMetricsyouwillseeacountofmetricsinLastResultsasshownbelow.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
31
AternityMediator
Mediator creation and configuration TocreateaAternitymediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’
Select‘Aternity’intheMediationPackTypeandnametheinstance:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
32
Supplytheconfigurationdetails
ThemetricscheduleforAternityisfixed.
Thenpress
Check the connection
ValidatetheconnectiontoAternity‘Check->Connection’.Resultsshouldbesimilarto:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
33
Run metric extraction Task
SplunkMediator
Create new Splunk Mediator TocreateanewSplunkmediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’
Thenpress
Provideconfigurationinfo:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
34
Configurethedesiredmetricextractionschedule
Thenpress:
Check Connection Fromthemainmenu,‘Check’then‘Connection’:
Youshouldthenseesomethingsimilartothis
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
35
Select metrics and mappings ThebasicapproachisforthemetricextractiontoreferencepreviouslycreatedSplunk‘searches’,extractdatafromthoseandmapthatdatainspecifiedwaytokeyfieldsintheMediatorsflows.
ClickChooseSavedSearch
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
36
NowconfigurethedetailsofthatSavedSearchextraction.TheoverallapproachistoselectfieldsfromtheSplunkrecordsandindicatehowtheyaretobemappedtotheCSVfile.(Thefollowingaresimplyexamples.Theexactfieldsyouusewilldependonyoursituation/environment)
FirstselectthekeyHost&RunningSoftwarefields.
ThevaluesinthesefieldsareoutputtofieldsintheCSVfileasfollows
§ Host=>‘targetName’§ RunningSoftware=>‘Node’
ThenconfigurehowyouwanttotreatindividualfieldsfromtheincomingSplunkeventsandhowtomapthoseto‘metric’values.Here,forexampleyouareselectingwhichfieldsofdatafromthatsearchyouwanttoinclude,whatyouwantthemtorepresent(e.g.metricvalues),andwhichonesyouwanttoexcluded/ignore.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
37
ValuesmappedtoField#1-5willbemappedtofieldsField1Value,Field2ValueetcintheoutputCSVfiles.Leave(orchange)allremainingfieldsas‘Ignore’
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
38
Thenconfigure‘unit’sfortheselectedfields
Finally,savetheconfiguration,andyoushouldseesomethinglikethefollowing
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
39
Run metric extraction Task ScheduletheMetricCollectionTask
Youshouldseeinformationsimilartothis
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
40
DCRUMMediator
Primary Configuration NavigatetotheMediatorsinterfaceathttp://localhost:7457
SelectMediators>Create
SelectMediationPackType‘DCRUM’
andgiveitanappropriatenameClickCreateMediator.YoushouldthenbepresentedwiththeconfigurationscreenforDCRUMmediator.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
41
PopulatetheDCRUMCASServerHostwiththeCASServerFQDN
PopulatetheDCRUMCASServerPort
PopulatetheDCRUMCASServerUser
PopulatetheDCRUMCASServerPassword
PopulatetheOffsetPeriod
Note:TheOffsetPeriodshouldbesetto5minutes
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
42
Reviewtheconfiguration-yourconfigwilllikelybedifferent
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
43
NowvalidatetheconnectiontoDCRUMCheck>Connection
Thisshouldbetheresult
NowconfiguretheDCRUMmetrics.Click‘MetricsAutoConfiguration’fromtheDomentionoption:
Selectanavailableapplication(s)andclickSelectApplication(s)andcontinuetoTiers
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
44
Selectatier(s)andclickSelectTier(s)andcontinuetoServices
Selectasoftwareservice(s)andclickSelectService(s)andcontinuetoTransactions
Selectatransaction(s)andclickSelectTransaction(s)andcontinuetoMetrics
SelectatemplateandclickSelectTransaction(s)andcontinuetoMetrics
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
45
Reviewtheconfiguration
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
46
ClickShow>ConfiguredMetrics
ReviewtheConfiguredMetrics
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
47
Note:Changescanbemadetotheconfigurationusingtheeditlinkasnotedhere:
StartcollectingtheDCRUMmetrics.
ClickTasks>Metrics
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
48
Select‘Schedule’:
Enableautorefreshbyclicking‘TurnAuto-RefreshOn’
ConfirmdesiredTaskexecution:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
49
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
50
CAAPM(Introscope)Mediator
Overview CAAPMwasformerlyknownasWilyIntroscope.MetricextractionfromCAAPMisbaseduponconfiguringthesystemtoextractdataforspecificCAAPM‘Agents’and‘Metrics’
Mediator creation and configuration TocreateanewCAAPMmediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’
Provideanameforthenewinstance
Thenpress‘CreateMediator’
ThenewCAAPMmediatoriscreatedandyouarepresentedwiththemainconfigurationscreen.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
51
EntertheconnectioninformationfortheCAAPMHost
SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.TheMetricsOutputDestinationisfixed.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
52
TesttheconfigurationbyselectingCheck->ConnectionfromtheleftSideBar.
Iftheconnectionissuccessful,thefollowingwilldisplayonthescreenastheresultoftheconnectioncheck
Configuring Metric extraction MetricselectionfromCAAPMisbaseduponspecifyingHost,ProcessesandAgentsfollowedbyMetricselections.Firstgoto‘MetricsConfiguration’
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
53
TheMediatorwillquerytheCAAPMsystemtodeterminewhichHostisactivelymonitoring(ie,haverecentdatacollected).
Youthenpickthehost(s)youwhichtocollectfor,thosehostsmovefromthelefttotherightpanel.Youcande-selectbyclickingitemsontherightpanelandhavethemmoveback.Thepress‘SelectHost(s)andcontinuetoprocesses’buttonYouwillbepresentedwithalistofmonitoredprocessesfortheselectedhosts
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
54
Aswithhosts,selecttheprocessthatyouwanttoextractdatafor.ThenyougettoselecttheAgentsontheselectedprocesses
Finally,yougettoselectfromtheavailablemetricsbeingcollectedbythoseAgents
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
55
Press‘SelectMetricsandSave’
YoucandeleteHosts,Process,AgentsorMetricsbyclickingon‘edit’andyouwillbepresentedwithascreensuchas
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
56
RunmetricextractionTaskIntheleftpaneclick[Tasks]andthenclick[FetchMetrics]
Thenselect‘RunOnceNow’.WhentheTaskStatuscompletesforMetricsyouwillseeacountofmetricsinLastResultsasshownbelow.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
57
ExtraHopMediator
Overview ExtraHopmetricextractionisbasedupona‘Push’model,whereExtraHop,afterbeingappropriatelyconfigured,pushesdatatoMediator.ThisisincontrasttomostoftheotherMediatorswhichreachoutand‘Pull’datafromtheirrespectivesources.ThepushapproachrequirestheMediatortoinstallExtraHop‘Triggers’intotheExtraHopserverandtheconfigurationofanExtraHop‘OpenDataSource’(ODS)instancetofacilitatedeliveryofdatafromExtraHoptotheMediator.Onceinstalled,Triggersare‘assigned’tovarioussystemresourcestocollectdataandthen‘enabled’.BothassignmentandenablementrequireExtraHopadministrationsteps.WhendatamatchingtherequirementsoftheTriggersisfoundbyExtraHop,thatdataisdeliveredtotheTrigger,andfromtheresenttotheMediatoroverHTTPviatheODSmechanism.
Triggers,Assignments,ODSareExtraHopconceptsandthereaderisdirectedtotheExtraHopdocumentationfordetails.
Before you begin - ExtraHop pre-reqs
Inadditiontotheusualconnectivityinfo(e.g.host/port,accountname)youwillalsoneedandExtraHopAPIkeyforthedesignatedaccount.YourExtraHopadminshouldbeabletoprovideyouwiththiskey.ThiskeycanbegeneratedfromtheExtraHopAdministrationscreen:
Followedby
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
58
ThiskeywillbesuppliedtotheMediatorconfigurationtoenableittoaccesstheExtraHopRESTAPI(whichisusedtoinstallTriggersintotheExtraHopsystem)
Mediator creation and configuration TocreateanewCAAPMmediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’
Provideanameforthenewinstance
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
59
Thenpress‘CreateMediator’
Providetheconfigurationinformation.
InadditiontotheAPIkeywhichyoushouldalreadyhave,theODSDataFeedHTTPAuthUser/PasswordarethosetoallowRESTcallsontheMediator.Bydefaultthesearej9admin/j9admin.TheExtraHopserveruser/passwordisnotusedatthistime.
InthecaseofExtraHop,giventhePushofmetricsfromExtraHoptotheMediator,thisschedulesettingisessentiallyredundantandcanbeignored.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
60
Testtheconnectionintheusualway
Note:TheconnectioncheckismadeagainsttheRESTAPI,usingthesuppliedAPIkey.Iftheconnectionissuccessful,thefollowingwilldisplayonthescreenastheresultoftheconnectioncheck
Configuring Metric extraction
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
61
ExtraHop Open Data Stream Asmentionedintheoverview,Metricextractionisa‘push’model.AsetofTriggers(whichcollect,packageanddeliver)thedatamustbeinstalledintoExtraHop.ThedatafromsuchTriggersisdeliveredtoadestination,inourcase,Mediation,viaanExtraHopOpenDataStreamcomponent.ThismustbedefinedfortheconfiguredMediatorTodefineanOpenDataStreaminstance,gottotheExtraHopAdministrationpage:
From there :
Then ‘Add Target’
HereyouaresimplytellingExtraHophowtocommunicatewithadatadestination.Inthiscase,itwillbearunningMediatorinstance.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
62
Note,thataspartofthepathdefinition(underTestConfiguration/Options)youprovidetheMediatorinstancename-inourexampleweprovided‘all’,butifyougaveyourmediatoradifferentname,youmustprovidethatnameheretoo.“path”:“/accelerator/ExtraHop/all/data/metrics-feed”YoumustalsonamethisODSentrywiththemediatorname‘all’
TheTriggersdeployedbytheMediatorinstance(nextsection)willcommunicatewiththisODSviathatname.OnceyouverifysuccessfulconnectionTest,savethisODSinstance.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
63
ExtraHop Triggers Asmentionedintheoverview,Metricextractionisa‘push’model.AsetofTriggers(whichcollect,packageanddeliver)thedatamustbeinstalledintoExtraHop.Again,youmayrequireExtraHopadminassistanceforthis.FordetailsonExtraHopTriggersseeherehttps://docs.extrahop.com/current/extrahop-trigger-api/#overviewThesetoftriggerscurrentlydeployedcanbeviewedonExtraHopbynavigatingtothe‘Triggers’configpage
TheMediatorcomeswithanumberofpre-definedTriggerstosupporttheOut-of-the-Boxdatacollection.InstallthisintoExtraHopbyselecting‘DeployTriggers’
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
64
Ifsuccessful,youshouldsee
YoucanexaminethelistofTriggersinExtraHoptoo
Note:Bydefaultallinstalledtriggersare‘disabled’andtheyare‘Assigned’to‘All’InordertocollectdatathetriggersneedtobeselectivelyAssignedtoandtheyneedtobeenabled.BothoperationsrequiredExtraHopadministrationsteps.
Trigger Assignment
Trigger‘Assignment’istheExtraHopterminologyfordeterminingwhichentitiesintheenvironment/networkwillhavedatacollectedfromthem,andhaveitdeliveredtoTriggers.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
65
ThisiswelldescribedintheExtraHopdocumentatione.g.ghttps://docs.extrahop.com/current/walkthrough-trigger/Asasimpleexample,wegotoExtraHop‘Metrics’
ThenselectaDeviceGroup
Theafterselecting‘VMware’
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
66
andthenselect‘Assignments’(underManageGroup)fromtheupper-right.
ThenassigntheTriggersasdesired.Note:AssigningTriggers‘globally’isnotgenerallyagoodidea(forperformance/datavolumereasons).Usually,youwanttobemuchmoreselectiveaboutwhereyouarecollectingdatafrom.
Trigger Enablement OncetheTriggershavebeenassigned,thelaststepisto‘enable’them-thiswillcauseExtraHoptoroutedatatothemwhenitbecomesavailable.GototheTriggerviewerandselectthedesiredTriggere.g.andclick‘Enable’.
Metric Collection - Last points TheregularmetricpollingofotherMediatorsdoesnotapplytoExtraHop.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
67
MetriccollectioniscontrolledfromExtraHopviaassignmentandenablement.Tostopmetriccollection,‘disable’thetriggersasdesired.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
68
CAUIMMediatorNote: Prior to extracting metrics from CA UIM, you must download and deploy the webservices_rest package into your local archive. You can do this by going into the CA UIM admin console > Archive. Click on the webservices_rest package and go to Actions > Download to get the latest version. Once downloaded, click on the webservices_rest package again and go to Actions > Deploy.
Primary Configuration SelectMediatorsandthe‘Create’option:
Thenselectthedesired‘MediationPackType’.Inthiscase,CAUIM,andprovideaninstancenamee.g.‘cauim1’:
Thenpressthebutton‘CreateMediator’ThenewmediatorforCAUIMwillbecreatedandyouwillbepresentedwiththemainconfigurationscreen.
SelectthecheckboxtoautomaticallystarttherepeatingmetriccollectiononMediatorStartUp.Thisisdesirableonceyouaresatisfiedthatyouhaveacorrectconfigurationinplace:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
69
FillintheCAUIMcontrollerdetailsandcredentials:
NOTE:Onthisscreen,besuretoticktheboxforHTTPScommunicationsifneeded.SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.PredictiveInsightsCSVistheonlyoutputoption.
CacheRefreshScheduledoesnotapplyatthistime–ignore.AcceptthedefaultsettingsforThreadPoolConfiguration:
ClickonConfiguretocompletetheconfiguration:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
70
Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,credentials,routestotheAppDserveretc.
CheckConnectionSucceedediswhatyouareafter
Nowproceedtometricconfiguration.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
71
Configure Metric Selection
YouractualchoiceofmetricswilldependonwhatisavailableinyourupstreamCAUIMsystem.Thisnextsectionissimplyanexampleofhowtocarryoutsuchselection.Intheleftmenuclick[Do]andselect“MetricsConfiguration”:
SelecttheAvailable‘Devices’thatyouwouldliketoconfigureandclickthe[SelectDevice(s)andcontinuetoProbes]button(leaveblankifyouwantALL‘Devices’):
SelecttheProbe(s)ofinterestandclickthe[SelectProbe(s)andcontinuetoMetrics]button(leaveblankifyouwantALLProbes):
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
72
SelecttheMetric(s)ofinterestandclickthe[SelectMetricsandSave]button:
Youwillseetheresultofentriesaddedingreenasshownbelow:
Running Metric Extraction Task Note:priortorunningthemetricextraction,youshouldensurethatyou’veconfiguredPredictiveInsightsoutputfromthe‘Core’menu(SeeSection0)Underthemainmenus,select‘Tasks’andFetchMetrics
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
73
Choose‘Schedule’toschedulemetricextraction.Thescreenwillgiveyoudetailsonthetaskstatus.
‘RunOnceNow’isusefulforinitialtestingtoconfirmthatyouaregettingsomedataout.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
74
MicroFocusAPMMediatorMIcroFocus APM was formerly known as Hewlett-Packard (HP) APM
Primary Configuration SelectMediatorsandthe‘Create’option:
Thenselectthedesired‘MediationPackType’.Inthiscase,MFAPM,andprovideaninstancenamee.g.‘mfapm1’:
Thenpressthebutton‘CreateMediator’ThenewmediatorforMFAPMwillbecreatedandyouwillbepresentedwiththemainconfigurationscreen.
SelectthecheckboxtoautomaticallystarttherepeatingmetriccollectiononMediatorStartUp.Thisisdesirableonceyouaresatisfiedthatyouhaveacorrectconfigurationinplace:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
75
FillintheMFAPMcontrollerdetailsandcredentials:
NOTE:Onthisscreen,besuretoticktheboxforHTTPScommunicationsifneeded.SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.PredictiveInsightsCSVistheonlyoutputoption.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
76
CacheRefreshScheduledoesnotapplyatthistime–ignore.AcceptthedefaultsettingsforThreadPoolConfiguration:
ClickonConfiguretocompletetheconfiguration:
Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,credentials,routestotheMFAPMserveretc.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
77
CheckConnectionSucceedediswhatyouareafter
Nowproceedtoshowmetricsconfiguration.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
78
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
79
Running Metric Extraction Task Note:priortorunningthemetricextraction,youshouldensurethatyou’veconfiguredPredictiveInsightsoutputfromthe‘Core’menu(SeeSection0)Underthemainmenus,select‘Tasks’andFetchMetrics
Choose‘Schedule’toschedulemetricextraction.Thescreenwillgiveyoudetailsonthetaskstatus.
‘RunOnceNow’isusefulforinitialtestingtoconfirmthatyouaregettingsomedataout.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
80
NetIQAppManagerMediator
Primary Configuration Toconfigurethismediator,Select‘Mediators’,then‘Create’:
Then select ‘NetIQ AppManager’
Provide a name for the new Mediator. In this case, ‘all’, then press ‘Create Mediator’
The specify the essential connectivity parameters
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
81
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
82
Thenthedatapollinginterval
Savethisconfigurationbypressingthe‘Configure’button
Showtheconfiguration
NowChecktheconnectivity
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
83
Youshouldseeoutputsimilartothis
Configure Metric Extraction
Select the hosts
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
84
Then proceed to ‘Knowledge Scripts’ and make your selections
After you save you should see your selections presented in a table like this
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
85
Running metric extraction task
Then ‘Schedule’ the task and you should see output like
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
86
NewRelicMediator
Primary Configuration SelectMediatorsandthe‘Create’option:
Then select ‘New Relic’
Provide a name for the new Mediator. In this case, ‘all’, then press ‘Create Mediator’
The specify the essential connectivity parameters
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
87
You should generally have port 443 and HTTPS checked when using New Relic at api.newrelic.com
Unlike many of the other Accelerators, a username/password is not required here. You must supply an API key - typically from the New Relic website (e.g. newrelic.com) You should follow instructions as below (from New Relic) to obtain the API key
For further details on getting the key see the New Relic documentation:
https://docs.newrelic.com/docs/apis/rest-api-v2/getting-started/api-keys
Getthekey,andenteritintothe‘APIKeyforNewRelicRESTinterface’fielde.g.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
88
ClickonConfiguretocompletetheconfiguration:
Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,APIkey,routestotheNewRelicserver/APIetc.
CheckConnectionSucceedediswhatyouareafter
Nowproceedtometricconfiguration.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
89
Metric Configuration
Metricconfigurationdependsonhavingametadatamodel.InordertoestablishthisintheMediator,executetheRefreshCachecommand
Oncethecacheisrefreshed,youshouldseesomethinglike
Now,withametadatamodelinplaceyoucanproceedwithactualmetricselection.Afterasuccessful‘CheckConnection’and‘CacheRefresh’youwillsee‘MetricsConfiguration’addedtothe‘Do’menu.Select‘MetricsConfiguration’
Youarethenpresentedwithalistofavailableapplications
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
90
Choosetheapplicationsyouwishtocollectmetricsforandwhendone,press‘SelectApplications(s)andSave:
Atthebottomofthepageyouwillseetheselectedapplications.ThesystemwillextractALLmetricsforeachoftheseapplications.
Todeletethese,pressthe‘edit’inthetext,andselectapplicationsfordeletion.Toaddotherapplications,returntothe‘MetricsConfiguration’screenandaddmore.
Running Metric Extraction Task
Then ‘Schedule’ the task and you should see output like
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
91
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
92
OracleOEMMediator
Primary Configuration SelectMediatorsandthe‘Create’option:
Then select ‘Oracle OEM’
Provide a name for the new Mediator. In this case, ‘all’, then press ‘Create Mediator’
The specify the essential connectivity parameters :
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
93
Depending on the configuration/performance of your source Oracle OEM system, metric data may not be immediately available. The ‘Offset period’ setting allows you to look for slightly older data. In our system with the above configuration, at each data extraction poll, Mediators looks for data 15 minutes behind current time.
For performance reasons, it is often useful to have concurrent data extraction. Use the ‘Max DB Connection Currency’ to control this :
With the configuration show, the Mediators client will establish a JDBC connection pool and maintain up to 10 concurrent connections to the source Oracle OEM system.
ClickonConfiguretocompletetheconfiguration:
Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,APIkey,routestotheOracleOEMsystemetc.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
94
CheckConnectionSucceedediswhatyouareafter
Nowproceedtometricconfiguration.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
95
Metric Configuration
Metricconfigurationdependsonhavingametadatamodel.InordertoestablishthisintheMediator,executetheRefreshCachecommand
Oncethecacheisrefreshed,youshouldseesomethinglike
TargetsaretheOracleOEMentititieswhichhavemetricdataavailable.Now,withametadatamodelinplaceyoucanproceedwithactualmetricselection.Afterasuccessful‘CheckConnection’and‘CacheRefresh’youcanSelect‘MetricsConfiguration’
Youarethenpresentedwithalistofavailabletargets
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
96
Choosethetargetsyouwishtocollectmetricsforandwhendone,press‘SelectTarget(s)andcontinuetonextscreentoselectfromavailablemetriccollections:
Whenyouhaveselectedthedesiredmetriccollectionsforeachtarget,continuetometrics.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
97
Note:themetricse.g.‘Load’intheaboveexample,areactualgroupsofmetrics(theOracleOEMterminologyisfollowedhere).Selectthedesiredmetrics(groups)andsave.AtthebottomofthepageyouwillseetheselectedTargets,MetricCollectionsandMetrics.ThesystemwillextractALLmetricsforeachoftheseentries
Todeletethese,pressthe‘edit’inthetext,andselectentitiesfordeletion.Toaddothertargetsetc,returntothe‘MetricsConfiguration’screenandaddmoreinthesamemannerasabove.
Running Metric Extraction Task
Then ‘Schedule’ the task and you should see output like this :
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
98
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
99
PredictiveInsightsoutputAllmetricdataextractedisroutedtoa‘core’componentcalled‘PredictiveInsights’.ThiscomponentwilloutputstandardPredictiveInsightsCSVfilesinwhatisknownas‘skinny’or‘metric-names-in-data’format.Fordetailsonthenamingconventionsetcassociatedwiththesefiles,seethemainPredictiveInsightsdocumentation.
CSV file output Filesareoutputtoseparatedirectoriescorrespondingtoeachup-stream‘Mediator’.Thegeneralfilepathpatternisasfollows
$MediatorsDataHome/{mediator-type}/{mediator-instance-name}/metrics/ibm/ Forexample /var/cache/j9accelerators/appdynamics/appd1/metrics
Timestamps TimestampsonfilenamesandinthedataitselfareinUTCandfollowtheJavaSimpleDateFormatspec:
yyyyMMddHHmmss
Configuring Predictive Insights output
ThereisasinglesetofconfigurationoptionscontrollingallCSVoutputintendedforPredictiveInsights.Thisoutputisroutedtoseparatedirectories(perMediatorinstance)andfileclosureiscontrolledbythesesettings.Navigatetothisconfigurationbyselectingthe‘Cores’menuoption,andfromthedropdown.Selectthe‘PredictiveInsights’option:
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
100
Thenselectthe‘Configure’option
Youwillthenbepresentedwiththefollowing
Upstreamdatacollectioncanproceedattheirownrateandsothereisanexplicitcontrolheretogovernthetime-windowassociatedwiththefile.Asdataisextracteditiswrittentoaworkingfilecalled current.csv Whenthatfileis‘done’itwillbeclosedandrenamedtothePredictiveInsightsCSVfileconventiondescribedabove.Thereisawindowoftimeassociatedwiththecurrentfile.Asdataarrivesthesystemwritesittothecurrentfileaslongastheincomingdataiswithinthattimewindow.Whendataarrivesthatisoutsidethattimewindow(usually,
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
101
later),thesystemdeemsthecurrentfiletobe‘Done’,soitclosesit,renamesaccordingtotheconventionshownabove,andopensanewcurrentfileforthenewerdata.Typically,the‘MaxTimeWindowperPredictiveInsightsCSVfile’settingshouldbesettomatchthedownstreamPredictiveInsights‘aggregation’interval.Filesarealignedontime-boundariesso,forexample,witha5minwindowset,youwouldseefilesat00:00,00:05,00:10etcboundaries
PredictiveInsights‘model’filesAsamplePredictiveInsights‘model’fileissuppliedforeachofthesupporteddatasourcesandthesefilescanbeusedasastartingpointforconfiguringthePredictiveInsights‘MediationTool’.Thefilesarelocatedin
$MediatorsSharedHome/ibm/pamodel Forexample /usr/share/j9accelerators/ibm/pamodel/appdynamics.pamodel EachoneofthesefilescanbeloadedintothemediationtoolbycopyingtothePredictiveInsights‘MediationTool’workspaceandrelevantprojecte.g. cp /usr/share/j9accelerators/ibm/pamodel/appdynamics.pamodel ~/workspace/J9Integration/ Then,whenyourefreshtheviewintheMediationTool,youshouldseethenewpamodelalongsideanyothermodelsyoumayhavee.g.
Youmustcustomizetheusualitemse.g.FilePath,foryourparticularenvironment.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
102
Giventhatthedatais‘Skinny’,asinglegroup‘all’isdefinedineachmodelfilewithaninitialmappingforeachforthesupportedtechnologies.Theseareastartingpoint.Youwilllikelyhavetochangethemforyourparticulardeploymentcontext.Thefilecomeswithagroup‘all’defined.
Group information IfyounameyourMediatorinstance‘all’thenthatwillmatchthegroupdefinedinthemodelfile.However,ifyourmediationinstancehasanameotherthan‘all’,thenyou’llneedtocreateanewgroup,usingtheexampleoneasinitialguidance.Thisisthepreferredapproach.Analternative,istodirectlymodifythe‘group’aspectsofthesuppliedmodelfilebyeditingtheunderlyingXMLfile.Forexample,ifwewantedtohaveadifferentgroupforappdynamicsvi /home/scadmin/workspace/<myproject>/appdynamics.pamodel Locate and change the ‘all’ to your preferred group name <name>APPDYNAMICS</name> <groups> <name>all</name> <timestampKey> Alsolocateandedithereandsimilarlychange‘all’toyournewgroupname.
<sources><name>appdynamics-all</name><DataEntitySource>
Metric information
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
103
Thesetofactualmetricsishighlydependentonwhatdataisactuallyextractedfromthesourcesyouwillalsoneedtoaddthemetricnames.ThequickestwaytodothisistofirstusetheMediatorstoextractrepresentativesetofCSVfilesandfromthoseextractthemetricnamestoatextfile.ThenusethePredictiveInsightsMediationtooltoimportthosemetrics.Forexample,inatypicaloutputfilefromSplunk,youwouldhaveCSVfileswiththefollowingheader
#Timestamp,measurementValue,targetName,Node,measurementName,unit,Field1Value,Field2Value,Field3Value,Field4Value,Field5Value
‘measurementName’columnwouldcontainthemetricsnameswewant.SowewanttoprocessasetoftheseoutputCSVfiles,andextractmetricNamesfromthiscolumn
• Col#5forSplunk• Col#12forCAAPM• Col#4forExtraHop• Col#20forCAUIM• Col#3forMFAPM• Col#5forNetIQAPM• Col#5forOracleOEM-Note:OracleOEMcallsthis‘metricColumn’-wemaintainsame
convention.‘measurementName’inthiscaseismoreliketheusual‘group’indicator• Col#7forNewRelic• Coll#16fortheotherCSVfiles
Thefollowingwouldachievethiscd /path/to/CSV/files grep -v “Timestamp” *.csv | awk -F, ‘{print $5}’ | sort -u Youcandosimilarforeachoftheotherfiletypes,adjustingthecolumnnumberappropriatelytoselectthedesired‘metric’columnPipethisoutputtoafiletocreateafilesuitableforimportingviathe‘Addmetricsfromfile’button.
Miscellaneous
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
104
Separate files by Predictive Insight’s ‘group’ Ifyouwanttohavedatawrittentoseparate‘group’(seePredictiveInsightsdocumentationfordescriptionsofthis‘group’concept)filesforaparticularsourcethenyoumustcreateseparateMediatorinstances.Thiswillresultinfilesbeingroutedtoseparatedirectories,whichyoucanthenpullfromusingcommonmechanismssuchascron’dfilemv.
Transferring files from Mediators to Predictive Insights Mediatorfilesareinitiallyownedby‘j9accelerators’user/group.PredictiveInsightstypicallyrequiresscadmin:scadminownership.SharingfilesbetweentheseuserscanbeachievedthroughvariousLinuxmechanisms.Twopossibleapproachesaredescribedbelow,buthowbestachievethisdependsontheparticulardeploymentcontextandisbeyondthescopeofthisdocument.
Add ‘scadmin’ to ‘j9accelerators’ group Asroot,addscadmintoj9acceleratorsgroup
usermod -a -G j9accelerators scadmin Giveread/writepermissionstofilesforthegroupwhichnowincludesscadmin)
chmod -R g+w /var/cache/j9accelerators Ensurethatnewdirectoriesandfileswhicharecreatedarecreatedwiththedesiredaccesspermissions.Thiscommandwillsetthecorrectpermissionsonthedirectories,whichwillthenbeinheritedappropriatelybyfilescreatedwithinthosedirectories
find /var/cache/j9accelerators -type d -exec chmod 2775 {} \;
YoushouldalsoensurethatfilescreatedbyAcceleratorhaveappropriate‘write’permissionsfor‘thegroup’.Todothis,add‘umask2’asthesecondlastlineinthestartupprogramin/usr/share/j9accelerator/bin/j9accelerator.Thefinaltwolinesshouldlooklike
umask 2 run $”$@”
BothPredictiveInsightsandtheMediatorscanthenreadandwritefilesasneeded.Note:Youwillhavetologout/in(or‘suscadmin’)forthesechangestotakeeffectfromterminalsessionsand/orrestartthemediatorservice
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
105
Cron job CreateacronjobwhichrenamesthefilesonascheduleandthentransfersthemtoawaitingPredictiveInsights-specificdirectory(ownedbyscadmin).Forexample,puttingthefollowingtwolinesinascriptfile,andrunningviacronwouldachievethedesiredfilemovement./bin/chownscadmin:db2iadm1/var/cache/j9accelerators/appdynamics/appd1/metrics/ibm/appdynamics*.csv/bin/mv/var/cache/j9accelerators/appdynamics/appd1/metrics/ibm/appdynamics*.csv/home/scadmin/piData/appD1ThisismoreusefulinthecaseofremoteMediatorsinstallationwiththeneedtoretrievefilesonaschedule.
Logs Logsarewrittento /var/log/j9accelerators
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
106
Removing applications from metric extraction scope
ToremovetheApplicationfromtheAccelerator,performthefollowingstepsfromwithintheAccelerator.ClickonDo->RemoveMetricPathsSelecttheapplicationthatyouwouldliketoremove.SelectalltheMetricPathsthatarelistedinMetricPathsToRemove.ClickRemovePathsiconatthebottom.ToverifyRemovalofApplicationclickonshow->metricchoicesandverifythattheapplicationthatwasremovedisnolongervisible.
SupportTogetassistancefromtheIBMsupportteam,youmayopenaProblemManagementRecord(PMR).ThePMRneedstobeopenedforIBMOperationsAnalyticsPredictiveInsightsorIBMOperationsAnalyticsAdvanceInsightsindicatingthe“MediationPackforSolutionName”.DescribetheproblemencounteredprovidingthefollowinginformationthatmustbeattachedtothePMR:ProductName:IBMOperationsAnalyticsPredictiveInsightsorIBMOperationsAnalyticsAdvanceInsightsProductVersion:1.3.3orhigher<Productversion(s)onwhichyouareusingthisMediationPackMediationPack:MediationPackforSolutionNameMediationPackVersion:1.3.0Includethefollowing:• SampleextractedCSVfiles,whicharebeingingestedintoPredictiveInsights.• Datasourceconnectivitystatusscreenshot• Logfiles
o PredictiveInsightslogfiles($PI_HOME/log/topicname/)whentheproblemoccurredwhileusingthemediationpack.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
107
o Mediationpacklogfiles(/var/log/j9accelerators/*.log)• Runthe$PI_HOME/bin/collect.shandreturncollectedinfo• Ascreenshotoftheerrormessagethatisgeneratedwhileusingthemediation
pack.• Aspecificusecasescenario(s)whereproblemoccurredwhileusingthemediation
pack.
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
108
® © Copyright IBM Corporation 2017 IBM United States of America Produced in the United States of America US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
109
2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A.
Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information in softcopy form, the photographs and color illustrations might not be displayed. Copyright License This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. Privacy Policy Considerations IBM Software products, including software as service solutions, (“Software Offerings”) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user, or for other purposes. In many cases, no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering’s use of cookies is set forth below. Depending on the configuration that is deployed in the application server, this Software Offering may use session cookies for session management. These cookies can optionally be enabled or disabled, but disabling the cookies will also disable the functionality that they enable. See the application server documentation for additional information. Optionally, you can also use functionality, such as typeahead, to store data locally on the browser. The data that is stored locally could contain personally identifiable information: Data validation. If the configurations that are deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users by using cookies and other technologies, you should seek your own legal advice about any laws that are applicable to such data collection, including any requirements for notice and consent. For more information about the use of various technologies, including cookies, for these purposes, see IBM’s Privacy Policy at http://www.ibm.com/privacy and IBM's Online Privacy Statement at
Operations Analytics Predictive Insights - Mediation Pack for AppDynamics, Dynatrace, DCRum, Aternity, Splunk, CA APM, ExtraHop, CA UIM, MF APM, NetIQ AppManager, New Relic and Oracle OEM
110
http://www.ibm.com/privacy/details in the section entitled “Cookies, Web Beacons and Other Technologies” and the "IBM Software Products and Software-as-a-Service Privacy Statement" at http://www.ibm.com/software/info/product-privacy.
Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at www.ibm.com/legal/copytrade.shtml. J9 Technologies and the J9 Technologies logo are registered trademark and/or trademarks of J9 Technologies in various jurisdictions. Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and service names might be trademarks of IBM or other companies.