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 StringThe 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 BooleanIftrue(and ifingest.geoip.downloader.eager.downloadisfalse), the missing database is downloaded when the pipeline is created.final Stringfield()Required - The field to get the ip address from for the geographical lookup.final BooleanIftrue, only the first found IP location data will be returned, even if the field contains an array.final BooleanIftrueandfielddoes not exist, the processor quietly exits without modifying the document.static IpLocationProcessorControls what properties are added to thetarget_fieldbased on the IP location lookup.protected voidserializeInternal(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper) protected static voidfinal StringThe 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, toStringMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods 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:
_processorKindin 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
Iftrueandfielddoes not exist, the processor quietly exits without modifying the document.API name:
ignore_missing -
properties
Controls what properties are added to thetarget_fieldbased 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.downloadisfalse), the missing database is downloaded when the pipeline is created. Else, the download is triggered by when the pipeline is used as thedefault_pipelineorfinal_pipelinein an index.API name:
download_database_on_pipeline_creation -
serializeInternal
- Overrides:
serializeInternalin classProcessorBase
-
setupIpLocationProcessorDeserializer
protected static void setupIpLocationProcessorDeserializer(ObjectDeserializer<IpLocationProcessor.Builder> op)
-