Skip to content

Commit

Permalink
Dotnet exporters update 2 (#4016)
Browse files Browse the repository at this point in the history
  • Loading branch information
svrnm authored Apr 16, 2024
1 parent f0f43de commit 6c28a2e
Show file tree
Hide file tree
Showing 9 changed files with 242 additions and 163 deletions.
2 changes: 1 addition & 1 deletion content/en/docs/languages/net/automatic/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -235,7 +235,7 @@ You can also use the
## Configuring the agent

To see the full range of configuration options, see
[Configuration and settings](./config).
[Configuration and settings](./configuration).

## Log to trace correlation

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: Configuration and settings
linkTitle: Configuration
weight: 20
aliases: [config]
# prettier-ignore
cSpell:ignore: AZUREAPPSERVICE Bitness CLSID CORECLR dylib NETFX PROCESSRUNTIME UNHANDLEDEXCEPTION
---
Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/languages/net/automatic/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -297,7 +297,7 @@ Value: Sum: 1330.4766000000002 Count: 5 Min: 50.0333 Max: 465.7936
For more:

- To configure exporters, samplers, resources and more, see
[Configuration and settings](../config)
[Configuration and settings](../configuration)
- See the list of [available instrumentations](../instrumentations)
- If you want to combine automatic and manual instrumentation, learn how you
[can create custom traces and metrics](../custom)
Expand All @@ -306,7 +306,7 @@ For more:
[traces]: /docs/concepts/signals/traces/
[metrics]: /docs/concepts/signals/metrics/
[logs]: /docs/concepts/signals/logs/
[configure .NET Automatic Instrumentation]: ../config
[configure .NET Automatic Instrumentation]: ../configuration
[console exporter]:
https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/docs/config.md#internal-logs
[releases]:
Expand Down
18 changes: 10 additions & 8 deletions content/en/docs/languages/net/automatic/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,12 @@ Detailed debug logs can help you troubleshoot instrumentation issues, and can be
attached to issues in this project to facilitate investigation.

To get the detailed logs from the OpenTelemetry .NET Automatic Instrumentation,
set the [`OTEL_LOG_LEVEL`](../config#internal-logs) environment variable to
`debug` before the instrumented process starts.
set the [`OTEL_LOG_LEVEL`](../configuration#internal-logs) environment variable
to `debug` before the instrumented process starts.

By default, the library writes the log files under predefined
[locations](../config#internal-logs). If needed, change the default location by
updating the `OTEL_DOTNET_AUTO_LOG_DIRECTORY` environment variable.
[locations](../configuration#internal-logs). If needed, change the default
location by updating the `OTEL_DOTNET_AUTO_LOG_DIRECTORY` environment variable.

After obtaining the logs, remove the `OTEL_LOG_LEVEL` environment variable, or
set it to less verbose level to avoid unnecessary overhead.
Expand All @@ -45,7 +45,8 @@ Then restart the application to collect the logs.
### No telemetry is produced

There is no telemetry generated. There are no logs in OpenTelemetry .NET
Automatic Instrumentation internal logs [location](../config#internal-logs).
Automatic Instrumentation internal logs
[location](../configuration#internal-logs).

It might occur that the .NET Profiler is unable to attach and therefore no logs
would be emitted.
Expand Down Expand Up @@ -73,8 +74,9 @@ instrumentation globally by setting the environment variables at system or user
scope.

If the usage of system or user scope is intentional, use the
[`OTEL_DOTNET_AUTO_EXCLUDE_PROCESSES`](../config#global-settings) environment
variables to exclude applications from the automatic instrumentation.
[`OTEL_DOTNET_AUTO_EXCLUDE_PROCESSES`](../configuration#global-settings)
environment variables to exclude applications from the automatic
instrumentation.

### `dotnet` CLI tool is crashing

Expand Down Expand Up @@ -141,7 +143,7 @@ Find their versions in the following locations:
By default, assembly references for .NET Framework applications are redirected
during runtime to the versions used by the automatic instrumentation. This
behavior can be controlled through the
[`OTEL_DOTNET_AUTO_NETFX_REDIRECT_ENABLED`](../config) setting.
[`OTEL_DOTNET_AUTO_NETFX_REDIRECT_ENABLED`](../configuration) setting.

If the application already ships binding redirection for assemblies used by
automatic instrumentation this automatic redirection may fail, see
Expand Down
Loading

0 comments on commit 6c28a2e

Please sign in to comment.