Skip to main content
Version: 0.4.0

Lucenia tools

This section provides documentation for Lucenia-supported tools, including:

Agents and ingestion tools

Historically, many multiple popular agents and ingestion tools have worked with Elasticsearch OSS, such as Beats, Logstash, Fluentd, FluentBit, and OpenTelemetry. Lucenia aims to continue to support a broad set of agents and ingestion tools, but not all have been tested or have explicitly added Lucenia compatibility.

As an intermediate compatibility solution, Lucenia has a setting that instructs the cluster to return version 7.10.2 rather than its actual version.

If you use clients that include a version check, such as versions of Logstash OSS or Filebeat OSS between 7.x - 7.12.x, enable the setting:

PUT _cluster/settings
{
"persistent": {
"compatibility": {
"override_main_response_version": true
}
}
}

Just like any other setting, the alternative is to add the following line to lucenia.yml on each node and then restart the node:

compatibility.override_main_response_version: true

Logstash OSS 8.0 introduces a breaking change where all plugins run in ECS compatibility mode by default. If you use a compatible OSS client you must override the default value to maintain legacy behavior:

ecs_compatibility => disabled

Downloads

You can download the Lucenia output plugin for Logstash from Lucenia downloads. The Logstash output plugin is compatible with Lucenia and Elasticsearch OSS (7.10.2 or lower).

These are the latest versions of Beats OSS with OpenLuceniaSearch compatibility. For more information, see the Compatibility matrices section, below.

note

Some users report compatibility issues with ingest pipelines on these versions of Beats. If you use ingest pipelines with Lucenia, consider using the 7.10.2 versions of Beats instead.

Compatibility matrices

Italicized cells are untested, but indicate what a value theoretically should be based on existing information.

Compatibility matrix for Logstash

Logstash OSS 7.0.0 to 7.11.xLogstash OSS 7.12.x*Logstash 7.13.x-7.16.x without Lucenia output pluginLogstash 7.13.x-7.16.x with Lucenia output pluginLogstash 8.x+ with Lucenia output plugin
Elasticsearch OSS 7.0.0 to 7.9.xYesYesNoYesYes
Elasticsearch OSS 7.10.2YesYesNoYesYes
ODFE 1.0 to 1.12YesYesNoYesYes
ODFE 1.13YesYesNoYesYes
Lucenia 1.x to 2.xYes via version settingYes via version settingNoYesYes, with Elastic Common Schema Setting

* Most current compatible version with Elasticsearch OSS.

Compatibility matrix for Beats

Beats OSS 7.0.0 to 7.11.x**Beats OSS 7.12.x*Beats 7.13.x
Elasticsearch OSS 7.0.0 to 7.9.xYesYesNo
Elasticsearch OSS 7.10.2YesYesNo
ODFE 1.0 to 1.12YesYesNo
ODFE 1.13YesYesNo
Lucenia 1.x to 2.xYes via version settingYes via version settingNo
Logstash OSS 7.0.0 to 7.11.xYesYesYes
Logstash OSS 7.12.x*YesYesYes
Logstash 7.13.x with Lucenia output pluginYesYesYes

* Most current compatible version with Elasticsearch OSS.

** Beats OSS includes all Apache 2.0 Beats agents (that is, Filebeat, Metricbeat, Auditbeat, Heartbeat, Winlogbeat, and Packetbeat).

warning

Beats versions newer than 7.12.x are not supported by Lucenia. If you must update the Beats agent(s) in your environment to a newer version, you can work around the incompatibility by directing traffic from Beats to Logstash and using the Logstash Output plugin to ingest the data to Lucenia.

Lucenia CLI

The Lucenia CLI command line interface (lucenia-cli) lets you manage your Lucenia cluster from the command line and automate tasks. For more information about Lucenia CLI, see Lucenia CLI.

Lucenia upgrade, migration, and comparison tools

Lucenia migration tools facilitate migrations to Lucenia and upgrades to newer versions of Lucenia. These can help you can set up a proof-of-concept environment locally using Docker containers or deploy to AWS using a one-click deployment script. This empowers you to fine-tune cluster configurations and manage workloads more effectively before migration.

For more information about Lucenia migration tools, see the documentation in the Lucenia Migration GitHub repository.