Skip to main content

Collection Settings

Collection settings are split across three levels: organization, collector, and individual source. The table below shows where each setting is configured.

Where settings live

ScopeConfigure atSettings
OrganizationPlatform → CollectorsOrganization collection settings (button on the page header)Rate limits, timeouts, retries, RIB collection, sensitive data redaction, trusted certificates, custom SSH password prompts, beta commands, SNMP credential discovery
CollectorPlatform → Collectors, then click a collector row → Settings tabGlobal connection concurrency, vCenter collection concurrency, SNMP performance data collection concurrency
SourceSources → <source-type>, then add or edit a sourcePer-jump-server concurrency, per-cloud-account API concurrency and timeouts, custom Azure environments
NetworkCollection → Collection Settings (per-network)Collection schedule, snapshot retention policy, custom collection groups, endpoint profiles, credentials, jump servers, internet proxies

Organization collection settings

Click Organization collection settings in the Collectors page header to open the drawer. It has three tabs.

Limits tab

Organization collection settings — Limits tab

These rate limits are configured at the org level but enforced independently on each collector. Each collector has its own bucket; with multiple collectors running, the upstream load on TACACS / RADIUS scales with the collector count.

FieldDefaultDescription
Maximum device authentications1000/sCap per collector on SSH or Telnet authentication attempts to network devices.
Maximum device command authorizations1000/sCap per collector on CLI commands issued to devices.

Trusted certificates tab

Use this tab to add certificates that the collector should include in the certificate chain when it talks to cloud systems and controllers. This is useful when proxies or firewalls decrypt traffic for inspection and re-encrypt it with their own keys.

Click Add trusted certificate to add an entry, then click Apply all changes. Applying restarts the collector once any in-progress jobs finish.

Advanced tab

The Advanced tab is grouped into the following sections.

Concurrencies

FieldDefaultDescription
Extra connections per device0Extra SSH connections per device for parallelizable collection (e.g. VRFs).
Allowed concurrent SNMP requests per device4Cap on simultaneous SNMP requests per device, applied to credential auto-discovery and OID collection.
Maximum number of connections2000/sConnection rate during the connection-scan phase of a subnet scan.

Timeouts

FieldDefaultDescription
Snapshot collection timeout360 minutesTotal collection time across all devices in a snapshot.
Device collection timeout180 minutesPer-device collection time.
Connectivity test timeout20 minutesPer-device connectivity test time.
Device discovery timeout360 minutesTotal discovery time across all devices in a snapshot.

Retries

FieldDefaultDescription
Number of retries5 per deviceMaximum retry attempts for a failed device. Subsequent attempts use exponential backoff.
Delay before 1st retry15000 msInitial retry delay; subsequent delays double up to Maximum retry delay.
Maximum retry delay60000 msCap on retry delay.

RIB collection

Applies to Arista, Cisco, and Juniper.

  • Max number of routes — Cap on routes collected per device. When the cap is exceeded, only routes whose subnets appear in Required subnets are collected. The default route is always collected.
  • Required subnets — Subnets to always collect, one per line. Both IPv4 and IPv6 are supported (e.g. 10.42.2.0/24, fd00:1942:3::/48).
  • VRF/routing instance name filters — Glob patterns for VRFs to collect, one per line (e.g. default, VRF?, *-VRF).

Sensitive data redaction

The redaction algorithm and patterns configured here apply to every network in the organization. See Sensitive Data Redaction for behavior and guidance on each algorithm.

FieldDescription
Default redaction algorithmRedaction applied to sensitive fields. Options: None (disabled), Mask only, MD5 hash (16 digits).
Hierarchical pattern filtersCustom redaction patterns, one per line. Globs and regex are both supported.
Redaction algorithm override per networkOptional per-network overrides of the default algorithm. Resolution order: network's own override, parent network's override (for workspaces), organization default.

Organization collection settings — Sensitive data redaction

Other collection options

  • Enable collection of the beta commands — When off, beta commands are skipped, which may reduce model accuracy.
  • Enable SNMP credential auto-discovery for all devices — When on, the collector tries configured SNMP credentials against newly added devices.

SSH authentication

  • Password prompts — Custom prompt strings to recognize password challenges from remote AAA servers, one per line.

Per-collector settings

Open the Settings tab on the Collector drawer (Platform → Collectors → click a row).

FieldDefaultDescription
Global connection concurrency128Total concurrent SSH/CLI connections from this collector across all devices it serves.
vCenter collection concurrency1Concurrent vCenter API calls from this collector.
SNMP performance data collection concurrency64Concurrent SNMP performance polls from this collector. See Performance Data for the per-device thresholds.

Collector drawer — Settings tab

Per-source settings

Some collection knobs live with the source itself rather than the collector or the organization. Edit a source from Sources → <type>.

Source typeSource-level fields
Jump serverMaximum startups, Maximum sessions (see Jump Servers)
AWSAPI connection timeout, API request timeout
AzureAPI connection timeout, API request timeout, Custom environment name
GCPMaximum concurrent API requests, API connection timeout, API request timeout
NSX-T managerMaximum concurrent API requests
VelocloudMaximum concurrent API requests
MerakiMaximum concurrent API requests

The per-source concurrency fields are bounded by the collector's Global connection concurrency.

RBAC

ActionOrg AdminNetwork AdminNetwork OperatorRead-only
View Organization collection settingsYesYesYesYes
Edit Organization collection settingsYesNoNoNo
View per-collector settingsYesYesYesYes
Edit per-collector settingsYesNoNoNo
Override redaction algorithm for a networkYesNoNoNo

Workspace networks

Concurrency, timeouts, retries, trusted certificates, and per-source fields apply to a workspace network the same way they apply to its parent — through the workspace's collector and the organization. There are no per-workspace values for any of these.

A workspace can use a different redaction algorithm than its organization. Add an entry for the workspace in Redaction algorithm override per network under the Advanced tab. At collection time the algorithm resolves to: workspace's own override → parent's override → organization default.