[[configuring-howto-heartbeat]]
= Configuring {beatname_uc}

[partintro]
--
Before modifying configuration settings, make sure you've completed the
<<heartbeat-configuration,configuration steps>> in the Getting Started.
This section describes some common use cases for changing configuration options.

To configure Heartbeat, you edit the configuration file. For rpm and deb,
you’ll find the default configuration file at
+/etc/heartbeat/heartbeat.yml+. There's also a full example
configuration file at +/etc/heartbeat/heartbeat.reference.yml+ that shows
all non-deprecated options. For mac and win, look in the archive that you
extracted.

The Heartbeat configuration file uses http://yaml.org/[YAML] for its syntax.
See the
{beats-ref}/config-file-format.html[Config File Format] section of the
_Beats Platform Reference_ for more about the structure of the config file.

The following topics describe how to configure Heartbeat:

* <<configuration-heartbeat-options>>
* <<configuration-general-options>>
* <<configuring-internal-queue>>
* <<configuring-output>>
* <<ilm>>
* <<configuration-ssl>>
* <<filtering-and-enhancing-data>>
* <<configuring-ingest-node>>
* <<{beatname_lc}-geoip>>
* <<configuration-path>>
* <<setup-kibana-endpoint>>
* <<configuration-dashboards>>
* <<configuration-template>>
* <<configuration-logging>>
* <<using-environ-vars>>
* <<configuration-autodiscover>>
* <<yaml-tips>>
* <<regexp-support>>
* <<http-endpoint>>
* <<{beatname_lc}-reference-yml>>

--

include::./heartbeat-options.asciidoc[]

include::./heartbeat-general-options.asciidoc[]

include::{libbeat-dir}/docs/queueconfig.asciidoc[]

include::{libbeat-dir}/docs/outputconfig.asciidoc[]

include::{libbeat-dir}/docs/shared-ilm.asciidoc[]

include::{libbeat-dir}/docs/shared-ssl-config.asciidoc[]

include::./heartbeat-filtering.asciidoc[]

include::{libbeat-dir}/docs/shared-config-ingest.asciidoc[]

include::{libbeat-dir}/docs/shared-geoip.asciidoc[]

include::{libbeat-dir}/docs/shared-path-config.asciidoc[]

include::{libbeat-dir}/docs/shared-kibana-config.asciidoc[]

include::{libbeat-dir}/docs/setup-config.asciidoc[]

include::{libbeat-dir}/docs/loggingconfig.asciidoc[]

:standalone:
include::{libbeat-dir}/docs/shared-env-vars.asciidoc[]
:standalone!:

include::{libbeat-dir}/docs/shared-autodiscover.asciidoc[]

:standalone:
include::{libbeat-dir}/docs/yaml.asciidoc[]
:standalone!:

include::{libbeat-dir}/docs/regexp.asciidoc[]

include::{libbeat-dir}/docs/http-endpoint.asciidoc[]

include::{libbeat-dir}/docs/reference-yml.asciidoc[]
