﻿---
title: Enable debug logging for EDOT SDKs
description: Learn how to enable debug logging for EDOT SDKs to troubleshoot application-level instrumentation issues.
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5109/troubleshoot/ingest/opentelemetry/edot-sdks/enable-debug-logging
products:
  - Elastic Cloud Serverless
  - Elastic Distribution of OpenTelemetry SDK
  - Elastic Observability
applies_to:
  - Serverless Observability projects: Generally available
  - Elastic Stack: Generally available
---

# Enable debug logging for EDOT SDKs
You can enable debug logging for Elastic Distributions of OpenTelemetry (EDOT) SDKs to troubleshoot application-level issues.
Enabling debug logging can help surface common problems such as:
- Auto-instrumentation not attaching or being disabled
- Authentication or endpoint misconfigurations
- Unsupported framework or language version
- Sampling rate being set too low (resulting in missing spans)


## Verify you're looking at the right logs

Ensure you’re checking logs for the same process that starts your app (systemd service, container entrypoint, IIS worker, and so on):
- For containerized environments such as Kubernetes/Docker:
  - `kubectl logs <pod> -c <container>` (correct container name matters if there are sidecars)
- Check the new Pod after a rollout, as old Pods may show stale environment without your debug flags.
- Tail the place your launcher writes to, and make sure your debug environment variables and flags are applied to that process.
- Some environments redirect `stdout`/`stderr` to `files—confirm` the target (for example `/var/log/...`, platform log drains).
- Look for messages like `installing instrumentation for …`, `detected framework …`, or `exporter configured …`. If you don’t see these after enabling debug, your flags likely aren’t applied to the running process.


## General SDK troubleshooting tips

Check your application logs for SDK-specific output and errors. If no logs appear at all, verify that:
- The SDK or agent is correctly installed and loaded
- The application runtime includes the correct path or classpath
- The environment variables are visible to the application process
- The logs are being written to the correct location

<warning>
  Debug logs can be verbose, potentially impacting performance and containing sensitive information such as system paths, variable names, or internal data structures. They shouldn't be enabled in production environments.
</warning>


## Java

You can enable debug logging using environment variables.
For general EDOT Java agent debugging, try:
```bash
export ELASTIC_OTEL_JAVAAGENT_LOG_LEVEL=debug
java -jar your-app.jar
```

The output is captured span information from the agent itself, in a JSON format.
If you need to see and inspect the specific trace data your application is generating, use:
```bash
export OTEL_TRACES_EXPORTER=otlp,logging-otlp
java -jar your-app.jar
```

The output are the application’s traces in a JSON format.
By default, logs are written to `stderr`.

## Python

To enable debug logging, set the `OTEL_PYTHON_LOG_LEVEL` variable to `debug`:
```bash
export OTEL_PYTHON_LOG_LEVEL=debug
```

Run your application as usual, for example:
```bash
python your_application.py
```


## .NET

To enable debug logging for the EDOT .NET agent, set:
<tab-set>
  <tab-item title="macOS">
    ```bash
    export OTEL_LOG_LEVEL=debug
    ```
  </tab-item>

  <tab-item title="Windows">
    ```powershell
    $env:OTEL_LOG_LEVEL="debug"
    ```
  </tab-item>
</tab-set>


## Node.js

Set this environment variable before starting your app:
<tab-set>
  <tab-item title="macOS">
    ```bash
    export OTEL_LOG_LEVEL=debug
    node --import @elastic/opentelemetry-node your-app.js
    ```
  </tab-item>

  <tab-item title="Windows">
    ```powershell
    $env:OTEL_LOG_LEVEL="debug" 
    node --import @elastic/opentelemetry-node your-app.js
    ```
  </tab-item>
</tab-set>

This produces debug-level logs from the SDK itself.
If you also want to inspect the actual telemetry your app is generating, configure exporters to log traces, metrics, or logs to the console. For example:
```sh
export OTEL_TRACES_EXPORTER=otlp, console
export OTEL_METRICS_EXPORTER=otlp, console
node --import @elastic/opentelemetry-node your-app.js
```


## PHP

While the EDOT PHP agent supports the standard `OTEL_LOG_LEVEL` variable, you must also configure at least one of the Elastic-specific sink options to direct logs to a destination:
- `ELASTIC_OTEL_LOG_LEVEL_FILE`
- `ELASTIC_OTEL_LOG_LEVEL_STDERR`
- `ELASTIC_OTEL_LOG_LEVEL_SYSLOG`

Refer to [Logging configuration](https://docs-v3-preview.elastic.dev/elastic/elastic-otel-php/tree/main/reference/edot-php/configuration#logging-configuration) for more details.
For deeper troubleshooting, you can also enable diagnostic data collection. For example:
```bash
export ELASTIC_OTEL_DEBUG_DIAGNOSTIC_FILE=/tmp/php_diag_%p_%t.txt php test.php
```

Ensure the file path is writable by the PHP process. If multiple PHP processes are running, use directives in the diagnostic file name to generate unique files and prevent overwriting. You can use:
- `%p` to insert the process ID
- `%t` to insert the UNIX timestamp

After setting the variable, restart the PHP process you're collecting diagnostics for, then send an HTTP request or run a script (for PHP-CLI).
The collected information includes:
- Process ID and parent process ID
- User ID of the worker process
- Loaded PHP extensions
- Output from the `phpinfo()` function
- Memory usage and maps `(/proc/{{id}}/maps` and `/proc/{{id}}/smaps_rollup)`
- Process status `(/proc/{{id}}/status)`

Disable diagnostic collection when you're done by unsetting the variable or restoring the previous configuration.

## Resources

To learn how to enable debug logging for the EDOT Collector, refer to [Enable debug logging for EDOT Collector](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5109/troubleshoot/ingest/opentelemetry/edot-collector/enable-debug-logging).