Splunk Cloud Platform

Use Edge Processors

Get syslog data into an Edge Processor

Edge Processors support syslog data. Syslog is a network-based mechanism that allows sending data from various devices directly to an Edge Processor. Send events from your syslog data source to an Edge Processor so that you can process your data before sending it to the Splunk platform or other data destinations.

To send syslog data directly from the data source to an Edge Processor, you must do the following:

  1. Configure a receiving port for syslog data. See Configure a port for receiving syslog data.
  2. Configure your Edge Processor to be able to receive syslog data. See Activate the syslog receiver on your Edge Processor.
  3. Configure your device to send data to your Edge Processor. See Configure your device to send syslog data to an Edge Processor.

As alternatives, you can also use Splunk forwarders or Splunk Connect for Syslog (SC4S) to send syslog data to an Edge Processor.

Prerequisites

Before configuring your Edge Processor to receive syslog data, make sure the following requirements are met:

  • On the host machine of your Edge Processor, the port that you want to use to receive syslog data is available, and your network policy allows that port to be opened.
  • If you want to secure communications between your data source and your Edge Processor using mutually authenticated TLS (mTLS), which means that the data source and the Edge Processor must prove their identities by presenting valid TLS certificates before they can connect and communicate with each other, start by confirming that TLS is available on your syslog device or forwarder. Then, obtain the following certificates in Privacy Enhanced Mail (PEM) format:
    • A client certificate, CA certificate, and private key that the data source can use to prove its identity.
    • A server certificate, CA certificate, and private key that the Edge Processor can use to prove its identity.

These certificates can be self-signed or they can be signed by a third-party. See Obtain TLS certificates for data sources and Edge Processors for information on generating client and server certificates.

Configure a port for receiving syslog data

Specify the port that your Edge Processors use to listen for incoming syslog data. You can choose to use a different port for every source type assigned to your incoming syslog data, or use one port for all incoming syslog traffic. If you use one port for all incoming syslog traffic, set the source type associated with the port to a placeholder value. You will need to use a pipeline to manually extract data values into fields and append the correct sourcetype value for each log.

  1. In the Edge Processor service, navigate to the Edge Processors page.
  2. Select Shared settings.
  3. Select New port in the Syslog section.
    1. In the Port field, enter your desired port number. Enter a unique port number that is not 8888 or 1777. You may use the same port if the transport protocol is different.

      You can use ports 1-1024 only if you run your Edge Processor instances as root. If you don't want to run your Edge Processor instances as root, then you must enter port numbers 1025 or higher. Alternatively, consult your Linux administrator to allow non-root users to use ports 1-1024.

    2. In the Source type field, select a source type or enter your own. The source type is the metadata value assigned to incoming syslog data.
    3. In the RFC protocol field, select the RFC protocol that matches your syslog data. The transport protocol is determined by the RFC protocol selected. If your syslog data does not meet the selected RFC protocol standards, select Other formats. In this case, you need to manually configure field extractions through the pipeline. See Extract fields from event data using an Edge Processor for more information on configuring field extractions and Request body format for more information on RFC protocol standards.
    4. (Optional) In the Default source field, enter a source if your event does not have it.
  4. Select Save.
  5. To edit an existing port, select the Edit (Image of the Edit icon) icon. To delete an existing port, select the Delete icon (Image of the Delete icon).

Next, you can optionally configure the time zone of your incoming syslog data before activating the syslog receiver on your Edge Processor.

Configure the time zone of your syslog data in the Edge Processor

If you don't have a time zone assigned, by default, the Edge Processor assigns the Universal Time Coordinated (UTC) time standard for your syslog events. If your syslog data uses the RFC 3164 protocol and does not have a time zone assigned to it, you can optionally configure your Edge Processor to assign it to a different time zone.

  1. In the Edge Processor service, navigate to the Edge Processors page.
  2. Select Shared settings.
  3. In the Time zone for syslog data section, select Edit.
  4. Select your desired time zone assignment.
    • Select Use system local time if you want to use the time zone that is associated with the local system time of your host machine.
    • Select Assign time zone if you want to use a specific time zone from the options provided.
  5. Select Save.

If there are errors when the Edge Processor validates the time zone, then the Edge Processor will assign the default UTC time standard. Validation errors could occur if, for example, there are no time zone databases installed on the Edge Processor host.

Next, activate the syslog receiver on your Edge Processor.

Activate the syslog receiver on your Edge Processor

Configure your Edge Processor to support incoming syslog data.

The following instructions mention the settings that are required for receiving syslog data. For information about other Edge Processor settings, see Add an Edge Processor.

  1. In the Edge Processor service, navigate to the Edge Processors page.
  2. To access the receiver settings, do one of the following:
    1. If you want to configure an existing Edge Processor, find the row that lists that Edge Processor. Then, select the Actions icon (Image of the Actions icon) and select Edit Edge Processor.
    2. If you want to configure a new Edge Processor, select New Edge Processor.
  3. In the Receive data from these inputs section, select Syslog.
  4. If you want to use mTLS to secure the communications between your syslog data sources and the Edge Processor, then do the following:
    1. In the Syslog section, select mTLS.
    2. If this is the first time that the mTLS settings have been turned on for this Edge Processor, then upload PEM files containing the certificates for proving the Edge Processor's identity in the Server private key, Server certificate, and CA certificates fields.
    3. The Edge Processor uses the same PEM files to prove its identity to all data sources where mTLS is used. For example, if you are also using mTLS with Splunk forwarders, then the Edge Processor uses the same server-side PEM files when receiving data from forwarders and syslog data sources.

  5. Select Save.

The Edge Processor can now receive data from a syslog data source. Next, configure your device to send syslog data to the Edge Processor.

Configure your device to send syslog data to an Edge Processor

Configure your syslog data source to send data to an Edge Processor instance and through the assigned port. If you configured your Edge Processor to use mTLS to secure communications from syslog data sources, then you must configure the data source to provide TLS certificates that prove its identity. Refer to the documentation for your specific data source for information on how to configure it to use TLS certificates.

The following are examples of basic TCP and UDP requests that send hello, world! as a syslog event to an Edge Processor instance.

Example of a basic TCP request:

echo 'hello, world' | nc host_123ghnskfpi 8090

Example of a basic UDP request:

echo 'hello, world' | nc -u host_123ghnskfpi 8090

For best results, make sure that the requests follow the requirements and best practices described in the following sections:

In the Edge Processor service, you can find examples of basic requests that have the host name and port values relevant to your Edge Processors. You can use these examples as a starting point for your requests. See Get syslog request examples with your Edge Processor information in this topic.

URI format

The request must be directed to a Uniform Resource Indicator (URI) written in this format:
<host>:<port>

The variables are defined as follows:

  • <host> is the host name of a specific Edge Processor instance.
  • <port> is the number of the port that the Edge Processor instance uses to receive syslog data. This port number is a shared configuration setting that is specified in the Edge Processor service. See Configure a port for receiving syslog data for more information.

Request body format

The body of the syslog data depends on your RFC protocol. Other optional parameters and event fields are also supported.

As a best practice for reducing inaccuracies in the Edge Processor metrics, make sure that your syslog request specifies a host value. The Inbound data sources metric is based on the number of distinct host values detected in the inbound events.

The following table mentions the RFC protocols supported by the Edge Processor:

RFC protocol Format Example
5424 and 6587 <Priority>version timestamp hostname app-name procid msgid structured-data msg <165>1 2023-07-17T22:14:15.003Z hello.world.com evntslog 123 - ID47 [exampleSDID@32473 iut="3" eventSource="Application" eventID="1011"] BOMAn applicationevent log entry
3164 <priority>timestamp hostname message <priority><132>Jul 17 22:14:015 hello.world.com evntslog BOMAn applicationevent log entry

If your syslog data does not meet the selected RFC protocol standards, select Other formats when configuring a port for your syslog data. You need to manually configure field extractions through the pipeline.

Syslog data behavior based on selected RFC protocol

The Edge Processor extracts fields from your data based on the RFC protocol you selected. Select the correct RFC protocol to ensure accurate data formatting.

The following table shows how syslog data with a specific RFC protocol behaves when matched with other RFC protocols:

Original RFC protocol of the data RFC 5424 or 6587 is selected RFC 3164 is selected Other is selected
RFC 5424 and 6587 All fields recognized Host: <nil>

Source: edge-source
_raw: <the message in log>

All fields recognized
RFC 3164 Host: <nil>

Source: edge-source
_raw: <the message in log>

All fields recognized Host: <nil>

Source: edge-source
_raw: <the message in log>

Other Host: <nil>

Source: edge-source
_raw: <the message in log>

Host: <nil>

Source: edge-source
_raw: <the message in log>

Host: <nil>

Source: edge-source
_raw: <the message in log>

Get syslog request examples with your Edge Processor information

You can find syslog request examples with hostname and port values relevant to your Edge Processors by doing the following:

  1. In the Edge Processor service, navigate to the Edge Processors page.
  2. In the row that lists your Edge Processor, select the Actions icon (Image of the Actions icon) and then select Configure data sources.
  3. In the Configure data sources side panel, use the drop-down list to select Syslog.
  4. Select your source type and port to use, and then select an instance.
  5. To copy the example, select Copy to clipboard.

Use SC4S to get syslog data into an Edge Processor

As an alternative to sending syslog data directly from the data source to an Edge Processor, you can use SC4S to send syslog data to an Edge Processor through the HTTP Event Collector (HEC).

SC4S is a solution for ingesting syslog data into the Splunk platform. It provides robust support for parsing syslog data, allowing you to break and merge data into distinct events and set Splunk metadata fields such as index, host, source, and sourcetype. For more information about SC4S, see the Splunk Connect for Syslog documentation.

Using SC4S to get syslog data into an Edge Processor involves doing the following:

  1. Configure your Edge Processor to receive data through the HTTP Event Collector (HEC). Because SC4S transmits data using HEC, you can use the same Edge Processor configurations as you would for receiving other HEC data. Follow the instructions provided in these sections of the Get data into an Edge Processor using HTTP Event Collector topic:
  2. If you don't already have an SC4S instance running, install SC4S. See the Getting Started chapter in the Splunk Connect for Syslog documentation.

    For best results, run the installation in a containerized environment. Do not use the "Bring your own Environment" installation method unless it is necessary for supporting your syslog use cases.

  3. If you haven't already configured the data sources for your SC4S instance, configure SC4S to collect your syslog data. See the Sources chapter and the Configuration topic in the Splunk Connect for Syslog documentation.
  4. Make sure that SC4S sets the appropriate Splunk metadata in all the syslog data that it handles.
    • Your data must be associated with a sourcetype value, or else Edge Processor pipelines cannot select that data for processing.
    • As a best practice for reducing inaccuracies in the Edge Processor metrics, make sure that your data is also associated with a host value. The Inbound data sources metric is based on the number of distinct host values detected in the inbound events.

    For information about the metadata configurations that SC4S uses by default, see the pages nested under "Known Vendors" in the Sources chapter of the Splunk Connect for Syslog documentation. For information about how to override these configurations, see SC4S metadata configuration in the Splunk Connect for Syslog documentation.

  5. Configure SC4S to use your Edge Processor as a HEC destination. See Configure SC4S to send data to an Edge Processor in this topic.

Configure SC4S to send data to an Edge Processor

If you have an SC4S instance that is collecting and parsing your syslog data, you can configure it to send syslog data to an Edge Processor for processing and routing.

  1. On the machine where SC4S is installed, set the SC4S_DEST_SPLUNK_HEC_DEFAULT_URL environment variable to the URL of your Edge Processor instance. If you're sending data to an Edge Processor instance group, then you can set this environment variable to a comma-separated list of the instance URLs. Each URL must be written in this format:
    <protocol>://<host>:<port>
    

    The variables are defined as follows:

    • <protocol> is either http or https.
    • <host> is the host name of a specific Edge Processor instance.
    • <port> is the number of the port that the Edge Processor instance uses to receive HEC requests.

    This port number is a shared configuration setting that is specified in the Edge Processor service. See Configure shared Edge Processor settings for more information.

  2. Depending on the specific installation method and runtime environment that is used, some SC4S deployments need to be restarted before configuration changes take effect. If necessary, restart SC4S.
  3. (Optional) Confirm if your Edge Processor is receiving, processing, and routing data from SC4S as expected.
    1. In the Edge Processor service, do the following:
      1. Navigate to the Edge Processors page. Then, in the row that lists your Edge Processor, select the Actions icon (Image of the Actions icon) and then select Open.
      2. From the Metrics drop-down list, select a timeframe during which SC4S is sending data to the Edge Processor.
      3. In the Received data pane, confirm that the Source type list includes the source type of your syslog data.
      4. In the Data flowing through in the last <timeframe> area of the page, confirm that the Inbound data sources field includes the expected count of HEC sources. Each distinct host value in your syslog data is counted as 1 HEC source.
      5. In the Pipeline pane, check the Outbound data metrics to confirm that all your pipelines are successfully sending data out to the specified destinations.
    2. Browse or search your data destinations to confirm that they contain your syslog data as expected.

You can now use the Edge Processor solution to process the syslog data from your SC4S instance and send it to a supported destination of your choice.

Be aware that you might start seeing a message similar to the following in your SC4S logs. This log message is expected.

curl: (6) Could not resolve host: <IP or HOST>:<PORT>
SC4S_ENV_CHECK_HEC: Invalid Splunk HEC URL, invalid token, or other HEC connectivity issue index=main. sourcetype=sc4s:fallback
Startup will continue to prevent data loss if this is a transient failure.
Last modified on 03 October, 2024
Get data into an Edge Processor using HTTP Event Collector   Obtain TLS certificates for data sources and Edge Processors

This documentation applies to the following versions of Splunk Cloud Platform: 9.0.2209, 9.0.2303, 9.0.2305, 9.1.2308, 9.1.2312, 9.2.2403 (latest FedRAMP release), 9.2.2406


Was this topic useful?







You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters