Parameters

Advanced mode

Configuration file (--conf)

agents_group_id = ID of the Pandora FMS agent group where the agents will be created.
interval = monitoring interval of the task in seconds.
subscription_id = Azure subscription identifier.
tenant_id = Azure Active Directory tenant identifier.
client_id = Service Principal application identifier.
client_secret = Service Principal secret.
resource_group = Azure resource group to monitor, optional. If left empty, Load Balancers from the whole subscription are discovered.
threads = maximum number of execution threads.
target_agent = target agent when one agent is not created for each Load Balancer.
modules_prefix = optional prefix for module names.
scan_load_balancers = enables automatic Load Balancer discovery.
agent_per_load_balancer = creates one agent for each discovered Load Balancer.
lb_agent_prefix = optional prefix for the name of the agents created per Load Balancer.
entities_list = path to the temporary file where discovered entities are stored.
enable_entities_interval = enables periodic refresh of the entities file.
entities_interval = entities file refresh interval.
time_window = time window used to query Azure Monitor metrics.
check_availability_modules = enables availability modules.
check_traffic_modules = enables traffic modules.
check_snat_modules = enables SNAT modules.
check_backend_pool_host_count = enables the backend pool host count module.
check_load_balancer_count = enables the Load Balancer count module.
metric_interval = Azure Monitor metric granularity in ISO-8601 format, for example PT1M.
metric_timeout = timeout in seconds for Azure API calls. If 0 or a negative value is configured, the plugin will use 30 seconds.
max_retries = maximum number of retries for temporary API errors, including HTTP 429 rate limiting.
mock_api_url = optional Azure mock URL for local testing. In production, it must be left empty.

Example

[CONF]
agents_group_id = 10
interval = 300
subscription_id = 00000000-0000-0000-0000-000000000000
tenant_id = 11111111-1111-1111-1111-111111111111
client_id = 22222222-2222-2222-2222-222222222222
client_secret = my_client_secret
resource_group = rg-production
threads = 1
target_agent = Azure Load Balancer
modules_prefix =
scan_load_balancers = 1
agent_per_load_balancer = 1
lb_agent_prefix = Azure LB 
entities_list = /tmp/tmp_discovery.azure_load_balancer.entities
enable_entities_interval = 0
entities_interval = 86400
time_window = 300
check_availability_modules = 1
check_traffic_modules = 1
check_snat_modules = 1
check_backend_pool_host_count = 1
check_load_balancer_count = 1
metric_interval = PT1M
metric_timeout = 30
max_retries = 3
mock_api_url =

Example using a local mock

[CONF]
agents_group_id = 10
interval = 300
subscription_id = test-subscription
tenant_id = test-tenant
client_id = test-client
client_secret = test-secret
resource_group =
threads = 1
target_agent = Azure Load Balancer
modules_prefix =
scan_load_balancers = 1
agent_per_load_balancer = 1
lb_agent_prefix = Azure LB 
entities_list = /tmp/azure_lb_mock.entities
enable_entities_interval = 0
entities_interval = 86400
time_window = 300
check_availability_modules = 1
check_traffic_modules = 1
check_snat_modules = 1
check_backend_pool_host_count = 1
check_load_balancer_count = 1
metric_interval = PT1M
metric_timeout = 30
max_retries = 3
mock_api_url = http://azure-load-balancer-mock:8080