hands-on lab: application performance management command center: automate monitoring management with...

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


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


Agenda

APM COMMAND CENTER OVERVIEW

PUBLIC RESTful API

SAMPLE USE CASES

HANDS ON LAB

1

2

3

4

APM Command Center Overview


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


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.


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

Public RESTful API


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


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.


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


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.

Hands-on Lab


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


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


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


Theater 5


Follow On Conversations At…

Smart Bar


Theater 5

Tech Talks


Theater 5


For More Information

To learn more, please visit:

http://cainc.to/Nv2VOe

CA World ’15

http://cainc.to/Nv2VOe

http://bit.ly/1wbjjqX