dotnet / dotnet/docs

[New article]: Detailed docs for Microsoft.Extensions.Telemetry

Open
#48,910 1 comment 1 reaction 0 assignees View on GitHub
:watch: Not Triaged
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.