Go to file
Shaunak Kashyap 84d4b0dc73
Relax check to account for metricbeat-indexed doc format (#23730)
With Metricbeat shipping Elasticsearch monitoring data (instead of internal collection by Elasticsearch), there are some subtle changes to the format of monitoring docs that are indexed into `.monitoring-es-6-*`. One such change is that metricbeat won't index fields with `null` values; instead it simply doesn't index such fields at all.

As a result, in the context of Elasticsearch monitoring docs, when it comes to docs with `type` = `shards` representing unassigned shards, the `shard.node` field was being indexed as `null` by internal Elasticearch collection, whereas the field was absent when the doc was indexed by Metricbeat.

Since both cases represent the same case — the shard being unassigned — this PR relaxes the check in the UI code to look for either case.

### Sample `shards` document indexed by internal ES collection

```js
{
   "_index":".monitoring-es-6-2018.10.02",
   "_type":"doc",
   "_id":"WUf_htOeSXOJQmiesyF5Bw:_na:metricbeat-7.0.0-alpha1-2018.10.01:0:r",
   "_source":{
      "cluster_uuid":"zXO1GjA6SJGsrPnCPkOoyA",
      "timestamp":"2018-10-02T03:54:43.364Z",
      "interval_ms":10000,
      "type":"shards",
      "source_node":null,
      "state_uuid":"WUf_htOeSXOJQmiesyF5Bw",
      "shard":{
         "state":"UNASSIGNED",
         "primary":false,
         "node":null,
         "relocating_node":null,
         "shard":0,
         "index":"metricbeat-7.0.0-alpha1-2018.10.01"
      }
   }
}
```

### Sample `shards` document indexed by Metricbeat collection

```js
{
   "_index":".monitoring-es-6-mb-2018.10.02",
   "_type":"doc",
   "_id":"FhDRTPjkQJqsgawYbxjQzw:_na:metricbeat-7.0.0-alpha1-2018.10.01:0:r",
   "_source":{
      "@timestamp":"2018-10-02T04:00:03.361Z",
      "interval_ms":10000,
      "shard":{
         "state":"UNASSIGNED",
         "primary":false,
         "index":"metricbeat-7.0.0-alpha1-2018.10.01",
         "shard":0
      },
      "state_uuid":"FhDRTPjkQJqsgawYbxjQzw",
      "beat":{
         "hostname":"Shaunaks-MBP-2",
         "version":"7.0.0-alpha1",
         "name":"Shaunaks-MBP-2"
      },
      "timestamp":"2018-10-02T04:00:03.375Z",
      "type":"shards",
      "metricset":{
         "name":"shard",
         "module":"elasticsearch",
         "host":"localhost:9200",
         "rtt":14254,
         "namespace":"elasticsearch.shard"
      },
      "host":{
         "name":"Shaunaks-MBP-2"
      },
      "cluster_uuid":"zXO1GjA6SJGsrPnCPkOoyA"
   }
}
```
2018-10-03 11:49:38 -07:00
.github [PROPOSAL] Make Kibana's PR template a checklist (#23511) 2018-09-28 09:36:31 -07:00
bin [bin/windows] Remove title (#21567) 2018-08-03 06:53:54 -05:00
config Set kibana locale in kibana.yml config (#21201) 2018-08-02 14:43:22 +03:00
data [folder structure] plugins/.data -> data 2016-07-05 14:06:16 -05:00
docs Limiting maximum number of Spaces (#23673) 2018-10-03 09:09:12 -07:00
licenses Migrate x-pack-kibana source to kibana 2018-04-24 13:48:10 -07:00
packages [I18n] Add HOC injecting i18n provider (#23683) 2018-10-03 17:57:04 +03:00
plugins [folder structure] plugins/.data -> data 2016-07-05 14:06:16 -05:00
scripts Integrate main i18n tool into build pipeline (#22254) 2018-08-29 11:55:34 +03:00
src eCommerce Sample Data (#23214) 2018-10-03 13:55:04 -04:00
style_guides Update JS style guide with rule for prefixing private class methods with an underscore. (#20851) 2018-07-17 08:44:51 -07:00
tasks Add jenkins:report task for test failures (#22682) 2018-09-21 09:31:51 -05:00
test eCommerce Sample Data (#23214) 2018-10-03 13:55:04 -04:00
utilities Apache 2.0 license headers (#19383) 2018-05-28 20:06:30 -07:00
webpackShims add polyfill for ChildNode remove (#21797) 2018-08-10 15:21:11 -06:00
x-pack Relax check to account for metricbeat-indexed doc format (#23730) 2018-10-03 11:49:38 -07:00
.backportrc.json Adds 6.4 branch to backports config (#21217) 2018-07-25 11:02:58 -07:00
.browserslistrc Convert all Less files to Sass in Dashboard, using EUI variable scope (#21374) 2018-08-14 19:05:33 -04:00
.editorconfig Apply the same editorconfig rules to both markdown and asciidoc files 2016-09-07 11:41:41 -04:00
.eslintignore chore: eslint fixes in canvas 2018-09-13 14:58:36 -07:00
.eslintrc.js Update versions of @babel/parser and @babel/types (#23268) 2018-09-25 14:35:31 +03:00
.gitignore update gitignore and remove monitoring css file (#21962) 2018-08-14 10:56:40 -07:00
.i18nrc.json Translate metric_vis (#23187) 2018-09-27 11:53:16 +03:00
.node-version Bump node to 8.11.4 (#22048) 2018-08-16 13:05:17 -05:00
.nvmrc Bump node to 8.11.4 (#22048) 2018-08-16 13:05:17 -05:00
.prettierrc Increase prettier line width to 100 (#20535) 2018-07-09 22:50:37 +02:00
CONTRIBUTING.md [PROPOSAL] Make Kibana's PR template a checklist (#23511) 2018-09-28 09:36:31 -07:00
FAQ.md propose language changes (#10709) 2017-03-05 12:10:32 -05:00
Gruntfile.js Apache 2.0 license headers (#19383) 2018-05-28 20:06:30 -07:00
LICENSE.txt Migrate x-pack-kibana source to kibana 2018-04-24 13:48:10 -07:00
NOTICE.txt Graph LESS to SASS (#23348) 2018-09-20 09:35:22 -04:00
package.json i18n engine typescript migration (#22441) 2018-10-02 11:55:15 +03:00
preinstall_check.js Apache 2.0 license headers (#19383) 2018-05-28 20:06:30 -07:00
README.md Revert "Point issue links to new choose page (#19042)" (#21519) 2018-08-01 11:05:36 +02:00
STYLEGUIDE.md Fix typo in accessibility styleguide link (#14718) 2017-11-02 12:28:22 +01:00
tsconfig.browser.json [typescript] continue to use the default config in development (#21966) 2018-08-14 15:27:07 -07:00
tsconfig.json Spaces Phase 1 (#21408) 2018-10-01 07:09:33 -04:00
tslint.yaml Upgrade to TypeScript 3 (#22792) 2018-09-11 08:38:41 +03:00
yarn.lock Remove elasticsearch package from kbn-es (#23662) 2018-10-02 10:19:33 -05:00

Kibana 7.0.0-alpha1

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:

Snapshot Builds

For the daring, snapshot builds are available. These builds are created nightly and have undergone no formal QA, so they should never be run in production. All builds are 64 bit.

platform default OSS
OSX tar tar
Linux tar deb rpm tar deb rpm
Windows zip zip

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.