Processor: Comparison
The Comparison processor takes two Table(number) inputs: 'A' and 'B'. It then matches corresponding items from the inputs by their keys, and performs a comparison operation defined by the 'operation' configuration property. If the inputs have different sets of keys, the 'significant_keys' configuration property should be set, which is a list of keys used to map items from the inputs. Otherwise, if the inputs set of keys are different, no items will be matched and an empty result is returned. Also, inputs and significant_keys (if specified) must allow only 1:1 item mapping from 'A' to 'B'. If it allows to match one item from 'A' to more than one item from 'B' and vice versa, the probe goes into error state.
| Parameters | Description |
|---|---|
| Input Types | Tablev(number) |
| Output Types | Table (discrete state): true or false |
| Comparison Operation (operation) |
Operation for comparing operands. le (less than or equal), ne (not equal), ge (greater than or equal), gt (greater than), lt (less than), eq (equal) |
| Significant Keys (significant_keys) |
List of keys to map items from the inputs for applying the specified operation. It is typically used by processors that take multiple inputs and perform operations on them. When inputs have the same sets of keys it does not need to be specified. When inputs have different sets of keys, it must be specified and it must allow only 1:1 items mapping from the given inputs, otherwise the probe will go into error state. |
| Enable Streaming (enable_streaming) |
Makes samples of output stages streamed if enabled. An optional boolean that defaults to False. If set to True, all output stages of this processor are streamed in the generic protobuf schema. |
Example: Comparison
significant_keys: ["system_id", "interface"] operation: "ge"
Input A:
[system_id=leaf1,interface=eth0,counter_type=tx_bytes]: 34 [system_id=leaf1,interface=eth1,counter_type=tx_bytes]: 58
Input B:
[system_id=leaf1,interface=eth0,counter_type=rx_bytes]: 15 [system_id=leaf1,interface=eth1,counter_type=rx_bytes]: 73
Output (Discrete-State-Set):
[system_id=leaf1,interface=eth0]: "true" [system_id=leaf1,interface=eth1]: "false"