Deprecated: Deprecated in Query Context

Deprecated when used in query context, meant for use in parsers only. For uses in queries please use the lower function. Lower-cases the contents of either or both of the field names or values of a string field.

ParameterTypeRequiredDefaultDescription
field[a]Array of stringsrequired  The name of the input field or fields (in []) to lowercase. Use the special value as the only field * for ALL fields. When in this mode only the lower-cased fields remain.
includestringoptional[b]values What to lowercase.
  Valid Values
   bothConvert both the values and field names to lowercase
   fieldsConvert the field names to lowercase
   valuesConvert the values of the fields to lowercase
localestringoptional[b]  The name of the locale to use, as ISO 639 language and an optional ISO 3166 country, such as da, da_DK or en_US. When not specified, uses the system locale.

[a] The argument name field can be omitted.

[b] Optional parameters use their default value unless explicitly set

Omitted Argument Names

The argument name for field can be omitted; the following forms of this function are equivalent:

logscale
lowercase("value")

and:

logscale
lowercase(field="value")

lowercase() Examples

With an event with a field Bar=CONTENTS, you get contents in the Bar field:

logscale
lowercase("Bar")

With an event with a field BAR=CONTENTS, you get CONTENTS in the bar field, while BAR is still CONTENTS.

logscale
lowercase("BaR", include="field")

With an event with a field BAR=CONTENTS, you get contents in the bar field, while BAR is still CONTENTS.

logscale
lowercase(field=["foo","bar"], include="both")

With an event with a field BAR=CONTENTS, you get contents in the bar field, while BAR is no longer present.

logscale
lowercase(field="*", include="both")