mediation pack for multiple technologies - appdynamics ...€¦ · mediation pack for multiple...

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


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


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


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.


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.


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


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.


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.


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


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


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


15

IfusingPredictiveInsights136+,thentheMediatorscanusetheIBMJVM1.8whichcomeswithPredictiveInsights.NofurtherJavasetupisrequired

Accessing the Mediation system Onceinstalled,youcaninteractwiththeMediationsystemviaweb-browser.Bydefault,theMediationsystemlistensonport7457,soforexample,pointyourweb-browsertohttp://<server>:7457


16

AppDynamicsMediator

Primary Configuration SelectMediatorsandthe‘Create’option:

Thenselectthedesired‘MediationPackType’.Inthiscase,AppDynamics,andprovideaninstancenamee.g.‘appd1’:

Thenpressthebutton‘CreateMediator’ThenewmediatorforAppDynamicswillbecreatedandyouwillbepresentedwiththemainconfigurationscreen.

SelectthecheckboxtoautomaticallystarttherepeatingmetriccollectiononMediatorStartUp.Thisisdesirableonceyouaresatisfiedthatyouhaveacorrectconfigurationinplace:


17

FillintheAppDynamicscontrollerdetailsandcredentials:

NOTE:Onthisscreen,besuretoticktheboxforHTTPScommunicationsifneeded.SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.PredictiveInsightsCSVistheonlyoutputoption.

CacheRefreshScheduledoesnotapplyatthistime–ignore.AcceptthedefaultsettingsforThreadPoolConfiguration:


18

ClickonConfiguretocompletetheconfiguration:

Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,credentials,routestotheAppDserveretc.

CheckConnectionSucceedediswhatyouareafter

Nowproceedtometricconfiguration.


19

Auto-Configure Application

YouractualchoiceofmetricswilldependonwhatisavailableinyourupstreamAppDsystem.Thisnextsectionissimplyanexampleofhowtocarryoutsuchselection.Intheleftmenuclick[Do]andselect“Auto-ConfigureApplication”:

SelecttheApplicationthatyouwouldliketoAuto-Configureandclickthe[ChooseApplication]button:


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.


21

‘RunOnceNow’isusefulforinitialtestingtoconfirmthatyouaregettingsomedataout.

Removing applications from metric extraction scope

ToremovetheApplicationfromtheAccelerator,performthefollowingstepsfromwithintheAccelerator.ClickonDo->RemoveMetricPathsSelecttheapplicationthatyouwouldliketoremove.SelectalltheMetricPathsthatarelistedinMetricPathsToRemove.ClickRemovePathsiconatthebottom.ToverifyRemovalofApplicationclickonshow->metricchoicesandverifythattheapplicationthatwasremovedisnolongervisible.


22

DynatraceMediator

Overview MetricextractionfromDynatraceisbasedupontheuseofDynatrace‘Dashboards’.SuchDashboardsareconfiguredwithinDynatraceandtheMediatorsselectandextractdatafromthosedashboards.TheMediationsystemexpectstofinddashboardsdefinedinthesourceDynatracesystemcontainingthemetricstobeextracted.FordetailsoncreatingsuchDynatraceDashboards,pleaseseetheDynatracedocumentation.AsampledashboardisprovidedwiththeMediationplatformtogetyoustarted(See0)

Mediator creation and configuration TocreateanewDynatracemediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’


23

Fromthe[Do]SideMenu,select“Configure”.


24

EntertheinformationforthedynaTraceControllerHost,ControllerPort,AccountName,Username,andPassword.

SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.TheMetricsOutputDestinationisfixed.


25

TesttheconfigurationbyselectingCheck->RESTConnectionfromtheleftSideBar.

Iftheconnectionissuccessful,thefollowingwilldisplayonthescreenastheresultoftheRESTCheck.

Asmentionedabove,theMediatorexpectstofindadashboarddefinedinDynatrace,fromwhichtoextractmetricdata.Thisnextsectiondescribeshowtoinstallthesample‘PredictiveInsightsDashboard’.Ifyoualreadyhavesuchdashboardsinplace,thenskipoverthenextsection

Installing sample ‘Predictive Insights Dashboard’ NavigatetotheMediatorsinterfaceandthenclick‘dynaTrace’intheleftmenuoftheAccelerator’shomepageUI(inthiscase,bothanAppDynamicsanddynaTracemediatorisconfigured):


26

SelectthedynaTracemediatorinstanceandfromthere,select‘DynatraceDashboardforPredictiveInsightsanddownloadthedashboardzipfileandnotethelocation:

Then,toimportthedashboardintodynatrace,logintothedynaTraceClient,navigatetoDashboardopenoption,selectthesamplePredictiveInsightsDashboard,openit,thensaveittotheserver(seeDynatraceDocumentationfordetailsonimporting‘dashboards’).Hereistheapproach:


27


28


29

Configuring Metric extraction using defined dynaTrace Dashboards OnceyouhavesuccessfullyconnectedtoDynatraceandconfirmedthatyouhaveadashboardwiththedesiredmetricsinplace,youcanconfigureMetricextraction.(Note,youwillnotsee‘SelectDashboard’optionbelowwithouthavingsuccessfullyconnected)

Selectthedesireddashboardsandsystemprofilestoextract

TheselectedDashboardsmovetotheright


30

RunmetricextractionTaskIntheleftpaneclick[Tasks]andthenclick[FetchMetrics].

WhentheTaskStatuscompletesforMetricsyouwillseeacountofmetricsinLastResultsasshownbelow.


31

AternityMediator

Mediator creation and configuration TocreateaAternitymediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’

Select‘Aternity’intheMediationPackTypeandnametheinstance:


32

Supplytheconfigurationdetails

ThemetricscheduleforAternityisfixed.

Thenpress

Check the connection

ValidatetheconnectiontoAternity‘Check->Connection’.Resultsshouldbesimilarto:


33

Run metric extraction Task

SplunkMediator

Create new Splunk Mediator TocreateanewSplunkmediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’

Thenpress

Provideconfigurationinfo:


34

Configurethedesiredmetricextractionschedule

Thenpress:

Check Connection Fromthemainmenu,‘Check’then‘Connection’:

Youshouldthenseesomethingsimilartothis


35

Select metrics and mappings ThebasicapproachisforthemetricextractiontoreferencepreviouslycreatedSplunk‘searches’,extractdatafromthoseandmapthatdatainspecifiedwaytokeyfieldsintheMediatorsflows.

ClickChooseSavedSearch


36

NowconfigurethedetailsofthatSavedSearchextraction.TheoverallapproachistoselectfieldsfromtheSplunkrecordsandindicatehowtheyaretobemappedtotheCSVfile.(Thefollowingaresimplyexamples.Theexactfieldsyouusewilldependonyoursituation/environment)

FirstselectthekeyHost&RunningSoftwarefields.

ThevaluesinthesefieldsareoutputtofieldsintheCSVfileasfollows

§ Host=>‘targetName’§ RunningSoftware=>‘Node’

ThenconfigurehowyouwanttotreatindividualfieldsfromtheincomingSplunkeventsandhowtomapthoseto‘metric’values.Here,forexampleyouareselectingwhichfieldsofdatafromthatsearchyouwanttoinclude,whatyouwantthemtorepresent(e.g.metricvalues),andwhichonesyouwanttoexcluded/ignore.


37

ValuesmappedtoField#1-5willbemappedtofieldsField1Value,Field2ValueetcintheoutputCSVfiles.Leave(orchange)allremainingfieldsas‘Ignore’


38

Thenconfigure‘unit’sfortheselectedfields

Finally,savetheconfiguration,andyoushouldseesomethinglikethefollowing


39

Run metric extraction Task ScheduletheMetricCollectionTask

Youshouldseeinformationsimilartothis


40

DCRUMMediator

Primary Configuration NavigatetotheMediatorsinterfaceathttp://localhost:7457

SelectMediators>Create

SelectMediationPackType‘DCRUM’

andgiveitanappropriatenameClickCreateMediator.YoushouldthenbepresentedwiththeconfigurationscreenforDCRUMmediator.


41

PopulatetheDCRUMCASServerHostwiththeCASServerFQDN

PopulatetheDCRUMCASServerPort

PopulatetheDCRUMCASServerUser

PopulatetheDCRUMCASServerPassword

PopulatetheOffsetPeriod

Note:TheOffsetPeriodshouldbesetto5minutes


42

Reviewtheconfiguration-yourconfigwilllikelybedifferent


43

NowvalidatetheconnectiontoDCRUMCheck>Connection

Thisshouldbetheresult

NowconfiguretheDCRUMmetrics.Click‘MetricsAutoConfiguration’fromtheDomentionoption:

Selectanavailableapplication(s)andclickSelectApplication(s)andcontinuetoTiers


44

Selectatier(s)andclickSelectTier(s)andcontinuetoServices

Selectasoftwareservice(s)andclickSelectService(s)andcontinuetoTransactions

Selectatransaction(s)andclickSelectTransaction(s)andcontinuetoMetrics

SelectatemplateandclickSelectTransaction(s)andcontinuetoMetrics


45

Reviewtheconfiguration


46

ClickShow>ConfiguredMetrics

ReviewtheConfiguredMetrics


47

Note:Changescanbemadetotheconfigurationusingtheeditlinkasnotedhere:

StartcollectingtheDCRUMmetrics.

ClickTasks>Metrics


48

Select‘Schedule’:

Enableautorefreshbyclicking‘TurnAuto-RefreshOn’

ConfirmdesiredTaskexecution:


49


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.


51

EntertheconnectioninformationfortheCAAPMHost

SelecttheMetricsSchedule.TheMetricsScheduleistypicallythesameasthedownstreamPredictiveInsightsaggregationinterval.TheMetricsOutputDestinationisfixed.


52

TesttheconfigurationbyselectingCheck->ConnectionfromtheleftSideBar.

Iftheconnectionissuccessful,thefollowingwilldisplayonthescreenastheresultoftheconnectioncheck

Configuring Metric extraction MetricselectionfromCAAPMisbaseduponspecifyingHost,ProcessesandAgentsfollowedbyMetricselections.Firstgoto‘MetricsConfiguration’


53

TheMediatorwillquerytheCAAPMsystemtodeterminewhichHostisactivelymonitoring(ie,haverecentdatacollected).

Youthenpickthehost(s)youwhichtocollectfor,thosehostsmovefromthelefttotherightpanel.Youcande-selectbyclickingitemsontherightpanelandhavethemmoveback.Thepress‘SelectHost(s)andcontinuetoprocesses’buttonYouwillbepresentedwithalistofmonitoredprocessesfortheselectedhosts


54

Aswithhosts,selecttheprocessthatyouwanttoextractdatafor.ThenyougettoselecttheAgentsontheselectedprocesses

Finally,yougettoselectfromtheavailablemetricsbeingcollectedbythoseAgents


55

Press‘SelectMetricsandSave’

YoucandeleteHosts,Process,AgentsorMetricsbyclickingon‘edit’andyouwillbepresentedwithascreensuchas


56

RunmetricextractionTaskIntheleftpaneclick[Tasks]andthenclick[FetchMetrics]

Thenselect‘RunOnceNow’.WhentheTaskStatuscompletesforMetricsyouwillseeacountofmetricsinLastResultsasshownbelow.


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


58

ThiskeywillbesuppliedtotheMediatorconfigurationtoenableittoaccesstheExtraHopRESTAPI(whichisusedtoinstallTriggersintotheExtraHopsystem)

Mediator creation and configuration TocreateanewCAAPMmediator,navigatetotheMediatormainmenuathttp://<mediationserver>:7457andselect‘Mediators;andthen‘Create’

Provideanameforthenewinstance


59

Thenpress‘CreateMediator’

Providetheconfigurationinformation.

InadditiontotheAPIkeywhichyoushouldalreadyhave,theODSDataFeedHTTPAuthUser/PasswordarethosetoallowRESTcallsontheMediator.Bydefaultthesearej9admin/j9admin.TheExtraHopserveruser/passwordisnotusedatthistime.

InthecaseofExtraHop,giventhePushofmetricsfromExtraHoptotheMediator,thisschedulesettingisessentiallyredundantandcanbeignored.


60

Testtheconnectionintheusualway

Note:TheconnectioncheckismadeagainsttheRESTAPI,usingthesuppliedAPIkey.Iftheconnectionissuccessful,thefollowingwilldisplayonthescreenastheresultoftheconnectioncheck

Configuring Metric extraction


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.


62

Note,thataspartofthepathdefinition(underTestConfiguration/Options)youprovidetheMediatorinstancename-inourexampleweprovided‘all’,butifyougaveyourmediatoradifferentname,youmustprovidethatnameheretoo.“path”:“/accelerator/ExtraHop/all/data/metrics-feed”YoumustalsonamethisODSentrywiththemediatorname‘all’

TheTriggersdeployedbytheMediatorinstance(nextsection)willcommunicatewiththisODSviathatname.OnceyouverifysuccessfulconnectionTest,savethisODSinstance.


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’


64

Ifsuccessful,youshouldsee

YoucanexaminethelistofTriggersinExtraHoptoo

Note:Bydefaultallinstalledtriggersare‘disabled’andtheyare‘Assigned’to‘All’InordertocollectdatathetriggersneedtobeselectivelyAssignedtoandtheyneedtobeenabled.BothoperationsrequiredExtraHopadministrationsteps.

Trigger Assignment

Trigger‘Assignment’istheExtraHopterminologyfordeterminingwhichentitiesintheenvironment/networkwillhavedatacollectedfromthem,andhaveitdeliveredtoTriggers.


65

ThisiswelldescribedintheExtraHopdocumentatione.g.ghttps://docs.extrahop.com/current/walkthrough-trigger/Asasimpleexample,wegotoExtraHop‘Metrics’

ThenselectaDeviceGroup

Theafterselecting‘VMware’


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.


67

MetriccollectioniscontrolledfromExtraHopviaassignmentandenablement.Tostopmetriccollection,‘disable’thetriggersasdesired.


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.


Thenselectthedesired‘MediationPackType’.Inthiscase,CAUIM,andprovideaninstancenamee.g.‘cauim1’:

Thenpressthebutton‘CreateMediator’ThenewmediatorforCAUIMwillbecreatedandyouwillbepresentedwiththemainconfigurationscreen.



69

FillintheCAUIMcontrollerdetailsandcredentials:





70

Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,credentials,routestotheAppDserveretc.




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):


72

SelecttheMetric(s)ofinterestandclickthe[SelectMetricsandSave]button:

Youwillseetheresultofentriesaddedingreenasshownbelow:

Running Metric Extraction Task Note:priortorunningthemetricextraction,youshouldensurethatyou’veconfiguredPredictiveInsightsoutputfromthe‘Core’menu(SeeSection0)Underthemainmenus,select‘Tasks’andFetchMetrics


73




74

MicroFocusAPMMediatorMIcroFocus APM was formerly known as Hewlett-Packard (HP) APM


Thenselectthedesired‘MediationPackType’.Inthiscase,MFAPM,andprovideaninstancenamee.g.‘mfapm1’:

Thenpressthebutton‘CreateMediator’ThenewmediatorforMFAPMwillbecreatedandyouwillbepresentedwiththemainconfigurationscreen.



75

FillintheMFAPMcontrollerdetailsandcredentials:



76



Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,credentials,routestotheMFAPMserveretc.


77


Nowproceedtoshowmetricsconfiguration.


78


79

Running Metric Extraction Task Note:priortorunningthemetricextraction,youshouldensurethatyou’veconfiguredPredictiveInsightsoutputfromthe‘Core’menu(SeeSection0)Underthemainmenus,select‘Tasks’andFetchMetrics




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


81


82

Thenthedatapollinginterval

Savethisconfigurationbypressingthe‘Configure’button

Showtheconfiguration

NowChecktheconnectivity


83

Youshouldseeoutputsimilartothis

Configure Metric Extraction

Select the hosts


84

Then proceed to ‘Knowledge Scripts’ and make your selections

After you save you should see your selections presented in a table like this


85

Running metric extraction task

Then ‘Schedule’ the task and you should see output like


86

NewRelicMediator


Then select ‘New Relic’


The specify the essential connectivity parameters


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.


88


Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,APIkey,routestotheNewRelicserver/APIetc.




89

Metric Configuration

Metricconfigurationdependsonhavingametadatamodel.InordertoestablishthisintheMediator,executetheRefreshCachecommand

Oncethecacheisrefreshed,youshouldseesomethinglike

Now,withametadatamodelinplaceyoucanproceedwithactualmetricselection.Afterasuccessful‘CheckConnection’and‘CacheRefresh’youwillsee‘MetricsConfiguration’addedtothe‘Do’menu.Select‘MetricsConfiguration’

Youarethenpresentedwithalistofavailableapplications


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


91


92

OracleOEMMediator


Then select ‘Oracle OEM’


The specify the essential connectivity parameters :


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.


Check the connection Nowconfirmbasicconnectivity.Thismustsucceedbeforeproceeding.Ifyoucannotconnect,checkalltheusualthings,APIkey,routestotheOracleOEMsystemetc.


94




95

Metric Configuration

Metricconfigurationdependsonhavingametadatamodel.InordertoestablishthisintheMediator,executetheRefreshCachecommand

Oncethecacheisrefreshed,youshouldseesomethinglike

TargetsaretheOracleOEMentititieswhichhavemetricdataavailable.Now,withametadatamodelinplaceyoucanproceedwithactualmetricselection.Afterasuccessful‘CheckConnection’and‘CacheRefresh’youcanSelect‘MetricsConfiguration’

Youarethenpresentedwithalistofavailabletargets


96

Choosethetargetsyouwishtocollectmetricsforandwhendone,press‘SelectTarget(s)andcontinuetonextscreentoselectfromavailablemetriccollections:

Whenyouhaveselectedthedesiredmetriccollectionsforeachtarget,continuetometrics.


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 :


98


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:


100

Thenselectthe‘Configure’option

Youwillthenbepresentedwiththefollowing

Upstreamdatacollectioncanproceedattheirownrateandsothereisanexplicitcontrolheretogovernthetime-windowassociatedwiththefile.Asdataisextracteditiswrittentoaworkingfilecalled current.csv Whenthatfileis‘done’itwillbeclosedandrenamedtothePredictiveInsightsCSVfileconventiondescribedabove.Thereisawindowoftimeassociatedwiththecurrentfile.Asdataarrivesthesystemwritesittothecurrentfileaslongastheincomingdataiswithinthattimewindow.Whendataarrivesthatisoutsidethattimewindow(usually,


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.


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


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


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


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


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.


107

o Mediationpacklogfiles(/var/log/j9accelerators/*.log)• Runthe$PI_HOME/bin/collect.shandreturncollectedinfo• Ascreenshotoftheerrormessagethatisgeneratedwhileusingthemediation

pack.• Aspecificusecasescenario(s)whereproblemoccurredwhileusingthemediation

pack.


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


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


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.

mediation pack for multiple technologies - appdynamics ...€¦ · mediation pack for multiple...

Documents