Contents
Destinations
Destinations define network settings for sending normalized events. Collectors and correlators use destinations to describe where to send processed events. Typically, correlators and storages act as destinations.
You can specify destination point settings on the Basic settings and Advanced settings tabs. The available settings depend on the selected type of destination.
Destinations can have the following types:
- internal for receiving data from KUMA services using the 'internal' protocol.
- nats-jetstream for communication through NATS.
- tcp for communications over TCP.
- http for communication over HTTP.
- diode for transmitting events using a data diode.
- kafka for kafka communications.
- file for writing to a file.
- storage for sending data to storage.
- correlator for sending data to a correlator.
- eventRouter for sending events to an event router.
Destination, internal type
Destinations of the internal type are used for receiving data from KUMA services using the 'internal' protocol. You can transfer the following data using the internal protocol:
- Internal data, such as event routes.
- File attributes. If while creating the collector at the Transport step of the installation wizard, you specified a connector of the file, 1c-xml, or 1c-log type, at the Event parsing step, in the Mapping table, you can pass the name of the file being processed by the collector or the path to the file in the KUMA event field. To do this, in the Source column, specify one of the following values:
$kuma_fileSourceName
to pass the name of the file being processed by the collector in the KUMA event field.$kuma_fileSourcePath
to pass the path to the file being processed by the collector in the KUMA event field.
When you use a file, 1c-xml, or 1c-log connector, the new variables in the normalizer will only work with destinations of the internal type.
- Events to the event router. The event router can only receive events over the 'internal' protocol, therefore you can only use internal destinations when sending events to the event router.
Settings for a destination of the internal type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: internal. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Output format |
Format in which events are sent to the destination:
|
Proxy server |
The proxy server for the destination. You can select an existing proxy server or create a new proxy server. To create a new proxy server, select Create new. If you want to edit the settings of an existing proxy server, click the pencil |
URL selection policy |
Method of determining URLs to which events must be sent first if you added multiple URLs in the URL field on the Basic settings:
|
Health check timeout |
Interval, in seconds, for checking the health of the destination. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, type nats-jetstream
Destinations of the nats-jetstream type are used for communication through NATS. Settings for a destination of the nats-jetstream type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: nats-jetstream. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Subject |
The topic of NATS messages. Characters are entered in Unicode encoding. Required setting. |
Authorization |
Type of authorization when connecting to the URL specified in the URL field:
|
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Output format |
Format in which events are sent to the destination:
|
TLS mode |
TLS encryption mode. When using TLS encryption, you cannot specify an IP address in the URL field on the Basic settings. Available values:
|
Compression |
Drop-down list for configuring Snappy compression:
|
Delimiter |
The character that marks the boundary between events:
If you do not select a value in this drop-down list, \n is selected by default. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, tcp type
Destinations of the tcp type are used for TCP communications. Settings for a destination of the tcp type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: tcp. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Output format |
Format in which events are sent to the destination:
|
TLS mode |
TLS encryption mode. When using TLS encryption, you cannot specify an IP address in the URL field on the Basic settings. Available values:
|
Compression |
Drop-down list for configuring Snappy compression:
|
URL selection policy |
Method of determining URLs to which events must be sent first if you added multiple URLs in the URL field on the Basic settings:
|
Delimiter |
The character that marks the boundary between events:
If you do not select a value in this drop-down list, \n is selected by default. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, http type
Destinations of the http type are used for HTTP communications. Settings for a destination of the http type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: http. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Authorization |
Type of authorization when connecting to the URL specified in the URL field:
|
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Output format |
Format in which events are sent to the destination:
|
TLS mode |
TLS encryption mode. When using TLS encryption, you cannot specify an IP address in the URL field on the Basic settings. Available values:
|
Proxy server |
The proxy server for the destination. You can select an existing proxy server or create a new proxy server. To create a new proxy server, select Create new. If you want to edit the settings of an existing proxy server, click the pencil |
Compression |
Drop-down list for configuring Snappy compression:
|
URL selection policy |
Method of determining URLs to which events must be sent first if you added multiple URLs in the URL field on the Basic settings:
|
Delimiter |
The character that marks the boundary between events:
If you do not select a value in this drop-down list, \n is selected by default. |
Path |
The path that must be added in the request to the URL specified in the URL field on the Basic settings tab. For example, if you specify |
Health check path |
The URL for sending requests to obtain health information about the system that the destination resource is connecting to. |
Health check |
This toggle switch enables the health check. This toggle switch is turned off by default. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, diode type
Destinations of the diode type are used to transmit events using a data diode. Settings for a destination of the diode type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: diode. Required setting. |
Data diode source directory |
Path to the directory from which the data diode moves events. The maximum length of the path is 255 Unicode characters. Limitations when using prefixes in paths on Windows servers Limitations when using prefixes in paths on Linux servers The paths specified in the Data diode source directory and Temporary directory fields may not be the same. |
Temporary directory |
Path to the directory in which events are prepared for transmission to the data diode. The maximum length of the path is 255 Unicode characters. Events are stored in a file when a timeout or a buffer overflow occurs. The default timeout is 10 seconds. The prepared file with events is moved to the directory specified in the Data diode source directory field. The checksum (SHA-256) of the file contents is used as the name of the file with events. The paths specified in the Data diode source directory and Temporary directory fields may not be the same. |
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Compression |
Drop-down list for configuring Snappy compression:
|
Delimiter |
The character that marks the boundary between events:
If you do not select a value in this drop-down list, \n is selected by default. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, kafka type
Destinations of the kafka type are used for communication using kafka. Settings for a destination of the kafka type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: kafka. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Topic |
Subject of Kafka messages. The maximum length of the subject is 255 characters. You can use the following characters: a–z, A–Z, 0–9, ".", "_", "-". Required setting. |
Authorization |
Type of authorization when connecting to the URL specified in the URL field:
|
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Output format |
Format in which events are sent to the destination:
|
TLS mode |
TLS encryption mode. When using TLS encryption, you cannot specify an IP address in the URL field on the Basic settings. Available values:
|
Delimiter |
The character that marks the boundary between events:
If you do not select a value in this drop-down list, \n is selected by default. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, file type
Destinations of the file type destinations are used for writing to a file. Settings for a destination of the file type are described in the following tables.
When deleting a destination of the file type that is being used in a service, you must restart the service.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: file. Required setting. |
URL |
Path to the file to which the events must be written. Limitations when using prefixes in file paths Required setting. |
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Output format |
Format in which events are sent to the destination:
|
Delimiter |
The character that marks the boundary between events:
If you do not select a value in this drop-down list, \n is selected by default. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, storage type
Destinations of the storage type are used to transfer data to storage. Settings for a destination of the storage type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: storage. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Proxy server |
The proxy server for the destination. You can select an existing proxy server or create a new proxy server. To create a new proxy server, select Create new. If you want to edit the settings of an existing proxy server, click the pencil |
URL selection policy |
Method of determining URLs to which events must be sent first if you added multiple URLs in the URL field on the Basic settings:
|
Health check timeout |
Interval, in seconds, for checking the health of the destination. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, correlator type
Destinations of the correlator type are used to transfer data to a correlator. Settings for a destination of the correlator type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: correlator. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Proxy server |
The proxy server for the destination. You can select an existing proxy server or create a new proxy server. To create a new proxy server, select Create new. If you want to edit the settings of an existing proxy server, click the pencil |
URL selection policy |
Method of determining URLs to which events must be sent first if you added multiple URLs in the URL field on the Basic settings:
|
Health check timeout |
Interval, in seconds, for checking the health of the destination. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Destination, eventRouter type
Destinations of the eventRouter type are used for sending events to the event router. Settings for a destination of the eventRouter type are described in the following tables.
Basic settings tab
Setting |
Description |
---|---|
Name |
Unique name of the resource. The maximum length of the name is 128 Unicode characters. Required setting. |
Tenant |
The name of the tenant that owns the resource. Required setting. |
State |
This toggle switch enables sending events to the destination. This toggle switch is turned on by default.
|
Type |
Destination type: eventRouter. Required setting. |
URL |
URL that you want to connect to. The following URL formats are supported:
You can add multiple URLs or remove an URL. KUMA does not allow saving a resource or service if the URL field contains a tab or space character. To add an URL, click the + Add button. To remove an URL, click the delete Required setting. |
Tags |
Tags for resource search. Optional setting. |
Description |
Description of the resource. The maximum length of the description is 4000 Unicode characters. |
Advanced settings tab
Setting |
Description |
---|---|
Buffer size |
Buffer size in bytes for accumulating events in the RAM of the server before sending them for further processing or storage. The value must be a positive integer. Default buffer size: 1,048,576 bytes (1 MB). Maximum buffer size: 67,108,864 bytes (64 MB). |
Buffer flush interval |
Interval (in seconds) for sending events to the destination. The default value is 1 second. |
Disk buffer size limit |
Size of the disk buffer in bytes. The default value is 10 GB. |
Handlers |
Number of handlers that the service can run simultaneously to process response rules in parallel. To determine the number of handlers, you can use the following formula: (<number of CPUs> / 2) + 2. The value must be a positive integer up to 999. |
Output format |
Format in which events are sent to the destination:
|
Proxy server |
The proxy server for the destination. You can select an existing proxy server or create a new proxy server. To create a new proxy server, select Create new. If you want to edit the settings of an existing proxy server, click the pencil |
URL selection policy |
Method of determining URLs to which events must be sent first if you added multiple URLs in the URL field on the Basic settings:
|
Health check timeout |
Interval, in seconds, for checking the health of the destination. |
Disk buffer disabled |
This toggle switch that enables the disk buffer. This toggle switch is turned on by default. The disk buffer is used if the collector cannot send normalized events to the destination. You can specify the size of the disk buffer in the Disk buffer size limit field. If the disk buffer runs out of free space, new normalized events will overwrite old normalized events, starting with the oldest. |
Timeout |
The time, in seconds, for which the destination waits for a response from another service or component. |
Debug |
The switch enables resource logging. The toggle switch is turned off by default. |
Filter |
Filter for determining which events must be processed by the resource. You can select an existing filter or create a new filter. To create a new filter, select Create new. If you want to edit the settings of an existing filter, click the pencil |
Predefined destinations
Destinations listed in the table below are included in the KUMA distribution kit.
Predefined destinations
Destination name |
Description |
[OOTB] Correlator |
Sends events to a correlator. |
[OOTB] Storage |
Sends events to storage. |