# Getting started

Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fopentelemetry%2Fstandalone-installation%2Fstandalone-complete-observability-configuration.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fopentelemetry%2Fstandalone-installation%2Fstandalone-complete-observability-configuration.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

## Overview[​](#overview "Direct link to Overview")

Coralogix offers **Standalone Observability using OpenTelemetry** for comprehensive host and application observability. With our [OpenTelemetry Collector installer](https://github.com/coralogix/telemetry-shippers/tree/master/otel-installer/standalone), you can collect logs, metrics, and traces from your hosts.

Use our guided interface to automatically generate a tailored OpenTelemetry configuration and installation script based on your environment and use case. Enable logs, metrics, traces, and advanced features with just a few clicks—no configuration fatigue, no manual setup.

## Integration overview[​](#integration-overview "Direct link to Integration overview")

* **Application monitoring** - Collect traces, generate metrics from spans, apply sampling strategies, and enable profiling—all to monitor application performance efficiently.
* **Advanced log handling** - Collect system logs from journald (Linux) or file-based logs, support multiline log parsing, and reduce payload size by removing unused metadata.
* **Infrastructure & metrics** - Capture system metrics at the host level—CPU, memory, disk, network—alongside StatsD ingestion and internal collector telemetry. Enable automatic service discovery for databases and common services.
* **Platform & fleet controls** - Manage collectors centrally through OpAMP-based fleet management (supervisor mode) or use local configuration management.

## Coralogix features enabled[​](#coralogix-features-enabled "Direct link to Coralogix features enabled")

Unlock deep observability and cost-efficient monitoring with a single toggle—no manual configuration needed.

* [**APM**](https://coralogix.com/docs/docs/user-guides/apm/getting-started/apm-onboarding-tutorial/.md) - End-to-end tracing using OpenTelemetry with optional [**eBPF**](https://coralogix.com/docs/docs/opentelemetry/instrumentation-options/ebpf-auto-instrumentation/overview/.md) auto-instrumentation for zero-code coverage. Includes [head sampling](https://github.com/coralogix/telemetry-shippers/blob/master/otel-installer/standalone/README.md) strategies to control volume and focus on high-value traces. Automatically [generates span metrics](https://coralogix.com/docs/docs/user-guides/apm/getting-started/span-metrics/.md) to transform and aggregate trace data into metrics, ensuring 100% APM metric coverage regardless of the sampling strategy.
* [**Continuous Profiling**](https://coralogix.com/docs/docs/user-guides/continuous-profiling/introduction/.md) - Analyzes software behavior over time by collecting data on its execution. This includes measuring function execution times, CPU usage, and other system resource consumption along with relevant metadata. Continuous Profiling enables teams to correlate resource inefficiencies or performance issues, offering granular insights into application behavior.
* **Logs and metrics** - Collection of enriched application logs, multiline stack traces, system logs from journald (Linux) or file-based logs, and system metrics from hosts—all tagged with metadata for context-aware filtering and analysis. Once ingested, logs and metrics become a powerful input across the Coralogix platform—powering [alerts](https://coralogix.com/docs/docs/user-guides/alerting/introduction-to-alerts/.md), [dashboards](https://coralogix.com/docs/docs/user-guides/custom-dashboards/introduction/.md), and many other features.
* [**Infrastructure Explorer**](https://coralogix.com/docs/docs/user-guides/infrastructure/infrastructure-explorer/overview/.md) - Explore a live, searchable inventory of your infrastructure resources with full real-time context. See hosts, services, and processes alongside tags, ownership, versions, and relationships—no manual mapping required. Quickly audit costs, track accountability, and navigate complex systems without relying on spreadsheets or static dashboards.
* [**Fleet Management**](https://coralogix.com/docs/docs/user-guides/fleet-management/overview/.md) - Centralize control of your OpenTelemetry agents by monitoring, configuring, and maintaining them at scale through supervisor mode.

## Prerequisites[​](#prerequisites "Direct link to Prerequisites")

Warning

If you've already installed the collector manually, be aware that upgrading may **overwrite existing configurations**, and behavior in your environment is **unpredictable**. We **strongly recommend testing updates in a staging environment first** to verify compatibility, stability, and ensure you can take full advantage of new features and best practices.

1. **System requirements**:

   <!-- -->

   * `curl` and `tar` commands available
   * Root/sudo access for installation
   * Outbound HTTPS access to Coralogix endpoints (ports 443, 4317, 4318)

2. **Coralogix credentials**:
   <!-- -->
   * A Coralogix [Send-Your-Data API key](https://coralogix.com/docs/docs/user-guides/account-management/api-keys/send-your-data-api-key/.md)

### Supervisor mode prerequisites[​](#supervisor-mode-prerequisites "Direct link to Supervisor mode prerequisites")

To enable supervisor mode (Fleet Management), you'll also need:

* Your Coralogix [domain](https://coralogix.com/docs/docs/user-guides/account-management/account-settings/coralogix-domain/.md)

## Installation[​](#installation "Direct link to Installation")

Follow the steps below to deploy the Coralogix OpenTelemetry Collector on your standalone host.

### Set up the integration in Coralogix[​](#set-up-the-integration-in-coralogix "Direct link to Set up the integration in Coralogix")

1. Access **Data Flow** > **Integrations**.

2. From the Integrations section, select **Host OpenTelemetry integration**.

3. On the **Host OpenTelemetry integration** integration page, click **+ Add New** to create a new integration. For existing integrations, click the arrow icon on the right to upgrade to the new version.

4. Provide a name to identify this integration.

5. Enter a [Send-Your-Data API key](https://coralogix.com/docs/docs/user-guides/account-management/api-keys/send-your-data-api-key/.md) or click **Create a New Key** to generate a new dedicated API key.

6. Enter the **Application** name (default: "otel"). This identifies the application for which the integration is configured.

7. Enter the **Subsystem Name** (default: "integration"). This helps organize and filter your telemetry data.

8. Select the **Operating System** where the collector will be deployed: **Linux** (Mac and Windows are coming soon).

9. Select the **Deployment Environment**: **On premise**, **AWS**, **GCP**, or **Azure**.

10. Click **Next**.

### Select observability features[​](#select-observability-features "Direct link to Select observability features")

1. Toggle the observability features you want to enable through this integration. Toggling a feature will include the relevant configuration in your generated OpenTelemetry config file.

2. Click **Save**.

### Review and deploy[​](#review-and-deploy "Direct link to Review and deploy")

This step in the integration UI provides all required commands and configuration. The UI offers three deployment methods:

#### Option 1: Script deployment with config file download[​](#option-1-script-deployment-with-config-file-download "Direct link to Option 1: Script deployment with config file download")

1. Download the generated configuration file (`otel-config.yaml`) from the UI.

2. Run the installation command referencing the downloaded config file:

   ```
   CORALOGIX_PRIVATE_KEY="your-api-key-here" \

     bash -c "$(curl -sSL https://github.com/coralogix/telemetry-shippers/releases/latest/download/coralogix-otel-collector.sh)" \

     -- --config <otel-config.yaml file path>
   ```

#### Option 2: Script deployment with inline command[​](#option-2-script-deployment-with-inline-command "Direct link to Option 2: Script deployment with inline command")

1. Copy the generated deployment command from the UI. This command includes the configuration inline and will create the config file and deploy the collector in a single step.
2. Execute the copied command on your host.

#### Option 3: Manual deployment[​](#option-3-manual-deployment "Direct link to Option 3: Manual deployment")

Follow the on-screen instructions in the UI to complete the manual deployment process.

When finished, return to the UI and click **Complete setup**.

## Limitations[​](#limitations "Direct link to Limitations")

* Coralogix places a hard limit of 10MB of data to our OpenTelemetry Endpoints, with a recommendation of 2MB.
* Metric names must be a maximum of 255 characters.
* Attribute keys for metric data must be a maximum of 255 characters.
* Supervisor mode is only available on Linux (not supported on macOS).

## Next steps[​](#next-steps "Direct link to Next steps")

For platform-specific installation and advanced configuration instructions, see:

* [Linux and macOS Installation](https://github.com/coralogix/telemetry-shippers/blob/master/otel-installer/standalone/README.md)
* [Windows Installation](https://github.com/coralogix/telemetry-shippers/blob/master/otel-installer/windows/README.md)
* [Docker Installation](https://github.com/coralogix/telemetry-shippers/blob/master/otel-installer/docker/README.md)

## Additional resources[​](#additional-resources "Direct link to Additional resources")

|                             |                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Documentation               | [GitHub Repository](https://github.com/coralogix/telemetry-shippers/tree/master/otel-installer/standalone) |
| OpenTelemetry Documentation | [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/)                                        |