Follow the steps in this topic to install or uninstall an OpenTelemetry Collector on macOS. See OpenTelemetry Collector for information on other operating systems.
The Sumo Logic OpenTelemetry Collector is supported on both amd64 and arm64 architectures.
Minimal resource requirements are the following:
- 200 MB of disk space
- 64 MB of RAM
- macOS 10.X and up
You can install our OpenTelemetry Collector using one of the following methods:
- In Sumo Logic, select Manage Data > Collection > OpenTelemetry Collection.
- On the OpenTelemetry Collection page, click Add Collector.
- On the left panel, select macOS as the platform.
- Select/create installation token and customize your tags.
- (Optional) Select the Auto Configure Host and Process metrics data collection checkbox to collect host and process metrics.
- Copy the command and execute it in your system terminal where the collector needs to be installed.
- Wait for the installation process to complete, then click Next to proceed.
Get the Installation token
Get your installation token (if you don't have it already) and assign it to an environment variable:
Run the installation script
You can run the script in two ways:
- By piping
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector/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"
- Or by first downloading the script, inspecting its contents for security, and then running it:
curl -Lso install-otelcol-sumo.sh https://github.com/SumoLogic/sumologic-otel-collector/releases/latest/download/install.sh
sudo -E bash ./install-otelcol-sumo.sh -d
-E argument to
sudo is needed to preserve the
SUMOLOGIC_INSTALLATION_TOKEN environment variable in
-d argument to the script is needed on macOS. It will skip Systemd installation, which is not supported on macOS.
It will perform the following operations:
- Install or upgrade operation by placing the latest version as
- Get static configuration and place it as
- Create user configuration directory (
common.yamlfile which will contain installation token
The following arguments can be passed to the script:
|long name||short name||description||takes value|
|Skips requirement for installation token. This option do not disable default configuration creation.||No|
|Sets tag for collector. This argument can be use multiple times. One per tag.||Yes, in |
|Download new binary only and skip configuration part.||No|
|Version of Sumo Logic Distribution for OpenTelemetry Collector to install. By default, it gets latest version.||Yes (for example: |
|Do not create default configuration||No|
|Preserves from Systemd service installation.||No|
|Install the FIPS-compliant binary. See FIPS section for more details.||No|
|Install the hostmetrics configuration to collect host metrics.||No|
|Disable confirmation asks.||No|
|Removes Sumo Logic Distribution for OpenTelemetry Collector from the system and disable Systemd service eventually. Use with ||No|
|It has to be used with ||No|
|Prints help and usage.||No|
The following env variables can be used along with script:
Manual step-by-step Installation
Step 1. Download the binary
Examples for OpenTelemetry Collector version
- amd64 (x86-64)
- arm64 (Apple Silicon)
curl -sLo otelcol-sumo "https://github.com/SumoLogic/sumologic-otel-collector/releases/download/v0.73.0-sumo-0/otelcol-sumo-0.73.0-sumo-0-darwin_amd64"
curl -sLo otelcol-sumo "https://github.com/SumoLogic/sumologic-otel-collector/releases/download/v0.73.0-sumo-0/otelcol-sumo-0.73.0-sumo-0-darwin_arm64"
Step 2. Move the binary to your
Move the downloaded binary into a directory from your
PATH environment so that it can be used by simply invoking
chmod +x otelcol-sumo
sudo mv otelcol-sumo /usr/local/bin/otelcol-sumo
Step 3. Verify the Installation
To verify installation, run the OpenTelemetry Collector.
Step 4. Running Binary
As for now, we do not support installation of OpenTelemetry Collector as service for macOS. It needs to be run manually.
sudo otelcol-sumo --config=/etc/otelcol-sumo/sumologic.yaml --config "glob:/etc/otelcol-sumo/conf.d/*.yaml"
This section describes common OpenTelemetry customizations.
Exporters leverage the HTTP communication and respect the following proxy environment variables:
You can either export proxy environment variables locally, e.g.
or make them available globally for all users, e.g.
tee -a /etc/profile << END
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 command:
We currently do not build FIPS binary for macOS. Refer to BoringCrypto and FIPS compliance in our repository for more details.
The recommended way to uninstall the OpenTelemetry Collector depends on how you installed it.
If you installed the Collector with the install script, you can use it to uninstall the Collector:
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector/releases/latest/download/install.sh | sudo -E bash -s -- -u -y
You can also use flag
-p to remove all existing configurations as well:
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector/releases/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.
sudo rm -rf /var/cache/otelcol-sumo
Manual step-by-step installation
If you installed the Collector manually, simply remove the binary from the directory you have placed it in:
sudo rm /usr/local/bin/otelcol-sumo
Upgrading the collector
Upgrade OpenTelemetry Collector
First, you have to upgrade the Collector's version. The way you should do it, depends on how you installed it.
Running install script will simply upgrade collector to the latest version:
sudo curl -Ls https://github.com/SumoLogic/sumologic-otel-collector/releases/latest/download/install.sh | sudo bash
You'll need to restart the collector process manually in order to apply changes.
Manual step-by-step installation
If you installed the Collector manually, the simplest way to upgrade is to follow these steps:
Update your config
After an upgrade, you should make sure that your config for OpenTelemetry Collector is up to date.
List of breaking changes specific to Sumo Logic Distribution of OpenTelemetry Collector can be found here.
For information on troubleshooting and solutions, refer to Troubleshooting.