GeoIP Processor

Status
Stability	alpha: traces, metrics, logs
Distributions	contrib
Issues
Code Owners	@andrzej-stencel, @michalpristas, @rogercoll

Description

The geoIP processor geoipprocessor enhances the attributes of a span, log, or metric by appending information about the geographical location of an IP address. To add geographical information, the IP address must be included in the attributes using the source.address semantic conventions key attribute. By default, only the resource attributes will be modified. Please refer to config.go for the config spec.

Geographical location metadata

The following resource attributes will be added if the corresponding information is found:

  * geo.city_name
  * geo.postal_code
  * geo.country_name
  * geo.country_iso_code
  * geo.continent_name
  * geo.continent_code
  * geo.region_name
  * geo.region_iso_code
  * geo.timezone
  * geo.location.lat
  * geo.location.lon

Configuration

The following settings must be configured:

• providers: A map containing geographical location information providers. These providers are used to search for the geographical location attributes associated with an IP. Supported providers:
  • maxmind
• context: Allows specifying the underlying telemetry context the processor will work with. Available values:
  • resource(default): Resource attributes.
  • record: Attributes within a data point, log record or a span.

Examples

processors:
    # processor name: geoip
    geoip:
      context: resource
      providers:
        maxmind:
          database_path: /tmp/mygeodb