docs: explain how fields are counted towards total_fields.limit#139915
Conversation
Add documentation explaining that total_fields.limit counts all mappers (object mappers, field mappers, multi-fields, aliases, runtime fields), not just leaf fields. Include examples and note that subobjects: false reduces the count by avoiding intermediate object mappers. Add FieldCountingTests.java to document and capture the documented behavior.
|
Pinging @elastic/es-storage-engine (Team:StorageEngine) |
|
Pinging @elastic/core-docs (Team:Docs) |
|
hi @salvatore-campagna - I think you might need to update your branch to get the docs CI to pass. sorry for the inconvenience! |
total_fields.limit
🔍 Preview links for changed docs |
ℹ️ Important: Docs version tagging👋 Thanks for updating the docs! Just a friendly reminder that our docs are now cumulative. This means all 9.x versions are documented on the same page and published off of the main branch, instead of creating separate pages for each minor version. We use applies_to tags to mark version-specific features and changes. Expand for a quick overviewWhen to use applies_to tags:✅ At the page level to indicate which products/deployments the content applies to (mandatory) What NOT to do:❌ Don't remove or replace information that applies to an older version 🤔 Need help?
|
The subobjects mapping parameter was introduced in Elasticsearch 8.3.0 (PR elastic#86166). Adding the `applies_to` tag ensures readers know this feature is version-specific, following cumulative docs guidelines.
…astic#139915) Add documentation explaining that total_fields.limit counts all mappers (object mappers, field mappers, multi-fields, aliases, runtime fields), not just leaf fields. Include examples and note that subobjects: false reduces the count by avoiding intermediate object mappers. Add FieldCountingTests.java to document and capture the documented behavior. The subobjects mapping parameter was introduced in Elasticsearch 8.3.0 (PR elastic#86166). Adding the `applies_to` tag ensures readers know this feature is version-specific, following cumulative docs guidelines.
Adds documentation explaining how Elasticsearch counts fields towards the
index.mapping.total_fields.limitsetting.This addresses a common source of confusion where users count only leaf fields (fields with a
typeproperty) but miss object mappers (which havepropertiesinstead). For deeply nested field paths like those in ECS-style mappings, this can cause users to significantly underestimate their actual mapper count.Documentation changes:
host.os.namecreate 3 mappers, not 1subobjects: falsereduces field countMoreover, add
FieldCountingTests.javato validate the documented counting behavior.