This changelog is intended for community Beat developers. It covers the major
breaking changes to the internal APIs in the official Beats and changes related
to developing a Beat like code generators or fields.yml
. Only the major
changes will be covered in this changelog that are expected to affect community
developers. Each breaking change added here should have an explanation on how
other Beats should be migrated.
Note: This changelog was only started after the 6.3 release.
The list below covers the major changes between 7.0.0-rc2 and 7.0 only.
Added support for using PYTHON_EXE to control what Python interpreter is used
by make
and mage
. Example: export PYTHON_EXE=python2.7
. 11212
Introduce processing.Support to instance.Setting. This allows Beats to fully modify the event processing. 10801
Allow multiple object type configurations per field. 9772
Move agent metadata addition to a processor. 9952
Add (*common.Config).Has and (*common.Config).Remove. 10363
Introduce ILM and IndexManagement support to beat.Settings. 10347
Generating index pattern on demand instead of shipping them in the packages. 10478
The list below covers the major changes between 6.3.0 and 7.0.0-alpha2 only.
The beat.Pipeline is now passed to cfgfile.RunnerFactory. Beats using libbeat for module reloading or autodiscovery need to be adapted. 7017
Moving of TLS helper functions and structs from output/tls
to tlscommon
. 7054
Port fields.yml collector to Golang 6911
Dashboards under _meta/kibana are expected to be decoded. See https://github.com/elastic/beats/pull/7224 for a conversion script. 7265
Constructor (github.com/elastic/beats/libbeat/output/codec/json).New
expects a new escapeHTML
parameter. 7445
Packaging has been refactored and updates are required. See the PR for migration details. 7388
make fields
has been modified to use Mage (https://magefile.org/) in an effort to make
the building a Beat more cross-platform friendly (e.g. Windows). This requires that your Beat
has a magefile.go with a fields target. The FIELDS_FILE_PATH
make variable is no longer
used because the value is specified in magefile.go. 7670
Outputs must implement String. 6404
Renamed -beat-name
CLI option used in kibana_index_pattern.go
to -beat
for consistency with other scripts in dev-tools/cmd
. 8615
Systemd unit file template used on Linux packaging now includes environment variables to ease flag overriding. One of them includes the -e
flag, making beats log to stderr by default on systemd uses. 8942
Removed dashboards and index patterns generation for Kibana 5. 8927
Move generator packages of Filebeat from scripts/generator
to generator
. 9147
Libbeat provides a global registry for beats developer that allow to register and retrieve plugin. 7392
Added more options to control required and optional fields in schema.Apply(), error returned is a plain nil if no error happened 7335
Packaging on MacOS now produces a .dmg file containing an installer (.pkg) and uninstaller for the Beat. 7481
Added mage targets goTestUnit
and goTestIntegration
for executing
'go test'. This captures the log to a file, summarizes the result, produces a
coverage profile (.cov), and produces an HTML coverage report. See
mage -h goTestUnit
. 7766
Beats packaging now build non-oss binaries from code located in the x-pack folder. 7783
New function AddTagsWithKey
is added, so common.MapStr
can be enriched with tags with an arbitrary key. 7991
Move filebeat/reader to libbeat/reader 8206
Libbeat provides a new function cmd.GenRootCmdWithSettings
that should be preferred over deprecated functions
cmd.GenRootCmd
, cmd.GenRootCmdWithRunFlags
, and cmd.GenRootCmdWithIndexPrefixWithRunFlags
. 7850
Set current year in generator templates. 8396
You can now override default settings of libbeat by using instance.Settings. 8449
Add -space-id
option to export_dashboards.go
script to support Kibana Spaces 7942
Add -name
option to asset.go
script to explicitly name the asset rather than using its filename. 8693
Add -out
option to kibana_index_pattern.go
to control the output dir to make it possible to write the generated output to build/kibana
instead of _meta/kibana.generated
(but the output dir remains unchanged at this point). 8615
Add module_fields.go
for generated fields.go
files for modules. 8615
Add mage.GenerateModuleReferenceConfig
for generating reference config files that include configuration sections from the module directory. 8615
Add mage.GenerateFieldsGo
for generating fields.go files. 8615
Add mage.KibanaDashboards
for collecting Kibana dashboards and generating index patterns. 8615
Allow to disable config resolver using the Settings.DisableConfigResolver
field when initializing libbeat. 8769
Add mage.AddPlatforms
to allow to specify dependent platforms when building a beat. 8889
Add cfgwarn.CheckRemoved6xSetting(s)
to display a warning for options removed in 7.0. 8909
Add docker image building to mage.Package
. 8898
Simplified exporting of dashboards. 7730
Update Beats to use go 1.11.2 8746
Allow/Merge fields.yml overrides 9188
Filesets can now define multiple ingest pipelines, with the first one considered as the entry point pipeline. 8914
Add group_measurements_by_instance
option to windows perfmon metricset. 8688
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。