Skip to content

Bots From Extension: snmp

Collects the inventory data using SNMP protocol

This extension provides 3 bots.





Bot @snmp:snmp-bulkwalk

Bot Position In Pipeline: Sink

Collect snmp through bulk walk

This bot expects a Restricted CFXQL.

Each parameter may be specified using '=' operator and AND logical operation
Following are the parameters expected for this Bot

Parameter Name Type Default Value Description
ip_column* Text Column name in the input datset that contains IP addresses
secret_names Text Comma separated list of names of the secret from the vault. If not provided, all secrets of
type 'snmp-cred' will be tried until connection is established.
oids* Text List of OIDs to collect. If each oid is not ending with .0, the .0 is appended to it.
timeout Text 10 Timeout
retries Text 0 Number of retries.
non_repeaters Text 1 Non repeaters
max_repetitions Text 10 Maximum repetitions.
max_rows Text 100000 Max SNMP Rows to be collected for SNMP Table Operations (0 means no limit, default:100,000).
return_type Text dataset Returns the response as dataset or writes to a pstream. expects 'dataset' or 'pstream'.
pstream_name Text Name of the pstream to write. Must be provided if return_type is pstream
use_last_successful_cred Text yes Look for the last successful secret in the pstream_name and use that first during collection.
pstream should have 'target_ip', 'collection_status' and 'secret' columns.
lexicographic_mode Text no Walk SNMP agent's MIB till the end (if yes), otherwise (if no) stop iteration when all
response MIB variables leave the scope of initial MIB variables in varBinds.
ignore_non_increasing_oid Text no Continue iteration even if response MIB variables (OIDs) are not greater then request MIB variables.
max_calls Text 0 Max SNMP Calls for SNMP Table Operations (0 means no limit)







Bot @snmp:snmp-get

Bot Position In Pipeline: Sink

Collect snmp scalar mib values

This bot expects a Restricted CFXQL.

Each parameter may be specified using '=' operator and AND logical operation
Following are the parameters expected for this Bot

Parameter Name Type Default Value Description
ip_column* Text Column name in the input datset that contains IP addresses
secret_names Text Comma separated names of the secret from the vault. If not provided, all secrets of type 'snmp-cred'
will be tried until connection is established.
oids* Text List of OIDs to collect. If each oid is not ending with .0, the .0 is appended to it.
timeout Text 10 Timeout
retries Text 0 Number of retries.
return_type Text dataset Returns the response as dataset or writes to a pstream. expects 'dataset' or 'pstream'.
pstream_name Text Name of the pstream to write. Must be provided if return_type is pstream
use_last_successful_cred Text yes Look for the last successful secret in the pstream_name and use that first during collection.
pstream should have 'target_ip', 'collection_status' and 'secret' columns.







Bot @snmp:snmp-table

Bot Position In Pipeline: Sink

Collect snmp data through table/columns oids

This bot expects a Restricted CFXQL.

Each parameter may be specified using '=' operator and AND logical operation
Following are the parameters expected for this Bot

Parameter Name Type Default Value Description
ip_column* Text Column name in the input datset that contains IP addresses
secret_names Text Comma separated names of the secret from the vault. If not provided, all secrets of type 'snmp-cred'
will be tried until connection is established.
oids* Text Comma separated list of OIDs to collect. If each oid is not ending with .0, the .0 is appended
to it.
timeout Text 10 Timeout
retries Text 0 Number of retries.
return_type Text dataset Returns the response as dataset or writes to a pstream. expects 'dataset' or 'pstream'.
pstream_name Text Name of the pstream to write. Must be provided if return_type is pstream
use_last_successful_cred Text yes Look for the last successful secret in the pstream_name and use that first during collection.
pstream should have 'target_ip', 'collection_status' and 'secret' columns.
max_rows Text 100000 Max SNMP Rows to be collected for SNMP Table Operations (0 means no limit, default:100,000).
lexicographic_mode Text no Walk SNMP agent's MIB till the end (if yes), otherwise (if no) stop iteration when all
response MIB variables leave the scope of initial MIB variables in varBinds.
ignore_non_increasing_oid Text no Continue iteration even if response MIB variables (OIDs) are not greater then request MIB variables.
max_calls Text 0 Max SNMP Calls for SNMP Table Operations (0 means no limit)