How Can We Help?

This section describes the usage of Query APIs to get information on components in HEAL and details on their KPIs.

List Component Sub-types

To get the list of component sub-types for a specific type of a component in an account, use the ‘components’ Query API as follows:
API Name – components
Format – GET /config/accounts/{accountId}/components

Input Parameters

TypeNameDescriptionSchemaMandatory / Optional
PathaccountIdID or Identifier of an AccountstringMandatory
QuerycomponentTypeType of a ComponentstringMandatory

 

Output Parameters
Output Type: CSV

  • Component Sub-type – Sub-type for a component type
  • Component Version – Version of a Component

 

Sample Input

http://<keycloak_host>:<keycloak_port>/appsone-query-api/v1.0/config/accounts/4/components?componentType=HOST

KPI Details for a Component

To get details of supported KPIs for a specific sub type of a component in an account, use ‘componentsKPIs’ Query API as follows:
API Name – componentsKPIs
Format – GET /config/accounts/{accountId}/componentsKPIs

Input Parameters

TypeNameDescriptionSchemaMandatory / Optional
PathaccountIdID or Identifier of an AccountstringMandatory
QuerycomponentSubTypeSub Type of a ComponentstringMandatory
QuerycomponentVersionVersion of a ComponentstringMandatory

 

Output Parameters
Output Type: CSV

  • KPI Type – Type of a KPI (Availability, Metric(Core as per DB), Config watch, File watch)
  • KPI Category – Category of a KPI. Example: CPU, Disk IO
  • KPI Group Id – Unique ID of a group KPI
  • KPI Group Name – Name of a group KPI
  • KPI Id – Unique ID of a KPI
  • KPI Name – Name of a KPI
  • KPI Description – Description of a KPI

 

Sample Input

http://<keycloak_host>:<keycloak_port>/appsone-query-api/v1.0/config/accounts/2/componentKPIs?componentSubType=RHEL&componentVersion=6.x

Table of Contents