Skip to content

snmptrap MX Message

snmptrap message is generated by trapcollector service when managed object SNMP Trap is received.

Message Headers

Message-Type
Type of message. Always snmptrap.
Sharding-Key
Key for consistent sharding.
Labels
Managed Object's effective labels.

Message Format

Message contains JSON object, containing objects of following structure

Name Type Description
timestamp DateTime ISO 8601 timestamp (i.e. YYYY-MM-DDTHH:MM:SS) of collected metrics
message_id String Global message identifier
collector_type String Always snmptrap
collector String Collector Pool
address String SNMP Trap Source Address
managed_object Object Managed Object details
id String Managed Object's ID
remote_system Object Source remote system for Managed Object
id String External system's id
name String External system's name
name String Managed Object's name
remote_id String External system's id (Opaque attribbute)
bi_id Integer Managed Object's BI ID
administrative_domain Object Administrative Domain details
id String Administrative Domain's ID
name String Administrative Domain's name
remote_id String Managed Object Administrative Domain's ID in Remote System (if any)
remote_system Object Source remote system for Managed Object Administrative Domain
id String External system's id
name String External system's name
labels Array of String Managed Object's labels
data Object SNMP Trap message body content
vars Array of SNMP Trap varbinds
oid String Var OID
value String Var value
value_raw String Var in PDU value with base64 encode
raw_pdu Array of SNMP Trap varbinds

Example

{
  "timestamp": "2022-06-20T10:07:15",
  "message_id": "3d6a2405-447c-44e7-b885-7a2deb43a26a",
  "collector_type": "snmptrap",
  "collector": "default",
  "address": "127.0.0.1",
  "managed_object": {
    "id": "450",
    "bi_id": 7602684790455147111,
    "name": "device-1",
    "administrative_domain": {
      "id": 11,
      "name": "default",
      "remote_system": {
        "id": "596e715fc165cf1e082ea14c",
        "name": "TEST"
      },
      "remote_id": "1"
    },
    "labels": [],
    "remote_system": {
      "id": "596e715fc165cf1e082ea14c",
      "name": "TEST"
    },
    "remote_id": "22"
  },
  "data": {
    "vars": [
      {
        "oid": "1.3.6.1.2.1.1.3.0",
        "value": 2294684216,
        "value_raw": "QwUAiMYaOA=="
      },
      {
        "oid": "1.3.6.1.6.3.1.1.4.1.0",
        "value": "1.3.6.1.6.3.1.1.5.3",
        "value_raw": ""
      },
      {
        "oid": "1.3.6.1.2.1.2.2.1.1.9",
        "value": 10104,
        "value_raw": "AgIneA=="
      },
      {
        "oid": "1.3.6.1.2.1.2.2.1.7.9",
        "value": 1,
        "value_raw": "AgEB"
      },
      {
        "oid": "1.3.6.1.2.1.2.2.1.8.9",
        "value": 2,
        "value_raw": "AgEC"
      },
      {
        "oid": "1.3.6.1.2.1.2.3",
        "value": "This is a Test",
        "value_raw": "BA5UaGlzIGlzIGEgVGVzdA=="
      }
    ]
  }
}