Class IpLocationProcessor
java.lang.Object
co.elastic.clients.elasticsearch.ingest.ProcessorBase
co.elastic.clients.elasticsearch.ingest.IpLocationProcessor
- All Implemented Interfaces:
ProcessorVariant
,JsonpSerializable
@JsonpDeserializable
public class IpLocationProcessor
extends ProcessorBase
implements ProcessorVariant
- See Also:
-
Nested Class Summary
Nested ClassesNested classes/interfaces inherited from class co.elastic.clients.elasticsearch.ingest.ProcessorBase
ProcessorBase.AbstractBuilder<BuilderT extends ProcessorBase.AbstractBuilder<BuilderT>>
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final JsonpDeserializer<IpLocationProcessor>
Json deserializer forIpLocationProcessor
-
Method Summary
Modifier and TypeMethodDescriptionProcessor variant kind.final String
The database filename referring to a database the module ships with (GeoLite2-City.mmdb, GeoLite2-Country.mmdb, or GeoLite2-ASN.mmdb) or a custom database in the ingest-geoip config directory.final Boolean
Iftrue
(and ifingest.geoip.downloader.eager.download
isfalse
), the missing database is downloaded when the pipeline is created.final String
field()
Required - The field to get the ip address from for the geographical lookup.final Boolean
Iftrue
, only the first found IP location data will be returned, even if the field contains an array.final Boolean
Iftrue
andfield
does not exist, the processor quietly exits without modifying the document.static IpLocationProcessor
Controls what properties are added to thetarget_field
based on the IP location lookup.protected void
serializeInternal
(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper) protected static void
final String
The field that will hold the geographical information looked up from the MaxMind database.Methods inherited from class co.elastic.clients.elasticsearch.ingest.ProcessorBase
description, if_, ignoreFailure, onFailure, serialize, setupProcessorBaseDeserializer, tag, toString
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface co.elastic.clients.elasticsearch.ingest.ProcessorVariant
_toProcessor
-
Field Details
-
_DESERIALIZER
Json deserializer forIpLocationProcessor
-
-
Method Details
-
of
public static IpLocationProcessor of(Function<IpLocationProcessor.Builder, ObjectBuilder<IpLocationProcessor>> fn) -
_processorKind
Processor variant kind.- Specified by:
_processorKind
in interfaceProcessorVariant
-
databaseFile
The database filename referring to a database the module ships with (GeoLite2-City.mmdb, GeoLite2-Country.mmdb, or GeoLite2-ASN.mmdb) or a custom database in the ingest-geoip config directory.API name:
database_file
-
field
Required - The field to get the ip address from for the geographical lookup.API name:
field
-
firstOnly
Iftrue
, only the first found IP location data will be returned, even if the field contains an array.API name:
first_only
-
ignoreMissing
Iftrue
andfield
does not exist, the processor quietly exits without modifying the document.API name:
ignore_missing
-
properties
Controls what properties are added to thetarget_field
based on the IP location lookup.API name:
properties
-
targetField
The field that will hold the geographical information looked up from the MaxMind database.API name:
target_field
-
downloadDatabaseOnPipelineCreation
Iftrue
(and ifingest.geoip.downloader.eager.download
isfalse
), the missing database is downloaded when the pipeline is created. Else, the download is triggered by when the pipeline is used as thedefault_pipeline
orfinal_pipeline
in an index.API name:
download_database_on_pipeline_creation
-
serializeInternal
- Overrides:
serializeInternal
in classProcessorBase
-
setupIpLocationProcessorDeserializer
protected static void setupIpLocationProcessorDeserializer(ObjectDeserializer<IpLocationProcessor.Builder> op)
-