logstash-filter-geoip 7.0.0-java → 7.0.1-java

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1863a093cb2b2c2cf3acc200ce48ff5c2103e0a998b419165b5dc910ae9a8afb
4
- data.tar.gz: 3b75fd3ce00d85a101b32f56e0a1a408be32d8c4e8381fa2df7b0abe3073e7d0
3
+ metadata.gz: 3775b623a8def0e1d46ab786bb0d386f38fe2f6db3cc52adf5d2cf271bc6441c
4
+ data.tar.gz: a3edac69f8071574af6bf2d8456bb63cda66874f8a8c9f5d2e5867cfeb4bc100
5
5
  SHA512:
6
- metadata.gz: fa881996b64bdbb97765c1e257c850f70bc552f087127fda76d659d94a3c34a9bd80ea07d9dc7a5339d759834a345492c60f3b5c6ad96fbc07910239ff8fc218
7
- data.tar.gz: 86063b89d552fd7b07d8add64bf4dfd644dff79fd978074bc09eca979ec7d86275e0672479a1401d1153cc5fbef2958dd692ee244b63c26ca720aaabf06ac05f
6
+ metadata.gz: 20030a899125bda090747d654c48e152690ca34203e08e11e3d380202dc79629c8da3e42fc238845568d672321711d565ca9235ad60f2a941d09dc598be3be55
7
+ data.tar.gz: de3c227f96dfc13b18d7e2397af48193f1b26274384049f8037ab7f07e401727523cf60ca233fab18aaeb855aa5c34760df7c9357b8303f2fb7e877529f50953
data/CHANGELOG.md CHANGED
@@ -1,3 +1,6 @@
1
+ ## 7.0.1
2
+ - [DOC] Add documentation for MaxMind database license change [#177](https://github.com/logstash-plugins/logstash-filter-geoip/pull/177)
3
+
1
4
  ## 7.0.0
2
5
  - Changed the plugin to use EULA GeoIP2 Database with auto-update [#176](https://github.com/logstash-plugins/logstash-filter-geoip/pull/176)
3
6
  Available in Logstash 7.13+ Elastic license
@@ -39,11 +42,11 @@
39
42
  - Add default_database_type configuration option to allow selection between the GeoLite2-City and GeoLote2-ASN databases.
40
43
 
41
44
  ## 4.2.0
42
- - Add support for GeoLite2-ASN database from Maxmind for ASN data.
45
+ - Add support for GeoLite2-ASN database from MaxMind for ASN data.
43
46
  - Update Java dependencies to 2.9.0 to support the new ASN database.
44
47
 
45
48
  ## 4.1.1
46
- - Add support for commercial databases from Maxmind.
49
+ - Add support for commercial databases from MaxMind.
47
50
  - Add ASN data support via GeoIP2-ISP database.
48
51
 
49
52
  ## 4.1.0
data/docs/index.asciidoc CHANGED
@@ -21,22 +21,41 @@ include::{include_path}/plugin_header.asciidoc[]
21
21
  ==== Description
22
22
 
23
23
  The GeoIP filter adds information about the geographical location of IP addresses,
24
- based on data from the Maxmind GeoLite2 databases.
24
+ based on data from the MaxMind GeoLite2 databases.
25
25
 
26
26
  ==== Supported Databases
27
27
 
28
- This plugin is bundled with https://dev.maxmind.com/geoip/geoip2/geolite2[GeoLite2] City database out of the box. From Maxmind's description --
28
+ This plugin is bundled with https://dev.maxmind.com/geoip/geoip2/geolite2[GeoLite2] City database out of the box. From MaxMind's description --
29
29
  "GeoLite2 databases are free IP geolocation databases comparable to, but less accurate than, MaxMind’s
30
30
  GeoIP2 databases". Please see GeoIP Lite2 license for more details.
31
31
 
32
- https://www.maxmind.com/en/geoip2-databases[Commercial databases] from Maxmind are also supported in this plugin.
32
+ https://www.maxmind.com/en/geoip2-databases[Commercial databases] from MaxMind are also supported in this plugin.
33
33
 
34
34
  If you need to use databases other than the bundled GeoLite2 City, you can download them directly
35
- from Maxmind's website and use the `database` option to specify their location. The GeoLite2 databases
35
+ from MaxMind's website and use the `database` option to specify their location. The GeoLite2 databases
36
36
  can be https://dev.maxmind.com/geoip/geoip2/geolite2[downloaded from here].
37
37
 
38
38
  If you would like to get Autonomous System Number(ASN) information, you can use the GeoLite2-ASN database.
39
39
 
40
+ [id="plugins-{type}s-{plugin}-database_license"]
41
+ ==== Database License
42
+
43
+ https://www.maxmind.com[MaxMind] changed from releasing the GeoIP database under
44
+ a Creative Commons (CC) license to a proprietary end-user license agreement
45
+ (EULA). The MaxMind EULA requires Logstash to update the MaxMind database
46
+ within 30 days of a database update. If Logstash fails to download the database
47
+ for 30 days, it will stop the pipeline in order to maintain compliance.
48
+
49
+ The GeoIP filter plugin can manage the database for users running the Logstash default
50
+ distribution, or you can manage
51
+ database updates on your own. The behavior is controlled by the `database` setting.
52
+ When you use the default `database` setting, the auto-update feature ensures that the plugin is
53
+ using the latest version of the database.
54
+ Otherwise, you are responsible for maintaining compliance.
55
+
56
+ The Logstash open source distribution uses the MaxMind Creative Commons license
57
+ database by default.
58
+
40
59
  ==== Details
41
60
 
42
61
  A `[geoip][location]` field is created if
@@ -109,14 +128,16 @@ number of cache misses and waste memory.
109
128
  ===== `database`
110
129
 
111
130
  * Value type is <<path,path>>
112
- * There is no default value for this setting.
131
+ * If not specified, the database defaults to the GeoLite2 City database that ships with Logstash.
113
132
 
114
- The path to Maxmind's database file that Logstash should use. The default database is GeoLite2-City.
115
- GeoLite2-City, GeoLite2-Country, GeoLite2-ASN are the free databases from Maxmind that are supported.
116
- GeoIP2-City, GeoIP2-ISP, GeoIP2-Country are the commercial databases from Maxmind that are supported.
133
+ The path to MaxMind's database file that Logstash should use. The default database is GeoLite2-City.
134
+ GeoLite2-City, GeoLite2-Country, GeoLite2-ASN are the free databases from MaxMind that are supported.
135
+ GeoIP2-City, GeoIP2-ISP, GeoIP2-Country are the commercial databases from MaxMind that are supported.
117
136
 
118
- If not specified, this will default to the GeoLite2 City database that ships
119
- with Logstash.
137
+ Database auto-update applies to default distribution. When `database` points to user's database path,
138
+ auto-update will be disabled.
139
+ See
140
+ <<plugins-{type}s-{plugin}-database_license,Database License>> for more information.
120
141
 
121
142
  [id="plugins-{type}s-{plugin}-default_database_type"]
122
143
  ===== `default_database_type`
@@ -5,7 +5,7 @@ require "logstash-filter-geoip_jars"
5
5
 
6
6
 
7
7
  # The GeoIP filter adds information about the geographical location of IP addresses,
8
- # based on data from the Maxmind GeoLite2 database.
8
+ # based on data from the MaxMind GeoLite2 database.
9
9
  #
10
10
  # A `[geoip][location]` field is created if
11
11
  # the GeoIP lookup returns a latitude and longitude. The field is stored in
@@ -1,7 +1,7 @@
1
1
  Gem::Specification.new do |s|
2
2
 
3
3
  s.name = 'logstash-filter-geoip'
4
- s.version = '7.0.0'
4
+ s.version = '7.0.1'
5
5
  s.licenses = ['Apache License (2.0)']
6
6
  s.summary = "Adds geographical information about an IP address"
7
7
  s.description = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: logstash-filter-geoip
3
3
  version: !ruby/object:Gem::Version
4
- version: 7.0.0
4
+ version: 7.0.1
5
5
  platform: java
6
6
  authors:
7
7
  - Elastic
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-03-01 00:00:00.000000000 Z
11
+ date: 2021-03-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  requirement: !ruby/object:Gem::Requirement