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

Offen
#48,910 1 Kommentar 1 Reaktion 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
42/100
Issue-Typ
Dokumentation
Klarheit
Größtenteils klar
Aktivitätsstatus
Veraltet
Tech-Stack
csharp
Bereich
documentation

Rechercherichtung

Beginnen Sie mit docs/core/extensions, den Quellverzeichnissen Microsoft.Extensions.Telemetry und Microsoft.Extensions.Telemetry.Abstractions sowie dem referenzierten Telemetry Logging sample. Lesen Sie die verlinkten Artikel, um Kontext zu [LogProperties] und [TagProvider] zu erhalten. Als abgeschlossen gilt die Veröffentlichung einer klaren offiziellen Dokumentation zu diesen Typen, Annotationen, ihrer effektiven Verwendung und repräsentativen Beispielen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

:watch: Not Triaged
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:

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.

Vorherrschende Sprache
Keine Sprachdaten
Sterne
4.8k
Forks
6.1k
Ø Merge
22 Std. 46 Min.
Gemergte PRs (30 T.)
296

Entwicklungsumgebung

In Codespaces öffnen

Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus dotnet/docs

Alle Issues in dotnet/docs

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.