docs(inputs.snmp): Explain different snmp backends (#12627)
This commit is contained in:
parent
80b48774ac
commit
3894ca6b91
|
|
@ -18,6 +18,20 @@ See the [CONFIGURATION.md][CONFIGURATION.md] for more details.
|
||||||
|
|
||||||
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
||||||
|
|
||||||
|
## SNMP backend: gosmi and netsnmp
|
||||||
|
|
||||||
|
Telegraf has two backends to translate SNMP objects. By default, Telegraf will
|
||||||
|
use `netsnmp`, however, this option is deprecated and it is encouraged that
|
||||||
|
users migrate to `gosmi`. If users find issues with `gosmi` that do not occur
|
||||||
|
with `netsnmp` please open a project issue on GitHub.
|
||||||
|
|
||||||
|
The SNMP backend setting is a global-level setting that applies to all use of
|
||||||
|
SNMP in Telegraf. Users can set this option in the `[agent]` configuration via
|
||||||
|
the `snmp_translator` option. See the [agent configuration][AGENT] for more
|
||||||
|
details.
|
||||||
|
|
||||||
|
[AGENT]: ../../../docs/CONFIGURATION.md#agent
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
```toml @sample.conf
|
```toml @sample.conf
|
||||||
|
|
@ -43,7 +57,7 @@ See the [CONFIGURATION.md][CONFIGURATION.md] for more details.
|
||||||
## When true, SNMP reponses are accepted from any address not just
|
## When true, SNMP reponses are accepted from any address not just
|
||||||
## the requested address. This can be useful when gathering from
|
## the requested address. This can be useful when gathering from
|
||||||
## redundant/failover systems.
|
## redundant/failover systems.
|
||||||
# unconnected_udp_socket = false
|
# unconnected_udp_socket = false
|
||||||
|
|
||||||
## Path to mib files
|
## Path to mib files
|
||||||
## Used by the gosmi translator.
|
## Used by the gosmi translator.
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@
|
||||||
## When true, SNMP reponses are accepted from any address not just
|
## When true, SNMP reponses are accepted from any address not just
|
||||||
## the requested address. This can be useful when gathering from
|
## the requested address. This can be useful when gathering from
|
||||||
## redundant/failover systems.
|
## redundant/failover systems.
|
||||||
# unconnected_udp_socket = false
|
# unconnected_udp_socket = false
|
||||||
|
|
||||||
## Path to mib files
|
## Path to mib files
|
||||||
## Used by the gosmi translator.
|
## Used by the gosmi translator.
|
||||||
|
|
|
||||||
|
|
@ -29,6 +29,20 @@ to use them.
|
||||||
|
|
||||||
[SECRETSTORE]: ../../../docs/CONFIGURATION.md#secret-store-secrets
|
[SECRETSTORE]: ../../../docs/CONFIGURATION.md#secret-store-secrets
|
||||||
|
|
||||||
|
## SNMP backend: gosmi and netsnmp
|
||||||
|
|
||||||
|
Telegraf has two backends to translate SNMP objects. By default, Telegraf will
|
||||||
|
use `netsnmp`, however, this option is deprecated and it is encouraged that
|
||||||
|
users migrate to `gosmi`. If users find issues with `gosmi` that do not occur
|
||||||
|
with `netsnmp` please open a project issue on GitHub.
|
||||||
|
|
||||||
|
The SNMP backend setting is a global-level setting that applies to all use of
|
||||||
|
SNMP in Telegraf. Users can set this option in the `[agent]` configuration via
|
||||||
|
the `snmp_translator` option. See the [agent configuration][AGENT] for more
|
||||||
|
details.
|
||||||
|
|
||||||
|
[AGENT]: ../../../docs/CONFIGURATION.md#agent
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
```toml @sample.conf
|
```toml @sample.conf
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue