Snmp Receiver

Available in: contrib Maintainers: @tamir-michaeli Source: opentelemetry-collector-contrib

Supported Telemetry

Overview

Purpose

The purpose of this receiver is to allow users to generically monitor metrics using SNMP. If one of the specified SNMP data values cannot be loaded on startup, a warning will be printed, but the application will not fail fast.

Prerequisites

This receiver supports SNMP versions:

Configuration

Connection Configuration

These configuration options are for connecting to a SNMP host.

collection_interval: (default = 10s): This receiver collects metrics on an interval. This value must be a string readable by Golang’s time.ParseDuration. Valid time units are ns, us (or µs), ms, s, m, h.
timeout: (default: 5s): Timeout for each SNMP request. This value must be a string readable by Golang’s time.ParseDuration. Valid time units are ns, us (or µs), ms, s, m, h.
endpoint (default: udp://localhost:161): SNMP endpoint to connect to in the form of [udp|tcp][://]{host}[:{port}]
- If no scheme is supplied, a default of udp is assumed
- If no port is supplied, a default of 161 is assumed
version: (default = v2c): SNMP version options are
- v1: SNMP version 1
- v2c: SNMP version 2c
- v3: SNMP version 3
community: (default = public): The community string for the SNMP connection. This is not available for SNMP version v3.
user: The user for the SNMP connection. This is only available for SNMP version v3.
security_level: (default = no_auth_no_priv): The security requirements of the SNMP connection. This is only available for SNMP version v3. SNMP security_level options are
- no_auth_no_priv: No authentication protocol and no privacy protocol used
- auth_no_priv: Authentication protocol is used but no privacy protocol used
- auth_priv: Both authentication and privacy protocols are used
auth_type: (default = MD5): The authentication protocol used for the SNMP connection. This is only available if security_level is not set to no_auth_no_priv. SNMP auth_type options are
- MD5
- SHA
- SHA224
- SHA256
- SHA384
- SHA512
auth_password: The authentication password used for the SNMP connection. This is only available if security_level is not set to no_auth_no_priv.
privacy_type: (default = DES): The privacy protocol used for the SNMP connection. This is only available if security_level is set to auth_priv. SNMP privacy_type options are
- DES
- AES
- AES192
- AES256
- AES192c
- AES256c
privacy_password: The privacy password used for the SNMP connection. This is only available if security_level is set to auth_priv.

Metric/Attribute Configuration

These configuration options are for determining what metrics and attributes will be created with what SNMP data

resource_attributes: This may be configured with one or more key value pairs of resource attribute names and resource attribute configurations.
attributes This may be configured with one or more key value pairs of attribute names and attribute configurations
metrics: This is the only required parameter. The must be configured with one or more key value pairs of metric names and metric configuration.

Resource Attribute Configuration

Resource attribute configurations are used to define what resource attributes will be used in a collection.

Field Name	Description	Value
`oid`	Required if no `scalar_oid` or `indexed_value_prefix`. This is the column OID in a SNMP table which will use the returned indexed SNMP data to create resource attribute values for unique resources. Metric configurations will reference these resource attribute configurations in order to assign metrics data to resources	string
`scalar_oid`	Required if no `oid` or `indexed_value_prefix`. This is the scalar OID which will return non-indexed SNMP data to create resource attribute values for unique resources. Metric configurations will reference these resource attribute configurations in order to assign metrics data to resources	string
`indexed_value_prefix`	Required if no `scalar_oid` or `oid`. This is a string prefix which will be added to the indices of returned metric indexed SNMP data to create resource attribute values for unique resources. Metric configurations will reference these resource attribute configurations in order to assign metrics data to resources	string
`description`	Definition of what the resource attribute represents	string

Attribute Configuration

Attribute configurations are used to define what resource attributes will be used in a collection.

Field Name	Description	Value
`oid`	Required if no `indexed_value_prefix` or `enum`. This is the column OID in a SNMP table which will use the returned indexed SNMP data to create attribute values for the attribute. Metric configurations will reference these attribute configurations in order to assign these attributes and indexed data values to metrics and their datapoints	string
`indexed_value_prefix`	Required if no `oid` or `enum`. This is a string prefix which will be added to the indices of returned metric indexed SNMP data to create attribute values the attribute. Metric configurations will reference these attribute configurations in order to assign these attributes and index based value to metrics and their datapoints	string
`enum`	Required if no `oid` or `indexed_value_prefix`. This should be a list of values that are possible for this attribute. Metric configurations will reference these attribute configurations in order to assign these attributes and values to metrics and their datapoints	string[]
`description`	Definition of what the attribute represents	string

Metric Configuration

Field Name	Description	Value	Default
`unit`	Required. To display what is actually being measured for this metric	string	1
`gauge`	Required if no `sum`. Details that this metric is of the gauge type	GaugeMetric
`sum`	Required if no `gauge`. Details that this metric is of the sum type	SumMetric
`column_oids`	Required if no `scalar_oids`. Details that this metric is made from one or more columns in an SNMP table. The returned indexed SNMP data for these OIDs might either be datapoints on a single metrics, or datapoints across multiple metrics attached to different resources depending on the column OID configurations	ColumnOID[]
`scalar_oids`	Required if no `column_oids`. Details that this metric is made from one or more scalard SNMP values (multiple scalar OIDs would represent multiple datapoints within the same metric)	ScalarOID[]
`description`	Definition of what the metric represents	string

GaugeMetric Configuration

Field Name	Description	Value	Default
`value_type`	The value type of this metric’s data. Can be either `int` or `double`	string	double

SumMetric Configuration

Field Name	Description	Value	Default
`value_type`	The value type of this metric’s data. Can be either `int` or `double`	string	double
`monotonic`	Whether this is a monotonic sum or not	bool	false
`aggregation`	The aggregation type of this metric’s data. Can be either `cumulative` or `delta`	string	cumulative

ScalarOID Configuration

Field Name	Description	Value
`oid`	The SNMP scalar OID value to grab data from (must end in .0).	string
`resource_attributes`	The names of the related resource attribute configurations, allowing scalar oid metrics to be added to resources that have one or more scalar oid resource attributes. Cannot have indexed resource attributes as values.	string[]
`attributes`	The names of the related attribute enum configurations as well as the values to attach to this returned SNMP scalar data. This can be used to have a metric config with multiple ScalarOIDs as different datapoints with different attribute values within the same metric	Attribute

ColumnOID Configuration

Field Name	Description	Value
`oid`	The SNMP scalar OID value to grab data from (must end in .0).	string
`attributes`	The names of the related attribute configurations as well as the enum values to attach to this returned SNMP indexed data if the attribute configuration has enum data. This can be used to attach a specific metric SNMP column OID to an attribute. In doing so, multiple datapoints for a single metric will be created for each returned SNMP indexed data value for the metric along with different attribute values to differentiate them. This also can be used to have a metric config with multiple ColumnOIDs as different datapoints with different attribute values within the same metric	Attribute[]
`resource_attributes`	The names of the related resource attribute configurations. This is used to attach a specific metric SNMP column OID to a resource attribute. In doing so, multiple resources will be created for each returned SNMP indexed data value for the metric	string[]

Attribute

Field Name	Description	Value	Default
`name`	The name of the attribute configuration that this data refers to	string
`value`	If the referred to attribute configuration is of enum type, the specific enum value that should be used for this specific attribute	string

Example Configuration

receivers:
  snmp:
    collection_interval: 60s
    endpoint: udp://localhost:161
    version: v3
    security_level: auth_priv
    user: otel
    auth_type: "MD5"
    auth_password: ${env:SNMP_AUTH_PASSWORD}
    privacy_type: "DES"
    privacy_password: ${env:SNMP_PRIVACY_PASSWORD}

    resource_attributes:
      resource_attr.name.1:
        indexed_value_prefix: probe
      resource_attr.name.2:
        oid: "1.1.1.1"

    attributes:
      attr.name.1:
        value: a2_new_key
        enum:
          - in
          - out
      attr.name.2:
        indexed_value_prefix: device
      attr.name.3:
        oid: "2.2.2.2"

    metrics:
      # This metric will have multiple datapoints wil 1 attribute on each.
      # Each datapoint will have a (hopefully) different attribute value
      metric.name.1:
        unit: "1"
        sum:
          aggregation: cumulative
          monotonic: true
          value_type: int
        column_oids:
          - oid: "2.2.2.1"
            attributes:
              - name: attr.name.3
      # This metric will have multiple datapoints with 2 attributes on each.
      # Each datapoint will have a guaranteed different attribute indexed value for 1 of the attributes.
      # Half of the datapoints will have the other attribute with a value of "in".
      # The other half will have the other attribute with a value of "out".
      metric.name.2:
        unit: "By"
        gauge:
          value_type: int
        column_oids:
          - oid: "3.3.3.3"
            attributes:
              - name: attr.name.2
              - name: attr.name.1
                value: in
          - oid: "2"
            attributes:
              - name: attr.name.2
              - name: attr.name.1
                value: out
      # This metric will have 2 datapoints with 1 attribute on each
      # One datapoints will have an attribute value of "in".
      # The other will have an attribute value of "out".
      metric.name.3:
        unit: "By"
        sum:
          aggregation: delta
          monotonic: false
          value_type: double
        scalar_oids:
          - oid: "4.4.4.4.0"
            attributes:
              - name: attr.name.1
                value: in
          - oid: "4.4.4.5.0"
            attributes:
              - name: attr.name.1
                value: out
      # This metric will have metrics created with each attached to a different resource.
      # Each resource will have a resource attribute with a guaranteed unique value based on the index.
      metric.name.4:
        unit: "By"
        gauge:
          value_type: int
        column_oids:
          - oid: "5.5.5.5"
            resource_attributes:
              - resource_attr.name.1
      # This metric will have metrics created with each attached to a different resource.
      # Each resource will have a resource attribute with a hopefully unique value.
      metric.name.5:
        unit: "By"
        gauge:
          value_type: int
        column_oids:
          - oid: "1.1.1.2"
            resource_attributes:
              - resource_attr.name.2

The full list of settings exposed for this receiver are documented in config.go with detailed sample configurations in testdata/config.yaml.

Configuration

Example Configuration

snmp/v2c_connection_good:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_endpoint:
  collection_interval: 10s
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/invalid_endpoint:
  collection_interval: 10s
  endpoint: udp://a:a:a:a:a:a
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_port:
  collection_interval: 10s
  endpoint: "udp://localhost"
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_port_trailing_colon:
  collection_interval: 10s
  endpoint: "udp://localhost:"
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/bad_endpoint_scheme:
  collection_interval: 10s
  endpoint: "http://localhost:161"
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_endpoint_scheme:
  collection_interval: 10s
  endpoint: "localhost:161"
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_version:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/bad_version:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: '9999'
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_connection_good:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: "v3"
  security_level: "auth_priv"
  user: u
  auth_type: "MD5"
  auth_password: "p"
  privacy_type: "DES"
  privacy_password: "pp"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_no_user:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "no_auth_no_priv"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_no_security_level:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  user: u
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_bad_security_level:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "super"
  user: u
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_no_auth_type:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "auth_no_priv"
  user: u
  auth_password: "p"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_bad_auth_type:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "auth_no_priv"
  user: u
  auth_type: "super"
  auth_password: "p"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_no_auth_password:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "auth_no_priv"
  user: u
  auth_type: "MD5"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_no_privacy_type:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "auth_priv"
  user: u
  auth_type: "MD5"
  auth_password: "p"
  privacy_password: "pp"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_bad_privacy_type:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "auth_priv"
  user: u
  auth_type: "MD5"
  auth_password: "p"
  privacy_type: "super"
  privacy_password: "pp"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/v3_no_privacy_password:
  collection_interval: 10s
  endpoint: "udp://localhost:161"
  version: "v3"
  security_level: "auth_priv"
  user: u
  auth_type: "MD5"
  auth_password: "p"
  privacy_type: "DES"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_metric_config:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
snmp/no_metric_unit:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_metric_gauge_or_sum:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      scalar_oids:
        - oid: "1"
snmp/no_metric_oids:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: double
snmp/no_metric_gauge_type:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type:
      scalar_oids:
        - oid: "1"
snmp/bad_metric_gauge_type:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "Counter"
      scalar_oids:
        - oid: "1"
snmp/no_metric_sum_type:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      sum:
        aggregation: cumulative
        monotonic: true
      scalar_oids:
        - oid: "1"
snmp/bad_metric_sum_type:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      sum:
        aggregation: cumulative
        monotonic: true
        value_type: "Counter"
      scalar_oids:
        - oid: "1"
snmp/no_metric_sum_aggregation:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      sum:
        monotonic: true
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/bad_metric_sum_aggregation:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      sum:
        aggregation: Counter
        monotonic: true
        value_type: double
      scalar_oids:
        - oid: "1"
snmp/no_scalar_oid_oid:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - attributes:
snmp/no_attribute_oid_prefix_or_enums:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "1"
snmp/no_scalar_oid_attribute_name:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "1"
          attributes:
            - value: val1
snmp/bad_scalar_oid_attribute_name:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      enum:
        - val1
        - val2
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "1"
          attributes:
            - name: a1
              value: val1
snmp/bad_scalar_oid_attribute:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      oid: "1"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "1"
          attributes:
            - name: a2
              value: val1
snmp/bad_scalar_oid_attribute_value:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      enum:
        - val1
        - val2
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "1"
          attributes:
            - name: a2
              value: val3
snmp/no_column_oid_oid:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - attributes:
snmp/no_column_oid_attribute_name:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          attributes:
            - name:
snmp/bad_column_oid_attribute_name:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      oid: "1"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          attributes:
            - name: a1
snmp/bad_column_oid_attribute_value:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      enum:
        - val1
        - val2
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          attributes:
            - name: a2
              value: val3
snmp/bad_column_oid_resource_attribute_name:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      oid: "2"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - a2
snmp/column_oid_no_indexed_attribute_or_resource_attribute:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      enum:
        - val1
        - val2
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          attributes:
            - name: a2
              value: val1
snmp/no_resource_attribute_oid_or_scalar_oid_or_prefix:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
snmp/complex_good:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      indexed_value_prefix: p
    ra2:
      oid: "1"
  attributes:
    a1:
      value: v
      enum:
        - val1
    a2:
      enum:
        - val1
        - val2
    a3:
      indexed_value_prefix: p
    a4:
      oid: "1"
  metrics:
    m1:
      unit: "1"
      sum:
        aggregation: cumulative
        monotonic: true
        value_type: int
      column_oids:
        - oid: "1"
          attributes:
            - name: a4
    m2:
      unit: "By"
      gauge:
        value_type: int
      column_oids:
        - oid: "1"
          attributes:
            - name: a3
            - name: a2
              value: val1
        - oid: "2"
          attributes:
            - name: a3
            - name: a2
              value: val2
    m3:
      unit: "By"
      gauge:
        value_type: double
      scalar_oids:
        - oid: "1"
          attributes:
            - name: a1
              value: val1
    m4:
      unit: "{things}"
      sum:
        aggregation: cumulative
        monotonic: true
        value_type: int
      scalar_oids:
        - oid: "1"
    m5:
      unit: "{things}"
      sum:
        aggregation: cumulative
        monotonic: false
        value_type: int
      scalar_oids:
        - oid: "1"
          attributes:
            - name: a1
              value: val1
    m6:
      unit: "1"
      sum:
        aggregation: delta
        monotonic: true
        value_type: int
      scalar_oids:
        - oid: "1"
          attributes:
            - name: a2
              value: val1
        - oid: "2"
          attributes:
            - name: a2
              value: val2
    m7:
      unit: "By"
      gauge:
        value_type: int
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
    m8:
      unit: "By"
      gauge:
        value_type: int
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra2
    m9:
      unit: "By"
      gauge:
        value_type: int
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
            - ra2
    m10:
      unit: "By"
      gauge:
        value_type: int
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
            - ra2
          attributes:
            - name: a1
              value: val1
            - name: a3
            - name: a4
snmp/scalar_oid_resource_attribute_on_column_oid_metric_with_column_oid_attribute:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      oid: "1"
  resource_attributes:
    ra1:
      scalar_oid: "0"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          attributes:
            - name: a2
          resource_attributes:
            - ra1
snmp/scalar_oid_resource_attribute_on_column_oid_metric_with_indexed_value_prefix_attribute:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  attributes:
    a2:
      indexed_value_prefix: "p"
  resource_attributes:
    ra1:
      scalar_oid: "0"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          attributes:
            - name: a2
          resource_attributes:
            - ra1
snmp/scalar_oid_resource_attribute_on_column_oid_metric_without_indexed_identifier:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      scalar_oid: "0"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
snmp/scalar_oid_resource_attribute_on_column_oid_metric_with_column_oid_resource_attribute:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      scalar_oid: "0"
    ra2:
      oid: "1"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
            - ra2
snmp/scalar_oid_resource_attribute_on_column_oid_metric_with_indexed_value_prefix_resource_attribute:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      scalar_oid: "0"
    ra2:
      indexed_value_prefix: "p"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
            - ra2
snmp/multiple_keys_on_resource_attribute:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      scalar_oid: "0"
      oid: "1"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
snmp/scalar_oid_resource_attribute_ends_in_nonzero_digit:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      scalar_oid: "1"
    ra2:
      oid: "1"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
            - ra2
snmp/column_oid_resource_attribute_ends_in_zero:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      oid: "0"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      column_oids:
        - oid: "1"
          resource_attributes:
            - ra1
snmp/scalar_oid_single_scalar_resource_attribute_is_valid:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      scalar_oid: "0"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "1"
          resource_attributes:
            - ra1
snmp/scalar_oid_multiple_scalar_resource_attribute_is_valid:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      scalar_oid: "0"
    ra2:
      scalar_oid: "0"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "0"
          resource_attributes:
            - ra1
            - ra2
snmp/scalar_oid_with_coid_resource_attribute_is_invalid:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      oid: "2"
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "0"
          resource_attributes:
            - ra1
snmp/scalar_oid_with_ivp_resource_attribute_is_invalid:
  collection_interval: 10s
  endpoint: udp://localhost:161
  version: v2c
  community: public
  resource_attributes:
    ra1:
      indexed_value_prefix: p
  metrics:
    m3:
      unit: "By"
      gauge:
        value_type: "double"
      scalar_oids:
        - oid: "0"
          resource_attributes:
            - ra1

Last generated: 2026-08-24

​Snmp Receiver

​Supported Telemetry

​Overview

​Purpose

​Prerequisites

​Configuration

​Connection Configuration

​Metric/Attribute Configuration

​Resource Attribute Configuration

​Attribute Configuration

​Metric Configuration

​GaugeMetric Configuration

​SumMetric Configuration

​ScalarOID Configuration

​ColumnOID Configuration

​Attribute

​Example Configuration

​Configuration

​Example Configuration

Snmp Receiver

Supported Telemetry

Overview

Purpose

Prerequisites

Configuration

Connection Configuration

Metric/Attribute Configuration

Resource Attribute Configuration

Attribute Configuration

Metric Configuration

GaugeMetric Configuration

SumMetric Configuration

ScalarOID Configuration

ColumnOID Configuration

Attribute

Example Configuration

Configuration

Example Configuration