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.
alternativesConnection SettingstextSpecify .

Field

Required

Default

Multiple

NotesExample
descriptionYes-NoName of the component application.

"Elastic Cache Lookup"

propertiesYes-NoConfiguration object
Elasticsearch SettingsServer urltextYes-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 timeoutnumberYes3600000NoMaximum time (in milliseconds) to keep an idle connection open.3600000
Max connectionsnumberYes100NoMaximum number of connections to be opened.100
Connections per targetnumberYes10NoMaximum number of connections opened for the same target.10
Connection timeoutnumberYes15000NoMaximum time (in milliseconds) to wait for the connection.15000
Socket timeoutnumberYes15000NoMaximum time (in milliseconds) to wait for a socket response.Connection throttlingbooleanfalseCheckbox to choose the enable connection throttling.15000
Throttling periodnumberYes5000NoTime period (in milliseconds) to throttle the connection.5000
Max connections per periodnumberYes500NoMaximum number of connections used during the throttling period.500
Maximum retriesnumberYes3NoMaximum number of retries for a failed document.3
Retry delaynumberYes5000NoTime (in milliseconds) to wait before a retry.CacheUse cachealternativestrueResults should be cached in memory.Cache Eviction PolicyalternativessizeHow items should be selected for being deleted from the in-memory cache.5000
Max number of entriesnumberNo1000NoMax total number of entries to keep in the cache.1000
Max Total Weight (MB)numberNo500NoSpecifies the maximum weight of entries the cache must contain.500
Time (min)numberNo5NoRemove records that have been idle for an amount of time in minutes.Lookup Fields5
Index lookup fieldYes-NoElastic index field name for the lookup,[{"index":"index1"}]
Source lookup fieldtextYes-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 valuebooleanNotrueNoConvert the value of the source field into UPPERCASE value.FALSE
Lookup output fieldtextYes-NoOutput fields from the lookup will be placed under this configured object.myidOutput
DebugbooleanNofalseNoOption if you want debug messages enabled.FALSE
Hit sizenumberNo1000NoMax 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,
        "maxConnections": 100,
        "id": "2a5ca234-e328-4d40-bb2a-2df3e550b065",
"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
iddescriptionYes-NoId Name of the connection to update"89d6632a-a296-426c-adb0-d442adcab4b0",
descriptionNo-NoName of the connection object.

"MyImage RemovedConnection"

throttlePolicyNo-NoId of the throttle policy that applies to this connection object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPoliciesNo[ ]YesThe ids of the routing policies that this connection will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]
propertiesYes-NoConfiguration object

Example

component application.

"Elastic Cache Lookup"

propertiesYes-NoConfiguration object
Server urlYes-NoComplete URL where the feeds will be sent.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 (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 

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