diff --git a/blog-collector/2025-10-03-otel.md b/blog-collector/2025-10-03-otel.md new file mode 100644 index 0000000000..bab6c32d48 --- /dev/null +++ b/blog-collector/2025-10-03-otel.md @@ -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. +::: \ No newline at end of file diff --git a/docs/integrations/hosts-operating-systems/opentelemetry/linux-opentelemetry.md b/docs/integrations/hosts-operating-systems/opentelemetry/linux-opentelemetry.md index 8e7289ab70..9756e57a4d 100644 --- a/docs/integrations/hosts-operating-systems/opentelemetry/linux-opentelemetry.md +++ b/docs/integrations/hosts-operating-systems/opentelemetry/linux-opentelemetry.md @@ -71,7 +71,7 @@ import SetupColl from '../../../reuse/apps/opentelemetry/set-up-collector.md'; -Collector +linux-terminal ### Step 2: Configure integration diff --git a/docs/integrations/hosts-operating-systems/opentelemetry/macos-opentelemetry.md b/docs/integrations/hosts-operating-systems/opentelemetry/macos-opentelemetry.md index cf7b0d0cf7..5c2e80411f 100644 --- a/docs/integrations/hosts-operating-systems/opentelemetry/macos-opentelemetry.md +++ b/docs/integrations/hosts-operating-systems/opentelemetry/macos-opentelemetry.md @@ -46,7 +46,7 @@ import SetupColl from '../../../reuse/apps/opentelemetry/set-up-collector.md'; -Collector +macos-terminal ### Step 2: Configure integration diff --git a/docs/integrations/hosts-operating-systems/opentelemetry/windows-opentelemetry.md b/docs/integrations/hosts-operating-systems/opentelemetry/windows-opentelemetry.md index 812ae2b99d..b20c035051 100644 --- a/docs/integrations/hosts-operating-systems/opentelemetry/windows-opentelemetry.md +++ b/docs/integrations/hosts-operating-systems/opentelemetry/windows-opentelemetry.md @@ -59,7 +59,7 @@ import SetupColl from '../../../reuse/apps/opentelemetry/set-up-collector.md'; -Collector +windows-terminal ### Step 2: Configure integration diff --git a/docs/send-data/opentelemetry-collector/install-collector/linux.md b/docs/send-data/opentelemetry-collector/install-collector/linux.md index b4e5448486..0f14dbbe89 100644 --- a/docs/send-data/opentelemetry-collector/install-collector/linux.md +++ b/docs/send-data/opentelemetry-collector/install-collector/linux.md @@ -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**.
[**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.
linux-terminal +1. On the left panel, select **Linux** as the platform.
linux-terminal 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.
execute command in terminal +1. Copy the command and execute it in your system terminal where the collector needs to be installed.
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. @@ -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 ``` @@ -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. @@ -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 @@ -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 diff --git a/docs/send-data/opentelemetry-collector/install-collector/macos.md b/docs/send-data/opentelemetry-collector/install-collector/macos.md index 33c5a609e6..59ca9fb85b 100644 --- a/docs/send-data/opentelemetry-collector/install-collector/macos.md +++ b/docs/send-data/opentelemetry-collector/install-collector/macos.md @@ -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**.
[**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.
macOs-terminal +1. On the left panel, select **macOS** as the platform.
macOs-terminal 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.
execute command in terminal +1. Copy the command and execute it in your system terminal where the collector needs to be installed.
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. @@ -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 ``` @@ -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. @@ -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 @@ -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. @@ -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 diff --git a/docs/send-data/opentelemetry-collector/install-collector/windows.md b/docs/send-data/opentelemetry-collector/install-collector/windows.md index b03a24366a..fa632404ac 100644 --- a/docs/send-data/opentelemetry-collector/install-collector/windows.md +++ b/docs/send-data/opentelemetry-collector/install-collector/windows.md @@ -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**.
[**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.
widows-terminal +1. On the left panel, select **Windows** as the platform.
widows-terminal 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.
windows-ui-installation-6.png +1. Open PowerShell and execute the command in the PowerShell where the collector needs to be installed.
windows-ui-installation-6.png 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. @@ -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 `` 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 "" -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 "" -Tags @{"host.group" = "default"; "deployment.environment" = "default"} ``` The script is going to perform the following operations: diff --git a/static/img/send-data/opentelemetry-collector/linux-install-command.png b/static/img/send-data/opentelemetry-collector/linux-install-command.png new file mode 100644 index 0000000000..7cd19ccf36 Binary files /dev/null and b/static/img/send-data/opentelemetry-collector/linux-install-command.png differ diff --git a/static/img/send-data/opentelemetry-collector/linux-install-ui.png b/static/img/send-data/opentelemetry-collector/linux-install-ui.png new file mode 100644 index 0000000000..d8f5396aa7 Binary files /dev/null and b/static/img/send-data/opentelemetry-collector/linux-install-ui.png differ diff --git a/static/img/send-data/opentelemetry-collector/macos-install-command.png b/static/img/send-data/opentelemetry-collector/macos-install-command.png new file mode 100644 index 0000000000..915d2a0829 Binary files /dev/null and b/static/img/send-data/opentelemetry-collector/macos-install-command.png differ diff --git a/static/img/send-data/opentelemetry-collector/macos-install-ui.png b/static/img/send-data/opentelemetry-collector/macos-install-ui.png new file mode 100644 index 0000000000..9503e0d9a1 Binary files /dev/null and b/static/img/send-data/opentelemetry-collector/macos-install-ui.png differ diff --git a/static/img/send-data/opentelemetry-collector/windows-install-command.png b/static/img/send-data/opentelemetry-collector/windows-install-command.png new file mode 100644 index 0000000000..2e67fc200f Binary files /dev/null and b/static/img/send-data/opentelemetry-collector/windows-install-command.png differ diff --git a/static/img/send-data/opentelemetry-collector/windows-install-ui.png b/static/img/send-data/opentelemetry-collector/windows-install-ui.png new file mode 100644 index 0000000000..bd374cd222 Binary files /dev/null and b/static/img/send-data/opentelemetry-collector/windows-install-ui.png differ