[1.6] Clarify that file extension should exclude the dot. (#1016)

CHANGELOG.md

@@ -10,6 +10,7 @@ All notable changes to this project will be documented in this file based on the
 #### Bugfixes
 
 * Field `registry.data.strings` should have been marked as an array field. #790
+* Clarify the definition of `file.extension` (no dots). #1016
 
 #### Added
 

docs/field-details.asciidoc

@@ -2080,7 +2080,9 @@ example: `C`
 // ===============================================================
 
 | file.extension
-| File extension.
+| File extension, excluding the leading dot.
+
+Note that when the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz").
 
 type: keyword
 

generated/beats/fields.ecs.yml

@@ -1574,7 +1574,10 @@
       level: extended
       type: keyword
       ignore_above: 1024
-      description: File extension.
+      description: 'File extension, excluding the leading dot.
+
+        Note that when the file name has multiple extensions (example.tar.gz), only
+        the last one should be captured ("gz", not "tar.gz").'
       example: png
     - name: gid
       level: extended

generated/csv/fields.csv

@@ -173,7 +173,7 @@ ECS_Version,Indexed,Field_Set,Field,Type,Level,Normalization,Example,Description
 1.6.0,true,file,file.device,keyword,extended,,sda,Device that is the source of the file.
 1.6.0,true,file,file.directory,keyword,extended,,/home/alice,Directory where the file is located.
 1.6.0,true,file,file.drive_letter,keyword,extended,,C,Drive letter where the file is located.
-1.6.0,true,file,file.extension,keyword,extended,,png,File extension.
+1.6.0,true,file,file.extension,keyword,extended,,png,"File extension, excluding the leading dot."
 1.6.0,true,file,file.gid,keyword,extended,,1001,Primary group ID (GID) of the file.
 1.6.0,true,file,file.group,keyword,extended,,alice,Primary group name of the file.
 1.6.0,true,file,file.hash.md5,keyword,extended,,,MD5 hash.

generated/ecs/ecs_flat.yml

@@ -2505,14 +2505,17 @@ file.drive_letter:
   type: keyword
 file.extension:
   dashed_name: file-extension
-  description: File extension.
+  description: 'File extension, excluding the leading dot.
+
+    Note that when the file name has multiple extensions (example.tar.gz), only the
+    last one should be captured ("gz", not "tar.gz").'
   example: png
   flat_name: file.extension
   ignore_above: 1024
   level: extended
   name: extension
   normalize: []
-  short: File extension.
+  short: File extension, excluding the leading dot.
   type: keyword
 file.gid:
   dashed_name: file-gid

generated/ecs/ecs_nested.yml

@@ -2923,14 +2923,17 @@ file:
       type: keyword
     file.extension:
       dashed_name: file-extension
-      description: File extension.
+      description: 'File extension, excluding the leading dot.
+
+        Note that when the file name has multiple extensions (example.tar.gz), only
+        the last one should be captured ("gz", not "tar.gz").'
       example: png
       flat_name: file.extension
       ignore_above: 1024
       level: extended
       name: extension
       normalize: []
-      short: File extension.
+      short: File extension, excluding the leading dot.
       type: keyword
     file.gid:
       dashed_name: file-gid

schemas/file.yml

@@ -74,7 +74,12 @@
     - name: extension
       level: extended
       type: keyword
-      description: File extension.
+      short: File extension, excluding the leading dot.
+      description: >
+        File extension, excluding the leading dot.
+
+        Note that when the file name has multiple extensions (example.tar.gz),
+        only the last one should be captured ("gz", not "tar.gz").
       example: png
 
     - name: type