{"id":21042764,"url":"https://github.com/aws-observability/aws-otel-dotnet-instrumentation","last_synced_at":"2026-01-08T00:12:41.711Z","repository":{"id":251419550,"uuid":"794197298","full_name":"aws-observability/aws-otel-dotnet-instrumentation","owner":"aws-observability","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-13T21:42:22.000Z","size":1722,"stargazers_count":1,"open_issues_count":9,"forks_count":14,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-05-13T23:06:23.059Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-observability.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-04-30T16:36:55.000Z","updated_at":"2025-05-13T21:42:26.000Z","dependencies_parsed_at":"2024-08-26T20:48:56.608Z","dependency_job_id":"312879cb-eb76-4248-9a86-e5f970b55fcc","html_url":"https://github.com/aws-observability/aws-otel-dotnet-instrumentation","commit_stats":null,"previous_names":["aws-observability/aws-otel-dotnet-instrumentation"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-dotnet-instrumentation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-dotnet-instrumentation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-dotnet-instrumentation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-dotnet-instrumentation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-observability","download_url":"https://codeload.github.com/aws-observability/aws-otel-dotnet-instrumentation/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254388054,"owners_count":22062976,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T14:08:56.506Z","updated_at":"2026-01-08T00:12:41.706Z","avatar_url":"https://github.com/aws-observability.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Distro for OpenTelemetry - Instrumentation for DotNet\n\n## Introduction\n\nThis project is a redistribution of the [OpenTelemetry Agent for DotNet](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation),\npreconfigured for use with AWS services. Please check out that project too to get a better\nunderstanding of the underlying internals. You won't see much code in this repository since we only\napply some small configuration changes, and our OpenTelemetry friends takes care of the rest.\n\n## Prerequisites\n\n1. Having one of [VSCode](https://code.visualstudio.com/docs/languages/dotnet), Visual Studio, or ReSharper installed\n2. Having dotnet cli installed.\n\n## Important\n\nThe AWS Distro for OpenTelemetry for .NET currently does not support AWS SDK for .NET V4. We will offer support for V4 before the AWS SDK for .NET V3 reaches end of life on June 1, 2026. In the meantime, please use the AWS SDK for .NET V3 with this package for full instrumentation support.\n\nAlthough this repository is released under the Apache-2.0 license, some Dockerfiles uses Windows as a base image, which is licensed under the following terms https://learn.microsoft.com/en-us/virtualization/windowscontainers/images-eula.\n\n## Building the Project\n\n### Building Locally\n\nTo build the dll files for the `AWS.Distro.OpenTelemetry.AutoInstrumentation` project, just run\n\n```sh\ndotnet build\n```\n\nThis will build the dll under `src/AWS.Distro.OpenTelemetry.AutoInstrumentation/bin/Debug/net8.0`.\n\n### Building For Release\n\nTo build the project for release, packaged with OpenTelemetry DotNet Instrumentation, run the following in the root directory:\n\n```sh\nbash build.sh\n```\n\nThis runs build/Build.cs which basically pulls OpenTelemetry DotNet Instrumentation packaged zip file and adds the `AWS.Distro.OpenTelemetry.AutoInstrumentation` dll there.\n\n## Styling\n\nThis package uses [StyleCop](https://github.com/DotNetAnalyzers/StyleCopAnalyzers) to enforce styling rules as well as having Copyright headers. More information about the rules themselves can be found [here](https://github.com/DotNetAnalyzers/StyleCopAnalyzers/blob/master/DOCUMENTATION.md). The project is configured to use StyleCop so any file that is added that violates any of the rules, the Code Editor will complain. Alternatively, running `dotnet build` will complain as well. Unfortunately, it doesn't auto apply styling. To fix \"most\" of styling issues that come up, you can run `dotnet format`.\n\n## Testing\n\nFor Integration Testing, follow README under `sample-applications/integration-test-app`\n\nFor Unit Testing, followed this [doc](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-with-dotnet-test) to create test/AWS.Distro.OpenTelemetry.AutoInstrumentation.Tests directory. You can use that doc to add more unit tests. To run the unit tests, run `dotnet test`\n\n## Security\n\nSee [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.\n\n## License\n\nThis project is licensed under the Apache-2.0 License.\n\n## Checksum Verification\n\nArtifacts released will include a `.sha256` file for checksum verification starting from v1.5.0\nTo verify, run the command `shasum -a 256 -c \u003cartifact_name\u003e.sha256` \nIt should return the output `\u003cartifact_name\u003e: OK` if the validation is successful\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-observability%2Faws-otel-dotnet-instrumentation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-observability%2Faws-otel-dotnet-instrumentation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-observability%2Faws-otel-dotnet-instrumentation/lists"}