Go to file
Frank Hassanabad 2e28683c12
Change DELETE to POST for _bulk_delete to avoid incompatibility issues (#87914)
## Summary

Changes `DELETE` to `POST` for _bulk_delete on the client only for a variety of reasons.

According to the RFC, not all servers and proxies need to honor DELETE having a body. From: https://tools.ietf.org/html/rfc7231

```
A payload within a DELETE request message has no defined semantics;
sending a payload body on a DELETE request might cause some existing
implementations to reject the request.
```

Within at least one proxy, h2o2, we have found that it does indeed change request headers which will cause NodeJS to not attach the body of a `DELETE`:
https://github.com/hapijs/h2o2/issues/124

Also from other communities such as OpenAPI where they debated this, they allow it but discourage it for reasons outlined there that I will not repeat here:
https://github.com/OAI/OpenAPI-Specification/pull/1937

Elastic Search API's and other Kibana API's use `POST` rather than `DELETE` for their bodies that are attached to `DELETE`:
https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-delete-by-query.html

We still support bodies in `DELETE` and `POST` but are just changing the web client to utilize `POST` moving forward.


### Checklist

Reviewed and we already have unit tests and end to end tests for these use cases so we are good with just updating them. 

- [x] [Unit or functional tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html) were updated or added to match the most common scenarios
2021-01-15 11:45:04 -07:00
.ci [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
.github Added missing configuration options for the alerting related plugins to the kibana-docker. (#88297) 2021-01-14 13:55:36 -08:00
.teamcity [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
common/graphql
config Add server.publicBaseUrl config (#85075) 2020-12-08 17:02:39 -07:00
dev_docs Split up plugin dev docs from team docs. Add some welcome landing pages. (#87353) 2021-01-06 08:18:51 -05:00
docs Use documentation links service provided by the core directly. (#88158) 2021-01-15 13:31:51 +01:00
examples [Search][Sessions] Rename Background Sessions to Search Sessions (#87500) 2021-01-07 17:28:27 +02:00
licenses
packages [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
plugins
rfcs [Search Sessions] Replace search session constants with kibana.yml configs (#88023) 2021-01-15 01:14:02 +02:00
scripts [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
src fix copy (#88481) 2021-01-15 12:55:45 -05:00
tasks/config [build] Migrate grunt license:csv_report to script (#86001) 2021-01-13 09:50:51 -06:00
test [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
typings
utilities
vars [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
x-pack Change DELETE to POST for _bulk_delete to avoid incompatibility issues (#87914) 2021-01-15 11:45:04 -07:00
.backportrc.json [backportrc] Adds 7.11 branch and bumps 7.x (#86131) 2020-12-16 10:10:39 -08:00
.browserslistrc [browserlist] Excludes browsers not supporting es6-class (#81431) 2020-10-28 16:38:59 -07:00
.editorconfig
.eslintignore [@kbn/ui-framework] Removes all but dist files (#85347) 2020-12-10 08:23:33 -08:00
.eslintrc.js [@kbn/ui-framework] Removes all but dist files (#85347) 2020-12-10 08:23:33 -08:00
.fossa.yml
.gitattributes
.gitignore [@kbn/ui-framework] Removes all but dist files (#85347) 2020-12-10 08:23:33 -08:00
.i18nrc.json [Time to Visualize] Add visualizations to dashboard from save modal (#83140) 2020-12-08 15:39:24 -06:00
.node-version Bump Node.js from version 14.15.3 to 14.15.4 (#87207) 2021-01-04 22:14:48 +01:00
.npmrc chore(NA): assure puppeteer_skip_chromium_download is applied across every yarn install situation (#88346) 2021-01-14 18:00:23 +00:00
.nvmrc Bump Node.js from version 14.15.3 to 14.15.4 (#87207) 2021-01-04 22:14:48 +01:00
.prettierignore [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
.prettierrc
.stylelintignore [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
.stylelintrc [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
.telemetryrc.json
.yarnrc chore(NA): enable yarn prefer offline and local mirror for development (#84124) 2020-11-25 00:18:18 +00:00
api-documenter.json
CONTRIBUTING.md
FAQ.md propose language changes (#10709) 2017-03-05 12:10:32 -05:00
github_checks_reporter.json
Gruntfile.js
Jenkinsfile chore(NA): remove usage of unverified es snapshots (#83589) 2020-11-18 00:18:31 +00:00
jest.config.integration.js Jest multi-project configuration (#77894) 2020-12-02 11:42:23 -08:00
jest.config.js Jest multi-project configuration (#77894) 2020-12-02 11:42:23 -08:00
jest.config.oss.js [coverage] re-enable jest (#85946) 2020-12-16 20:20:55 +01:00
kibana.d.ts
LICENSE.txt
NOTICE.txt 🍾 update notice text for 2021 2021-01-01 01:26:53 -07:00
package.json [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00
preinstall_check.js
README.md Fix "Getting started" link in README (#84153) 2020-11-23 15:33:02 -05:00
renovate.json5 [renovate] update label config 2020-12-04 12:23:47 -07:00
SECURITY.md Add security policy to the Kibana repository (#85407) 2020-12-10 09:26:00 -05:00
STYLEGUIDE.md chore(NA): tool to find plugins circular dependencies between plugins (#82867) 2020-11-30 22:19:32 +00:00
tsconfig.base.json Cleanup tsconfig files (#84396) 2020-11-30 19:12:00 +01:00
tsconfig.browser.json
tsconfig.json [DX] SavedObjectsManagement to TS project (#88240) 2021-01-13 22:23:06 +01:00
tsconfig.refs.json [DX] SavedObjectsManagement to TS project (#88240) 2021-01-13 22:23:06 +01:00
tsconfig.types.json
TYPESCRIPT.md
yarn.lock [dev] Replace sass-lint with stylelint (#86177) 2021-01-15 11:52:29 -06:00

Kibana

Kibana is your window into the Elastic Stack. Specifically, it's a browser-based analytics and search dashboard for Elasticsearch.

Getting Started

If you just want to try Kibana out, check out the Elastic Stack Getting Started Page to give it a whirl.

If you're interested in diving a bit deeper and getting a taste of Kibana's capabilities, head over to the Kibana Getting Started Page.

Using a Kibana Release

If you want to use a Kibana release in production, give it a test run, or just play around:

Building and Running Kibana, and/or Contributing Code

You might want to build Kibana locally to contribute some code, test out the latest features, or try out an open PR:

Documentation

Visit Elastic.co for the full Kibana documentation.

For information about building the documentation, see the README in elastic/docs.

Version Compatibility with Elasticsearch

Ideally, you should be running Elasticsearch and Kibana with matching version numbers. If your Elasticsearch has an older version number or a newer major number than Kibana, then Kibana will fail to run. If Elasticsearch has a newer minor or patch number than Kibana, then the Kibana Server will log a warning.

Note: The version numbers below are only examples, meant to illustrate the relationships between different types of version numbers.

Situation Example Kibana version Example ES version Outcome
Versions are the same. 5.1.2 5.1.2 💚 OK
ES patch number is newer. 5.1.2 5.1.5 ⚠️ Logged warning
ES minor number is newer. 5.1.2 5.5.0 ⚠️ Logged warning
ES major number is newer. 5.1.2 6.0.0 🚫 Fatal error
ES patch number is older. 5.1.2 5.1.0 ⚠️ Logged warning
ES minor number is older. 5.1.2 5.0.0 🚫 Fatal error
ES major number is older. 5.1.2 4.0.0 🚫 Fatal error

Questions? Problems? Suggestions?

  • If you've found a bug or want to request a feature, please create a GitHub Issue. Please check to make sure someone else hasn't already created an issue for the same topic.
  • Need help using Kibana? Ask away on our Kibana Discuss Forum and a fellow community member or Elastic engineer will be glad to help you out.