- 3 minutes to read

Message Context Key search field expression type plugin

Easily extract unique values from named context properties using the Nodinite Message Context Key Search Field Expression Plugin. This page shows you how to configure, test, and use this plugin with clear input, configuration, and result examples.

✅ Extract a unique value from any named context property
✅ Simple configuration for fast results
✅ Designed for high performance and self-service log views


What is the Message Context Key Plugin?

The Nodinite Message Context Key plugin lets you extract a unique value from a named context property in the payload of Log Events. Use it to process messages where you need to target a specific context property.

  • Extract a single value from a named context property
  • Ideal for small payloads and business integration scenarios

Use this plugin for extracting values from messages with named context properties.


How It Works: Input → Context Key → Result

Each example below clearly separates the Input (context property value), the Context Key (property name), and the Result (output value).


Quick Example

Input:

Nodinite

Context Key:

ProductOfTheYear

Result:

Nodinite

Examples

Example 1: Extract Product Name from Context Property

Input:

Nodinite

Context Key:

ProductOfTheYear

Result:

Nodinite

Test Expression
Valid expression with state output, unique value, and total count.


Features

  • Extract a single value from a named context property
  • Simple configuration for fast results
  • Designed for small payloads and high performance

Note: This plugin loads the entire message into RAM. Only use it for small payloads.


How to Use

  1. Select the 'Message Context Key' expression type plugin when configuring a Search Field.
  2. Enter the name of the context property to extract the value from.
  3. Finalize the configuration and select the Message Types to apply the expression.
  4. Optionally, perform a re-index operation (Add or manage Search Field).

Extracted values are stored for as long as the Message Type retention is configured.


Test Expression

You can test your configuration in the 'Test Expression' tab when setting up a Search Field:

  1. Enter a sample payload in the 'Message Body' tab
  2. Select the 'Message Context Key' plugin
    Select
    Here's an example selecting the 'Message Context Key' expression type plugin.
  3. Enter the name of the context property to extract the value from
  4. Review the output and adjust as needed

If the expression is valid, you will see the unique value and total count:

Test Expression
Valid expression with state output, unique value, and total count.

If the expression is invalid or does not match any data, you will see:
No Result
Example of an invalid expression yielding no result.



Mermaid Diagram: Search Field Expression Flow

This diagram shows how the Message Context Key plugin fits into the overall search field expression process.

graph LR subgraph "Search Fields" sf(fal:fa-magnifying-glass-plus Order Number) end subgraph "Search Field Expressions" sfe(fal:fa-flask Message Context plugin) end subgraph "MessageTypes" mt1(fal:fa-file Orders) end sf --- sfe sfe ---|Expression| mt1

Next Step


Learn More