You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/send-data/opentelemetry-collector/remote-management/remote-management-v2.md
+20-16Lines changed: 20 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,19 +18,23 @@ This feature is in Beta. To participate, contact your Sumo Logic account executi
18
18
19
19
The Sumo Logic Distribution for OpenTelemetry Collector facilitates remote management of data collection configurations, enabling seamless setup from the Sumo Logic UI and deployment to one or more collectors.
20
20
21
-
## Remote Management features
21
+
## Remote management features
22
22
23
23
### Collector tags
24
24
25
25
With OpenTelemetry (OTel) remote management, you can tag your [OpenTelemetry Collectors](/docs/send-data/opentelemetry-collector) and use those tags to categorize and group them. These tags are enriched in your data, so you can use them in your dashboards and searches as well.
26
26
27
27
### Source templates
28
28
29
-
With remote management, data configuration setup for OTel collectors is done using Source templates. This feature extends our existing [Installed Collector Source](/docs/send-data/installed-collectors/sources), allowing attachment to multiple collectors.
29
+
:::note
30
+
Source template feature is not available for locally managed collectors.
31
+
:::
32
+
33
+
With remote management, data configuration setup for OTel collectors is done using source templates. This feature extends our existing [Installed Collector Source](/docs/send-data/installed-collectors/sources), allowing attachment to multiple collectors.
30
34
31
-
Utilize collector tags for grouping collectors, and associate Source templates to these collector groups, reducing redundancy in data collection setup. This process, termed *Collector Linking*, streamlines configuration management.
35
+
Utilize collector tags for grouping collectors, and associate source templates to these collector groups, reducing redundancy in data collection setup. This process, termed *Collector Linking*, streamlines configuration management.
32
36
33
-
## Install a Collector and configure the Source Template
37
+
## Install a Collector and configure the source template
34
38
35
39
### Step 1: Collector installation
36
40
@@ -44,7 +48,7 @@ Follow the below steps to install the collector and add uniquely identifiable ta
44
48
1. For **Collector Settings**, leave them as default to configure collectors as remotely managed.
45
49
1. Under **Generate and run the command to install the collector**, copy the command and execute it in your system terminal where the collector needs to be installed.<br/><img src={useBaseUrl('img/send-data/linux-terminal-installation.png')} alt="linux-terminal-installation" width="800"/>
46
50
1. Wait for the installation process to complete, then click **Next** to proceed.
47
-
1. On the next screen, you will see a list of available Source Templates. Select the required Source Template and proceed with the data configuration.
51
+
1. On the next screen, you will see a list of available source templates. Select the required source template and proceed with the data configuration.
48
52
49
53
### Step 2: Data configuration
50
54
@@ -56,48 +60,48 @@ Follow the below steps to create a data collection configuration to collect the
56
60
57
61
1.[**Classic UI**](/docs/get-started/sumo-logic-ui-classic/). In the main Sumo Logic menu, select **Manage Data > Collection > Source Template**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui/). In the Sumo Logic top menu select **Configuration**, and then under **Data Collection** select **Source Template**.
58
62
1. On the **Source Template** page, click **Add Source Template** and search for the required Source Template.
59
-
1. Complete the Source Template form by providing the mandatory fields, then click **Next**.<br/><img src={useBaseUrl('img/send-data/local-file-apache.png')} alt="local-file-apache" style={{border:'1px solid gray'}} width="500"/>
63
+
1. Complete the source template form by providing the mandatory fields, then click **Next**.<br/><img src={useBaseUrl('img/send-data/local-file-apache.png')} alt="local-file-apache" style={{border:'1px solid gray'}} width="500"/>
60
64
1. On the **Link Collectors** page, you will have the option to link the collectors using the **Collector Name** or by adding **Collector Tags** to find the group of collectors.
61
65
1. Navigate to **Preview Collector(s)** to view the details about the compatibility of the collectors and list of collectors that will be linked to the newly created source template. If we have mapped the collectors using both the **Collector Name** and **Collector Tags**, you will get a separate preview sections for the collectors identified by collector name and collector tags.<br/><img src={useBaseUrl('img/send-data/link-collectors.png')} alt="link-collectors" style={{border: '1px solid gray'}} width="800" height="500"/>
62
66
:::note
63
67
Incompatible version conflict will be found if your collectors cannot be linked to the source template due to version incompatibility or unsupported operating system. To move to next step, make sure you update the collect version of the incompatible collector.<br/><img src={useBaseUrl('img/send-data/incompatible-collectors.png')} alt="incompatible-collectors" style={{border:'1px solid gray'}} width="800"/>
64
68
:::
65
69
1. Click **Next** to complete Source Template creation. In the background, the system will apply the configuration to all the compatible linked collectors and starts collecting the required files.
66
70
67
-
## Edit a Source Template
71
+
## Edit a source template
68
72
69
73
To edit a source template:
70
74
71
75
1. In the main Sumo Logic menu, select **Manage Data > Collection > Source Template**.
72
76
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.
73
-
1. Change the required configuration in the Source Template configuration page, and click **Next**.
77
+
1. Change the required configuration in the source template configuration page, and click **Next**.
74
78
1. If required, update the collectors on the **Link Collectors** page.
75
-
1. Click **Next** to complete editing the Source Template.
79
+
1. Click **Next** to complete editing the source template.
76
80
77
-
## Upgrade the Source Template
81
+
## Upgrade the source template
78
82
79
83
:::note
80
-
Source Template update will not available if there are any incompatible collector version.
84
+
Source template update will not available if there are any incompatible collector version.
81
85
:::
82
86
83
87
Follow the below steps to upgrade the source template:
84
88
85
89
1. In the main Sumo Logic menu, select **Manage Data > Collection > Source Template**.
86
-
1. Select the Source Template that you need to upgrade, and click **Upgrade** button.
90
+
1. Select the source template that you need to upgrade, and click **Upgrade** button.
87
91
1. To upgrade the compatible collectors:
88
-
1. Update the required configuration for the new Source Template version.
92
+
1. Update the required configuration for the new source template version.
89
93
:::info
90
-
To know about the changes in the latest Source Template version, click the **Learn more** button in the warning.<br/><img src={useBaseUrl('img/send-data/learn-more-button-warning.png')} alt="learn-more-button-warning" style={{border:'1px solid gray'}} width="500"/>
94
+
To know about the changes in the latest source template version, click the **Learn more** button in the warning.<br/><img src={useBaseUrl('img/send-data/learn-more-button-warning.png')} alt="learn-more-button-warning" style={{border:'1px solid gray'}} width="500"/>
91
95
:::
92
96
1. Click **Next** to finish the upgrade.
93
97
1. To upgrade the incompatible collectors. Navigate to the **Preview Collector(s)** section to view the list of collectors that are compatible and incompatible to the new version of the source template. Follow any one of the below steps:
94
98
- Create a new source template and link the compatible collectors by collector name and collector tags.
95
99
- Or, unlink the collectors added in the new source template to the existing source template.
96
100
97
-
## Delete a Source Template
101
+
## Delete a source template
98
102
99
103
To delete a source template:
100
104
101
105
1. In the main Sumo Logic menu, select **Manage Data > Collection > Source Template**.
102
-
1. Select the Source Template that you need to delete, and click the **Delete** button. Or, click the kebab menu against the selected source template and click **Delete** from the dropdown.
106
+
1. Select the source template that you need to delete, and click the **Delete** button. Or, click the kebab menu against the selected source template and click **Delete** from the dropdown.
103
107
1. The source template will be deleted and removed from the **Source Template** page.
0 commit comments