Support Center Home


Adding an OpenTelemetry Collector

Overview

LogicMonitor provides a wrapped version of OpenTelemetry that is pre-configured to forward traces from your instrumented applications to the LogicMonitor platform. We recommend installing this OpenTelemetry Collector before instrumenting your applications, because you will need to reference the endpoint of the OpenTelemetry Collector during instrumentation. The best way to add an OpenTelemetry Collector and get the necessary information for installation is via the LogicMonitor UI.

Installation

1. From the Exchange page, select the OpenTelemetry Collectors tab and click “Add”.

2. In the Add OpenTelemetry Collector wizard select a Bearer API Token to use for communication between the OpenTelemetry Collector and the LogicMonitor platform.

As a best practice, we recommend having a (single) Bearer token associated with a dedicated API-only user for forwarding trace data. This bearer token needs, at a minimum, the following permissions:

  • Manage Data Ingestion | Traces
  • Manage LogicMonitor OpenTelemetry Collectors

If you don’t have a Bearer API Token that meets these criteria, you can create one from Settings | Users & Roles | Users. Manage an existing user or create a new user, and make sure to select the Token Type “Bearer” when you’re adding the API Token.

3. Select the platform the OpenTelemetry Collector will run on: Linux | Kubernetes | Docker. Each platform has different install options you can choose from.

Linux: If you are installing an OpenTelemetry Collector on a Linux server, you should copy the cURL command provided and run in on your Linux server to download the installer. Once you’ve downloaded the installer, you’ll need to make it executable (chmod +x installer_file) and then run the executable (./installer_file).

Kubernetes: The best way to install an OpenTelemetry Collector (or several OpenTelemetry Collectors) in a Kubernetes cluster is to use the LogicMonitor provided Helm Charts. These Helm Charts run the OpenTelemetry Collector as a replicaset.

4. Once you’ve installed one or more OpenTelemetry Collectors, you can proceed to instrument your applications to emit traces and send them to these collectors.

You will be able to view and manage the installed OpenTelemetry Collectors via the Exchange | OpenTelemetry Collectors page.

Note: OpenTelemetry Collectors added for Kubernetes and Docker platforms will not display in the LogicMonitor UI until they are installed because the installation process creates the Collector within LogicMonitor. This is in contrast to OpenTelemetry Collectors for Linux, which will be listed immediately after the Add OpenTelemetry Collector wizard (listed as unregistered until install is complete).

In This Article