Page 1
World®’16
Hands-OnLab:SimplifyConfigurationwithCAApplicationPerformanceManagement(CAAPM)CommandCenter
GuenterGrossberger– Sr.EngineeringServicesArchitect- CATechnologiesAndreasReiss- Sr.PrincipalEngineeringServicesArchitect- CATechnologies
DO4X151L
DEVOPS– AGILEOPERATIONS
Page 2
2 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
©2016CA.Allrightsreserved.Alltrademarksreferencedhereinbelongtotheirrespectivecompanies.
Thecontentprovidedinthis CAWorld2016presentationisintendedforinformationalpurposesonlyanddoesnotformanytypeofwarranty. The informationprovidedbyaCApartnerand/orCAcustomerhasnotbeenreviewedforaccuracybyCA.
ForInformationalPurposesOnlyTermsofthisPresentation
Page 3
3 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Abstract
ThenewCAApplicationPerformanceManagement(CAAPM)CommandCentersimplifiestheadministrationofCAAPMinstallations.YoucancreateyouragentconfigurationintheCommandCenteruserinterface,selectfeatures,andaddextensionsfromtheCAAPMMarketplace.Finally,youcanpublishtheagentpackageyouhavecreatedtohundredsofagents.
GuenterGrossberger
AndreasReissCATechnologiesSr.PrincipalEngineeringServicesArchitects
CATechnologiesSr.EngineeringServicesArchitect
Page 4
4 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
CAAPMCOMMANDCENTERVISION
AGENTPACKAGESANDBUNDLES
Q&A
EXTENSIONSANDCAAPMMARKETPLACE
PACKAGEUPGRADESANDDYNAMICEXTENSIONS
LAB:UPDATEANDDEPLOYAGENTPACKAGE
1
2
3
4
5
6
Page 5
5 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAAPMCommandCenter:AgentPackagesandBundles
Page 6
6 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Recap:CommandCenterFocusAreas
§ CommandCentercanbedistilledinto4distinctareas
Diagnostics Health
ViewInformationaboutJavaagentsrunningwithintheenvironment
Remotelyfetchagentlogfilesandotherdiagnosticinformation
Packagediagnosticsforuploadtosupportticket
RemotelychangetheloglevelonasingleJavaagent
Deployment
Abilitytocreatetailoredpackages fordeploymenttoproductionsystems
PackagesexposedviaAPIforconsumptionby3rdpartydeploymenttools
Cloudbasedstoreforagentrelatedpackages:APMMarketplace
Configuration
Abilitytocreateconfigurationgroups
Createandenforceconfigurationpolicies
Supportfor‘hot’and‘cold’configuration
Audittrailofconfigurationchanges
Suggestadditionalmonitoringopportunities
Reviewthemonitoringoverheadoftheagents
Reportissues/errorswiththemonitoring
Suggestchangestothemonitoringtoreduceoverhead
Page 7
7 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Recap:Architecture
Page 8
8 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
WhatisaPackage?
Apackageisanarchive (ziportar)thatcontainsallofthematerialsrequiredtodeployanCAAPMJavaagent.Thisincludes:
§ AgentJAR
§ AgentprofileandPBDs
§ OthersupportJARsandbinaries
§ Installinstructions
Page 9
9 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
WhatisaPackage?
Apackageistailoredtotheenvironmentbeingmonitored
§ Applicationserver
§ Requiredmonitoringfunctionality
§ Specificmonitoringcapabilities
§ Specificinstallationrequirements
Apackageismadeupofoneormorebundles,eachofwhichrepresentsapieceoffunctionalityofferedbytheagent
Page 10
10 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
HowisaPackageBuilt?
Creatingapackageinvolvesusinga4stepwizardto
1. Definetheenvironment
2. Tailorthebundles
3. Tailortheconfiguration
4. Tailortheinstallationinstructions
Skippingsteps2-4willcreateadefaultpackagefortheselectedenvironment
Page 11
11 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
WhatDoesaBuiltPackageLookLike?
Apackageisaziportarfilethatexactlyresemblesanagentinstalldirectory,withtheusual‘wily’rootfolderAdditionalfilescreated:§ installInstructions.md – providestailoredinstructionson
howthispackageshouldbedeployed
§ manifest.txt – provideslistofbundlesused,togetherwithanypropertyoverrides
§ acc-master.pbl – usedtoprovideanexactlistofpbd filesincludedintheconfiguration
wily
core
config
tools
acc-master.pbl
IntroscopeAgent.profile
pbdfiles
hotdeploy
ext
manifest.txt
installInstructions.md
Agent.jar
common
connectors
logs
Page 12
12 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAAPMCommandCenterLab1:CreateanAgentPackage
Page 13
13 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CreateNewAgentPackage
2.ClickNew
1.ClickPackages
Page 14
14 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CreateNewAgentPackage
2.SelectOS
1.Enternameandcomment
3.Selectagentversion
4.EnterMOM/EM(optionalorlist)
5.ClickDone
Page 15
15 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CreateNewAgentPackage
Downloadlink
OOTBrequiredandrecommendedbundlesper
applicationserver
Version
Page 16
16 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CreateNewAgentPackage
Downloadlink
Installandconfigurationinstructions
Page 17
17 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAAPMCommandCenterLab2:CustomizeAgentPackage
Page 18
18 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CustomizeAgentPackage
1.Selectagentbundle
2.Click“EDIT”
Or“COPY”
Page 19
19 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CustomizeAgentPackage
Bundledescriptionanddependencyinformation
Bundlesareorganizedintofourcategories:
1. Core2. Environment3. Feature4. Custom
1.Selectbundle
3.Click“ConfigureBundles”
2.Click“ADD”
Page 20
20 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CustomizeAgentPackage
§ IntroscopeAgent.profileisbrokendownintobundles– EnterpriseManagerconnection– Javaagent– CommandCenter
– Browseragent– JMX– EJB
§ CommandCenterconstructspackageIntroscopeAgent.profilefrombundles
Page 21
21 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CustomizeAgentPackage
Changedpropertiesareshowninboldfont
Youcanadd,revertanddeleteyourownpropertieshere.
Descriptionandpropertiesareshown
perbundle
E.g.use“MathClient”asagentname
Enteracustomproperty
Custompropertiesaremarkedwiththestar
Page 22
22 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CustomizeAgentPackage
Youcanedittheinstallinstructionsaswell.
2.Click“DONE”whenyou’refinished
1.Click“InstallInstructions”
Textismarkdownsyntax(helpexplains
markdown!).
Page 23
23 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAAPMCommandCenterLab3:ImportBundlefromAPMMarketplace
Page 24
24 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Motivation
§ CAAPMisextensible
§ Therearemanyfieldextensionsoutthere– where?
§ CAAPMCommunity,github.com/CA-APM,colleagueslaptop,…
§ WehavestartedtomakeextensionsfullysupportedviaCASupport
§ CAAPMMarketplaceistheplacetofindallCAAPMextensions
§ http://marketplace.ca.com/apm
Page 25
25 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAAPMMarketplacehttp://marketplace.ca.com/apm
CAsupportedextension
Searchorselectcategory
Searchorselectcategory
• Agentextensions• EPAagentplugins/scripts• Examples
SSO:ca.com,Support,Communitieslogin
AllCAAPMextensionsarefree!
Page 26
26 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAAPMMarketplace
§ Afterorderingyouwillgettwoemails– Orderconfirmation– Downloadlink
§ DownloadedFile(ifAgentExtension)– <extension>-<version>-dist.tar.gz
e.g.spring-3.3.0-dist.tar.gz§ post-10.5/spring-3.3.0.tar.gz(agentbundle!)
§ pre-10.5/spring-3.3.0-pre-10.5.tar.gz(agentbundle!)
– ImportintoCommandCenter:ImportbuttoninCAPM10.5,copytoimportfolderinCAAPM10.2andCAAPM10.3
http://marketplace.ca.com/apm
Page 27
27 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImportExtensions
2.Click“IMPORT”andselectfile
1.Click“Bundles”
Page 28
28 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImportExtensions
Restartnecessary
Bundlewillappearinlist
Page 29
29 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAAPMCommandCenterLab4:DynamicExtensions
Page 30
30 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicExtensions
Newagentsub-directoriesTodeployandagentextension:
1. UseCommandCenteror2. Copyextensioninto$WILYHOME/deploy
Extensionwillbeextractedintoextensionsdirectory– Iftheextensionisdynamic(propertyin
bundle.json)§ Loadedversionofextensionisunloaded
§ Newversionofextensionisloaded§ Noapplicationserverrestartrequired
– Otherwiseonlyloadedonapplicationserverrestart
Oldagentextensions:core/config,core/ext
DropnewextensionsintodeployoruseACC
Newextensionsdirectory
Page 31
31 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicExtensions
Norestartnecessary
Bundlerequiresrestart
Dynamicextension
Old(pre-CAAPM10.5)extension,notdynamic
Page 32
32 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicExtensions
Dynamicextensions
Bundlerequiresrestart
Dynamicextension
Page 33
33 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicExtensions
Youcanpushachangedconfigurationtoagroupofagents(“NamedFilter”)directlyfromtheCommandCenterUI
Agentstatuswillshowifanagentneedstoberestarted
Page 34
34 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Thankyou.
Stayconnectedatcommunities.ca.com
Page 35
35 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DevOps– AgileOps
FormoreinformationonDevOps– AgileOps,pleasevisit:http://cainc.to/wYXSg6