SolarWinds Orion SubnetUtilizationTrigger
CertifiedEnterprise EditionTrigger when subnet utilization exceeds a threshold in SolarWinds IPAM
SolarWinds Orion SubnetUtilizationTrigger
Trigger when subnet utilization exceeds a threshold in SolarWinds IPAM
Polls IPAM.Subnet at the configured interval and fires an execution for each subnet whose
utilization percentage exceeds threshold. Subnets with zero total addresses are skipped.
Optionally filter by group ID or address prefix.
Only the first breaching subnet per polling cycle fires an execution to avoid execution fan-out. Note: as long as at least one subnet remains above the threshold, an execution is fired on every polling cycle. Use the KV store in downstream tasks to deduplicate alerts if needed.
type: io.kestra.plugin.ee.solarwinds.ipam.SubnetUtilizationTriggerExamples
Fire when any subnet exceeds 80% utilization.
id: subnet_utilization_alert
namespace: company.team
triggers:
- id: utilization_watch
type: io.kestra.plugin.ee.solarwinds.ipam.SubnetUtilizationTrigger
host: "{{ secret('SOLARWINDS_HOST') }}"
username: "{{ secret('SOLARWINDS_USER') }}"
password: "{{ secret('SOLARWINDS_PASSWORD') }}"
threshold: 80.0
interval: PT5M
tasks:
- id: log_breach
type: io.kestra.plugin.core.log.Log
message: "Subnet {{ trigger.address }}/{{ trigger.cidr }} is at {{ trigger.utilizationPercent }}%"
Properties
host *Requiredstring
SolarWinds Orion host
password *Requiredstring
Password
username *Requiredstring
Username
addressFilter string
Address filter
Filters subnets by address prefix (SWQL LIKE match).
allowConcurrent Non-dynamicboolean
falseSpecifies whether a trigger is allowed to start a new execution even if a previous run is still in progress.
groupId integerstring
Group ID filter
Limits polling to subnets in this IPAM group.
interval Non-dynamicstring
PT5MdurationPolling interval
How frequently to check subnet utilization. ISO-8601 duration (e.g. PT5M).
maxResults integerstring
1000Maximum results per poll
Caps the number of subnet rows fetched per evaluation cycle. Defaults to 1000.
port integerstring
17778SWIS port
Defaults to 17778.
stopAfter Non-dynamicarray
CREATEDSUBMITTEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINTRESUBMITTEDList of execution states after which a trigger should be stopped (a.k.a. disabled).
threshold numberstring
80.0Utilization threshold (%)
Percentage (0–100) above which a subnet triggers an execution. Defaults to 80.
verifySsl booleanstring
trueVerify SSL certificate
When false, disables TLS certificate verification. Useful when Orion uses a self-signed certificate.
Defaults to true (secure).
when string
trueA condition that determines whether the trigger should run.
A Pebble expression evaluated at trigger time. The trigger fires only when the expression evaluates to a truthy value (true, a non-empty string, a non-zero number). Use this to gate trigger execution on dynamic runtime values such as execution labels, flow variables, or environment conditions.
Outputs
address string
Network address
available integer
Number of available addresses
cidr integer
CIDR prefix length
friendlyName string
Friendly name
subnetId integer
Subnet ID
totalCount integer
Total IP address count
used integer
Number of used addresses
utilizationPercent number
Utilization percentage at trigger time
