# encoding: utf-8
require "logstash/filters/base"
require "logstash/namespace"

require "logstash-filter-geoip_jars"

java_import "java.net.InetAddress"
java_import "com.maxmind.geoip2.DatabaseReader"
java_import "com.maxmind.geoip2.model.CityResponse"
java_import "com.maxmind.geoip2.record.Country"
java_import "com.maxmind.geoip2.record.Subdivision"
java_import "com.maxmind.geoip2.record.City"
java_import "com.maxmind.geoip2.record.Postal"
java_import "com.maxmind.geoip2.record.Location"
java_import "com.maxmind.db.CHMCache"

def suppress_all_warnings
  old_verbose = $VERBOSE
  begin
    $VERBOSE = nil
    yield if block_given?
  ensure
    # always re-set to old value, even if block raises an exception
    $VERBOSE = old_verbose
  end
end

# create a new instance of the Java class File without shadowing the Ruby version of the File class
module JavaIO
  include_package "java.io"
end


# The GeoIP2 filter adds information about the geographical location of IP addresses,
# based on data from the Maxmind database.
#
# Starting with version 1.3.0 of Logstash, a `[geoip][location]` field is created if
# the GeoIP lookup returns a latitude and longitude. The field is stored in
# http://geojson.org/geojson-spec.html[GeoJSON] format. Additionally,
# the default Elasticsearch template provided with the
# <<plugins-outputs-elasticsearch,`elasticsearch` output>> maps
# the `[geoip][location]` field to an http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/mapping-geo-point-type.html#_mapping_options[Elasticsearch geo_point].
#
# As this field is a `geo_point` _and_ it is still valid GeoJSON, you get
# the awesomeness of Elasticsearch's geospatial query, facet and filter functions
# and the flexibility of having GeoJSON for all other applications (like Kibana's
# map visualization).
#
# This product includes GeoLite2 data created by MaxMind, available from
# <http://dev.maxmind.com/geoip/geoip2/geolite2/>.
class LogStash::Filters::GeoIP < LogStash::Filters::Base
  config_name "geoip"

  # The path to the GeoIP2 database file which Logstash should use. Only City database is supported by now.
  #
  # If not specified, this will default to the GeoLiteCity database that ships
  # with Logstash.
  config :database, :validate => :path

  # The field containing the IP address or hostname to map via geoip. If
  # this field is an array, only the first value will be used.
  config :source, :validate => :string, :required => true

  # An array of geoip fields to be included in the event.
  #
  # Possible fields depend on the database type. By default, all geoip fields
  # are included in the event.
  #
  # For the built-in GeoLiteCity database, the following are available:
  # `city_name`, `continent_code`, `country_code2`, `country_code3`, `country_name`,
  # `dma_code`, `ip`, `latitude`, `longitude`, `postal_code`, `region_name` and `timezone`.
  config :fields, :validate => :array, :default => ['city_name', 'continent_code',
                                                    'country_code2', 'country_code3', 'country_name',
                                                    'dma_code', 'ip', 'latitude',
                                                    'longitude', 'postal_code', 'region_name',
                                                    'region_code', 'timezone', 'location']

  # Specify the field into which Logstash should store the geoip data.
  # This can be useful, for example, if you have `src\_ip` and `dst\_ip` fields and
  # would like the GeoIP information of both IPs.
  #
  # If you save the data to a target field other than `geoip` and want to use the
  # `geo\_point` related functions in Elasticsearch, you need to alter the template
  # provided with the Elasticsearch output and configure the output to use the
  # new template.
  #
  # Even if you don't use the `geo\_point` mapping, the `[target][location]` field
  # is still valid GeoJSON.
  config :target, :validate => :string, :default => 'geoip'

  # GeoIP lookup is surprisingly expensive. This filter uses an cache to take advantage of the fact that
  # IPs agents are often found adjacent to one another in log files and rarely have a random distribution.
  # The higher you set this the more likely an item is to be in the cache and the faster this filter will run.
  # However, if you set this too high you can use more memory than desired.
  # Since the Geoip API upgraded to v2, there is not any eviction policy so far, if cache is full, no more record can be added.
  # Experiment with different values for this option to find the best performance for your dataset.
  #
  # This MUST be set to a value > 0. There is really no reason to not want this behavior, the overhead is minimal
  # and the speed gains are large.
  #
  # It is important to note that this config value is global to the geoip_type. That is to say all instances of the geoip filter
  # of the same geoip_type share the same cache. The last declared cache size will 'win'. The reason for this is that there would be no benefit
  # to having multiple caches for different instances at different points in the pipeline, that would just increase the
  # number of cache misses and waste memory.
  config :cache_size, :validate => :number, :default => 1000

  # GeoIP lookup is surprisingly expensive. This filter uses an LRU cache to take advantage of the fact that
  # IPs agents are often found adjacent to one another in log files and rarely have a random distribution.
  # The higher you set this the more likely an item is to be in the cache and the faster this filter will run.
  # However, if you set this too high you can use more memory than desired.
  #
  # Experiment with different values for this option to find the best performance for your dataset.
  #
  # This MUST be set to a value > 0. There is really no reason to not want this behavior, the overhead is minimal
  # and the speed gains are large.
  #
  # It is important to note that this config value is global to the geoip_type. That is to say all instances of the geoip filter
  # of the same geoip_type share the same cache. The last declared cache size will 'win'. The reason for this is that there would be no benefit
  # to having multiple caches for different instances at different points in the pipeline, that would just increase the
  # number of cache misses and waste memory.
  config :lru_cache_size, :validate => :number, :default => 1000

  public
  def register
    suppress_all_warnings do
      if @database.nil?
        @database = ::Dir.glob(::File.join(::File.expand_path("../../../vendor/", ::File.dirname(__FILE__)),"GeoLite2-City.mmdb")).first

        if @database.nil? || !File.exists?(@database)
          raise "You must specify 'database => ...' in your geoip filter (I looked for '#{@database}')"
        end
      end

      @logger.info("Using geoip database", :path => @database)

      db_file = JavaIO::File.new(@database)
      begin
        @parser = DatabaseReader::Builder.new(db_file).withCache(CHMCache.new(@cache_size)).build();
      rescue Java::ComMaxmindDb::InvalidDatabaseException => e
        @logger.error("The Geoip2 MMDB database provided is invalid or corrupted.", :exception => e, :field => @source)
        raise e
      end
    end
  end # def register

  public
  def filter(event)
    return unless filter?(event)

    begin
      ip = event[@source]
      ip = ip.first if ip.is_a? Array
      ip_address = InetAddress.getByName(ip)
      response = @parser.city(ip_address)
      country = response.getCountry()
      subdivision = response.getMostSpecificSubdivision()
      city = response.getCity()
      postal = response.getPostal()
      location = response.getLocation()

      geo_data_hash = Hash.new()

      @fields.each do |field|
        case field
        when "city_name"
          geo_data_hash["city_name"] = city.getName()
        when "country_name"
          geo_data_hash["country_name"] = country.getName()
        when "continent_code"
          geo_data_hash["continent_code"] = response.getContinent().getCode()
        when "continent_name"
          geo_data_hash["continent_name"] = response.getContinent().getName()
        when "country_code2"
          geo_data_hash["country_code2"] = country.getIsoCode()
        when "country_code3"
          geo_data_hash["country_code3"] = country.getIsoCode()
        when "ip"
          geo_data_hash["ip"] = ip_address.getHostAddress()
        when "postal_code"
          geo_data_hash["postal_code"] = postal.getCode()
        when "dma_code"
          geo_data_hash["dma_code"] = location.getMetroCode()
        when "region_name"
          geo_data_hash["region_name"] = subdivision.getName()
        when "region_code"
          geo_data_hash["region_code"] = subdivision.getIsoCode()
        when "timezone"
          geo_data_hash["timezone"] = location.getTimeZone()
        when "location"
          geo_data_hash["location"] = [ location.getLongitude(), location.getLatitude() ]
        when "latitude"
          geo_data_hash["latitude"] = location.getLatitude()
        when "longitude"
          geo_data_hash["longitude"] = location.getLongitude()
        else
          raise Exception.new("[#{field}] is not a supported field option.")
        end
      end

    rescue com.maxmind.geoip2.exception.AddressNotFoundException => e
      @logger.debug("IP not found!", :exception => e, :field => @source, :event => event)
      event[@target] = {}
      return
    rescue java.net.UnknownHostException => e
      @logger.error("IP Field contained invalid IP address or hostname", :exception => e, :field => @source, :event => event)
      event[@target] = {}
      return
    rescue Exception => e
      @logger.error("Unknown error while looking up GeoIP data", :exception => e, :field => @source, :event => event)
      event[@target] = {}
      return
    end

    event[@target] = geo_data_hash

    filter_matched(event)
  end # def filter
end # class LogStash::Filters::GeoIP