# snmp: Send SNMP traps

The `snmp()` driver sends SNMP traps using the Simple Network Management Protocol version 2c or version 3. Incoming log messages can be converted to SNMP traps, as the fields of the SNMP messages can be customized using AxoSyslog macros.

The `snmp()` driver is available in AxoSyslog version 3.22 and later.

Note The `snmp` destination driver currently supports sending SNMP traps only using the UDP transport protocol. 

The `snmp()` driver requires the `host()`, `trap-obj()`, and `snmp-obj()` options to be set, as well as the `engine-id()` and `version()` options when using the SNMPv3 protocol. For the list of available optional parameters, see [snmp() destination options](../../docs/axosyslog-core/chapter-destinations/destination-snmp/reference-destination-snmp/index.md).

## Declaration:
```
       destination d_snmp {snmp(host() trap-obj() snmp-obj() ...);};
    
```

Warning If AxoSyslog cannot resolve the destination hostname during startup, it will try to resolve the hostname again when the next message to be sent as an SNMP trap is received. However, if this name resolution fails, the trap will be dropped. 

Note The `snmp()` destination driver does not generate MARK signals itself, but can receive and forward MARK signals. 

## Example: Using the snmp() destination driver

The following example defines an SNMP destination that uses the SNMPv2c protocol.
```
 
       destination d_snmpv2c{
            snmp(
                version('v2c')
                host('192.168.1.1')
                trap-obj('.1.3.6.1.6.3.1.1.4.1.0', 'Objectid', '.1.3.6.1.4.1.18372.3.1.1.1.2.1')
                snmp-obj('.1.3.6.1.4.1.18372.3.1.1.1.1.1.0', 'Octetstring', 'Test SNMP trap')
                snmp-obj('.1.3.6.1.4.1.18372.3.1.1.1.1.2.0', 'Octetstring', 'admin')
                snmp-obj('.1.3.6.1.4.1.18372.3.1.1.1.1.3.0', 'Ipaddress', '192.168.1.1')
                );
        };
    
```

The following example defines an SNMP destination that uses the SNMPv3 protocol and uses macros to fill the values of the SNMP objects.
```
 
       destination d_snmpv3{
            snmp(
                version('v3')
                host('192.168.1.1')
                port(162)
                engine-id('0xdeadbeefde')
                auth-username('myusername')
                auth-password('password')
                enc-algorithm('AES')
                enc-password('password')
                trap-obj('.1.3.6.1.6.3.1.1.4.1.0', 'Objectid', '.1.3.6.1.4.1.18372.3.1.1.1.2.1')
                snmp-obj('.1.3.6.1.4.1.18372.3.1.1.1.1.1', 'Octetstring', '${MESSAGE}')
                snmp-obj('.1.3.6.1.4.1.18372.3.1.1.1.1.2', 'Octetstring', 'admin')
                snmp-obj('.1.3.6.1.4.1.18372.3.1.1.1.1.3', 'Ipaddress', '${SOURCEIP}')
                );
        };
    
```

* * *

[Converting Cisco syslog messages to clogMessageGenerated SNMP traps](../../docs/axosyslog-core/chapter-destinations/destination-snmp/cisco-syslog-snmp/index.md)

[snmp() destination options](../../docs/axosyslog-core/chapter-destinations/destination-snmp/reference-destination-snmp/index.md)

Last modified October 29, 2023: [Create manpages (#34) (9534f54e)](<https://github.com/axoflow/axosyslog-core-docs/commit/9534f54ee9e0cc76cb336c0c01f2e1973760d0e0>)