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
{{ tab4 }} id	String	External system's id
{{ tab4 }} 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=="
      }
    ]
  }
}