Correlator type

The correlator type is used to transmit data to the correlator.

Basic settings tab

Setting

Description

Name

Required setting.

Unique name of the resource. Must contain 1 to 128 Unicode characters.

Tenant

Required setting.

The name of the tenant that owns the resource.

The State toggle switch

Used when events must be sent to the destination.

By default, sending events is enabled.

Type

Required setting.

Destination type, correlator.

URL

Required setting.

URL that you want to connect to. Available formats: host:port, IPv4:port, :port. IPv6 addresses are also supported, however, when you use them, you must specify the interface as well: [address%interface]:port.
Example: [fe80::5054:ff:fe4d:ba0c%eth0]:4222).

You can add multiple addresses using the URL button.

The URL field supports search for services by FQDN, IP address, and name. Search string formats:

  • <Search value>—search is performed by FQDN, IP addresses, and service names.
  • <First search value ending in one or more digits>:<second search value>—the first value is used to search by the service FQDN or IP address, and the second value is used to search by port.
  • :<value>—search is performed by port.

Description

Resource description: up to 4,000 Unicode characters.

Advanced settings tab

Setting

Description

Proxy server

Drop-down list for selecting a proxy server.

Buffer size

Sets the size of the buffer.

The default value is 1 KB, and the maximum value is 64 MB.

Disk buffer size limit

Size of the disk buffer in bytes.

The default value is 10 GB.

URL selection policy

Drop-down list in which you can select a method for determining which URL to send events to if several URLs have been specified:

  • Any. Events are sent to one of the available URLs as long as this URL receives events. If the connection is broken (for example, the receiving node is disconnected) a different URL will be selected as the events destination.
  • Prefer first. Events are sent to the first URL in the list of added addresses. If it becomes unavailable, events are sent to the next available node in sequence. When the first URL becomes available again, events start to be sent to it again.
  • Balanced means that packages with events are evenly distributed among the available URLs from the list. Because packets are sent either on a destination buffer overflow or on the flush timer, this URL selection policy does not guarantee an equal distribution of events to destinations.

Buffer flush interval

Time (in seconds) between sending batches of data to the destination. The default value is 1 second.

Number of handlers

This field is used to set the number of services processing the queue. By default, this value is equal to the number of vCPUs of the KUMA Core server.

Health check timeout

Frequency of the health check in seconds.

Debug

This toggle switch lets you specify whether resource logging must be enabled. The default value is Disabled.

Disk buffer disabled

Drop-down list that lets you enable or disable the disk buffer. By default, the disk buffer is enabled.

The disk buffer is used if the collector cannot send normalized events to the destination. The amount of allocated disk space is limited by the value of the Disk buffer size limit setting.

If the disk space allocated for the disk buffer is exhausted, events are rotated as follows: new events replace the oldest events written to the buffer.

Filter

In the Filter section, you can specify the criteria for identifying events that must be processed by the resource. You can select an existing filter from the drop-down list or create a new filter.

Creating a filter in resources

Page top