Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Elastic Cache Lookup component can be configured using the Aspire workflow section. It requires the following entities to be created.

Below are the examples of how to configure the component. 


Easy Heading Free
navigationTitleOn this Page
wrapNavigationTexttrue
navigationExpandOptionexpand-all-by-default

Create Workflow


NOTE: Some options in the following table collapse or are displayed only when selecting other options, such as a checkbox or selects.

Field

Required

Default

Multiple

NotesExample
descriptionYes-NoName of the component application.

"Elastic Cache Lookup"

propertiesYes-NoConfiguration object
Server urlYes-NoComplete Url URL where the feeds are going to will be sendsent.http://localhost:9200/bulk_
AuthenticationNoNoneYesUser with the permissions to read from the Elastic index specified.none, basic, aws
IndexYes-NoThe elastic index to crawl. Index name limitations: 1) Lowercase only. 2) Cannot include \\, \/, ?, \", <, >, |, (space character), ,, # 3) Cannot start with -, _, + 4)[{"index":"index1"}]
Idle connection timeoutYes3600000NoMaximum time (in milliseconds) to keep an idle connection open.3600000
Max connectionsYes100NoMaximum number of connections to be opened.100
Connections per targetYes10NoMaximum number of connections opened for the same target.10
Connection timeoutYes15000NoMaximum time (in milliseconds) to wait for the connection.15000
Socket timeoutYes15000NoMaximum time (in milliseconds) to wait for a socket response.15000
Throttling periodYes5000NoTime period (in milliseconds) to throttle the connection.5000
Max connections per periodYes500NoMaximum number of connections used during the throttling period.500
Maximum retriesYes3NoMaximum number of retries for a failed document.3
Retry delayYes5000NoTime (in milliseconds) to wait before a retry.5000
Max number of entriesNo1000NoMax total number of entries to keep in the cache.1000
Max Total Weight (MB)No500NoSpecifies the maximum weight of entries the cache must contain.500
Time (min)No5NoRemove records that have been idle for an amount of time in minutes.5
Index lookup fieldYes-NoElastic index field name for the lookup,[{"index":"index1"}]
Source lookup fieldYes-NoSpecify field name from the incoming AspireObject for the lookup. Field availability will be searched first in 'doc' and then in 'doc.connectorSpecific' section.myid
Uppercase the source lookup field valueNotrueNoConvert the value of the source field into UPPERCASE value.FALSE
Lookup output fieldYes-NoOutput fields from the lookup will be placed under this configured object.myidOutput
DebugNofalseNoOption if you want debug messages enabled.FALSE
Hit sizeNo1000NoMax mount of hits returned by the cache lookup. If -1 all hits will be returned.1000

Example 

NOTE: The following structure is not ordered by the sections of the component configuration, as found on the Elastic Cache Lookup App Bundle page

Code Block
themeRDark
titlePUT aspire/_api/credentials/2a5ca234-e328-4d40-bb2a-2df3e550b065
{
    "description": "Elastic Cache Lookup",
    "properties": {
	 	"url": "http://localhost:9200",
        "authType": "none",
        "index": "index_name",
		"idleConnectionTimeout": 3600000,
       "id": "2a5ca234-e328-4d40-bb2a-2df3e550b065",
 "maxConnections": 100,
        "maxConnectionsPerRoute": 10,
        "connectionTimeout": 15000,
        "socketTimeout": 15000,
        "useThrottling": false,
        "maxRetries": 3,
        "descriptionretryWaitTime": "<Connector Name> Credential5000,
		"cache": true,
        "eviction": "size",
        "propertiesevictionMaxSize": {1000,
		"esIndexLookupField": "indexName",
        "sourceLookupField": "myid",
        "sourceLookupFieldToUpperCase": false,
        "lookupOutputField": "myidOutput",
        "debug": false,
        "size": 1000       
	}
}

Update

Connection

Workflow


Field

Required

Default

Multiple

NotesExample
descriptionYes-NoName of the component application.

"Elastic Cache Lookup"

propertiesYes-NoConfiguration object
Server urlYes-NoComplete Url URL where the feeds are going to will be sendsent.http://localhost:9200/bulk_
AuthenticationNoNoneYesUser with the permissions to read from the Elastic index specified.none, basic, aws
propertiesYes-NoConfiguration object
IndexYes-NoThe elastic index to crawl. Index name limitations: 1) Lowercase only. 2) Cannot include \\, \/, ?, \", <, >, |, (space character), ,, # 3) Cannot start with -, _, + 4)[{"index":"index1"}]
Idle connection timeoutYes3600000NoMaximum time (in milliseconds) to keep an idle connection open.3600000
Max connectionsYes100NoMaximum number of connections to be opened.100
Connections per targetYes10NoMaximum number of connections opened for the same target.10
Connection timeoutYes15000NoMaximum time (in milliseconds) to wait for the connection.15000
Socket timeoutYes15000NoMaximum time (in milliseconds) to wait for a socket response.15000
Throttling periodYes5000NoTime period (in milliseconds) to throttle the connection.5000
Max connections per periodYes500NoMaximum number of connections used during the throttling period.500
Maximum retriesYes3NoMaximum number of retries for a failed document.3
Retry delayYes5000NoTime (in milliseconds) to wait before a retry.5000
Max number of entriesNo1000NoMax total number of entries to keep in the cache.1000
Max Total Weight (MB)No500NoSpecifies the maximum weight of entries the cache must contain.500
Time (min)No5NoRemove records that have been idle for an amount of time in minutes.5
Index lookup fieldYes-NoElastic index field name for the lookup,[{"index":"index1"}]
Source lookup fieldYes-NoSpecify field name from the incoming AspireObject for the lookup. Field availability will be searched first in 'doc' and then in 'doc.connectorSpecific' section.myid
Uppercase the source lookup field valueNotrueNoConvert the value of the source field into UPPERCASE value.TRUE
Lookup output fieldYes-NoOutput fields from the lookup will be placed under this configured object.myidOutput
DebugNofalseNoOption if you want debug messages enabled.TRUE
Hit sizeNo1000NoMax mount of hits returned by the cache lookup. If -1 all hits will be returned.1000
Example

Example 

Code Block
themeRDark
{
    "description": "Elastic Cache Lookup",
    "properties": {
	 	"url": "http://localhost:9200",
        "authType": "none",
        "index": "index_name",
		"idleConnectionTimeout": 3600000,
        "maxConnections": 100,
        "maxConnectionsPerRoute": 10,
    "id": "89d6632a-a296-426c-adb0-d442adcab4b0",
    "description": "<Connector Name> Test Connector",
    "properties": {    "connectionTimeout": 15000,
        "socketTimeout": 15000,
        "useThrottling": true,
        "maxRetries": 3,
        "retryWaitTime": 5000,
		"cache": true,
        "eviction": "size",
        "evictionMaxSize": 1000,
		"esIndexLookupField": "indexName",
        "sourceLookupField": "myid",
        "sourceLookupFieldToUpperCase": true,
        "lookupOutputField": "myidOutput",
        "debug": true,
        "size": 1000       
	}
}