A10 Harmony Controller Operator Console

The A10’s HarmonyTM Controller Operator Console allows users to Configure, Debug, and Monitor the A10 HarmonyTM Controller Services in a very easy and efficient manner. The Operator Console has a dashboard which shows the detailed information such as Status, IP address, Service status and other parameters of the services or an API can be used to get the job done. The dashboard also offers options to configure few service parameters.

The A10’s Operator Console is most helpful for the Developers, System Engineers, Administrators to debug, monitor, and to configure various A10 Controller services. The Operator Console also provides APIs to perform the configuration, to pull log information and to get detailed information of the services running.

The A10’s Operator Console has three main components:

  1. Harmony Controller Dashboard
  2. Micro Service Dashboard
  3. Configuration Management

HarmonyTM Controller Dashboard

The HarmonyTM Controller dashboard provides user detailed information about the micro services running in an A10 Controller. The dashboard displays information such as the Service Status, internal IP address of the service, and the state of service whether it is Up or Down.

These information helps the user to monitor and debug. For example, if any service is down, then it is marked in Red, for which the user can check the corresponding logs and find the root cause for the service to go down.

The figure below is the A10 Harmony Controller dashboard.


Micro Service Dashboard


The Micro Service dashboard provides the detailed information of each micro-service running on A10 controller. This dashboard provides information such as Ports, Protocol used, and the IP on which the service is up. The user can also run the APIs to fetch the above metadata information. This metadata information helps the operator to set-up the required ports and provides protocol information.

The figure shows the list of micro-services running in the A10 HarmonyTM Controller at the given instance. When clicked on Micro Service Dashboard drop down the list appears as shown.

When an individual service is clicked from the list then the UI shows the detailed information for that specific service. For example, when message-bus is clicked from the list then the dashboard displays the Instance IP and the Port information for message-bus micro services.

Similarly, when any other service is clicked from the list the information relevant to those micro-services are displayed. The figure below shows the detailed information for Config Manager service.


Configuration Management

The Configuration Management provides the operator options to configure the properties/templets of A10 Controller components such as Welcome Email template for the new users, Log level settings, Root Provider admins, Lightning ADC Images, and the Certificate configuration. These configurations can be configured via dashboard or can be configured via APIs

The each configurable parameter is described as below.

Harmony Controller

Here the user can configure the log collection options and also view the HarmonyTM Controller version currently running. The log options can be set at three levels like Info, Debug, and Error. Once the log option is set and saved the logs can be collected at an FTP server location and the FTP location can be specified under Collect logs tab. These logs can be further downloaded from this location. Irrespective of the level set the logs collected will have all the microservice information.


Authenticated FTP server can be used for log collection and you need to provide the FTP upload directory, IP address, username and password.


Email Content

Whenever a new customer is added to the system, A10 sends a welcome email, Activation email with all user credentials or a password reset emails to the existing customers. If there is a need to modify or edit these emails then the user can use this option in the dashboard to configure and edit the email content. The dashboard offers options to configure the Content of the email as shown in the below figure:


Lightning ADC Images

Provide a Lightning ADC image ID for different regions in Amazon or a image ID in Google to launch a Lightning ADC cluster.


Email Server

A few advanced options where the user can define the Server Host, Server port, From Address, From Personal, User Name, Password. The dashboard offers options to configure the Advanced options as shown in the below figure:



The Certificate option allows the user to update or to add a new certificate scheme for portal server(UI). The user is required to provide the FQDN, Server Certificate, Server Key, and CA Certificate information as shown in the figure below.


Network Time Protocol

The Network Time Protocol (NTP) option allows the user to configure one or more Network Time protocol servers.



When the automatic log-rate is enabled, Harmony Controller periodically adjusts the log-rate configuration parameter of Thunder devices in ratio of traffic through the devices. This value is applied to partitions for all connected Thunder devices running ACOS 4.1.4-GR or later version.


Service Properties

This is a centralised configuration store to used to store the configuration of the micro services. When you select a particular component and select the appropriate properties, it will update the property and restart the service.



You can monitor using prometheus or grafana.


Prometheus collects metrics from monitored targets by scraping metrics HTTP endpoints on these targets. Since Prometheus also exposes data in the same manner about itself, it can also scrape and monitor its own health.



Grafana allows you to query, visualize, alert on and understand your metrics no matter where they are stored.


You can create a dashboard or import or new dashboard folder. Dashboards can be managed, and can create new playlists. You can add notification channels or alert rules. You can also manage all users and organizations.

A10 Harmony Operator Console APIs

As we are aware the Operator Console is most used with User Interface. However, the user can also use the APIs provided to perform all such tasks which can be done through UI. For example, when a new user subscribes our A10 Lightning Application Delivery System an activation email is sent to the customer. So the provider or sub-provider can use the Operator Console UI or the API to modify the email content or to set advanced options in the email server.

Below we are showing few example APIs from the Operator Console. The API method varies depending on the component we are referring in the Operator Console. To access the APIs click the i button on the right top corner of the dashboard screen.

Micro Service Dashboard API

The Micro Service dashboard displays the detailed information of the micro-services running. Hence, the API uses the GET method to fetch information from the services.

The figure below is the API used to get barista service information.


Code Sample:

.. gist:: https://gist.github.com/c-success/0238acfa567808e09d915ebb5f0d692e


User gets the Authorization key in the Operator Console login API response, only if login is successful.

Configuration Management API

The Configuration Management allows the user to configure the A10 Lightning components. Hence, the API uses the POST method for configuration.

The figure below is the API used to configure the activation emails.


Code Sample:

.. gist:: https://gist.github.com/c-success/97573f89aeb5938eb450cf793a484e6e


User gets the Authorization key in the Operator Console login API response, only if login is successful.

Analytics Configuration Management API

Harmony Controller Analytics enables Analytics auto-request log-rate adapter by default. When automatic log-rate is enabled, A10 HarmonyTM Controller periodically adjusts the log-rate configuration parameter of Thunder devices in ratio of traffic through the devices.

The feature can be enabled or disabled through an Operator Console API. POST call on config or analytics with key “rate.adapter.enabled” value set to disables this feature.

The figure below is the API used to enable analytics auto-request log-rate adapter.


Code Sample: