Skip to content
Merged
14 changes: 14 additions & 0 deletions blog-collector/2025-10-03-otel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: Download a collector using the CDN URL (OpenTelemetry Collector)
image: https://assets-www.sumologic.com/company-logos/_800x418_crop_center-center_82_none/SumoLogic_Preview_600x600.jpg?mtime=1617040082
keywords:
- otel-collector
- download-collector
hide_table_of_contents: true
---

We’re pleased to announce a new method for downloading the latest version of our OpenTelemetry collectors for Linux, macOS, and Windows. While the static URL method is still available, you now have the option to use a CDN URL via UI for better performance.

:::info
This change does not affect the UI itself. The download process looks the same, but the underlying URL now uses a CDN to improve reliability and speed.
:::
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ import SetupColl from '../../../reuse/apps/opentelemetry/set-up-collector.md';

<SetupColl/>

<img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/Linux-OpenTelemetry/Linux-Collector.png' style={{border:'1px solid gray'}} alt="Collector" />
<img src={useBaseUrl('img/send-data/opentelemetry-collector/linux-install-ui.png')} alt="linux-terminal" style={{border: '1px solid gray'}} width="900"/>

### Step 2: Configure integration

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ import SetupColl from '../../../reuse/apps/opentelemetry/set-up-collector.md';

<SetupColl/>

<img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/Mac-OpenTelemetry/Mac-Collector.png' style={{border:'1px solid gray'}} alt="Collector" />
<img src={useBaseUrl('img/send-data/opentelemetry-collector/macos-install-ui.png')} alt="macos-terminal" style={{border: '1px solid gray'}} width="900"/>

### Step 2: Configure integration

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ import SetupColl from '../../../reuse/apps/opentelemetry/set-up-collector.md';

<SetupColl/>

<img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/Windows-OpenTelemetry/Windows-Collector.png' style={{border:'1px solid gray'}} alt="Collector" />
<img src={useBaseUrl('img/send-data/opentelemetry-collector/windows-install-ui.png')} alt="windows-terminal" style={{border: '1px solid gray'}} width="900"/>

### Step 2: Configure integration

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,10 +38,10 @@ You can install our OpenTelemetry Collector using one of the following methods:

1. [**New UI**](/docs/get-started/sumo-logic-ui). In the Sumo Logic main menu select **Data Management**, and then under **Data Collection** select **OpenTelemetry Collection**. You can also click the **Go To...** menu at the top of the screen and select **OpenTelemetry Collection**. <br/>[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > OpenTelemetry Collection**.
1. On the OpenTelemetry Collection page, click **Add Collector**.
1. On the left panel, select **Linux** as the platform.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/linux-terminal.png')} alt="linux-terminal" style={{border: '1px solid gray'}} width="900"/>
1. On the left panel, select **Linux** as the platform.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/linux-install-ui.png')} alt="linux-terminal" style={{border: '1px solid gray'}} width="900"/>
1. Select/create installation token and customize your tags.
1. (Optional) In the **Collector Settings**, select the **Ephemeral** checkbox to auto-delete your collector after 12 hours, and select the **Locally Manage Collector** checkbox if you want to configure, maintain, and monitor your collector locally.
1. Copy the command and execute it in your system terminal where the collector needs to be installed.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/linux-terminal-installation.png')} alt="execute command in terminal" width="900"/>
1. Copy the command and execute it in your system terminal where the collector needs to be installed.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/linux-install-command.png')} alt="execute command in terminal" width="900"/>
1. Wait for the installation process to complete, then click **Next** to proceed.
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.

Expand All @@ -63,11 +63,11 @@ You can run the script in two ways:

* By piping `curl` straight into `bash`:
```bash
curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- --tag "host.group=default" --tag "deployment.environment=default"
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- --tag "host.group=default" --tag "deployment.environment=default"
```
* By first downloading the script, inspecting its contents for security, and then running it:
```bash
curl -Lso install-otelcol-sumo.sh https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh
sudo -E bash ./install-otelcol-sumo.sh
```

Expand Down Expand Up @@ -320,7 +320,7 @@ Service need to be restarted in order to apply the changes.
To install FIPS compliant binary, you should add `--fips` switch to installation command, so it will look like the following:

```bash
curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | SUMOLOGIC_INSTALLATION_TOKEN="TOKEN" sudo -E bash -s -- --tag "host.group=default" --tag "deployment.environment=default" --fips && sudo otelcol-sumo --config=/etc/otelcol-sumo/sumologic.yaml --config "glob:/etc/otelcol-sumo/conf.d/*.yaml"
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | SUMOLOGIC_INSTALLATION_TOKEN="TOKEN" sudo -E bash -s -- --tag "host.group=default" --tag "deployment.environment=default" --fips && sudo otelcol-sumo --config=/etc/otelcol-sumo/sumologic.yaml --config "glob:/etc/otelcol-sumo/conf.d/*.yaml"
```

Refer to [BoringCrypto and FIPS compliance](https://github.com/SumoLogic/sumologic-otel-collector/blob/main/docs/fips.md) in our repository for more details.
Expand All @@ -334,13 +334,13 @@ The recommended way to uninstall the OpenTelemetry Collector depends on how you
If you installed the Collector with the install script, you can this command to uninstall the Collector:

```bash
curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- -u -y
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- -u -y
```

You can also use flag `-p` to remove all existing configurations as well:

```bash
curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- -u -y -p
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- -u -y -p
```

### Manual step-by-step Uninstall
Expand All @@ -362,7 +362,7 @@ First, you have to upgrade the Collector's version. The way you should do it, de
Running install script will simply upgrade collector to the latest version:

```bash
curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo bash
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo bash
```

:::note
Expand Down
20 changes: 10 additions & 10 deletions docs/send-data/opentelemetry-collector/install-collector/macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,10 +38,10 @@ You can install our OpenTelemetry Collector using one of the following methods:

1. [**New UI**](/docs/get-started/sumo-logic-ui). In the Sumo Logic main menu select **Data Management**, and then under **Data Collection** select **OpenTelemetry Collection**. You can also click the **Go To...** menu at the top of the screen and select **OpenTelemetry Collection**. <br/>[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > OpenTelemetry Collection**.
1. On the OpenTelemetry Collection page, click **Add Collector**.
1. On the left panel, select **macOS** as the platform.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/macOs.png')} alt="macOs-terminal" style={{border: '1px solid gray'}} width="900"/>
1. On the left panel, select **macOS** as the platform.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/macos-install-ui.png')} alt="macOs-terminal" style={{border: '1px solid gray'}} width="900"/>
1. Select/create installation token and customize your tags.
1. (Optional) In the **Collector Settings**, select the **Ephemeral** checkbox to auto-delete your collector after 12 hours, and select the **Locally Manage Collector** checkbox if you want to configure, maintain, and monitor your collector locally.
1. Copy the command and execute it in your system terminal where the collector needs to be installed.<br/><img src={useBaseUrl('img/send-data/opentelemetry-collector/macos-terminal.png')} alt="execute command in terminal" />
1. Copy the command and execute it in your system terminal where the collector needs to be installed.<br/><img src={useBaseUrl('img/send-data/opentelemetry-collector/macos-install-command.png')} alt="execute command in terminal" />
1. Wait for the installation process to complete, then click **Next** to proceed.
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.

Expand All @@ -63,11 +63,11 @@ You can run the script in two ways:

* By piping `curl` straight into `bash`:
```bash
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- --tag "host.group=default" --tag "deployment.environment=default" && sudo otelcol-sumo --config=/etc/otelcol-sumo/sumologic.yaml --config "glob:/etc/otelcol-sumo/conf.d/*.yaml"
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- --tag "host.group=default" --tag "deployment.environment=default" && sudo otelcol-sumo --config=/etc/otelcol-sumo/sumologic.yaml --config "glob:/etc/otelcol-sumo/conf.d/*.yaml"
```
* Or by first downloading the script, inspecting its contents for security, and then running it:
```bash
curl -Lso install-otelcol-sumo.sh https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh
sudo -E bash ./install-otelcol-sumo.sh -d
```

Expand Down Expand Up @@ -211,13 +211,13 @@ The recommended way to uninstall the OpenTelemetry Collector depends on how you
If you installed the Collector with the install script, you can use it to uninstall the Collector:

```bash
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- -u -y
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- -u -y
```

You can also use flag `-p` to remove all existing configurations as well:

```bash
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- -u -y -p
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- -u -y -p
```

You can also run the following command to clear the cache. This will remove any cached data associated with the Collector.
Expand Down Expand Up @@ -245,7 +245,7 @@ First, you have to upgrade the Collector's version. The way you should do it, de
Running install script will simply upgrade collector to the latest version:

```bash
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo bash
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo bash
```

:::note
Expand Down Expand Up @@ -278,7 +278,7 @@ Here are some troubleshooting steps specific to macOS.
If you're trying to uninstall the collector on macOS, and you see an error similar to the following:

```console
$ sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- -u -y -p
$ sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- -u -y -p
Detected OS type: darwin
Detected architecture: arm64
Going to uninstall otelcol-sumo.
Expand All @@ -290,13 +290,13 @@ This means that you've installed the collector before the installation script wa
To uninstall, use an older version of the installation script:

```shell
sudo curl -L https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- --uninstall --purge --yes
sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- --uninstall --purge --yes
```

The output should be similar to this:

```console
$ sudo curl -L https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.sh | sudo -E bash -s -- --uninstall --purge --yes
$ sudo curl -sL https://download-otel.sumologic.com/latest/download/install.sh | sudo -E bash -s -- --uninstall --purge --yes
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,11 @@ You can install our OpenTelemetry Collector using either of the following method

1. [**New UI**](/docs/get-started/sumo-logic-ui). In the Sumo Logic main menu select **Data Management**, and then under **Data Collection** select **OpenTelemetry Collection**. You can also click the **Go To...** menu at the top of the screen and select **OpenTelemetry Collection**. <br/>[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > OpenTelemetry Collection**.
1. On the OpenTelemetry Collection page, click **Add Collector**.
1. On the left panel, select **Windows** as the platform.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/windows.png')} alt="widows-terminal" style={{border: '1px solid gray'}} width="900"/>
1. On the left panel, select **Windows** as the platform.<br/> <img src={useBaseUrl('img/send-data/opentelemetry-collector/windows-install-ui.png')} alt="widows-terminal" style={{border: '1px solid gray'}} width="900"/>
1. Select/create installation token and customize your tags.
1. (Optional) In the **Collector Settings**, select the **Ephemeral** checkbox to auto-delete your collector after 12 hours and select the **Locally Manage Collector** checkbox if you want to configure, maintain, and monitor the collector locally.
1. Copy the command.
1. Open PowerShell and execute the command in the PowerShell where the collector needs to be installed.<br/><img src={useBaseUrl('img/send-data/opentelemetry-collector/windows-ui-install-6.png')} alt="windows-ui-installation-6.png" width="900" />
1. Open PowerShell and execute the command in the PowerShell where the collector needs to be installed.<br/><img src={useBaseUrl('img/send-data/opentelemetry-collector/windows-install-command.png')} alt="windows-ui-installation-6.png" width="900" />
1. Wait for the installation process to complete, then click **Next** to proceed.
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.

Expand All @@ -57,7 +57,7 @@ Get your [installation token](/docs/manage/security/installation-tokens) if you
Run the following command in the same PowerShell window, replacing `<TOKEN>` with your token from previous step:

```sh
Set-ExecutionPolicy RemoteSigned -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; $uri = "https://github.com/SumoLogic/sumologic-otel-collector-packaging/releases/latest/download/install.ps1"; $path="${env:TEMP}\install.ps1"; (New-Object System.Net.WebClient).DownloadFile($uri, $path); . $path -InstallationToken "<TOKEN>" -Tags @{"host.group" = "default"; "deployment.environment" = "default"}
Set-ExecutionPolicy RemoteSigned -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; $uri = "https://download-otel.sumologic.com/latest/download/install.ps1"; $path="${env:TEMP}\install.ps1"; (New-Object System.Net.WebClient).DownloadFile($uri, $path); . $path -InstallationToken "<TOKEN>" -Tags @{"host.group" = "default"; "deployment.environment" = "default"}
```

The script is going to perform the following operations:
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.