Hands-On Lab: Application Performance Management Command Center: Automate Monitoring Management With APIs Nik Jain Josh Napier DevOps: Agile Ops CA Technologies Sr. Principal Consultant DO5X236L @TwitterHandle #CAWorld
Apr 13, 2017
Hands-On Lab: Application Performance Management Command Center: Automate Monitoring Management With APIs
Nik JainJosh Napier
DevOps: Agile Ops
CA Technologies
Sr. Principal Consultant
DO5X236L
@TwitterHandle
#CAWorld
2 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
© 2015 CA. All rights reserved. All trademarks referenced herein belong to their respective companies.
The content provided in this CA World 2015 presentation is intended for informational purposes only and does not form any type of
warranty. The information provided by a CA partner and/or CA customer has not been reviewed for accuracy by CA.
For Informational Purposes Only
Terms of this Presentation
3 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
AbstractEnterprises with complex, large-scale environments manage hundreds of Application Performance Management (APM) agents in highly dynamic environments and are great candidates for the advantages offered by automation. CA APM Command Center features new APIs that can be easily integrated with scripts to connect with deployment tools such as Chef, Puppet and CA's own Release Automation. Learn how to harness these API's to simplify the management of APM agents.
Nik Jain,
Josh Napier
CA Technologies
Sr. Principal Consultant
4 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Agenda
APM COMMAND CENTER OVERVIEW
PUBLIC RESTful API
SAMPLE USE CASES
HANDS ON LAB
1
2
3
4
6 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
The Purpose
A key problem that APM Customers have is managing their APM
Infrastructure
The biggest pain point are APM Agents as there can be up to
20,000 agents in an environment
Whenever a customers needs to investigate a problem with an
individual APM Agent itself, it requires logging into the server,
pulling files, etc.
APM Command Center solves this problem by providing a
central console to manage all the APM Agents in a customers
environment
7 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Vision
Release 1.0 will provided:– Agent inventory information
– Diagnostic Capabilities
– Ability to change the Log Level on an Agent
Release 1.1 provides:– Public RESTful API
– Remote configuration capabilities via remote file push in the RESTful API
– Enhanced Search Capabilities
– Remote Controller Upgrade
Vision for future releases is to expand Remote Configuration capabilities and add Deployment, and Health capabilities
DiagnosticsView Information about Java Agents running within the environment.
Remotely fetch Agent Log Files and other diagnostic information.
Package diagnostics for upload to support ticket.
Remotely change Log Level on single Java Agent.
8 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Architecture
APM 9.x/10.x
Java Agent
UI (Web Based)
Dis
cove
ry
Exte
nsi
on
Configuration Server
Embedded ActiveMQ Broker
Embedded Jetty RESTful API
Agent Controller
Discovery
Log Files
Set Log Level
Plugins
Dedicated Server
ApplicationServer
Applicationbeing monitored
H2
HTTP
HTTP(S)
Local Socket
Lucene
3rd Party Client
10 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Public RESTful API
ACC 1.1 has a Public RESTful API that can be called within scripts to drive automation
The endpoint for the Public RESTful API is http[s]://[hostname]:[port]/apm/acc
Authentication to the RESTful API is via two mechanisms:
– Form (cookie) based authentication (i.e. what the UI uses)
– Token based authentication using bearer tokens
Token based authentication (generated via UI) should be used when using the RESTful API for
automation (e.g. calling via a script)
The token value should then be used in an HTTP header named “Authorization” and prefixed
by “Bearer ”. Example: Bearer 15ae560f-c1ce-4553-b4ed-7dc0df1280fd
About and exposed resources
11 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Public RESTful API - Exposed Resources
Name Description
agent A list of managed agents, including their properties.
agentUpdateTask Ability to modify the log level of an individual agent.
diagnosticReport A list of diagnostic reports, including the ability to download the reports.
diagnosticReportTask Provides the ability to generate a new diagnostic report for an agent.
controller A list of Agent Controllers connected to the Configuration Server.
controllerUpgradeTask Provides the ability to remotely upgrade Agent Controllers.
agentFileOperationTask Provides the ability to push (or delete) a file to a directory on a remote system.
file A list of files stored on the Configuration Server.
auditRecord A list of audit records associated with operations that change the environment.
12 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Public RESTful API - Diagrammatic Workflow
1. User logs into UI using username/ password and requests a Token
2. Token is returned to user and a hash (using SHA-256) written to the DB
3. User copies token into Automation Script
4. Script connects to API using Token
5. Token Hash is compared against Hash stored in DB in order to confirm identity
13 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Sample Use Cases
Use Case Description
Agent Log Level Automate handling of log levels of APM Agents matching certain criteria.
Agent Diagnostics Automate download of agent diagnostic reports.
File Copy Copy File(s) to agents. Examples of such files may include PBD’s, PBL’s, etc.
Delete File Remove files from agents. Examples include PBD’s, PBL’s, etc.
Upgrade Controllers Automate upgrading ACC controllers on remote systems.
15 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Recommended Sessions
SESSION # TITLE DATE/TIME
D05T07S Vision and Roadmap: CA Application Performance Management Roadmap - Driving Toward E.P.I.C. APM
11/18/2015 at 2:00pm
D05X201STechnology Primer: Closing the DevOps Loop by Integrating CA Application Performance Management and Jenkins
11/19/2015 at 3:00 PM
DO5X193SCustomize CA Application Performance Management with Tips for Using the CA Application Performance Management Open APIs
11/19/2015 at 4:30 pm
16 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Must See Demos
Application Performance Management and DevOps, featuring APM use in preproduction scenarios
Application Performance Management
Theater 5
Application Performance Management, Modern Monitoring, featuring the new APM Team Center
Application Performance Management
Theater 5
Ensuring a “5 star” mobile app experience with CA Mobile App Analytics
Mobile App Analytics
Theater 5
Unified Monitoring: APM Integrations including UIM
Application Performance Management
Theater 5
17 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
Follow On Conversations At…
Smart Bar
Application Performance Management
Theater 5
Tech Talks
Application Performance Management
Theater 5
19 © 2015 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
For More Information
To learn more, please visit:
http://cainc.to/Nv2VOe
CA World ’15