Add or manage destinations
Destinations represent and provide access to the storage locations that your Edge Processor pipelines send data to.
The interface that you use to add, edit, or delete a destination varies depending on the destination type and the Splunk Cloud Platform version that you are using. The following table identifies the destination management interface that you need to use for a given destination type and Splunk Cloud Platform version:
| Destination type | Splunk Cloud Platform version | Interface for managing the destination |
|---|---|---|
| Splunk platform S2S | 9.0.2209 and higher | Destinations page in the Edge Processor service |
| Splunk platform HEC | 9.0.2209 and higher | Destinations page in the Edge Processor service |
| Amazon S3 | 9.0.2209 to 10.3.2512 | Destinations page in the Edge Processor service |
| 10.4.2604 to 10.6 | Data Management app | |
| 10.7 and higher | Catalog | |
| Microsoft Azure | 10.4.2604 to 10.6 | Data Management app |
| 10.7 and higher | Catalog |
As an administrator, you can use these interfaces to add, edit, or delete your destinations.
For more information, see the following sections on this page:
Add a destination
Depending on where you want to send your data and what version of Splunk Cloud Platform your Edge Processor service is associated with, you can add a destination by doing one of the following:
-
Navigate to the Destinations page in the Edge Processor service, select New destination, and then select the destination type.
-
Navigate to the Data Management app or the Catalog in Splunk Cloud Platform, and then create a connection and dataset corresponding to the storage location where you want to send your data.
For more information, see the following pages:
- Make more indexes available to the tenant
- Send data from Edge Processors to non-connected Splunk platform deployments using S2S
- Send data from Edge Processors to non-connected Splunk platform deployments using HEC
-
For Splunk Cloud Platform 10.4.2604 or higher:
- For Splunk Cloud Platform 10.3.2512 or lower:
Edit a destination
The instructions for editing a destination vary depending on whether the destination is managed by the Edge Processor service, the Data Management app, or the Catalog.
-
For destinations that are managed by the Edge Processor service, you open a destination for editing from the Destinations page.
-
For destinations that are managed by the Data Management app or the Catalog, you edit the destination by editing the associated connection and dataset. Settings that pertain to authentication and account access are typically stored in the connection, while settings that pertain to the choice of data storage location and the format of the output data are typically stored in the dataset.
To edit a destination, complete the following steps:
- Do one of the following:
Where the destination is managed Complete these steps Edge Processor service -
In the Edge Processor service, navigate to the Destinations page.
-
In the row that lists the destination that you want to modify, select the Actions icon (
) and then select Edit.
Data Management app -
In Splunk Cloud Platform, select the Data Management app, and then navigate to either the Connections page or the Datasets page.
-
In the row that lists the connection or dataset that you want to modify, select the Actions icon (
) and then select Edit.
Catalog -
In Splunk Cloud Platform, select the Catalog icon (
), and then select either the Connections tab or the Datasets tab.
-
In the row that lists the connection or dataset that you want to modify, select the Actions icon (
) and then select Manage.
-
- Update the configuration settings as desired, and then select Save.
If the destination is used by any Edge Processors or applied pipelines, then the affected Edge Processor instances restart and the Edge Processor service re-applies the affected pipelines. It can take a few minutes for these processes to be completed. During this time, the affected Edge Processor instances enter the Pending status.
To confirm that the process completed successfully, do the following:
- Navigate to the Edge Processors page. Then, verify that the Instance health column for the affected Edge Processors shows that all instances are back in the Healthy status.
- Navigate to the Pipelines page. Then, verify that the Applied column for the affected pipelines contains a The pipeline is applied icon (
).
Delete a destination
The instructions for deleting a destination vary depending on whether the destination is managed by the Edge Processor service, the Data Management app, or the Catalog.
-
For destinations that are managed by the Edge Processor service, you delete the destination from the Destinations page.
-
For destinations that are managed by the Data Management app or the Catalog, you delete the destination by deleting the associated dataset. You can choose whether to also delete the associated connection, or keep the connection so that you can use it to create other datasets and destinations.
To delete a destination, complete the following steps:
- Do one of the following:
Where the destination is managed Complete these steps Edge Processor service -
In the Edge Processor service, navigate to the Destinations page.
-
In the row that lists the destination that you want to delete, select the Actions icon (
) and then select Delete.
Data Management app -
In Splunk Cloud Platform, select the Data Management app, and then navigate to either the Connections page or the Datasets page.
-
In the row that lists the connection or dataset that you want to delete, select the Actions icon (
) and then select Delete.
Catalog -
In Splunk Cloud Platform, select the Catalog icon (
), and then select either the Connections tab or the Datasets tab.
-
In the row that lists the connection or dataset that you want to delete, select the Actions icon (
) and then select Delete.
-
- Select Delete to confirm your choice.