Add package.reference to record package home page (#585)

CHANGELOG.next.md

@@ -10,10 +10,10 @@ Thanks, you're awesome :-) -->
 ### Bugfixes
 
 ### Added
-* Added `host.domain` field. #591
 
+* Added `package.reference`. #585
+* Added `host.domain` field. #591
 * Added `process.exit_code`. #600
-
 * Added fields in `tls.*` to support analysis of TLS protocol events. #606
 
 ### Improvements

docs/field-details.asciidoc

@@ -2885,6 +2885,19 @@ example: `/usr/local/Cellar/go/1.12.9/`
 
 // ===============================================================
 
+| package.reference
+| Reference URL of this package.
+
+If available, use reference URL pointing to the project website that is contained in the package.
+
+type: keyword
+
+example: `https://golang.org`
+
+| extended
+
+// ===============================================================
+
 | package.size
 | Package size in bytes.
 

generated/beats/fields.ecs.yml

@@ -2148,6 +2148,15 @@
       ignore_above: 1024
       description: Path where the package is installed.
       example: /usr/local/Cellar/go/1.12.9/
+    - name: reference
+      level: extended
+      type: keyword
+      ignore_above: 1024
+      description: 'Reference URL of this package.
+
+        If available, use reference URL pointing to the project website that is contained
+        in the package.'
+      example: https://golang.org
     - name: size
       level: extended
       type: long

generated/csv/fields.csv

@@ -269,6 +269,7 @@ package.installed,date,extended,,1.2.0-dev
 package.license,keyword,extended,Apache License 2.0,1.2.0-dev
 package.name,keyword,extended,go,1.2.0-dev
 package.path,keyword,extended,/usr/local/Cellar/go/1.12.9/,1.2.0-dev
+package.reference,keyword,extended,https://golang.org,1.2.0-dev
 package.size,long,extended,62231,1.2.0-dev
 package.version,keyword,extended,1.12.9,1.2.0-dev
 process.args,keyword,extended,"['ssh', '-l', 'user', '10.0.0.16']",1.2.0-dev

generated/ecs/ecs_flat.yml

@@ -3062,6 +3062,19 @@ package.path:
   order: 5
   short: Path where the package is installed.
   type: keyword
+package.reference:
+  description: 'Reference URL of this package.
+
+    If available, use reference URL pointing to the project website that is contained
+    in the package.'
+  example: https://golang.org
+  flat_name: package.reference
+  ignore_above: 1024
+  level: extended
+  name: reference
+  order: 10
+  short: Package reference URL
+  type: keyword
 package.size:
   description: Package size in bytes.
   example: 62231

generated/ecs/ecs_nested.yml

@@ -3437,6 +3437,19 @@ package:
       order: 5
       short: Path where the package is installed.
       type: keyword
+    reference:
+      description: 'Reference URL of this package.
+
+        If available, use reference URL pointing to the project website that is contained
+        in the package.'
+      example: https://golang.org
+      flat_name: package.reference
+      ignore_above: 1024
+      level: extended
+      name: reference
+      order: 10
+      short: Package reference URL
+      type: keyword
     size:
       description: Package size in bytes.
       example: 62231

generated/elasticsearch/6/template.json

@@ -1266,6 +1266,10 @@
               "ignore_above": 1024, 
               "type": "keyword"
             }, 
+            "reference": {
+              "ignore_above": 1024, 
+              "type": "keyword"
+            }, 
             "size": {
               "type": "long"
             }, 

generated/elasticsearch/7/template.json

@@ -1265,6 +1265,10 @@
             "ignore_above": 1024, 
             "type": "keyword"
           }, 
+          "reference": {
+            "ignore_above": 1024, 
+            "type": "keyword"
+          }, 
           "size": {
             "type": "long"
           }, 

generated/legacy/template.json

@@ -889,6 +889,10 @@
               "ignore_above": 1024,
               "type": "keyword"
             },
+            "reference": {
+              "ignore_above": 1024,
+              "type": "keyword"
+            },
             "size": {
               "type": "long"
             },

schema.json

@@ -2110,6 +2110,16 @@
         "required": false, 
         "type": "keyword"
       }, 
+      "package.reference": {
+        "description": "Reference URL of this package.\nIf available, use reference URL pointing to the project website that is contained in the package.", 
+        "example": "https://golang.org", 
+        "footnote": "", 
+        "group": 2, 
+        "level": "extended", 
+        "name": "package.reference", 
+        "required": false, 
+        "type": "keyword"
+      }, 
       "package.size": {
         "description": "Package size in bytes.", 
         "example": "62231", 

schemas/package.yml

@@ -72,3 +72,13 @@
 
         Use a short name, e.g. the license identifier from SPDX License List where possible (https://spdx.org/licenses/).
       example: Apache License 2.0
+
+    - name: reference
+      level: extended
+      type: keyword
+      short: Package reference URL
+      description: >
+        Reference URL of this package.
+
+        If available, use reference URL pointing to the project website that is contained in the package.
+      example: https://golang.org