Skip to main content

Install OpenTelemetry Collector on Windows

thumbnail icon

Follow the steps in this topic to install or uninstall an OpenTelemetry Collector on Windows. See OpenTelemetry Collector for information on other operating systems.

System Requirements

Minimal resource requirements are the following:

  • 200 MB of disk space
  • 64 MB of RAM

Supported Versions

  • Windows 10 and up, Windows Server 2016 and up

Install

You can install our OpenTelemetry Collector using either of the following methods:

UI Installation

  1. In Sumo Logic, select Manage Data > Collection > OpenTelemetry Collection.
  2. On the OpenTelemetry Collection page, click Add Collector.
  3. On the left panel, select Windows as the platform.
    widows-terminal
  4. Select/create installation token and customize your tags.
  5. (Optional) Select the Auto Configure Host and Process metrics data collection checkbox to collect host and process metrics.
  6. Copy the command.
  7. Open PowerShell and execute the command in the PowerShell where the collector needs to be installed.
    windows-ui-installation-6.png
  8. Wait for the installation process to complete, then click Next to proceed.

Install Script

A single line installation powered by Install Script.

Get the Installation Token

Get your installation token if you don't have it already. We are going to refer to this token as <TOKEN> in next streps.

Run Installation Script

Run the following command in the same PowerShell window, replacing <TOKEN> with your token from previous step:

Set-ExecutionPolicy RemoteSigned -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; $uri = "https://raw.githubusercontent.com/SumoLogic/sumologic-otel-collector/main/scripts/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:

  • Install or upgrade operation by placing the latest version as C:\Program Files\Sumo Logic\OpenTelemetry Collector\bin
  • Get static configuration and place it as C:\ProgramData\Sumo Logic\OpenTelemetry Collector\config\sumologic.yaml
  • Create user configuration directory (C:\ProgramData\Sumo Logic\OpenTelemetry Collector\config\conf.d) with common.yaml file which will contain installation token
  • Create OtelcolSumo (Sumo Logic OpenTelemetry Collector) service

Script Options

NameDescriptionTakes Value
-InstallationTokenInstallation tokenYes
-TagsSets tags for collector. This argument should be a map.Yes, for example @{"host.group" = "default"; "deployment.environment" = "default"}
-InstallHostMetricsInstalls the hostmetrics configuration to collect host metrics. The default is $False.Yes, for example: -InstallHostMetrics $True or -InstallHostMetrics $False.

Manual Step-by-Step Installation

  1. Go to the latest release documentation.
  2. Download otelcol-sumo_x.y.z.0_en-US.x64.msi from the Assets section.
    windows-installation.png
  3. Run Installer.
    windows-installation-1.png
  4. Read and accept End-User License Agreement.
    windows-installation-2.png
  5. Select binary destination.
    windows-installation-3.png
  6. Set Installation Token and Tags properties.
    windows-installation-4.png
  7. Click Install to begin installation.
    windows-installation-5.png
  8. Wait for installation to be completed.
    windows-stallation-6.png
  9. You can modify configuration, which should be placed in C:\ProgramData\Sumo Logic\OpenTelemetry Collector\config directory.
    note

    C:\ProgramData directory is hidden by default.

Verify the Installation

Run the following command in PowerShell:

> Get-Service OtelcolSumo

Status Name DisplayName
------ ---- -----------
Running OtelcolSumo Sumo Logic OpenTelemetry Collector

Alternatively, you can open Services.msc and check whether Sumo Logic OTel Collector Service is running or not.

Additional Settings

This section describes common OpenTelemetry customizations.

Using Proxy

Exporters leverage the HTTP communication and respect the following proxy environment variables:

  • HTTP_PROXY
  • HTTPS_PROXY
  • NO_PROXY

You can set it by adding the following properties to Windows Registry key HKLM:\SYSTEM\CurrentControlSet\Services\OtelcolSumo\Environment:

FTP_PROXY=<PROXY-ADDRESS>:<PROXY-PORT>
HTTP_PROXY=<PROXY-ADDRESS>:<PROXY-PORT>
HTTPS_PROXY=<PROXY-ADDRESS>:<PROXY-PORT>

To exclude a specific domain or IP address from using the proxy, you can add it to the NO_PROXY environment variable. For example, to exclude the domain sumologic.com from using the proxy, you can add the following line:

NO_PROXY=sumologic.com
info

Restart Sumo Logic OpenTelemetry Collector (OtelcolSumo) service to apply the changes.

FIPS

We currently do not build FIPS binary for Windows.

Refer to BoringCrypto and FIPS compliance in our repository for more details.

Uninstall

  1. Go to Add or remove programs.
    windows-uninstallation-1.png
  2. Find OpenTelemetry Collector and click Uninstall.
    windows-uninstallation-2.png
  3. Confirm the uninstallation.
    windows-uninstallation-3.png

Upgrading the Collector

To upgrade the collector perform installation step and it will automatically upgrade the binary in-place.

Troubleshooting

Cannot restart service during Installation

If you get the following output while restarting the service:

> Restart-Service -Name OtelcolSumo
Restart-Service : Service 'Sumo Logic OpenTelemetry Collector (OtelcolSumo)' cannot be stopped due to the following
error: Cannot open OtelcolSumo service on computer '.'.
At line:1 char:1
+ Restart-Service -Name OtelcolSumo
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : CloseError: (System.ServiceProcess.ServiceController:ServiceController) [Restart-Service
], ServiceCommandException
+ FullyQualifiedErrorId : CouldNotStopService,Microsoft.PowerShell.Commands.RestartServiceCommand

Ensure that you run PowerShell as an Administrator.

For information on troubleshooting and solutions, refer to the Troubleshooting.

Legal
Privacy Statement
Terms of Use

Copyright © 2023 by Sumo Logic, Inc.