Pre-Con Ed: Build Your Own Apps for an Enhanced Network Management Experience with the CA Performance Management Open API

World®
’16
Build Your Own Apps for an
Enhanced Network Management
Experience with the CA Performance
Management Open API
Jason Normandin, Sr. Principal Product Manager, CA Technologies
Bernard Clairmont, Sr. Principal Consultant, CA Technologies
DO4X70E
DEVOPS – AGILE OPERATIONS

2 © 2016 CA. ALL RIGHTS RESERVED.@CAWORLD #CAWORLD
© 2016 CA. All rights reserved. All trademarks referenced herein belong to their respective companies.
The content provided in this CA World 2016 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

Abstract
Get your data, your way with the CA
Performance Management open API. Learn the
framework to create simple apps that can
provide your users with new visualizations into
your performance data. Using simple drag-and-
drop and the CA Performance Management
open API, you can make advanced operations
simple and innovate new ways for your business
partners and customers to consume data. This
hands-on lab session will prove you don’t have
to be a developer to be successful at building
your own integrations and applications with CA
Performance Management open API.
Jason
Normandin
Sr. Principal Product
Manager
CA Technologies
Bernard
Clairmont
CA Technologies
Sr. Principal Consultant

Agenda
CA PERFORMANCE MANAGEMENT OPENAPI – AN ECOSYSTEM
OPENAPI APP – BASICS AND DATA FLOW
YOUR TURN!
CREATING DYNAMIC QUERIES WITH CA PERFORMANCE CENTER BROWSER VIEWS
WEATHER-MAP APP CASE STUDY
OTHER APPS AND RESOURCES
1
2
3
4
5
6

The CA Performance Management OpenAPI Eco-System
CA PM OpenAPI
OData API Smart data extraction
Data and configuration extraction
End-user focused API (SSO & Auth)
Data Aggregator
REST
Manage administrative
operations
Configuration data
Metric families and vendor certs
Performance
Center API
Automate provisioning and
configuration tasks
Create and manage groups
Create and update user accounts
Data source unification
Manage data source access
Provide local/remote ID mappings
Context aware custom content
Import and export dashboards
Browser view w/parameters

What is an OpenAPI Application?
§ Accesses 1 (or more) of the CA Performance Management APIs to provide
interactivity between a Performance Center user and content delivered
through a Performance Center browser view
§ Many different purposes:
– Provide alternative or new visualization to augment the Performance Center
experience
– Allow a user to interact with the Data Aggregator REST API to update/create
item attributes
– Provide the ability to interact with 3rd party applications using data and context
driven from Performance Center and CA Performance Management

OpenAPI Applications - Hosting
§ OpenAPI Apps are primarily hosted on Performance Center to enable
simpler deployment and avoid restrictions related to Data Aggregator
access from beyond a firewall
§ The most important thing to remember is:
“Thou shalt not request data in an app which originates on a system other
than the hosted system.”
§ Unless…
A proxy is used to allow it to appear data is from the same domain
OR CORS is enabled

1. User authenticates to Performance Center thru
single sign-on
2. User access Open API app through Performance
Center
3. Open API app requests data from OpenAPI
through relative path
4. Performance Center proxy directs Open API
request to Data Aggregator
5. Open API validates user authorization (which
Items do they have permissions to view)
6. Open API creates data set from iRep and Vertica
based on user’s permissions
7. Data returned to Performance Center proxy
8. Proxy sends Open API data to app
9. User views app with Open API data
1
2 3
4
5
66
7
89
Open API Data Flow of an App – OData Example

Question?
§ What role does the Performance Center proxy play in the
OpenAPI application in the last scenario?

1. User authenticates to Performance Center through
single sign-on
2. User access Open API App through Performance
Center browser view
3. Performance Center passes dashboard parameters to
app
4. App makes REST call directly to Data Aggregator
5. REST update response passed back to Open API app
6. App provides feedback to user in browser view app
1
2
3
45
OpenAPI – Data flow of an App – DA Hosted App
36
6

Question?
§ Why is the application hosted on the Data Aggregator in the
last scenario?

What Are the Typical Aspects of an Open API App
§ Build the query
– Leverages Performance Center browser view to derive context for queries and
user output
§ Get the data
– Open API OData URLs
– Data Aggregator/Performance Center REST API Get/Put/Post
§ Parse and render
– Gets and parses the API response data
– Leverages client visualization or analytics libraries
– Generates output for the user

Build the Query
§ Queries built in query builder or listed in CA Performance Management
documentation are static
§ Performance Center browser views provide parameters to customize the
URL to add key info such as item IDs, item types, time-ranges, etc.

Creating Dynamic OData Queries using Performance Center
App gets context info from
Performance Center
browser view API
OData URL leverages
parameters for contextual
data set

Get the Data
§ The data can then be fetched from the client browser using a
variety of methodologies derived from AJAX

OpenAPI OData Data Extraction Example
JQuery D3

Parsing the Data
§ Parsing the data is an exercise of taking data returned by the API in format
A and transposing into format B
§ Many GREAT tools available for this
– Simplest: D3 & JQuery

Parsing Data the Easy Way: D3
§ D3 provides many great functions to parse, structure, analyze, and modify
data sets from an API call; here’s just a few:
http://bl.ocks.org/phoebebright/raw/3176159/
Objects A common data type in JavaScript is the associative array, or more simply the
object, which has a set of named properties
Maps A Map object iterates its elements in insertion order — a for...of loop returns an
array of [key, value] for each iteration
Sets The Set object lets you store unique values of any type, whether primitive values or
object references
Nests Nesting allows elements in an array to be grouped into a hierarchical tree
structure; think of it like the GROUP BY operator in SQL, except you can have
multiple levels of grouping, and the resulting output is a tree rather than a flat
table

Presenting the Data
§ This is the fun part and JavaScript makes it very easy
§ HTML, HTML5, CSS3, JavaScript, D3, Google Charts, etc.
§ Think about style, format, and data presentation goals
§ Plenty of help on-line in many different forums

Weather-map Case Study
§ What is a Weather-map?
– A geo-location based view which shows high-level devices on a map with
connections representing the logical circuit(s) between sites
– Sites and connections are both colored and sized dynamically based on metric
and attribute values/threshold
§ What a Weather-map is NOT?
– A Layer 2 topology view which shows intra-site device/interface to
device/interface connections

Weather-map Case Study (cont)
§ Pre-requisites:
– CA Performance Management 3.0 (requires custom attributes feature)
– OpenAPI Weather-map installed
§ GitHub:
– OpenAPI device geo-location attributes defined
§ GitHub:
– OpenAPI interface connection information
§ GitHub
– Follow install instructions in README for each app

Weather-map Case Study – Configuration Steps
Step 1. Create custom attribute to
define our device to device
connections
§ POST to Data Aggregator
§ ItemType: Port
§ Type: String
§ Name: ConnectsTo

Weather-map Case Study (cont.)
Step 2. Create group of
Weather-map devices and
interfaces
§ Device alias contains ‘Core’
§ Interface alias contains ‘->’

Step 3. For each device to
be placed on map
§ Set geo-location
information in context
page
§ Set alias to ‘<Site XYZ>
Core Router’

Step 4. For each device to be
placed on map
§ Set connection information in
interface context page
– ConnectsTo <device>
§ Set alias to ‘Location A ->
Location B’

Step 5. Allow OpenAPI ETL job to
complete and verify group contents
and geo and connection tags set
properly

Step 6. Verify
Performance Center
group contents and
alias values via
inventory views

Step 7. Launch Performance
Center Weather-map app
dashboard and select group
created in step 1

Weather-map Functionality
Each site within target group
displayed on map and in table
(sorted by CPU Util descending)
Site color based on threshold range
Key metrics for all connected
circuits shown (sorted by Util desc)

Hover over site to view Info and KPI values

Select a site on map or in
table to view connections
Circuits filtered to only show those
to/from selected site
Circuit color based on threshold range

Hover over a circuit to view info and
KPI values

Weather-map App Options
§ Options are configured as parameters passed to app via Performance
Center browser view
– connect=full | half
§ Controls the way the connections are drawn to enable line over-lap in larger
configurations
full half

– scope= usa | europe | world (default)
§ Allow map to be focused on specific continent for maps not requiring a
global perspective
usa europe world

– theme= dark | light
§ Controls the theme and colors
dark light

Other OpenAPI Apps
§ Visit our GitHub Repository for other great apps that can easily be
deployed and customized
https://github.com/CA-PM

Your Turn!
§ Refer to the next hands-on lab session (DO4X66E)for step by step instructions to:
– Deploy apps necessary for CA Performance Management M Weather-map
– Configure custom attribute and group rules to simplify data visualization
– Leverage the OpenAPI Apps to create the geo-location and connection data thatis
consumed by the map
– Run and troubleshoot
§ What could be changed to make this more applicable to your environment?
§ How would you make those changes?

Thank you.
Stay connected at communities.ca.com

Pre-Con Ed: Build Your Own Apps for an Enhanced Network Management Experience with the CA Performance Management Open API

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Viewers also liked

Viewers also liked (6)

Similar to Pre-Con Ed: Build Your Own Apps for an Enhanced Network Management Experience with the CA Performance Management Open API

Similar to Pre-Con Ed: Build Your Own Apps for an Enhanced Network Management Experience with the CA Performance Management Open API (20)

More from CA Technologies

More from CA Technologies (20)

Recently uploaded

Recently uploaded (20)

Pre-Con Ed: Build Your Own Apps for an Enhanced Network Management Experience with the CA Performance Management Open API