Skip to content

Deployment Configuration

The Deployment tab of the Agent Configuration dialog allows you to specify the target execution environment where the agent will be deployed. BizMetry uses this information to generate a fully configured installer that can deploy the agent autonomously within a Kubernetes cluster — whether on-premises or in the cloud.

To access the Deployment tab, open the Agent Configuration dialog and select Deployment from the tab bar.

Agent Configuration Dialog — Deployment Tab


Deployment Parameters at a Glance

The tab presents the following configuration fields, which together define the full deployment target specification:

Parameter Description
Architecture The OS and CPU architecture of the target environment.
Deploy-time parameters Whether registry credentials will be provided now or at install time.
Ingress Type The Kubernetes ingress controller deployed in the target cluster.
Registry URL The HTTPS URL of the container image registry.
Project Name The project within the registry where the agent image will be pushed.
User Name The registry user account used to push the agent image.
Password The credentials for the registry user account.

Architecture

Defines the operating system and CPU architecture of the host environment where the agent will be deployed. BizMetry uses this selection to produce an agent binary and container image that is compatible with the target runtime.

Agent Configuration Dialog — Deployment Tab - Architecture

Architecture Description
Darwin/amd64 macOS 64-bit Intel (x86_64) system
Darwin/arm64 macOS 64-bit Apple Silicon (ARM64) system
Linux/386 Linux 32-bit Intel/AMD (x86) system
Linux/amd64 Linux 64-bit AMD/Intel (x86_64) system
Linux/arm/v7 Linux 32-bit ARMv7 system
Linux/arm64 Linux 64-bit ARM (AArch64) system
Linux/ppc64le Linux 64-bit PowerPC Little Endian system
Linux/s390x Linux 64-bit IBM Z mainframe (s390x) system
Windows/amd64 Windows 64-bit AMD/Intel (x86_64) system
Windows/arm64 Windows 64-bit ARM (AArch64) system

Architecture mismatch will prevent the agent from starting

Before selecting an architecture, confirm that it matches the runtime environment of the target host — whether on-premises or in the cloud. Selecting the wrong architecture will cause the agent to fail at initialization and will require reconfiguration and redeployment.


Providing Deployment Parameters

The checkbox "I will provide deployment parameters at deploy-time" controls when the registry and ingress configuration is supplied.

Agent Configuration Dialog — Deployment Tab - Checkbox

Option A — Configure now (checkbox unchecked)

All deployment parameters — ingress type, registry URL, project, user, and password — must be filled in through this tab before downloading the agent. The installer will use these values directly, requiring no additional input at install time. This is the recommended approach for unattended, scripted deployments where the installation must be fully self-contained.

Option B — Provide at install time (checkbox checked)

The remaining fields in this tab are skipped during configuration. Instead, the installer script will prompt the operator for these values interactively at the moment of installation. Use this option when registry credentials or ingress details are not available at configuration time, or when different operators handle the configuration and the installation steps separately.


Ingress Type

The BizMetry agent is deployed behind a Kubernetes ingress load balancer, which receives inbound traffic and distributes it across the agent Pods. The installer generates ingress manifests tailored to the selected controller type, so it is essential to choose the option that matches the ingress controller already running in your target cluster.

Load balancer topology

When deployed, the BizMetry agent exposes two independent load balancers within the Kubernetes cluster, each serving a distinct purpose:

External load balancer Handles bidirectional communication between the BizMetry platform and the agent. The platform uses this endpoint to push commands to the agent — such as configuration updates, restart signals, and control instructions — and to receive feedback and telemetry data in return. This load balancer must be reachable from the BizMetry platform over the network.

Internal load balancer Handles inbound instrumentation data from business applications running within the same private network. Applications and/or remote clients (i.e. for data sensing topology) deliver metrics to the agent either through the BizMetry plugin deployed in the API Gateway, or directly via the BizMetry SDK. This load balancer is exposed exclusively within the internal network and is not accessible from outside it.

The ingress type selected below applies to both load balancers. Both are provisioned using the same ingress controller, so it is critical that the selected type matches the controller actually running in the target cluster.

Agent Configuration Dialog — Deployment Tab - Ingress Type

BizMetry supports the following ingress controllers:

Ingress Type Description
APISIX Apache APISIX Ingress Controller
CONTOUR Contour Ingress Controller
HAPROXY HAProxy Ingress Controller
ISTIO Istio Ingress Gateway
KONG Kong Ingress Controller
NGINX NGINX Ingress Controller
TRAEFIK Traefik Ingress Controller

Selecting the wrong ingress type will cause the installation to fail

Before configuring this field, verify which ingress controller is installed and active in the target Kubernetes cluster. If the selected type does not match the cluster's actual ingress controller, the generated manifests will be incompatible and the agent installation will fail.


Registry Configuration

Once downloaded, the agent image must be pushed to a container image registry accessible from the target Kubernetes cluster. The fields below define the registry connection and credentials that the installer will use to perform this push.

Agent Configuration Dialog — Deployment Tab - Registry Config


Registry URL

The HTTPS URL of the container image registry associated with the target environment. This is the endpoint the installer connects to when pushing the agent image.

The registry must be accessible over HTTPS

BizMetry only supports secure registry endpoints. Ensure the registry is exposed via HTTPS before proceeding. Additionally, verify that the registry URL is reachable from the machine where the installation will be performed — network visibility to this endpoint is required at install time.


Project Name

The name of the project — or repository namespace — within the registry where the installer will push the agent image. This must be an existing project that is accessible to the configured registry user.


User Name

The username used to authenticate against the registry. This account must exist in the registry and must have sufficient permissions to push images to the configured project.


Password

The password for the registry user account specified above. Ensure that the credentials provided are correct and current, as an authentication failure will prevent the installer from pushing the agent image and will halt the deployment.

Provide accurate registry credentials

All registry parameters — URL, project, username, and password — are required for the installer to push the agent image and proceed with the Kubernetes deployment. Incorrect values will cause the installation to fail at the image push step.

If any of these values are uncertain at configuration time, enable the "I will provide deployment parameters at deploy-time" option so they can be supplied interactively by the operator performing the installation.


Summary

Field Required when Purpose
Architecture Always Determines the agent binary and image variant to generate.
Ingress Type Parameters provided now Selects the Kubernetes ingress manifests to include in the installer.
Registry URL Parameters provided now Defines the registry endpoint where the agent image will be pushed.
Project Name Parameters provided now Identifies the registry project where the image will be stored.
User Name Parameters provided now Authenticates the installer against the registry.
Password Parameters provided now Credentials for the registry user account.