[receiver/ciscoosreceiver] Implement interface scrapper (open-telemetry#43815)

<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description
Adds interface scraper to Cisco OS receiver with 9 network metrics
following OpenTelemetry semantic conventions:

<!-- Issue number (e.g. open-telemetry#1234) or full URL to issue, if applicable. -->
#### Link to tracking issue

open-telemetry#42647

<!--Describe what testing was performed and which tests were added.-->
#### Testing
- Configuration validation and defaults
- Factory creation and lifecycle tests
- Interface parser (status, validation, formatting)
- Fixed metric names to match OpenTelemetry conventions
- Multi-device configuration tests
- 
<!--Describe the documentation added.-->
#### Documentation
- Complete README with metric specifications and examples
- All metrics defined in metadata.yaml
- Generated documentation.md with attribute details

<!--Please delete paragraphs that you did not use before submitting.-->

Author: etserend

.chloggen/42647-add-system-scraper.yaml

@@ -0,0 +1,29 @@
+# Use this changelog template to create an entry for release notes.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: enhancement
+
+# The name of the component, or a single word describing the area of concern, (e.g. receiver/filelog)
+component: receiver/ciscoosreceiver
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: "`ciscoosreceiver`: Add new receiver for collecting metrics from Cisco network devices via SSH"
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+issues: [42647]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext: |
+  Supports Cisco IOS, IOS-XE, and NX-OS devices with SSH-based metric collection.
+  Initial implementation includes system scraper for device availability and connection metrics.
+
+# If your change doesn't affect end users or the exported elements of any package,
+# you should instead start your pull request title with [chore] or use the "Skip Changelog" label.
+# Optional: The change log or logs in which this entry should be included.
+# e.g. '[user]' or '[user, api]'
+# Include 'user' if the change is relevant to end users.
+# Include 'api' if there is a change to a library API.
+# Default: '[user]'
+change_logs: [user]

.chloggen/config.yaml

@@ -330,6 +330,7 @@ components:
     - scraper/cpu
     - scraper/disk
     - scraper/filesystem
+    - scraper/interfaces
     - scraper/load
     - scraper/memory
     - scraper/network

.github/CODEOWNERS

@@ -241,6 +241,7 @@ receiver/azureeventhubreceiver/                                  @open-telemetry
 receiver/azuremonitorreceiver/                                   @open-telemetry/collector-contrib-approvers @nslaughter @celian-garcia @ishleenk17
 receiver/chronyreceiver/                                         @open-telemetry/collector-contrib-approvers @MovieStoreGuy @jamesmoessis
 receiver/ciscoosreceiver/                                        @open-telemetry/collector-contrib-approvers @dmitryax
+receiver/ciscoosreceiver/internal/scraper/interfacesscraper/     @open-telemetry/collector-contrib-approvers
 receiver/ciscoosreceiver/internal/scraper/systemscraper/         @open-telemetry/collector-contrib-approvers
 receiver/cloudflarereceiver/                                     @open-telemetry/collector-contrib-approvers @dehaansa
 receiver/cloudfoundryreceiver/                                   @open-telemetry/collector-contrib-approvers @crobert-1

.github/ISSUE_TEMPLATE/beta_stability.yaml

@@ -242,6 +242,7 @@ body:
       - receiver/carbon
       - receiver/chrony
       - receiver/ciscoos
+      - receiver/ciscoos/internal/scraper/interfacesscraper
       - receiver/ciscoos/internal/scraper/systemscraper
       - receiver/cloudflare
       - receiver/cloudfoundry

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -245,6 +245,7 @@ body:
       - receiver/carbon
       - receiver/chrony
       - receiver/ciscoos
+      - receiver/ciscoos/internal/scraper/interfacesscraper
       - receiver/ciscoos/internal/scraper/systemscraper
       - receiver/cloudflare
       - receiver/cloudfoundry

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -239,6 +239,7 @@ body:
       - receiver/carbon
       - receiver/chrony
       - receiver/ciscoos
+      - receiver/ciscoos/internal/scraper/interfacesscraper
       - receiver/ciscoos/internal/scraper/systemscraper
       - receiver/cloudflare
       - receiver/cloudfoundry

.github/ISSUE_TEMPLATE/other.yaml

@@ -239,6 +239,7 @@ body:
       - receiver/carbon
       - receiver/chrony
       - receiver/ciscoos
+      - receiver/ciscoos/internal/scraper/interfacesscraper
       - receiver/ciscoos/internal/scraper/systemscraper
       - receiver/cloudflare
       - receiver/cloudfoundry

.github/ISSUE_TEMPLATE/unmaintained.yaml

@@ -244,6 +244,7 @@ body:
       - receiver/carbon
       - receiver/chrony
       - receiver/ciscoos
+      - receiver/ciscoos/internal/scraper/interfacesscraper
       - receiver/ciscoos/internal/scraper/systemscraper
       - receiver/cloudflare
       - receiver/cloudfoundry

.github/component_labels.txt

@@ -222,6 +222,7 @@ receiver/azureeventhubreceiver receiver/azureeventhub
 receiver/azuremonitorreceiver receiver/azuremonitor
 receiver/chronyreceiver receiver/chrony
 receiver/ciscoosreceiver receiver/ciscoos
+receiver/ciscoosreceiver/internal/scraper/interfacesscraper receiver/ciscoos/internal/scraper/interfaces
 receiver/ciscoosreceiver/internal/scraper/systemscraper receiver/ciscoos/internal/scraper/systemscraper
 receiver/cloudflarereceiver receiver/cloudflare
 receiver/cloudfoundryreceiver receiver/cloudfoundry

receiver/ciscoosreceiver/README.md

@@ -58,6 +58,7 @@ The scrapers are configured as modular components. Each scraper type can be conf
 | Setting | Type | Description |
 |---------|------|-------------|
 | `system` | map | System metrics (device availability, CPU, memory) |
+| `interfaces` | map | Interface metrics (traffic, errors, status) |
 
 ## Metrics Collected
 
@@ -70,8 +71,24 @@ The scrapers are configured as modular components. Each scraper type can be conf
   - NX-OS: Calculated from `show system resources` (used / total)
   - IOS/IOS XE: Calculated from `show process memory` (Processor Pool used / total)
 
-### Attributes
-All metrics include the `target` attribute with the device's IP address for correlation with Kubernetes nodes and other resources.
+### 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)
+
+Interface metrics include attributes: `network.interface.name`, `network.interface.mac`, `network.interface.description`, `network.interface.speed`
+
+Metrics with direction attribute also include: `network.io.direction` (enum: `receive`, `transmit`)
+
+Metrics with packet type attribute also include: `network.packet.type` (enum: `multicast`, `broadcast`)
+
+### Resource Attributes
+All metrics include the following resource attributes following OpenTelemetry semantic conventions:
+- `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
 
@@ -99,6 +116,18 @@ receivers:
             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
 
   # Example 2: SSH key file authentication
   ciscoosreceiver/router01: