Skip to content

infrasonar/snmp-probe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

222 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CI Release Version

InfraSonar SNMP Probe

Environment variable

Variable Default Description
AGENTCORE_HOST 127.0.0.1 Hostname or Ip address of the AgentCore.
AGENTCORE_PORT 8750 AgentCore port to connect to.
INFRASONAR_CONF /data/config/infrasonar.yaml File with probe and asset configuration like credentials.
MAX_PACKAGE_SIZE 500 Maximum package size in kilobytes (1..2000).
MAX_CHECK_TIMEOUT 300 Check time-out is 80% of the interval time with MAX_CHECK_TIMEOUT in seconds as absolute maximum.
DRY_RUN none Do not run demonized, just return checks and assets specified in the given yaml (see the Dry run section below).
LOG_LEVEL warning Log level (debug, info, warning, error or critical).
LOG_COLORIZED 0 Log using colors (0=disabled, 1=enabled).
LOG_FMT %y%m%d %H:%M:%S Log format prefix.

Docker build

docker build -t snmp-probe . --no-cache

Config

Example configuration: (the example below is the default when no config is given)

snmp:
  config:
    version: "2c"
    community:
      secret: public

For SNMP version 3:

snmp:
  config:
    version: "3"
    username: alice
    auth:
      # auth is optional; type USM_AUTH_NONE is used when omitted.
      # supported:
      #   USM_AUTH_HMAC96_MD5, USM_AUTH_HMAC96_SHA,
      #   USM_AUTH_HMAC128_SHA224, USM_AUTH_HMAC192_SHA256,
      #   USM_AUTH_HMAC256_SHA384, USM_AUTH_HMAC384_SHA512 or USM_AUTH_NONE
      type: USM_AUTH_HMAC96_SHA
      password: "my secret password"
    priv:
      # priv is optional; type USM_PRIV_NONE is used when omitted.
      # supported:
      #   USM_PRIV_CBC56_DES, USM_PRIV_CFB128_AES or USM_PRIV_NONE
      type: USM_PRIV_CFB128_AES
      password: "my secret password"

Dry run

Available checks:

  • base
  • device
  • entity
  • sensor
  • interface
  • ipAddress
  • ipForward
  • powerEthernet
  • process
  • processor
  • storage
  • system
  • tcpConnection
  • tcpListener
  • ucd
  • ip
  • tcp
  • udp
  • lldp

Create a yaml file, for example (test.yaml):

asset:
  name: "foo.local"
  check: "system"
  config:
    address: "192.168.1.2"

Run the probe with the DRY_RUN environment variable set the the yaml file above.

DRY_RUN=test.yaml python main.py

About

InfraSonar Basic SNMP probe collector

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

 
 
 

Contributors