supported detectors

Author: matt-hensley

README.md

@@ -71,6 +71,7 @@ documents:
 * [Installation](./docs/installation.md)
 * [Configuration](./docs/configuration.md)
 * [Supported instrumentations](./docs/supported-instrumentations.md)
+* [Supported resource detectors](./docs/supported-resource-detectors.md)
 * [Migrating to upstream](./docs/migration.md)
 
 ## Troubleshooting

docs/installation.md

@@ -39,8 +39,9 @@ package to your project.
 dotnet add package --prerelease Grafana.OpenTelemetry.Base
 ```
 
-The list of [supported instrumentations](./supported-instrumentations.md)
-specifies what instrumentations are included in the base package.
+The list of [supported instrumentations](./supported-instrumentations.md) and 
+[supported resource detectors](./supported-resource-detectors.md)
+specify which are included in the base package and enabled by default.
 
 ## Minimizing unneeded dependencies
 
@@ -52,8 +53,8 @@ dependencies.
 
 To mitigate this situation, [base package](#install-the-base-package)
 with a built-in lazy-loading mechanism can be used. This mechanism will
-initialize any known available instrumentation library assembly, regardless of
-whether it's added as dependency of the [full package](#install-the-full-package-with-all-available-instrumentations)
+initialize known available instrumentation library or resource detectors
+assembly, regardless of whether it's added as dependency of the [full package](#install-the-full-package-with-all-available-instrumentations)
 or as part of the instrumented project.
 
 For example, if it is desired to use the `AspNetCore` instrumentation without
@@ -76,5 +77,6 @@ using var tracerProvider = Sdk.CreateTracerProviderBuilder()
     .Build();
 ```
 
-This way, any other instrumentation library [supported by the distribution](./supported-instrumentations.md)
-can be added via lazy loading.
+This way, any other [instrumentation library](./supported-instrumentations.md)
+or [resource detector](./supported-resource-detectors.md) supported by the
+distribution can be added via lazy loading.

docs/supported-resource-detectors.md

@@ -0,0 +1,22 @@
+# Supported resource detectors
+
+The following resource detectors are recognized:
+
+| Identifier            | Enabled by default | Pre-installed      | Library name |
+| --------------------- | ------------------ | ------------------ | ------------ |
+| `AWSEBS`              |                    |                    | [OpenTelemetry.ResourceDetectors.AWS](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.AWS) |
+| `AWSEC2`              |                    |                    | [OpenTelemetry.ResourceDetectors.AWS](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.AWS) |
+| `AWSECS`              |                    |                    | [OpenTelemetry.ResourceDetectors.AWS](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.AWS) |
+| `AWSEKS`              |                    |                    | [OpenTelemetry.ResourceDetectors.AWS](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.AWS) |
+| `AzureAppService`     |                    |                    | [OpenTelemetry.ResourceDetectors.Azure](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.Azure) |
+| `AzureVM`             |                    |                    | [OpenTelemetry.ResourceDetectors.Azure](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.Azure) |
+| `AzureContainerApps`  |                    |                    | [OpenTelemetry.ResourceDetectors.Azure](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.Azure) |
+| `Container`           |                    | :heavy_check_mark: | [OpenTelemetry.ResourceDetectors.Container](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.Container) |
+| `Host`                | :heavy_check_mark: | :heavy_check_mark: | [OpenTelemetry.ResourceDetectors.Host](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.Host) |
+| `OperatingSystem`     |                    |                    | [OpenTelemetry.ResourceDetectors.OperatingSystem](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.OperatingSystem) |
+| `Process`             | :heavy_check_mark: | :heavy_check_mark: | [OpenTelemetry.ResourceDetectors.Process](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.Process) |
+| `ProcessRuntime`      | :heavy_check_mark: | :heavy_check_mark: | [OpenTelemetry.ResourceDetectors.ProcessRuntime](https://www.nuget.org/packages/OpenTelemetry.ResourceDetectors.ProcessRuntime) |
+
+* The `Container` resource detector is included but needs to be explicitly
+  activated, as activating it in non-container environments can causes erroneous
+  attributes. A future release may activate it by default.