anchor.diff:  [[cat-fielddata]]
   === cat fielddata
   
  -`fielddata` shows how much heap memory is currently being used by fielddata
  -on every data node in the cluster.
  +Returns the amount of heap memory currently used by fielddata on every data node
  +in the cluster.
   
  +
  +[[cat-fielddata-api-request]]
  +==== {api-request-title}
  +
  +`GET /_cat/fielddata/{fields}`
  +
  +
  +[[cat-fielddata-api-path-params]]
  +==== {api-path-parms-title}
  +
  +`{fields}`::
  +(Optional, string) Comma-separated list of fields used to limit returned
  +information.
  +
  +
  +[[cat-fielddata-api-query-params]]
  +==== {api-query-parms-title}
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=bytes]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=http-format]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-h]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-v]
  +
  +
  +[[cat-fielddata-api-example]]
  +==== {api-examples-title}
   
   ////
   Hidden setup snippet to build an index with fielddata so our results are real:
  
positive.code:       "soul": {
          "type": "text",
          "fielddata":true
        }
      }
    }
  
negative.code: // TESTRESPONSE[s/544b|480b/\\d+(\\.\\d+)?[tgmk]?b/]
  // TESTRESPONSE[s/Nqk-6in[^ ]*/.+/ s/soul|body/\\w+/ non_json]
  
  The response shows the individual fielddata for the `body` and `soul` fields,
  one row per field per node.
  
  [[cat-fielddata-api-example-all]]
  ===== Example with all fields in a cluster
  
  The following `fieldata` API request retrieves heap memory size
  information all fields.
  
  [source,js]
  --------------------------------------------------
  GET /_cat/fielddata?v
  --------------------------------------------------
  // CONSOLE
  // TEST[continued]
  
  The API returns the following response:
  
  [source,txt]
  --------------------------------------------------
  id                     host      ip        node    field   size
  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in body    544b
  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in mind    360b
  Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in soul    480b
  --------------------------------------------------
  // TESTRESPONSE[s/544b|480b|360b/\\d+(\\.\\d+)?[tgmk]?b/]
  // TESTRESPONSE[s/Nqk-6in[^ ]*/.+/ s/soul|body|mind/\\w+/ non_json]