The integration APIs are completed by a standardized data format designed for data interchange.
You can access the Backend Services page by navigating to Administration > Components > Backend Services.
The Status page of the backend administration menu displays a list of all available services; the table is color coded to reflect the status of the services:
The Backend Services page
You can view the application log for a service clicking theicon at the end of the corresponding row.
As shown in the figure, the log table is color coded to reflect the type of message:
Example: the Data service log
Depending on the log message, it may be possible to expand the description clicking on the icon highlighted in the figure.
Example: the Data service log (expanded view)
Clicking on the name of a service in the Active services table, displays its detail page, that includes a toolbar with useful buttons to perform basic administration tasks. The available actions vary depending on the component.
Example: details for the Search service
The Backend Control service allows the execution of backend jobs, for example, scheduler tasks, through standardized APIs. Examples are:
Web services are exposed under the
BASE_CONTEXT/CaplanBackendWS context. The exposed web services are:
For more information on developing clients for these services, refer to Developing clients.
The Capacity-Aware Placement Advice service allows you to make choices for the placement and provisioning of virtual machines based on the available capacity.
Clicking on the name of the service in the Active services table, you can access its detail page where you can find placement advice statistics, that can help you troubleshoot the service.
Clicking Test placement triggers a test placement advice call and refreshes the Placement Advice Statistics table, to help you verify and troubleshoot the status of the service.
Clicking Show status refreshes the Placement Advice Statistics table.
By clicking Relocate you can relocate this backend service to another service container. For more information, see Relocating a backend service.
For more information on administering and troubleshooting the integration with BMC Cloud Lifecycle Management and the Capacity-Aware Placement Advice service, refer to Verifying and managing the Capacity-Aware Placement Advice integration.
You can obtain all metrics for the service by examining the business driver "Placement Advice Service", which is automatically created in the administration domain called "Self Monitoring".
The chargeback service API provides methods to configure and view results of chargeback models. The supported protocol for this backend service is the REST web interface. On the Active services table, click API Providers - Chargeback service, to view the detail page and perform one of the following functions:
Data Provider Service API provides methods to handle views workflow.
The Data service allows data exchange from/to BMC TrueSight Capacity Optimization using a specific format; it also provides a way to send and retrieve data from BMC TrueSight Capacity Optimization using standardized formats.
On the Active services table, click API Providers - Data service, to access the detail page for this backend service and perform one of the following functions:
Pause: Pauses the data service.
If the data service is paused, the loading of data into the BMC TrueSight Capacity Optimization database using the Data API will stop, and the data will be loaded when the data service is activated/run again.
The supported protocol is the REST Web Service.
Lookup Service API provides methods to perform lookup and entity creation for ETL processes. The Lookup service loads only Private entity catalog into the memory. The Shared entity catalog is not loaded into the memory. This service executes a set of queries on the Shared entity catalog for searching only the required lookup fields i.e. it retrieves only a very small fraction of the catalog. If the searched lookup fields are not available, it will assign a new ID.
If the lookup service is unavailable during the execution of the ETL loader (for example, when the maintenance is performed on service container), ETL loader performs the caching of the unresolved entities locally. The ETL loader tries to resolve the entities during the next execution of the ETL.
Reservation Service API provides methods to manage the reservation workflows. The supported protocol for this backend service is the REST web interface. On the Active services table, click API Providers - Reservation service, to view the detail page and perform one of the following functions:
The search service is used by the search functionality in BMC TrueSight Capacity Optimization. The system task, called Search Index Updater updates the search index based on the new data coming in BMC TrueSight Capacity Optimization by the ETL and based on the manual changes that you have performed. The search index might become out of sync with respect to the contents of BMC TrueSight Capacity Optimization if you unschedule the updater task or perform some manual queries in the BMC TrueSight Capacity Optimization schema to change bulk of data.
On the Active services table, clicking API Providers - Search service, displays the detail page for this backend service. On the detail page you can use the following options:
The time forecasting model service API provides methods to execute a time forecasting over the BMC TrueSight Capacity Optimization data. The supported protocol for this backend service is the REST web interface. On the Active services table, click API Providers - Time forecast model service, to view the detail page and click Show log to see view the application log.
The auto forecasting service is responsible to calculate indicators. On the Active services table, click Core Services - Auto Forecasting Service and use one of the following functions:
The NRTWH service is BMC TrueSight Capacity Optimization's warehousing engine, responsible for the immediate warehousing of data.
Details for the Near-Real-Time Warehouse service
In addition to starting and stopping the service by using the Run and Pause buttons, the following actions can be performed:
Show queues status
Show the status of processing queues
The Clear Freshness option resets the freshness timeout for all series. It is used in Development, Custom ETL development and Proof of Concept(poc) mode when reprocess data loaded by an ETL needs to quickly response.
The Clear Blacklist option resets the blacklisted objects. When the objects or series of objects encounter three subsequent unmanaged errors, then they get marked as blacklisted objects. For reprocessing such series of blacklist objects, one has to execute Clear Blacklist. The Clear Blacklist also automatically gets perform after every hour. In case one or more series continue to get blacklisted and the blacklisting cause is not exogenous (for example, database connectivity or space saturation issues) you should investigate on data related problems and contact support for other cases.
Reload the service's configuration
Show the application log
Pause the Near-real-time WareHouse service's
Resumes the Near-real-time WareHouse service's
The Near-Real-Time Warehouse Queues Status table provides useful information on the health of the Near-Real-Time Warehouse service. Statistics are updated at regular intervals and rolled up every hour. For each queue, the table provides the following details:
(*) The name of the thread launcher has the following structure: <part1>-<part2>, where:
Examples of valid names are "store-sys" or "ecs-wkld."
This backend service is used to control the BMC TrueSight Capacity Optimization schedulers. The most important function is to show the log, where some errors might be present and can be useful from a support perspective. On the Active services table, click Core Services - Remote scheduler supervisor, to perform one of the following functions: