Configure the Cisco OS receiver to collect Cisco Nexus metrics
Collect Cisco Nexus metrics with the Collector for Kubernetes.
To use the Cisco OS receiver to collect Cisco Nexus metrics, you must meet the following requirements.
-
You have installed the Splunk Distribution of the OpenTelemetry Collector for Kubernetes to monitor Cisco AI PODs. For instructions, see Install the Collector for Kubernetes to monitor Cisco AI PODs.Note: This solution requires using the latest version of the Collector. For upgrade instructions, see .
-
You have configured your Cisco Nexus switches to enable SSH access for the Splunk Distribution of the OpenTelemetry Collector for Kubernetes. For instructions, see Configuring SSH and Telnet in the Cisco Nexus documentation.
-
If your Cisco Nexus switch is deployed on a Red Hat OpenShift IBM Cloud cluster, you also must add a new network policy to enable SSH access. For instructions, see Controlling traffic with network policies in the IBM Cloud documentation.
Configuration settings
Configure scrapers
The Cisco OS receiver supports two types of scrapers, system and interfaces, which collect different metrics. For the list of metrics collected by each scraper, see Metrics.
To activate or deactivate a specific scraper for the Cisco OS receiver, update the scrapers section of the values.yaml configuration file and enable at least one metric. For example:
scrapers:
system:
metrics:
cisco.device.up:
enabled: true Configure metric collection
metrics section of the values.yaml configuration file. For example: scrapers:
system:
metrics:
cisco.device.up:
enabled: true
system.cpu.utilization:
enabled: true
system.memory.utilization:
enabled: true
interfaces:
metrics:
system.network.io:
enabled: true
system.network.errors:
enabled: true
system.network.packet.dropped:
enabled: true
system.network.packet.count:
enabled: true
system.network.interface.status:
enabled: true For more information on these metrics, see Metrics.
Metrics
default metric category.| Metric name | Unit | Description | Attributes | Scraper |
|---|---|---|---|---|
cisco.device.up | Binary | Device availability (1 = up, 0 = down). | None | system |
system.cpu.utilization | Percent | Percentage of CPU time in use. | None | system |
system.memory.utilization | Percent | Percentage of memory bytes in use. | None | system |
system.network.errors | Count | The number of errors encountered. | network.io.direction | interfaces |
system.network.interface.status | Binary | Interface operational status (1 = up, 0 = down). | None | interfaces |
system.network.io | Bytes | The number of bytes transmitted and received. | network.io.direction | interfaces |
system.network.packet.count | Count | The number of packets transmitted or received, categorized by type. | network.packet.type | interfaces |
system.network.packet.dropped | Count | The number of packets dropped. | network.io.direction | interfaces |
Attributes
| Resource attribute name | Type | Description |
|---|---|---|
host.ip | string | The IP address of the Cisco network device. |
hw.type | string | The type of physical hardware component. |
os.name | string | The operating system type of the Cisco device. |
| Metric attribute | Type | Description |
|---|---|---|
network.io.direction | string | The network IO direction. Possible values: receive, transmit. |
network.packet.type | string | The network packet type. Possible values: multicast, broadcast. |