54 lines
3.0 KiB
Markdown
54 lines
3.0 KiB
Markdown
# Console Exporter for OpenTelemetry .NET
|
|
|
|
[](https://www.nuget.org/packages/OpenTelemetry.Exporter.Console)
|
|
[](https://www.nuget.org/packages/OpenTelemetry.Exporter.Console)
|
|
|
|
The console exporter prints data to the Console window.
|
|
ConsoleExporter supports exporting logs, metrics and traces.
|
|
|
|
> [!WARNING]
|
|
> This component is intended to be used while learning how telemetry data is
|
|
created and exported. It is not recommended for any production environment.
|
|
|
|
## Installation
|
|
|
|
```shell
|
|
dotnet add package OpenTelemetry.Exporter.Console
|
|
```
|
|
|
|
See the individual "getting started" examples depending on the signal being
|
|
used:
|
|
|
|
* Logs: [ASP.NET Core](https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.12.0/src/OpenTelemetry.Exporter.Console/../../docs/logs/getting-started-aspnetcore/README.md) |
|
|
[Console](https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.12.0/src/OpenTelemetry.Exporter.Console/../../docs/logs/getting-started-console/README.md)
|
|
* Metrics: [ASP.NET
|
|
Core](https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.12.0/src/OpenTelemetry.Exporter.Console/../../docs/metrics/getting-started-aspnetcore/README.md) |
|
|
[Console](https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.12.0/src/OpenTelemetry.Exporter.Console/../../docs/metrics/getting-started-console/README.md)
|
|
* Traces: [ASP.NET Core](https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.12.0/src/OpenTelemetry.Exporter.Console/../../docs/trace/getting-started-aspnetcore/README.md)
|
|
| [Console](https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.12.0/src/OpenTelemetry.Exporter.Console/../../docs/trace/getting-started-console/README.md)
|
|
|
|
## Configuration
|
|
|
|
See the
|
|
[`TestConsoleExporter.cs`](https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.12.0/src/OpenTelemetry.Exporter.Console/../../examples/Console/TestConsoleExporter.cs) for
|
|
an example of how to use the exporter for exporting traces to a collection.
|
|
|
|
You can configure the `ConsoleExporter` through `Options` types properties
|
|
and environment variables.
|
|
The `Options` type setters take precedence over the environment variables.
|
|
|
|
## Environment Variables
|
|
|
|
The following environment variables can be used to override the default
|
|
values of the `PeriodicExportingMetricReaderOptions`
|
|
(following the [OpenTelemetry specification](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.12.0/specification/sdk-environment-variables.md#periodic-exporting-metricreader).
|
|
|
|
| Environment variable | `PeriodicExportingMetricReaderOptions` property |
|
|
| ------------------------------| ------------------------------------------------|
|
|
| `OTEL_METRIC_EXPORT_INTERVAL` | `ExportIntervalMilliseconds` |
|
|
| `OTEL_METRIC_EXPORT_TIMEOUT` | `ExportTimeoutMilliseconds` |
|
|
|
|
## References
|
|
|
|
* [OpenTelemetry Project](https://opentelemetry.io/)
|