From c56f8bd95f772646125bc91ddabb6f03cf0f6bb8 Mon Sep 17 00:00:00 2001
From: Joe Gallo <joegallo@gmail.com>
Date: Fri, 18 Oct 2024 16:38:06 -0400
Subject: [PATCH] Switch sample files and update code and tests

There are slightly different columns in this sample database than in
the one we had been using. Most of the difference is immaterial, but
the location columns themselves are named slightly differently, and we
need to update our code and tests to match this new schema.
---
 .../ingest/geoip/IpinfoIpDataLookups.java     |  17 ++++-----
 .../ingest/geoip/GeoIpProcessorTests.java     |   6 ++--
 .../geoip/IpinfoIpDataLookupsTests.java       |  33 +++++++++---------
 .../ipinfo/ip_geolocation_sample.mmdb         | Bin 32881 -> 0 bytes
 .../ip_geolocation_standard_sample.mmdb       | Bin 0 -> 30105 bytes
 5 files changed, 29 insertions(+), 27 deletions(-)
 delete mode 100644 modules/ingest-geoip/src/test/resources/ipinfo/ip_geolocation_sample.mmdb
 create mode 100644 modules/ingest-geoip/src/test/resources/ipinfo/ip_geolocation_standard_sample.mmdb

diff --git a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookups.java b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookups.java
index 5a13ea93ff032..8ce2424844d9d 100644
--- a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookups.java
+++ b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookups.java
@@ -218,8 +218,8 @@ public record CountryResult(
     public record GeolocationResult(
         String city,
         String country,
-        Double latitude,
-        Double longitude,
+        Double lat,
+        Double lng,
         String postalCode,
         String region,
         String timezone
@@ -229,14 +229,15 @@ public record GeolocationResult(
         public GeolocationResult(
             @MaxMindDbParameter(name = "city") String city,
             @MaxMindDbParameter(name = "country") String country,
-            @MaxMindDbParameter(name = "latitude") String latitude,
-            @MaxMindDbParameter(name = "longitude") String longitude,
-            // @MaxMindDbParameter(name = "network") String network, // for now we're not exposing this
+            // @MaxMindDbParameter(name = "geoname_id") String geonameId, // for now we're not exposing this
+            @MaxMindDbParameter(name = "lat") String lat,
+            @MaxMindDbParameter(name = "lng") String lng,
             @MaxMindDbParameter(name = "postal_code") String postalCode,
             @MaxMindDbParameter(name = "region") String region,
+            // @MaxMindDbParameter(name = "region_code") String regionCode, // for now we're not exposing this
             @MaxMindDbParameter(name = "timezone") String timezone
         ) {
-            this(city, country, parseLocationDouble(latitude), parseLocationDouble(longitude), postalCode, region, timezone);
+            this(city, country, parseLocationDouble(lat), parseLocationDouble(lng), postalCode, region, timezone);
         }
     }
 
@@ -395,8 +396,8 @@ protected Map<String, Object> transform(final Result<GeolocationResult> result)
                         }
                     }
                     case LOCATION -> {
-                        Double latitude = response.latitude;
-                        Double longitude = response.longitude;
+                        Double latitude = response.lat;
+                        Double longitude = response.lng;
                         if (latitude != null && longitude != null) {
                             Map<String, Object> locationObject = new HashMap<>();
                             locationObject.put("lat", latitude);
diff --git a/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java b/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java
index 9ef12cef66742..4548e92239ce1 100644
--- a/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java
+++ b/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/GeoIpProcessorTests.java
@@ -82,13 +82,13 @@ public void testMaxmindCity() throws Exception {
     }
 
     public void testIpinfoGeolocation() throws Exception {
-        String ip = "4.36.238.62";
+        String ip = "72.20.12.220";
         GeoIpProcessor processor = new GeoIpProcessor(
             IP_LOCATION_TYPE, // n.b. this is an "ip_location" processor
             randomAlphaOfLength(10),
             null,
             "source_field",
-            loader("ipinfo/ip_geolocation_sample.mmdb"),
+            loader("ipinfo/ip_geolocation_standard_sample.mmdb"),
             () -> true,
             "target_field",
             getIpinfoGeolocationLookup(),
@@ -107,7 +107,7 @@ public void testIpinfoGeolocation() throws Exception {
         Map<String, Object> data = (Map<String, Object>) ingestDocument.getSourceAndMetadata().get("target_field");
         assertThat(data, notNullValue());
         assertThat(data.get("ip"), equalTo(ip));
-        assertThat(data.get("city_name"), equalTo("Pensacola"));
+        assertThat(data.get("city_name"), equalTo("Chicago"));
         // see IpinfoIpDataLookupsTests for more tests of the data lookup behavior
     }
 
diff --git a/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookupsTests.java b/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookupsTests.java
index 36c26576cf9de..d0cdc5a3e1b5e 100644
--- a/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookupsTests.java
+++ b/modules/ingest-geoip/src/test/java/org/elasticsearch/ingest/geoip/IpinfoIpDataLookupsTests.java
@@ -194,8 +194,8 @@ public void testCountryFree() {
 
     public void testGeolocationStandard() {
         assumeFalse("https://github.com/elastic/elasticsearch/issues/114266", Constants.WINDOWS);
-        String databaseName = "ip_geolocation_sample.mmdb";
-        String ip = "90.203.36.70";
+        String databaseName = "ip_geolocation_standard_sample.mmdb";
+        String ip = "62.69.48.19";
         assertExpectedLookupResults(
             databaseName,
             ip,
@@ -204,10 +204,10 @@ public void testGeolocationStandard() {
                 entry("ip", ip),
                 entry("country_iso_code", "GB"),
                 entry("region_name", "England"),
-                entry("city_name", "Birkenhead"),
+                entry("city_name", "London"),
                 entry("timezone", "Europe/London"),
-                entry("postal_code", "CH41"),
-                entry("location", Map.of("lat", 53.39337, "lon", -3.01479))
+                entry("postal_code", "E1W"),
+                entry("location", Map.of("lat", 51.50853, "lon", -0.12574))
             )
         );
     }
@@ -215,36 +215,37 @@ public void testGeolocationStandard() {
     public void testGeolocationInvariants() {
         assumeFalse("https://github.com/elastic/elasticsearch/issues/114266", Constants.WINDOWS);
         Path configDir = tmpDir;
-        copyDatabase("ipinfo/ip_geolocation_sample.mmdb", configDir.resolve("ip_geolocation_sample.mmdb"));
+        copyDatabase("ipinfo/ip_geolocation_standard_sample.mmdb", configDir.resolve("ip_geolocation_standard_sample.mmdb"));
 
         {
             final Set<String> expectedColumns = Set.of(
-                "network",
                 "city",
+                "geoname_id",
                 "region",
+                "region_code",
                 "country",
                 "postal_code",
                 "timezone",
-                "latitude",
-                "longitude"
+                "lat",
+                "lng"
             );
 
-            Path databasePath = configDir.resolve("ip_geolocation_sample.mmdb");
+            Path databasePath = configDir.resolve("ip_geolocation_standard_sample.mmdb");
             assertDatabaseInvariants(databasePath, (ip, row) -> {
                 assertThat(row.keySet(), equalTo(expectedColumns));
                 {
-                    String latitude = (String) row.get("latitude");
+                    String latitude = (String) row.get("lat");
                     assertThat(latitude, equalTo(latitude.trim()));
                     Double parsed = parseLocationDouble(latitude);
                     assertThat(parsed, notNullValue());
-                    assertThat(latitude, equalTo(Double.toString(parsed))); // reverse it
+                    assertThat(Double.parseDouble(latitude), equalTo(Double.parseDouble(Double.toString(parsed)))); // reverse it
                 }
                 {
-                    String longitude = (String) row.get("longitude");
+                    String longitude = (String) row.get("lng");
                     assertThat(longitude, equalTo(longitude.trim()));
                     Double parsed = parseLocationDouble(longitude);
                     assertThat(parsed, notNullValue());
-                    assertThat(longitude, equalTo(Double.toString(parsed))); // reverse it
+                    assertThat(Double.parseDouble(longitude), equalTo(Double.parseDouble(Double.toString(parsed)))); // reverse it
                 }
             });
         }
@@ -391,13 +392,13 @@ public void testDatabaseTypeParsing() throws IOException {
         // pedantic about where precisely it should be.
 
         copyDatabase("ipinfo/ip_asn_sample.mmdb", tmpDir.resolve("ip_asn_sample.mmdb"));
-        copyDatabase("ipinfo/ip_geolocation_sample.mmdb", tmpDir.resolve("ip_geolocation_sample.mmdb"));
+        copyDatabase("ipinfo/ip_geolocation_standard_sample.mmdb", tmpDir.resolve("ip_geolocation_standard_sample.mmdb"));
         copyDatabase("ipinfo/asn_sample.mmdb", tmpDir.resolve("asn_sample.mmdb"));
         copyDatabase("ipinfo/ip_country_sample.mmdb", tmpDir.resolve("ip_country_sample.mmdb"));
         copyDatabase("ipinfo/privacy_detection_sample.mmdb", tmpDir.resolve("privacy_detection_sample.mmdb"));
 
         assertThat(parseDatabaseFromType("ip_asn_sample.mmdb"), is(Database.AsnV2));
-        assertThat(parseDatabaseFromType("ip_geolocation_sample.mmdb"), is(Database.CityV2));
+        assertThat(parseDatabaseFromType("ip_geolocation_standard_sample.mmdb"), is(Database.CityV2));
         assertThat(parseDatabaseFromType("asn_sample.mmdb"), is(Database.AsnV2));
         assertThat(parseDatabaseFromType("ip_country_sample.mmdb"), is(Database.CountryV2));
         assertThat(parseDatabaseFromType("privacy_detection_sample.mmdb"), is(Database.PrivacyDetection));
diff --git a/modules/ingest-geoip/src/test/resources/ipinfo/ip_geolocation_sample.mmdb b/modules/ingest-geoip/src/test/resources/ipinfo/ip_geolocation_sample.mmdb
deleted file mode 100644
index 7f558d440fb1404bcb05a67c9884d8241a7154ab..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 32881
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
AN&o-=

diff --git a/modules/ingest-geoip/src/test/resources/ipinfo/ip_geolocation_standard_sample.mmdb b/modules/ingest-geoip/src/test/resources/ipinfo/ip_geolocation_standard_sample.mmdb
new file mode 100644
index 0000000000000000000000000000000000000000..205bd77fd53e24eece4bd04460465da2a5dc4b78
GIT binary patch
literal 30105
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%0D9V9)+JAXOA=I
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
E1AV7OfB*mh

literal 0
HcmV?d00001