Skip to main content

Fortinet Appliance

Fortinet Appliance

Plugin: go.d.plugin Module: snmp

Maintained by Netdata

Overview​

Monitor Fortinet Appliance (network device) with Netdata over SNMP. Netdata recognizes the device automatically by its sysObjectID (recognized across 64 device identifiers) and collects the metrics this profile declares — on top of the generic SNMP baseline — with no manual OID configuration.

Netdata's SNMP collector matches the device to the fortinet-appliance.yaml profile via sysObjectID/sysDescr, then polls the OIDs it declares.

This integration is supported on all platforms.

This integration supports multiple instances configured side-by-side.

Default Behavior​

Auto-Detection​

Auto-detected as Fortinet Appliance via sysObjectID/sysDescr.

Limits​

The default configuration for this integration does not impose any limits.

Performance Impact​

The default configuration for this integration is not expected to impose a significant performance impact on the system.

Setup​

You can configure the snmp collector in two ways:

MethodBest forHow to
UIFast setup without editing filesGo to Nodes → Configure this node → Collectors → Jobs, search for snmp, then click + to add a job.
FileIf you prefer configuring via file, or need to automate deployments (e.g., with Ansible)Edit go.d/snmp.conf and add a job.
important

UI configuration requires paid Netdata Cloud plan.

Prerequisites​

SNMP access​

SNMP must be enabled on the device and reachable from the Netdata Agent acting as the site's SNMP hub.

Configuration​

Options​

Configure the SNMP collector with the device hostname and SNMP credentials. See the SNMP collector reference for all options.

via UI​

Configure the snmp collector from the Netdata web interface:

  1. Go to Nodes.
  2. Select the node where you want the snmp data-collection job to run and click the ⚙ (Configure this node). That node will run the data collection.
  3. The Collectors → Jobs view opens by default.
  4. In the Search box, type snmp (or scroll the list) to locate the snmp collector.
  5. Click the + next to the snmp collector to add a new job.
  6. Fill in the job fields, then click Test to verify the configuration and Submit to save.
    • Test runs the job with the provided settings and shows whether data can be collected.
    • If it fails, an error message appears with details (for example, connection refused, timeout, or command execution errors), so you can adjust and retest.

via File​

The configuration file name for this integration is go.d/snmp.conf.

The file format is YAML. Generally, the structure is:

update_every: 1
autodetection_retry: 0
jobs:
- name: some_name1
- name: some_name2

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config go.d/snmp.conf
Examples​

There are no configuration examples.

Alerts​

There are no alerts configured by default for this integration.

Metrics​

On top of the generic SNMP baseline (the Generic SNMP Device integration — interfaces, system, IP/TCP/UDP, host resources), this Fortinet Appliance profile adds the metrics below. Each is collected only where the device exposes the matching OID — inclusion means the profile requests it; availability depends on the device model and software.

31 metrics in 10 groups; each row is a chart context usable in alerts.

GroupMetrics
Hardware / Sensor1
Network / Interface4
Security / Device7
Security / Log1
Storage / RAID6
System / CPU2
System / Disk2
System / HA5
System / Memory2
System / Uptime1

Hardware / Sensor​

Metric (chart context)UnitScopeDescription
snmp.device_prof_fmSensorEntState{status}per fm_sensor_ent_name, fm_sensor_ent_typeSensor status

Network / Interface​

Metric (chart context)UnitScopeDescription
snmp.device_prof_ifAdminStatus{status}per interface, interfaceCurrent administrative state of the interface
snmp.device_prof_ifHighSpeedbit/sper interface, interfaceEstimate of the interface's current bandwidth
snmp.device_prof_ifNumber{interface}deviceNumber of network interfaces regardless of their current state present on this system
snmp.device_prof_ifOperStatus{status}per interface, interfaceCurrent operational state of the interface

Security / Device​

Metric (chart context)UnitScopeDescription
snmp.device_prof_fmDeviceEntConfigState{status}per fm_device_ent_indexDevice config status
snmp.device_prof_fmDeviceEntConnectState{status}per fm_device_ent_indexDevice connection status
snmp.device_prof_fmDeviceEntDbState{status}per fm_device_ent_indexDevice database status
snmp.device_prof_fmDeviceEntHaMode{status}per fm_device_ent_indexDevice high availability mode
snmp.device_prof_fmDeviceEntMode{status}per fm_device_ent_indexDevice management mode
snmp.device_prof_fmDeviceEntState{status}per fm_device_ent_indexDevice status
snmp.device_prof_fmDeviceEntSupportState{status}per fm_device_ent_indexThe support status of the device

Security / Log​

Metric (chart context)UnitScopeDescription
snmp.device_prof_fmLogRate{log}/sdeviceLog receiving rate in number of logs per second

Storage / RAID​

Metric (chart context)UnitScopeDescription
snmp.device_prof_fmRaidDiskEntSizeByper fm_raid_disk_ent_indexRaid disk size in GB
snmp.device_prof_fmRaidDiskEntState{status}per fm_raid_disk_ent_indexRaid disk status
snmp.device_prof_fmRaidDiskNumber{disk}deviceDisk numbers in the Raid
snmp.device_prof_fmRaidLevel{status}deviceRAID Level
snmp.device_prof_fmRaidSizeBydeviceRaid size in GB
snmp.device_prof_fmRaidState{status}deviceRAID Status

System / CPU​

Metric (chart context)UnitScopeDescription
snmp.device_prof_cpu_usage%deviceThe current CPU utilization
snmp.device_prof_fmSysCpuUsageExcludedNice%deviceCurrent CPU usage excluded nice processes usage (percentage)

System / Disk​

Metric (chart context)UnitScopeDescription
snmp.device_prof_fmSysDiskCapacityBydeviceTotal hard disk capacity
snmp.device_prof_fmSysDiskUsageBydeviceCurrent hard disk usage

System / HA​

Metric (chart context)UnitScopeDescription
snmp.device_prof_fmHaClusterId1deviceHa cluster ID
snmp.device_prof_fmHaMode{status}deviceHigh availability mode
snmp.device_prof_fmHaPeerEntEnabled{status}per fm_ha_peer_ent_indexWhether peer is enabled
snmp.device_prof_fmHaPeerEntState{status}per fm_ha_peer_ent_indexPeer status
snmp.device_prof_fmHaPeerNumber{peer}devicePeer numbers in the Ha

System / Memory​

Metric (chart context)UnitScopeDescription
snmp.device_prof_memory_totalBydeviceTotal physical and swap memory installed
snmp.device_prof_memory_usedBydeviceCurrent memory used

System / Uptime​

Metric (chart context)UnitScopeDescription
snmp.device_prof_systemUptimesdeviceTime since the system was last rebooted or powered on.

Troubleshooting​

Other Problems​

Collect Diagnostics for Netdata Support​

For SNMP metrics, BGP, licensing, or topology issues, follow Collect SNMP troubleshooting data to include built-in diagnostics in a support bundle. SNMP evidence is unsanitized; share the bundle through a restricted Netdata Support ticket.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.