[New article]: Detailed docs for Microsoft.Extensions.Telemetry
- Dominant language
- No language data
- Stars
- 4.8k
- Forks
- 6.1k
- Avg merge
- 19h 10m
- Merged PRs (30d)
- 268
Description
### Proposed topic or title
Logging extensions
### Location in table of contents.
docs/core/extensions
### Reason for the article
Currently, there are no docs with details about using the Microsoft.Extensions.Telemetry library effectively.
https://andrewlock.net/behind-logproperties-and-the-new-telemetry-logging-source-generator/ is linked to from the official docs (here https://learn.microsoft.com/en-us/aspnet/core/fundamentals/logging/)
and https://andrewlock.net/customising-the-new-telemetry-logging-source-generator/ covers more of the new source-generator.
By having these docs on the official https://learn.microsoft.com/ website, we'll be able to leverage AI further to use these best practices via the Microsoft Learn MCP
there are some docs on https://github.com/dotnet/extensions/tree/main/src/Libraries/Microsoft.Extensions.Telemetry & https://github.com/dotnet/extensions/tree/main/src/Libraries/Microsoft.Extensions.Telemetry.Abstractions
specifically missing docs about the types and annotations:
- `[LogProperties]` (maybe based on https://andrewlock.net/behind-logproperties-and-the-new-telemetry-logging-source-generator/)
- `[TagProvider]` (maybe based on https://andrewlock.net/customising-the-new-telemetry-logging-source-generator/)
### Relevant searches
https://github.com/search?q=org%3Adotnet%20%22%5BLogProperties%22&type=code
there are some great samples - https://github.com/dotnet/extensions-samples/tree/aaae284846366e5c122b2760c4060712b862c060/src/Telemetry/Logging
---
#### Document Details
⚠ *Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.*
* ID: 3cbdde85-09dd-c0c5-724c-50cee3c4da18
* Version Independent ID: 9a3e1a10-1b76-69ae-e3f5-2e030aceb351
* Platform ID: a00f3cfc-8923-cd59-02fd-17daf0022282
* Content: [Runtime libraries overview - .NET](https://learn.microsoft.com/en-us/dotnet/standard/runtime-libraries-overview)
* Content Source: [docs/standard/runtime-libraries-overview.md](https://github.com/dotnet/docs/blob/main/docs/standard/runtime-libraries-overview.md)
* Service: **dotnet-fundamentals**
* GitHub Login: @gewarren
* Microsoft Alias: **gewarren**
Contributor guide
Assessment
This issue has not been assessed yet.