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:
- Go to Nodes.
- 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.
- The Collectors → Jobs view opens by default.
- In the Search box, type snmp (or scroll the list) to locate the snmp collector.
- Click the + next to the snmp collector to add a new job.
- 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. |
Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.