Cisco UCS

Plugin: go.d.plugin Module: snmp

Overview

Monitor Cisco UCS (ucs) with Netdata over SNMP. Netdata recognizes the device automatically by its sysObjectID (recognized across 4 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 cisco-ucs.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 Cisco UCS 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:

Method	Best for	How to
UI	Fast setup without editing files	Go to Nodes → Configure this node → Collectors → Jobs, search for snmp, then click + to add a job.
File	If 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 Cisco UCS 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.

74 metrics in 12 groups; each row is a chart context usable in alerts.

Group	Metrics
Hardware / Board	11
Hardware / CPU	9
Hardware / Fan	5
Hardware / Memory	7
Hardware / PowerSupply	5
Network / Interface	4
RackUnit / CPU	3
RackUnit / Memory	2
RackUnit / Status	9
RackUnit / Temperature	4
Storage / FlexFlash	14
System / Uptime	1

Hardware / Board

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsComputeBoardOperPower	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Operational power state of the board
snmp.device_prof_cucsComputeBoardOperState	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Operational state of the board
snmp.device_prof_cucsComputeBoardOperability	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Operability state of the board
snmp.device_prof_cucsComputeBoardPerf	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Performance state of the board
snmp.device_prof_cucsComputeBoardPower	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Power state of the board
snmp.device_prof_cucsComputeBoardPresence	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Presence state of the board
snmp.device_prof_cucsComputeBoardThermal	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Thermal state of the board
snmp.device_prof_cucsComputeBoardVoltage	{status}	per cucs_compute_board_dn, cucs_compute_board_model, cucs_compute_board_serial, cucs_compute_board_vendor	Voltage state of the board
snmp.device_prof_cucsComputeMbPowerStatsConsumedPower	W	per cucs_compute_mb_power_stats_dn	Consumed power
snmp.device_prof_cucsComputeMbPowerStatsInputCurrent	A	per cucs_compute_mb_power_stats_dn	Input current
snmp.device_prof_cucsComputeMbPowerStatsInputVoltage	V	per cucs_compute_mb_power_stats_dn	Input voltage

Hardware / CPU

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsProcessorEnvStatsTemperature	Cel	per cucs_processor_env_stats_dn	Temperature
snmp.device_prof_cucsProcessorUnitCores	{core}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Number of cores
snmp.device_prof_cucsProcessorUnitCoresEnabled	{core}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Number of cores enabled
snmp.device_prof_cucsProcessorUnitOperState	{status}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Operational state of the processor unit
snmp.device_prof_cucsProcessorUnitOperability	{status}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Operability state of the processor unit
snmp.device_prof_cucsProcessorUnitPerf	{status}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Performance state of the processor unit
snmp.device_prof_cucsProcessorUnitPower	{status}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Power state of the processor unit
snmp.device_prof_cucsProcessorUnitPresence	{status}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Presence state of the processor unit
snmp.device_prof_cucsProcessorUnitThreads	{thread}	per cucs_processor_unit_dn, cucs_processor_unit_arch, cucs_processor_unit_model, cucs_processor_unit_vendor	Number of threads

Hardware / Fan

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsEquipmentFanOperState	{status}	per cucs_equipment_fan_dn, cucs_equipment_fan_int_type	Operational state of the fan
snmp.device_prof_cucsEquipmentFanOperability	{status}	per cucs_equipment_fan_dn, cucs_equipment_fan_int_type	Operability state of the fan
snmp.device_prof_cucsEquipmentFanPerf	{status}	per cucs_equipment_fan_dn, cucs_equipment_fan_int_type	Performance state of the fan
snmp.device_prof_cucsEquipmentFanPower	{status}	per cucs_equipment_fan_dn, cucs_equipment_fan_int_type	Power state of the fan
snmp.device_prof_cucsEquipmentFanPresence	{status}	per cucs_equipment_fan_dn, cucs_equipment_fan_int_type	Presence state of the fan

Hardware / Memory

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsMemoryUnitCapacity	By	per cucs_memory_unit_dn, cucs_memory_unit_location, cucs_memory_unit_type	Capacity of the memory unit
snmp.device_prof_cucsMemoryUnitEnvStatsTemperature	Cel	per cucs_memory_unit_env_stats_dn	Temperature
snmp.device_prof_cucsMemoryUnitOperState	{status}	per cucs_memory_unit_dn, cucs_memory_unit_location, cucs_memory_unit_type	Operational state of the memory unit
snmp.device_prof_cucsMemoryUnitOperability	{status}	per cucs_memory_unit_dn, cucs_memory_unit_location, cucs_memory_unit_type	Operability state of the memory unit
snmp.device_prof_cucsMemoryUnitPerf	{status}	per cucs_memory_unit_dn, cucs_memory_unit_location, cucs_memory_unit_type	Performance state of the memory unit
snmp.device_prof_cucsMemoryUnitPower	{status}	per cucs_memory_unit_dn, cucs_memory_unit_location, cucs_memory_unit_type	Power state of the memory unit
snmp.device_prof_cucsMemoryUnitPresence	{status}	per cucs_memory_unit_dn, cucs_memory_unit_location, cucs_memory_unit_type	Presence state of the memory unit

Hardware / PowerSupply

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsEquipmentPsuOperState	{status}	per cucs_equipment_psu_dn, cucs_equipment_psu_model, cucs_equipment_psu_revision, cucs_equipment_psu_serial	Operational state of the psu
snmp.device_prof_cucsEquipmentPsuOperability	{status}	per cucs_equipment_psu_dn, cucs_equipment_psu_model, cucs_equipment_psu_revision, cucs_equipment_psu_serial	Operability state of the psu
snmp.device_prof_cucsEquipmentPsuPerf	{status}	per cucs_equipment_psu_dn, cucs_equipment_psu_model, cucs_equipment_psu_revision, cucs_equipment_psu_serial	Performance state of the psu
snmp.device_prof_cucsEquipmentPsuPower	{status}	per cucs_equipment_psu_dn, cucs_equipment_psu_model, cucs_equipment_psu_revision, cucs_equipment_psu_serial	Power state of the psu
snmp.device_prof_cucsEquipmentPsuPresence	{status}	per cucs_equipment_psu_dn, cucs_equipment_psu_model, cucs_equipment_psu_revision, cucs_equipment_psu_serial	Presence state of the psu

Network / Interface

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ifAdminStatus	{status}	per interface, interface	Current administrative state of the interface
snmp.device_prof_ifHighSpeed	bit/s	per interface, interface	Estimate of the interface's current bandwidth
snmp.device_prof_ifNumber	{interface}	device	Number of network interfaces regardless of their current state present on this system
snmp.device_prof_ifOperStatus	{status}	per interface, interface	Current operational state of the interface

RackUnit / CPU

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsComputeRackUnitNumOfCores	{core}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Number of cores
snmp.device_prof_cucsComputeRackUnitNumOfCpus	{cpu}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Number of cpus
snmp.device_prof_cucsComputeRackUnitNumOfThreads	{thread}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Number of threads

RackUnit / Memory

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsComputeRackUnitAvailableMemory	By	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Rack unit available memory
snmp.device_prof_cucsComputeRackUnitTotalMemory	By	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Rack Unit total memory

RackUnit / Status

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsComputeRackUnitAdminPower	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Admin power state of the rack unit
snmp.device_prof_cucsComputeRackUnitAdminState	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Admin state of the rack unit
snmp.device_prof_cucsComputeRackUnitAssociation	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Association state of the rack unit
snmp.device_prof_cucsComputeRackUnitAvailability	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Availability state of the rack unit
snmp.device_prof_cucsComputeRackUnitCheckPoint	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Checkpoint state of the rack unit
snmp.device_prof_cucsComputeRackUnitOperPower	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Operational power state of the rack unit
snmp.device_prof_cucsComputeRackUnitOperState	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Operational state of the rack unit
snmp.device_prof_cucsComputeRackUnitOperability	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Operability state of the rack unit
snmp.device_prof_cucsComputeRackUnitPresence	{status}	per cucs_compute_rack_unit_dn, cucs_compute_rack_unit_model, cucs_compute_rack_unit_name, cucs_compute_rack_unit_serial, cucs_compute_rack_unit_uuid, cucs_compute_rack_unit_vendor	Presence state of the rack unit

RackUnit / Temperature

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsComputeRackUnitMbTempStatsAmbientTemp	Cel	per cucs_compute_rack_unit_mb_temp_stats_dn	Ambient temperature
snmp.device_prof_cucsComputeRackUnitMbTempStatsFrontTemp	Cel	per cucs_compute_rack_unit_mb_temp_stats_dn	Front temperature
snmp.device_prof_cucsComputeRackUnitMbTempStatsIoh1Temp	Cel	per cucs_compute_rack_unit_mb_temp_stats_dn	Ioh1 temperature
snmp.device_prof_cucsComputeRackUnitMbTempStatsRearTemp	Cel	per cucs_compute_rack_unit_mb_temp_stats_dn	Rear temperature

Storage / FlexFlash

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cucsStorageFlexFlashCardCardHealth	{status}	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Health state of the flex flash card
snmp.device_prof_cucsStorageFlexFlashCardCardMode	{status}	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Mode of the flex flash card
snmp.device_prof_cucsStorageFlexFlashCardCardState	{status}	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	State of the flex flash card
snmp.device_prof_cucsStorageFlexFlashCardCardSync	{status}	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Sync state of the flex flash card
snmp.device_prof_cucsStorageFlexFlashCardDrivesEnabled	{drive}	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Number of drives enabled
snmp.device_prof_cucsStorageFlexFlashCardOperability	{status}	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Operability state of the flex flash card
snmp.device_prof_cucsStorageFlexFlashCardPresence	{status}	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Presence state of the flex flash card
snmp.device_prof_cucsStorageFlexFlashCardReadIOErrorCount	{error}/s	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Read io error count
snmp.device_prof_cucsStorageFlexFlashCardSize	By	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Size of the flex flash card
snmp.device_prof_cucsStorageFlexFlashCardWriteIOErrorCount	{error}/s	per cucs_storage_flex_flash_card_dn, cucs_storage_flex_flash_card_card_type, cucs_storage_flex_flash_card_revision, cucs_storage_flex_flash_card_serial, cucs_storage_flex_flash_card_connection_protocol	Write io error count
snmp.device_prof_cucsStorageFlexFlashDriveOperability	{status}	per cucs_storage_flex_flash_drive_dn, cucs_storage_flex_flash_drive_model, cucs_storage_flex_flash_drive_name, cucs_storage_flex_flash_drive_visible, cucs_storage_flex_flash_drive_removable, cucs_storage_flex_flash_drive_rw_type, cucs_storage_flex_flash_drive_state, cucs_storage_flex_flash_drive_connection_protocol, cucs_storage_flex_flash_drive_type	Operability state of the flex flash drive
snmp.device_prof_cucsStorageFlexFlashDriveOperationState	{status}	per cucs_storage_flex_flash_drive_dn, cucs_storage_flex_flash_drive_model, cucs_storage_flex_flash_drive_name, cucs_storage_flex_flash_drive_visible, cucs_storage_flex_flash_drive_removable, cucs_storage_flex_flash_drive_rw_type, cucs_storage_flex_flash_drive_state, cucs_storage_flex_flash_drive_connection_protocol, cucs_storage_flex_flash_drive_type	Operation state of the flex flash drive
snmp.device_prof_cucsStorageFlexFlashDrivePresence	{status}	per cucs_storage_flex_flash_drive_dn, cucs_storage_flex_flash_drive_model, cucs_storage_flex_flash_drive_name, cucs_storage_flex_flash_drive_visible, cucs_storage_flex_flash_drive_removable, cucs_storage_flex_flash_drive_rw_type, cucs_storage_flex_flash_drive_state, cucs_storage_flex_flash_drive_connection_protocol, cucs_storage_flex_flash_drive_type	Presence state of the flex flash drive
snmp.device_prof_cucsStorageFlexFlashDriveSize	By	per cucs_storage_flex_flash_drive_dn, cucs_storage_flex_flash_drive_model, cucs_storage_flex_flash_drive_name, cucs_storage_flex_flash_drive_visible, cucs_storage_flex_flash_drive_removable, cucs_storage_flex_flash_drive_rw_type, cucs_storage_flex_flash_drive_state, cucs_storage_flex_flash_drive_connection_protocol, cucs_storage_flex_flash_drive_type	Size of the flex flash drive

System / Uptime

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_systemUptime	s	device	Time 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.