Business Engines
In this part of the documentation, we assume that, conceptually, you know what a Business Engine is. If not, please refer to the platform schema and its description, following by the Business Engine section.
Add and delete Engines
This feature allows to add as many Business Engines as needed to be in your system. Each of them should already be connected to a Grafana Instance. In the future, you can manage that connection from the Business Studio as well.
![Add a new Business Engine in the Business Studio.](/img/big/business-engine/add-engine.png)
Add a new Engine
To add a new Business Engine, click the + Add button on the main screen and then specify the following:
- Engine name
- Should be a unique name within the Business Studio.
- Engine URL
- A URL to access Business Engine API.
- Production or Community token
- Unique for each Business Engine Cluster.
- Use the Support menu at the bottom left to request a new or additional Production tokens.
![New Business Engine configuration.](/img/blog/2024-12-31-big-2.2.0/new-engine.png)
Once the Business Engine is added, you can review the configuration settings by clicking on its name in the list.
Business Engine
The Overview page, in addition to the basic engine statistics such as version, status (ok/error), a number of alert rules and actions, features the Alert History and high availability state.
![A Business Engine Overview page](/img/big/business-engine/tab-overview.png)
High availability can be:
- Disabled. If a Business Engine is the only one in the cluster.
- Enabled. If there are multiple (more than one) Business Engines in the cluster.
Alert rules
The Alert rules page is a part of the Business Alerting feature available in all Business Engines.
To learn more about alert rules, please refer to this documentation's Alert rules section.
Actions
The Actions page helps to configure actions, which are the set of steps that are triggered by an expected event. The most common scenario is when an action is triggered after an alert rule is broken, but it is just one of the possible scenarios.
To learn more about actions, please refer to this documentation's Actions section.
Environment
All environment variables are displayed on the Environment page.
![Environment variables for the Charlie Engine 1.](/img/big/business-studio/tab-env.png)
Grafana connection
The Business Studio allows you to establish that connection in the comfort of a user-friendly interface.
To accomplish that, follow the steps:
- Scroll to the Grafana section.
- Click the Edit button.
- Provide Grafana instance URL.
- Provide Service account token.
![Connect a Business Engine to Grafana instance via Business Studio.](/img/big/business-studio/token.png)
With this user action, the grafana_token
column of the environments
table is updated. That means if multiple business engines are connected to the same Grafana instance (HA scenario), then with updating the settings only for one business engine, all others are automatically updated since they all point to the same database field.
If multiple Business Engines are connected to the same Grafana instance, then updating ONLY one Business Engine is required. The rest of the connected business engines will be updated automatically.
Settings
The Settings page contains all the information you provided while creating the Business Engine plus one extra parameter - Update Engine license.
Initially Business Engine starts with the Community license.
When the Update Engine license parameter is checked, the Business Engine license token updates simultaneously with the Business Studio license token. This happens after you copy and paste a new token in the Token parameter and click the Save button.
![Settings for the Charlie Engine 1 and Update Engine License parameter.](/img/big/business-studio/update-engine-license.png)