kibana/docs/user/setup.asciidoc
DeDe Morton 9ff847dec7
[DOCS] Describe how to use Elastic Agent to monitor Kibana (#152634)
## Summary

Add Elastic Agent as another way to collect monitoring data.

This work is tracked by
https://github.com/elastic/observability-docs/issues/2602.

There will be additional PRs to address changes required to monitoring
docs for other stack components. TBH, it pains me a bit to see how many
places users need to go to find info about stack monitoring, but fixing
that problem is not in scope for these updates unfortunately. :-/

Please respond to questions addressed to reviewers.

### Checklist

Delete any items that are not applicable to this PR.

- [x] Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)

### To Do before merging

- [x] Remove questions to reviewers.

---------

Co-authored-by: Kevin Lacabane <klacabane@gmail.com>
2023-03-23 11:00:13 -07:00

75 lines
2.5 KiB
Text

[[setup]]
= Set up
[partintro]
--
This section includes information on how to setup Kibana and get it running,
including:
* Downloading
* Installing
* Starting
* Configuring
* Upgrading
[[supported-platforms]]
[float]
== Supported platforms
Packages of Kibana are provided for and tested against Linux, Darwin, and
Windows. Since Kibana runs on Node.js, we include the necessary Node.js
binaries for these platforms. Running Kibana against a separately maintained
version of Node.js is not supported.
[float]
[[elasticsearch-version]]
== Elasticsearch version
Kibana should be configured to run against an Elasticsearch node of the same
version. This is the officially supported configuration.
Running different major version releases of Kibana and Elasticsearch (e.g.
Kibana 5.x and Elasticsearch 2.x) is not supported, nor is running a minor
version of Kibana that is newer than the version of Elasticsearch (e.g. Kibana
5.1 and Elasticsearch 5.0).
Running a minor version of Elasticsearch that is higher than Kibana will
generally work in order to facilitate an upgrade process where Elasticsearch
is upgraded first (e.g. Kibana 5.0 and Elasticsearch 5.1). In this
configuration, a warning will be logged on Kibana server startup, so it's only
meant to be temporary until Kibana is upgraded to the same version as
Elasticsearch.
Running different patch version releases of Kibana and Elasticsearch (e.g.
Kibana 5.0.0 and Elasticsearch 5.0.1) is generally supported, though we
encourage users to run the same versions of Kibana and Elasticsearch down to
the patch version.
--
include::{kib-repo-dir}/setup/install.asciidoc[]
include::{kib-repo-dir}/setup/settings.asciidoc[]
include::{kib-repo-dir}/setup/start-stop.asciidoc[]
include::{kib-repo-dir}/setup/access.asciidoc[]
include::security/tutorials/how-to-secure-access-to-kibana.asciidoc[]
include::{kib-repo-dir}/setup/connect-to-elasticsearch.asciidoc[]
include::{kib-repo-dir}/setup/upgrade.asciidoc[]
include::security/securing-kibana.asciidoc[]
include::{kib-repo-dir}/setup/configuring-reporting.asciidoc[]
include::{kib-repo-dir}/setup/configuring-logging.asciidoc[]
include::monitoring/configuring-monitoring.asciidoc[leveloffset=+1]
include::monitoring/monitoring-elastic-agent.asciidoc[leveloffset=+2]
include::monitoring/monitoring-metricbeat.asciidoc[leveloffset=+2]
include::monitoring/viewing-metrics.asciidoc[leveloffset=+2]
include::monitoring/monitoring-kibana.asciidoc[leveloffset=+2]
include::commands/cli-commands.asciidoc[]