Skip to content

Commit 9266926

Browse files
authored
[receiver/ciscoosreceiver] Add Cisco network device monitoring receiver (open-telemetry#42742)
#### Description Introduce a new Cisco OS receiver to collect metrics from Cisco network devices via SSH, enabling native OpenTelemetry pipelines without external bridges or exporters. This first PR includes structure only (no scraping implementation yet), following contrib “new component” guidelines: - [README.md](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/README.md:0:0-0:0) with In Development stability - [config.go](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/config.go:0:0-0:0) with validation for devices/auth and scraper toggles - [factory.go](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/factory.go:0:0-0:0) using helper factory APIs (returns a no-op metrics receiver for lifecycle tests) - [doc.go](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/doc.go:0:0-0:0) with `//go:generate mdatagen metadata.yaml` - [metadata.yaml](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/metadata.yaml:0:0-0:0) and generated code under [internal/metadata/](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/internal/metadata:0:0-0:0) - Basic unit tests (config, factory, lifecycle) #### Link to tracking issue open-telemetry#42647 #### Testing - Unit tests included and passing: - Config validation tests in [receiver/ciscoosreceiver/config_test.go](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/config_test.go:0:0-0:0) - Factory defaults and lifecycle in [receiver/ciscoosreceiver/factory_test.go](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/factory_test.go:0:0-0:0) - Generated lifecycle tests via `mdatagen` - Local repository checks run: - `make checkdoc`, `make checkmetadata`, `make checkapi` - `make goporto`, `make crosslink`, `make gotidy` - `make genotelcontribcol`, `make genoteltestbedcol`, `make generate` #### Documentation - [receiver/ciscoosreceiver/README.md](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/README.md:0:0-0:0) with: - In Development stability notation - Basic configuration schema and example - Planned scrapers (BGP, Environment, Facts, Interfaces, Optics) for future PRs - [metadata.yaml](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/metadata.yaml:0:0-0:0) with development stability and initial metric scaffolding - [doc.go](cci:7://file:///Users/erden/codebase/forks/Untitled/receiver/ciscoosreceiver/doc.go:0:0-0:0) enabling `mdatagen` code generation @dmitryax - Component sponsor
1 parent 137042b commit 9266926

29 files changed

+965
-0
lines changed
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
2+
change_type: new_component
3+
4+
# The name of the component (path or short name is acceptable)
5+
component: receiver/ciscoosreceiver
6+
7+
# A brief description of the change
8+
note: "Add initial skeleton of Cisco OS receiver (README, config, factory, metadata) with In Development stability."
9+
10+
# Mandatory: tracking issues (use PR number if no issue exists)
11+
issues: [42647]
12+
13+
# Optional: additional lines shown under the main note
14+
subtext: |
15+
This PR adds structure only (no scraping implementation yet).
16+
Scrapers and SSH-based collection logic (BGP, Environment, Facts, Interfaces, Optics) will be added in follow-up PRs.
17+
18+
# Change logs where this entry should appear
19+
change_logs: [user]

.codecov.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -612,6 +612,10 @@ component_management:
612612
name: receiver_chrony
613613
paths:
614614
- receiver/chronyreceiver/**
615+
- component_id: receiver_ciscoos
616+
name: receiver_ciscoos
617+
paths:
618+
- receiver/ciscoosreceiver/**
615619
- component_id: receiver_cloudflare
616620
name: receiver_cloudflare
617621
paths:

.github/CODEOWNERS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,7 @@ receiver/azureblobreceiver/ @open-telemetry
232232
receiver/azureeventhubreceiver/ @open-telemetry/collector-contrib-approvers @atoulme @cparkins @dyl10s
233233
receiver/azuremonitorreceiver/ @open-telemetry/collector-contrib-approvers @nslaughter @celian-garcia @ishleenk17
234234
receiver/chronyreceiver/ @open-telemetry/collector-contrib-approvers @MovieStoreGuy @jamesmoessis
235+
receiver/ciscoosreceiver/ @open-telemetry/collector-contrib-approvers @dmitryax
235236
receiver/cloudflarereceiver/ @open-telemetry/collector-contrib-approvers @dehaansa
236237
receiver/cloudfoundryreceiver/ @open-telemetry/collector-contrib-approvers @crobert-1
237238
receiver/collectdreceiver/ @open-telemetry/collector-contrib-approvers @atoulme

.github/ISSUE_TEMPLATE/beta_stability.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -235,6 +235,7 @@ body:
235235
- receiver/bigip
236236
- receiver/carbon
237237
- receiver/chrony
238+
- receiver/ciscoos
238239
- receiver/cloudflare
239240
- receiver/cloudfoundry
240241
- receiver/collectd

.github/ISSUE_TEMPLATE/bug_report.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -238,6 +238,7 @@ body:
238238
- receiver/bigip
239239
- receiver/carbon
240240
- receiver/chrony
241+
- receiver/ciscoos
241242
- receiver/cloudflare
242243
- receiver/cloudfoundry
243244
- receiver/collectd

.github/ISSUE_TEMPLATE/feature_request.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,7 @@ body:
232232
- receiver/bigip
233233
- receiver/carbon
234234
- receiver/chrony
235+
- receiver/ciscoos
235236
- receiver/cloudflare
236237
- receiver/cloudfoundry
237238
- receiver/collectd

.github/ISSUE_TEMPLATE/other.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,7 @@ body:
232232
- receiver/bigip
233233
- receiver/carbon
234234
- receiver/chrony
235+
- receiver/ciscoos
235236
- receiver/cloudflare
236237
- receiver/cloudfoundry
237238
- receiver/collectd

.github/ISSUE_TEMPLATE/unmaintained.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,7 @@ body:
237237
- receiver/bigip
238238
- receiver/carbon
239239
- receiver/chrony
240+
- receiver/ciscoos
240241
- receiver/cloudflare
241242
- receiver/cloudfoundry
242243
- receiver/collectd

.github/component_labels.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -213,6 +213,7 @@ receiver/azureblobreceiver receiver/azureblob
213213
receiver/azureeventhubreceiver receiver/azureeventhub
214214
receiver/azuremonitorreceiver receiver/azuremonitor
215215
receiver/chronyreceiver receiver/chrony
216+
receiver/ciscoosreceiver receiver/ciscoos
216217
receiver/cloudflarereceiver receiver/cloudflare
217218
receiver/cloudfoundryreceiver receiver/cloudfoundry
218219
receiver/collectdreceiver receiver/collectd

cmd/otelcontribcol/builder-config.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,7 @@ receivers:
163163
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/bigipreceiver v0.136.0
164164
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/carbonreceiver v0.136.0
165165
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/chronyreceiver v0.136.0
166+
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/ciscoosreceiver v0.136.0
166167
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/cloudflarereceiver v0.136.0
167168
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/cloudfoundryreceiver v0.136.0
168169
- gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/collectdreceiver v0.136.0

0 commit comments

Comments
 (0)