diff --git a/content/en/docs/concepts/glossary.md b/content/en/docs/concepts/glossary.md index daa0b4b7333a..1870d97d946f 100644 --- a/content/en/docs/concepts/glossary.md +++ b/content/en/docs/concepts/glossary.md @@ -38,6 +38,12 @@ A key-value pair. Used across telemetry signals - e.g. in [`Traces`](#trace) to attach data to a [`Span`](#span), or in [`Metrics`](#metric). See [attribute spec][attribute]. +### **Automatic Instrumentation** + +Refers to telemetry collection methods that do not require the end-user to +modify application's source code. Methods vary by programming language, and +examples include bytecode injection or monkey patching. + ### **Baggage** A mechanism for propagating name/value pairs to help establish a causal diff --git a/content/en/docs/instrumentation/net/automatic.md b/content/en/docs/instrumentation/net/automatic.md new file mode 100644 index 000000000000..db695853ae64 --- /dev/null +++ b/content/en/docs/instrumentation/net/automatic.md @@ -0,0 +1,28 @@ +--- +title: Automatic Instrumentation +linkTitle: Automatic +weight: 3 +--- + +You can use [automatic instrumentation](/docs/reference/specification/glossary/#automatic-instrumentation) +to initalize [signal](/docs/reference/specification/glossary/#signals) providers +and generate telemetry data for supported [instrumented libraries](/docs/reference/specification/glossary/#instrumented-library) +without modifying the application's source code. + +[Here][release] you can find the latest release of +OpenTelemetry .NET Automatic Instrumentation. + +You can find the documentation in the [project's repository][repo]. + +## Next steps + +After you have set up instrumentation libraries, you may want to add [manual +instrumentation](/docs/instrumentation/net/manual) to collect custom telemetry +data. + +If you do not want to rely on automatic instrumentation, +which is currently in beta, you may want to use [instrumentation libraries] +(/docs/instrumentation/net/libraries) explicitly instead. + +[release]: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest +[repo]: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation diff --git a/content/en/docs/instrumentation/net/exporters.md b/content/en/docs/instrumentation/net/exporters.md index 2ffe93e2424a..b2959f98f9da 100644 --- a/content/en/docs/instrumentation/net/exporters.md +++ b/content/en/docs/instrumentation/net/exporters.md @@ -295,5 +295,5 @@ Additionally, enriching your codebase with gives you customized observability data. You can also check the -[automatic instrumentation for .NET](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation), +[automatic instrumentation for .NET](/docs/instrumentation/net/automatic), which is currently in beta. diff --git a/content/en/docs/instrumentation/net/libraries.md b/content/en/docs/instrumentation/net/libraries.md index 6610a3182a8f..712f2f6618cc 100644 --- a/content/en/docs/instrumentation/net/libraries.md +++ b/content/en/docs/instrumentation/net/libraries.md @@ -1,7 +1,6 @@ --- title: Using instrumentation libraries linkTitle: Libraries -aliases: [/docs/instrumentation/net/automatic] weight: 3 --- @@ -121,7 +120,7 @@ You'll also want to configure an appropriate exporter to [export your telemetry data](/docs/instrumentation/net/exporters) to one or more telemetry backends. You can also check the -[automatic instrumentation for .NET](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation), +[automatic instrumentation for .NET](/docs/instrumentation/net/automatic), which is currently in beta. [opentelemetry-dotnet]: https://github.com/open-telemetry/opentelemetry-dotnet diff --git a/content/en/docs/instrumentation/net/manual.md b/content/en/docs/instrumentation/net/manual.md index a22f26007a8e..39647b332c2f 100644 --- a/content/en/docs/instrumentation/net/manual.md +++ b/content/en/docs/instrumentation/net/manual.md @@ -333,5 +333,5 @@ You'll also want to configure an appropriate exporter to [export your telemetry data](/docs/instrumentation/net/exporters) to one or more telemetry backends. You can also check the -[automatic instrumentation for .NET](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation), +[automatic instrumentation for .NET](/docs/instrumentation/net/automatic), which is currently in beta. diff --git a/content/en/docs/instrumentation/net/netframework.md b/content/en/docs/instrumentation/net/netframework.md index 578aed832d54..09e71969f753 100644 --- a/content/en/docs/instrumentation/net/netframework.md +++ b/content/en/docs/instrumentation/net/netframework.md @@ -152,5 +152,5 @@ You'll also want to configure an appropriate exporter to [export your telemetry data](/docs/instrumentation/net/exporters) to one or more telemetry backends. You can also check the -[automatic instrumentation for .NET](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation), +[automatic instrumentation for .NET](/docs/instrumentation/net/automatic), which is currently in beta.