Neo Metrics in Open KPI Sotre

Prerequisites

Collecting metrics from SAP Business Technology Platform Neo is available since FRUN 3.0 FP01.

You need to know the credentials of a user that is able to call the Monitoring API in SAP Business Technology Platfrom.

Setup

1. Create HTTP destination

Create in SM59 a destination of type G (HTTP Connection to External Server) and fill out the following fields:

  • Technical Settings
    • Host = api.hana.ondemand.com
    • Port = 443
    • Path Prefix = /oauth2/apitoken/v1
  • Logon & Security
    • Enter your user and password under Basic Authentication
    • SSL = Active
    • Anonymous SSL Client

2. Create a variant for report RCA_GS_NEO_METRICS

You need to create for each Database in Neo you want to monitor a separate report variant.

Start SE38, enter RCA_GS_NEO_METRICS and execute (F8).

Enter the following fields

  • HTTP Destination (you created in step before)
  • Data Center your DB or application is running in (e.g. eu1)
  • Your technical Subaccount Name
  • DB Name (Optional)
    • The DB Metrics Names you want to collect. If nothing is entered all available metrics are collected.
    • The name of your XS Application (Optional)
    • The metrics for the XS Applications. If nothing is entered all available metrics are collected.
  • Java Applications 
    If you click on button Load Definitions you can choose the available Java applications from your subaccount with the value help (F4).

3. Schedule report RCA_GS_NEO_METRICS

Depending on your requirements and the metrics you want to collect you can decide in which interval you schedule the report. Usually a period of 2 or 5 minutes should be sufficient. 

Details about the available metrics can be found here:

Monitoring Metrics of a Database System

Monitoring Metrics of a Java Application

 

Creating New Dashboard

Create custom dashboards by using the “Add Page” function in the left-side navigation or in the personalization. The mechanisms are basically like all other Focused Run applications, thus only application specific details are explained here.

Procedure to Create a System Analysis Dashboard:

  • Create a page, assign name, icon; decide if you want to make it “public”
  • Decide on the layout of the page, e.g. grid layout
  • Drag view Open KPI from the available view types onto your dashboard.
  • Personalize each view by clicking on the “personalization” icon on the view title bar.
  • Save the personalization settings to persist the data. The new dashboard will reappear every time you launch the application.

Personalize View – Data Source Settings:

  • Open the Scope Selection and choose the sender type ( e.g. NEO DB System, NEO XS Application or NEO Java Application). Select the sender types.
  • Choose the metrics from the metric catalog.
  • In the metrics dialog, tab “Selected”: assign metrics to a second axis if needed. Apply scaling if needed.
  • In the metrics dialog, tab “Aggregation”: Decide which dimensions should be aggregated by default, set filters if needed.
  • If desired override the time range.
  • Resolution: You can decide to switch off the time axis completely (“No Time Axis”) or to explicitly set a resolution. Note that actually used resolution may also depend on the granularity of data collection. When switching off the time axis, time-series charts cannot be used (see chart settings).

Personalize View – Rendering Settings:

  • Choose the initial rendering type: chart or table
  • Set the view title
  • Decide if you want a legend displayed
  • Data labels are rendered as texts displaying the values of data points in the chart
  • Markers are rendered as “dots” for every data point. If a chart contains too many data points the markers may still not be visible. Use markers e.g. to expose isolated data points that are surrounded by “gaps”.
  • Chart type: time series charts are only available if the resolution is not set to “No Time Axis”. On the other hand side, pie and donut chart types only make sense if you set the resolution to “No Time Axis”