Skip to main content

Discovery task configuration

The wizard contains four visible steps.

1. Task definition

This step configures the general Discovery task settings:

  • Task name.
  • Agent group.
  • Execution interval.

A real Pandora FMS group must be selected. Do not use All, as the plugin rejects empty or non-positive group identifiers.

2. Azure credentials

Field Required Description
Tenant ID Yes Microsoft Entra ID tenant.
Client ID Yes Identifier of the registered application.
Client secret Yes Application secret.
API endpoint No When empty, https://management.azure.com is used. Change it only for sovereign clouds or custom environments.
Login endpoint No When empty, https://login.microsoftonline.com is used. Change it only for sovereign clouds or custom environments.

3. Azure event query and filters

Field Default value Description
Event history in days 15 Query period, from 1 to 365 days.
Azure API filter Empty Expression sent to Azure through $filter.
Subscription allow regexp Empty Expressions matched against the subscription ID and name.
Region allow regexp Empty Regions accepted by the plugin.
Service allow regexp Empty Impacted services accepted by the plugin.
Event type allow regexp Empty Allowed event types.
Status allow regexp Empty Allowed regional or general statuses.
Level allow regexp Empty Allowed event levels.
Event search allow regexp Empty At least one expression must match the complete event text.
Event search deny regexp Empty Discards matching events.
First run events are new Disabled When enabled, every event found during the first execution is treated as new.

4. Agents modules and execution

Field Default value Description
Create agent per impacted region Enabled Creates one agent per region. When disabled, Target agent is used.
Target agent Azure Service Health Events Single agent used when agents are not created per region.
Agent prefix Azure Service Health Prefix for regional agents.
Module prefix Empty Prefix added to final module names.
State modules Enabled Creates the Connection module.
Event count modules Enabled Creates the five event counter modules.
Event detail modules Enabled Creates Events and New events.
Maximum event detail length 16000 Maximum size of detail modules. The effective minimum is 1000 characters.
Modules allow regexp Empty Only creates modules whose final name matches.
Modules deny regexp Empty Discards modules whose final name matches.
Write event log Enabled Enables the JSONL event log.
Maximum event log size 20 Rotates the log when it reaches this size.
HTTP timeout 30 Maximum time per request. Zero or negative values are replaced with 30 seconds.
Maximum retries 2 Retries for HTTP 429 and transient Azure errors.
Verify SSL certificates Enabled Keep enabled in production.
Proxy URL Empty Optional HTTP or HTTPS proxy.
Mock Azure API URL Empty Reserved for testing and must remain empty in production.