The page that you are currently viewing is for an old version of Stroom (7.9). The documentation for the latest version of Stroom (7.10) can be found using the version drop-down at the top of the screen or by clicking here.
New Features
New Stroom-Proxy implementation
Stroom-Proxy has been re-written to fundamentally change the way it works internally. This is to improve performance over previous Stroom-Proxy implementations and to make it more robust.
TODO
Reporting
A reporting feature has been added in 7.8. It allows users to schedule queries that can be run at specific points in time to output tabular data in CSV or Excel etc. Any data source that can be queried in stroom can be the source of a report. Reports can be emailed to individuals or written as a stream for onward processing.
Apache HTTP Client
Previous versions of Stroom and Stroom-Proxy used a variety of HTTP clients for making HTTP requests, e.g. from the HTTPAppender . These have been standardised to all use the Apache HTTP client which means a consistent set of configuration can be used.
Receipt ID
A new meta attribute (ReceiptId
) has been added to Stroom and Stroom-Proxy to provide a unique identifier for each request received.
The format of this attribute has been made to make it more useful to administrators, while still being unique across the environment that the Stroom and Stroom-Proxy instances are deployed in.
The format is as follows:
<timestamp>_<seq no>_<(P|S)>_<proxyId or stroom nodeName>
<timestamp>
- The receipt timestamp in milliseconds since the Unix Epoch , zero padded.<seq no>
- This is zero padded four digit sequential number (starting at0000
) that is used to distinguish between multiple receipt events happening during the same millisecond.<P|S>
- Indicates whether the item was received by Stroom (S
) or Stroom-Proxy (P
).<proxyId or stroom nodeName>
- For Stroom-Proxy this will be theproxyId
that is either set in configuration to uniquely identify a proxy instance or is one of the FQDN/IP. For Stroom this is the node name of the Stroom instance.
An example Receipt ID is 0000001738332835967_0000_P_node1
The new format is useful for tracing the flow of data through a chain of proxies as it will be included in receive and send logs as well as being written to the meta attributes.
In addition to ReceiptId
we also have ReceiptIdPath
which will have a ReceiptId
appended to it on each receipt (comma delimited).
To ensure uniqueness of these IDs across the estate, ProxyIDs should be unique within the environment that data will flow. The same is true for Stroom node names.