project-snmp-profiles-authoring

Validate and author Netdata SNMP profile YAML configurations for infrastructure monitoring.

80.4k|6.6k|Updated Jun 17, 2013
One-click install
npx skills add https://github.com/netdata/netdata --skill project-snmp-profiles-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-snmp-profiles-authoring
Source: https://github.com/netdata/netdata/tree/main/.agents/skills/project-snmp-profiles-authoring
Command: npx skills add https://github.com/netdata/netdata --skill project-snmp-profiles-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the complexity of mapping SNMP MIB objects to Netdata metrics, ensuring that profile configurations are accurate, performant, and compliant with MIB accessibility rules.

Core Features & Use Cases

  • Accessibility Validation: Automatically checks MIB object MAX-ACCESS levels to prevent invalid OID polling.
  • Index Transformation: Provides standardized rules for extracting index components from complex SNMP tables.
  • Use Case: When adding a new network device profile, use this Skill to verify that your symbol.OID declarations correctly handle not-accessible index objects and follow the required topology and licensing schema.

Quick Start

Use the snmp-profiles-authoring skill to validate the OID accessibility and index transformation logic in my new switch profile YAML.

Frequently Asked Questions about project-snmp-profiles-authoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate SNMP profile OIDs?

Use the provided audit recipe with the `rg` command to scan MIB files for `MAX-ACCESS` definitions. Ensure any `not-accessible` objects are only used when they satisfy the device-scoped MIB-deviation requirements.

How to handle not-accessible index objects?

Derive these objects from the row OID index using `index` or `index_transform`. Do not configure them as a readable `symbol.OID` unless the device specifically returns them as a readable column.

Does this skill support BGP profile migration?

Yes, it provides specific guidelines for BGP row mapping, including the use of canonical RFC 4271 states and the requirement to deliver BGP rows through `ProfileMetrics.BGPRows`.

When should I use index_transform?

Use `index_transform` when an index consists of multiple components or requires specific slicing. It supports 0-based inclusive start and end indices to isolate the necessary OID segments.

What are the limitations of device-scoped MIB deviations?

Deviations are only valid when the polling row is restricted to a selector-matched device, proven by a fixture or live capture, and documented with a clear explanation in the profile.