SetSNMP Processor
描述
根据传入的 FlowFile 属性,处理器将执行 SNMP 设置请求。 当查找名称为 snmp$<OID> 的属性时,处理器将尝试将该属性的值设置为属性名称中给定的相应 OID。
标签
属性
| 名称 | 默认值 | 可选值 | 描述 |
|---|---|---|---|
| SNMP Agent Hostname | localhost | SNMP 代理的主机名或网络地址。 支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值) | |
| SNMP Agent Port | 161 | SNMP 代理的端口。 支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值) | |
| SNMP 版本 | SNMPv1 |
| 已经开发并部署了三个重要的 SNMP 版本。SNMPv1 是该协议的原始版本。较新的版本SNMPv2c 和 SNMPv3 在性能、灵活性和安全性方面有所改进。 |
| SNMP Community | public | SNMPv1 和 SNMPv2 使用社区名称来建立管理器和代理之间的信任。大多数代理支持三个社区名称,分别用于只读、读写和陷阱。这三个社区字符串控制不同类型的活动。只读社区适用于 get 请求。读写社区字符串适用于 set 请求。陷阱社区字符串适用于接收陷阱。 敏感属性:是 | |
| SNMP Security Level | noAuthNoPriv |
| SNMP 版本 3 通过基于用户的安全模型 (USM) 提供额外安全性。三个安全级别为:1. 无身份验证和加密的通信 (NoAuthNoPriv)。2. 有身份验证但无加密的通信 (AuthNoPriv)。3. 有身份验证和加密的通信 (AuthPriv)。 |
| SNMP Security Name | | 用于 SNMP v3 身份验证的用户名。 | |
| SNMP Authentication Protocol | |
| 基于哈希的身份验证协议,用于安全身份验证。 |
| SNMP Authentication Passphrase | | 用于 SNMP 身份验证协议的密码。 敏感属性:是 | |
| SNMP Privacy Protocol | |
| 隐私允许对 SNMP v3 消息进行加密,以确保数据的机密性。 |
| SNMP Privacy Passphrase | | 用于 SNMP 隐私协议的密码。 敏感属性:是 | |
| Number of Retries | 0 | 设置请求 SNMP 代理时的重试次数。 | |
| Timeout | 5000 | 设置请求 SNMP 代理时的超时(以毫秒为单位)。 |
关系 (Relationships)
| 名称 | 描述 | 自动终止 |
|---|---|---|
failure | 在 SNMP 设置护理期间失败的所有 FlowFile 都路由到此关系 | 否 |
success | 所有已成功用于执行 SNMP Set 的 FlowFile 都将路由到此关系 | 否 |
写入的 FlowFile 属性
| 名称 | 描述 |
|---|---|
snmp$<OID> | 响应变量绑定:OID(例如 1.3.6.1.4.1.343)及其值。 |
snmp$errorIndex | 表示发生错误的变量绑定。 |
snmp$errorStatus | PDU 的 snmp4j 错误状态。 |
snmp$errorStatusText | 错误状态的描述。 |
snmp$nonRepeaters | GETBULK PDU 中非中继器变量绑定的数量(当前不支持)。 |
snmp$requestID | 与 PDU 关联的请求 ID。 |
snmp$type | PDU 类型的 snmp4j 数字表示。 |
snmp$typeString | PDU 类型的名称。 |
状态管理
该组件不存储状态。
受限 (Restricted)
该组件不受限。
输入要求
该组件要求有传入连接。
详细说明
SetSNMP
概述
该 Processor 向 SNMP 代理发送 SNMP set 请求,以更新与给定 OID 关联的信息。该 Processor 支持 SNMPv1、SNMPv2c 和 SNMPv3。组件基于 SNMP4J。
该 Processor 通过从 FlowFile Attribute 中提取信息来构建 SNMP Set 请求。Processor 会查找以 snmp$ 为前缀的 Attribute。如果找到这样的 Attribute,会用 $ 字符拆分 Attribute 名。第二个元素必须符合 OID 格式才会被视为有效 OID。如果存在第三个元素,它必须表示与给定 OID 关联的 数据类型的 SMI Syntax 整数值,以便正确转换。如果没有第三个 元素,值会被视为 String,并以 OctetString 对象发送。