SNMP-enabled hardware

OpsVerse ObserveNow has support to pull metrics from most SNMP-enabled hardware, such as firewalls, switches, modems and IOT devices.
To setup SNMP Exporter, we create a set of targets/urls to monitor. And the OpsVerse agent queries the exporter with these targets/urls which generates endpoint metrics.
A sample configuration is shown below
Please ensure that the SNMP-enabled device is accessible from the machine/cluster running the OpsVerse Agent
Kubernetes Agent Configuration
Add the following YAML snippets to the OpsVerse agent's values.yaml file.
YAML
snmp-exporter:
  enabled: true
snmp-exporter:
  enabled: true
﻿
And add the following scrape config:
YAML
victoria-metrics-agent:
  extraScrapeConfigs:
  - job_name: 'snmp'
    static_configs:
      - targets:
        - 192.168.1.2  # SNMP device.
        - switch.local # SNMP device.
        - tcp://192.168.1.3:1161  # SNMP device using TCP transport and custom port.
    metrics_path: /snmp
    params:
      auth: [public_v2]
      module: [if_mib]
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: devopsnow-agent-snmp-exporter.devopsnow:9116
victoria-metrics-agent:
  extraScrapeConfigs:
  - job_name: 'snmp'
    static_configs:
      - targets:
        - 192.168.1.2  # SNMP device.
        - switch.local # SNMP device.
        - tcp://192.168.1.3:1161  # SNMP device using TCP transport and custom port.
    metrics_path: /snmp
    params:
      auth: [public_v2]
      module: [if_mib]
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: devopsnow-agent-snmp-exporter.devopsnow:9116
﻿
and reinstall the helm chart using the following command:
Shell
helm upgrade --install devopsnow-agent -n devopsnow \
    --repo https://registry.devopsnow.io/chartrepo/public \
    -f <path to opsverse-values.yaml file>
helm upgrade --install devopsnow-agent -n devopsnow \
    --repo https://registry.devopsnow.io/chartrepo/public \
    -f <path to opsverse-values.yaml file>
﻿
To add custom auth/modules, create a configmap with the auth modules as shown at the end of this page, then set the following in values.yaml:
YAML
snmp-exporter:
  extraConfigmapMounts:
    - name: snmp-exporter-configmap
      mountPath: /run/secrets/snmp-exporter
      subPath: snmp-custom.yaml
      configMap: snmp-exporter-configmap-configmap # Your Configmap here
      readOnly: true
      defaultMode: 420

  extraArgs: ["--config.file=/run/secrets/snmp-exporter/snmp-custom.yaml"]
snmp-exporter:
  extraConfigmapMounts:
    - name: snmp-exporter-configmap
      mountPath: /run/secrets/snmp-exporter
      subPath: snmp-custom.yaml
      configMap: snmp-exporter-configmap-configmap # Your Configmap here
      readOnly: true
      defaultMode: 420

  extraArgs: ["--config.file=/run/secrets/snmp-exporter/snmp-custom.yaml"]
﻿
﻿
﻿
Single Machine Configuration
Alternatively, you can install the Prometheus SNMP Exporter on a single machine.
﻿
Prerequisite(s):
You have the OpsVerse Agent running on the machine﻿
Run this command to install the SNMP Exporter
Shell
# for amd64
curl https://raw.githubusercontent.com/OpsVerseIO/installers/main/prometheus-exporters/install-exporter-amd64.sh | sudo bash -s -- -e snmp  

# for arm64
curl https://raw.githubusercontent.com/OpsVerseIO/installers/main/prometheus-exporters/install-exporter-arm64.sh | sudo bash -s -- -e snmp  
# for amd64
curl https://raw.githubusercontent.com/OpsVerseIO/installers/main/prometheus-exporters/install-exporter-amd64.sh | sudo bash -s -- -e snmp  

# for arm64
curl https://raw.githubusercontent.com/OpsVerseIO/installers/main/prometheus-exporters/install-exporter-arm64.sh | sudo bash -s -- -e snmp  
﻿
Edit the OpsVerse agent config file by using the following command:
Shell
sudo vi /etc/opsverse/agent-config.yaml
sudo vi /etc/opsverse/agent-config.yaml
﻿
Add the SNMP exporter job under scrape_configs and edit the fields as required.
Shell
- job_name: 'snmp-exporter'
    static_configs:
      - targets:
        - 192.168.1.2  # SNMP device.
        - switch.local # SNMP device.
        - tcp://192.168.1.3:1161  # SNMP device using TCP transport and custom port.
    metrics_path: /snmp
    params:
      auth: [public_v2]
      module: [if_mib]
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: 127.0.0.1:9116  # The SNMP exporter's hostname:port.
- job_name: 'snmp-exporter'
    static_configs:
      - targets:
        - 192.168.1.2  # SNMP device.
        - switch.local # SNMP device.
        - tcp://192.168.1.3:1161  # SNMP device using TCP transport and custom port.
    metrics_path: /snmp
    params:
      auth: [public_v2]
      module: [if_mib]
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: 127.0.0.1:9116  # The SNMP exporter's hostname:port.
﻿
To add custom auth, edit /etc/opsverse/exporters/snmp/snmp-config-custom.yml to add a custom auth module and restart the snmp-exporter service using systemctl restart prom-snmp-exporter.service.
Sample:
auths:
  custom_auth:
    community: mysecret
    security_level: SomethingReadOnly
    username: <username>
    password: <pass>
    auth_protocol: SHA256
    priv_protocol: AES
    priv_password: <privpass>
﻿
Did this page help you?
VMWare vCenter
Prometheus-Compatible Metrics EndEndpoints