Skip to main content
User guide

Field dictionary

Scan an index for its fields, types, cardinality, and sample values. Confirm field names before you write a query or a rule.

The field dictionary reads an index's mapping and a sample of documents and lists the fields and values that actually exist in your cluster, whether or not ECS defines them. Ask AI and Detection rules use the same scan internally. It is available in every edition.

Check the field dictionary when:

  • You are about to write a detection intent and need to know whether the field is event.action or event.type, and whether the value is login_failure or failed.
  • An Ask AI query finds nothing and you want to see whether the log says ERROR or error.
  • You are judging whether to onboard an index. Many empty fields or odd cardinalities point to a collector mapping problem.

Scan an index

Field dictionary

Steps

  1. Enter an index name. Wildcards are allowed, for example logs-nginx.*.
  2. Select Scan index.

Results are cached for 300 seconds. RST_FIELD_DICT_CACHE_TTL_S sets the cache time; 0 turns it off.

Scan overview

Scan overview

CardMeaning
DocumentsMatched index count and document count
Fields scannedFields seen in the sample, and fields declared in the mapping. A large index scanned only in part is marked First batch only
Empty fieldsIn the mapping but never seen in the sample. Avoid them in rules
Highest cardinalityThe field with the most distinct values, usually an ID, timestamp, or message body
Field typesShare of keyword, text, date, ip, long, and other types

Use the field table

Field table

Each row is a field with its type, estimated distinct values, and sample values, most frequent first.

ActionResult
Select a sample valueCopies it as field:"value", ready to paste into a query or rule
Insert into a queryTakes the field to Ask AI
Aggregate by a fieldTakes the question "Aggregate by X, top 10" to Ask AI

On this page