- Auditbeat Reference: other versions:
- Auditbeat overview
- Quick start: installation and configuration
- Set up and run
- Upgrade Auditbeat
- Configure
- Modules
- General settings
- Project paths
- Config file reloading
- Output
- Kerberos
- SSL
- Index lifecycle management (ILM)
- Elasticsearch index template
- Kibana endpoint
- Kibana dashboards
- Processors
- Define processors
- add_cloud_metadata
- add_cloudfoundry_metadata
- add_docker_metadata
- add_fields
- add_host_metadata
- add_id
- add_kubernetes_metadata
- add_labels
- add_locale
- add_network_direction
- add_nomad_metadata
- add_observer_metadata
- add_process_metadata
- add_tags
- community_id
- convert
- copy_fields
- decode_base64_field
- decode_json_fields
- decode_xml
- decode_xml_wineventlog
- decompress_gzip_field
- detect_mime_type
- dissect
- dns
- drop_event
- drop_fields
- extract_array
- fingerprint
- include_fields
- rate_limit
- registered_domain
- rename
- syslog
- translate_sid
- truncate_fields
- urldecode
- Internal queue
- Logging
- HTTP endpoint
- Regular expression support
- Instrumentation
- auditbeat.reference.yml
- How to guides
- Modules
- Exported fields
- Monitor
- Secure
- Troubleshoot
- Get Help
- Debug
- Common problems
- Auditbeat fails to watch folders because too many files are open
- Auditbeat uses too much bandwidth
- Error loading config file
- Found unexpected or unknown characters
- Logstash connection doesn’t work
- Publishing to Logstash fails with "connection reset by peer" message
- @metadata is missing in Logstash
- Not sure whether to use Logstash or Beats
- SSL client fails to connect to Logstash
- Monitoring UI shows fewer Beats than expected
- Dashboard could not locate the index-pattern
- High RSS memory usage due to MADV settings
- Contribute to Beats
Reload the configuration dynamically
editReload the configuration dynamically
editThis functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.
You can configure Auditbeat to dynamically reload configuration files when there are changes. To do this, you specify a path (glob) to watch for module configuration changes. When the files found by the glob change, new modules are started/stopped according to changes in the configuration files.
To enable dynamic config reloading, you specify the path
and reload
options
in the main auditbeat.yml
config file. For example:
auditbeat.config.modules: path: ${path.config}/conf.d/*.yml reload.enabled: true reload.period: 10s
-
path
- A glob that defines the files to check for changes.
-
reload.enabled
-
When set to
true
, enables dynamic config reload. -
reload.period
-
Specifies how often the files are checked for changes. Do not
set the
period
to less than 1s because the modification time of files is often stored in seconds. Setting theperiod
to less than 1s will result in unnecessary overhead.
Each file found by the glob must contain a list of one or more module definitions. For example:
- module: file_integrity paths: - /www/wordpress - /www/wordpress/wp-admin - /www/wordpress/wp-content - /www/wordpress/wp-includes
On systems with POSIX file permissions, all Beats configuration files are subject to ownership and file permission checks. If you encounter config loading errors related to file ownership, see https://www.elastic.co/guide/en/beats/libbeat/8.4/config-file-permissions.html.