​

Ciscoos Receiver

​

Supported Telemetry

​

Overview

​

Configuration

​

Device Configuration

• Password authentication: Provide auth.password
• SSH key file authentication: Provide auth.key_file (path to private key)
  • Supports unencrypted keys in RSA, ECDSA, Ed25519 formats
  • Supports both PEM and OpenSSH formats
  • Encrypted keys are not supported
• Fallback authentication: Provide both auth.password and auth.key_file
  • Key file is tried first, password is used as fallback if key authentication fails

​

Scrapers Configuration

​

Metrics Collected

​

System Metrics

• cisco.device.up - Device availability (1=up, 0=down)
• system.cpu.utilization - CPU utilization as a percentage (0-1)
  • NX-OS: Calculated from show system resources (user + kernel)
  • IOS/IOS XE: Calculated from show process cpu (5-second average)
• system.memory.utilization - Memory utilization as a percentage (0-1)
  • NX-OS: Calculated from show system resources (used / total)
  • IOS/IOS XE: Calculated from show process memory (Processor Pool used / total)

​

Interface Metrics

• system.network.io - Number of bytes transmitted and received (with network.io.direction attribute: receive or transmit)
• system.network.errors - Number of errors encountered (with network.io.direction attribute: receive or transmit)
• system.network.packet.dropped - Number of packets dropped (with network.io.direction attribute: receive or transmit)
• system.network.packet.count - Number of packets transmitted or received, categorized by type (with network.packet.type attribute: multicast or broadcast)
• system.network.interface.status - Interface operational status (1 = up, 0 = down)

​

Resource Attributes

• host.ip - Device IP address for correlation with Kubernetes nodes and other resources
• hw.type - Hardware type, set to “network” per OpenTelemetry hardware.network conventions
• os.name - Operating system name (e.g., “NX-OS”, “IOS XE”, “IOS”)

​

Example Configuration

receivers:
  ciscoos:
    collection_interval: 60s
    timeout: 30s
    scrapers:
      system:
      interfaces:
    devices:
      - name: "core-switch-01"
        host: "192.168.1.10"
        port: 22
        auth:
          username: "admin"
          password: "secure-password"
      - name: "edge-router-01"
        host: "192.168.1.20"
        port: 22
        auth:
          username: "admin"
          key_file: "/home/user/.ssh/id_rsa"

exporters:
  debug:

service:
  pipelines:
    metrics:
      receivers: [ciscoos]
      exporters: [debug]

​

Configuration

​

Example Configuration

ciscoos:
  collection_interval: 60s
  timeout: 30s
  scrapers:
    system:
    interfaces:
  devices:
    - name: "device-1"
      host: "192.168.1.1"
      port: 22
      auth:
        username: "admin"
        password: "password"
    - name: "device-2"
      host: "192.168.1.2"
      port: 22
      auth:
        username: "admin"
        password: "password"