diff --git a/docs/send-data/opentelemetry-collector/remote-management/source-templates/manage-source-templates.md b/docs/send-data/opentelemetry-collector/remote-management/source-templates/manage-source-templates.md index 8bed443832..4198866929 100644 --- a/docs/send-data/opentelemetry-collector/remote-management/source-templates/manage-source-templates.md +++ b/docs/send-data/opentelemetry-collector/remote-management/source-templates/manage-source-templates.md @@ -69,7 +69,7 @@ For more details on source templates, see [Installed Collector Sources](/docs/se To edit a source template: -1. In the main Sumo Logic menu, select **Manage Data > Collection > Source Template**. +1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > Source Template**.
[**New UI**](/docs/get-started/sumo-logic-ui). Go to the Sumo Logic top menu and select **Configuration > Collection > Source Template**. 1. Select the source template that you need to edit, and click **Edit**. Or, click the kebab menu against the selected source template and click **Edit** from the dropdown. 1. Change the required configuration in the source template configuration page, and click **Next**. 1. If required, update the collectors on the **Link Collectors** page. @@ -95,6 +95,23 @@ You cannot upgrade a source template if there are any incompatible collector ver 1. Click the **Delete** button (or use the kebab menu against the selected source template, click **Delete** from the dropdown). 1. Confirm the deletion. The source template will be removed from the **Source Template** page and unlinked from all collectors. +## Enable/disable a source template + +You can enable or disable a source template to optimize your data flow management. Below are some of the key benefits of enabling or disabling the source template: + +- **Cost efficiency.** Proactively manage and reduce costs associated with excessive or unnecessary data ingestion. +- **Compliance protection.** Safeguard your organization from compliance violations by preventing potential exposure of sensitive information in logs. +- **Agility in response.** Quickly address misconfigurations or anomalies in your data sources without disrupting other crucial workflows. + +Follow the below steps to enable or disable a source template: +1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > Source Template**.
[**New UI**](/docs/get-started/sumo-logic-ui). Go to the Sumo Logic top menu and select **Configuration > Collection > Source Template**.
source-template-landing-page +1. Select the source template that you need to enable or disable. Click **More Actions** > **Enable** or **Disable** the source template. Or, click the kebab menu against the selected source template and click **Enable** or **Disable** from the dropdown.
enable-source-template +1. Enter **CONFIRM** and click the **Confirm** button to complete the action.
confirm-enable-source-template + +When you re-enable a disabled source template, the collection can either start from the very beginning of the file or from the moment when you re-enabled the source template. Collection starting from the beginning could lead to duplicate data while collecting data from the re-enabled moment can lead to data loss for the duration the source template was inactive. + +In the disabled state, only minor and patch versions will be auto-upgraded and you will be blocked from upgrading the source template with any major pending Source Schema version. It is recommended that you first enable the source template before manually upgrading it. + ## Collector tags With remote management, you can tag your [OpenTelemetry Collectors](/docs/send-data/opentelemetry-collector) to categorize and group them. These tags are also enriched in your data, enabling you to use them in your dashboards and searches. @@ -107,9 +124,9 @@ With remote management, you can tag your [OpenTelemetry Collectors](/docs/send-d You can add collector tags during OTEL collector setup as described in the previous section. Follow the below steps to add, update, or delete the collector tags after creation: -1. Navigate to the **OpenTelemetry Collection** page.
opentelemetry-collection +1. Navigate to the **OpenTelemetry Collection** page.
opentelemetry-collection 1. Click on the desired collector where you need to add collector tags. -1. In the right pane, scroll to the **Collector Tags** section and click **Edit**.
collector-tags-edit +1. In the right pane, scroll to the **Collector Tags** section and click **Edit**.
collector-tags-edit 1. In the edit window, click **+ Add tags** to add a new tag. You can also update or delete the required tags. Then click **Proceed**.
add-delete-update-tags 1. A new **Update Collector Tag(s)** window appears. Click the **click here** link to understand the impact of this update.
update-tags-click-here 1. You will be redirected to the **Mapped Source Template** section, which displays the mapped source templates for the collector tags added. This window also displays the **Compatible** and **Incompatible Version** details for the mapped source template for the collector.
mapped-source-templates @@ -124,3 +141,4 @@ If you try to add or update any collector tags using the API, the following vali 1. Validates if the disco tags are added, updated, or deleted. 1. Validates if the default tags are added or deleted. ::: + diff --git a/static/img/send-data/enable-confirm-st.png b/static/img/send-data/enable-confirm-st.png new file mode 100644 index 0000000000..5b979eefa9 Binary files /dev/null and b/static/img/send-data/enable-confirm-st.png differ diff --git a/static/img/send-data/enable-st.png b/static/img/send-data/enable-st.png new file mode 100644 index 0000000000..3e1b39d32d Binary files /dev/null and b/static/img/send-data/enable-st.png differ diff --git a/static/img/send-data/st-landing-page.png b/static/img/send-data/st-landing-page.png new file mode 100644 index 0000000000..f593e185fc Binary files /dev/null and b/static/img/send-data/st-landing-page.png differ