[New article]: Detailed docs for Microsoft.Extensions.Telemetry
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 42/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- csharp
调研方向
从 docs/core/extensions、Microsoft.Extensions.Telemetry 和 Microsoft.Extensions.Telemetry.Abstractions 源代码目录，以及所引用的 Telemetry Logging sample 开始。阅读链接的文章，了解 [LogProperties] 和 [TagProvider] 的相关背景。完成的标准是发布清晰的官方文档，涵盖这些类型、注释、有效用法和具有代表性的示例。
由索引模型根据 Issue 内容生成。
描述
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
- Content Source: docs/standard/runtime-libraries-overview.md
- Service: dotnet-fundamentals
- GitHub Login: @gewarren
- Microsoft Alias: gewarren
- 主要语言
- 没有语言数据
- 星标
- 4.8k
- 派生
- 6.1k
- 平均合并
- 22 小时 46 分钟
- 30 天内合并 PR
- 296
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
dotnet/docs 的其他 Issue
-
Examen未关闭dotnet-csharp/svc lang-reference/subsvc needs-more-info
难度 2/5 1-3 小时 新手友好度 66/100
维护者通常 1 天内回复
-
Update the .NET Framework 3.5 on Windows 11 FAQ to mention Windows 11 26H2可能已有人在做 @BillWagner 于 3 天前认领。 未关闭:pushpin: seQUESTered dotnet/svc
难度 1/5 1 小时以内 新手友好度 78/100
dotnet/docs#56791 · 1 个 reaction · 已指派 2 人 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 86/100
维护者通常 1 天内回复
-
Improve description of `limitations of extensions`可能已有人在做 @Manish-1kumar 于 11 天前认领。 未关闭advanced-concepts/subsvc dotnet-csharp/svc
难度 1/5 1-3 小时 新手友好度 84/100
维护者通常 1 天内回复
-
Document unit-test / theory-data impact of .NET 11 double→decimal conversion可能已有人在做 @SkyDevLab 于 22 天前认领。 未关闭:watch: Not Triaged dotnet-fundamentals/svc
难度 1/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复
相似的 Issue
-
documentation
难度 2/5 1-3 小时 新手友好度 72/100
buckai-observatory/Automated-Cloud-Removal-and-Seamless-Satellite-Image-Mosaicking-Pipeline#52 ·
维护者通常 1 天内回复
-
documentation
难度 1/5 1-3 小时 新手友好度 84/100
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 82/100
run-llama/llama_index#24163 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 82/100
btclib-org/btclib#3090 ·
维护者通常 1 天内回复
-
documentation good first issue
难度 2/5 1-3 小时 新手友好度 84/100
asasemahmed/openboard#68 ·
维护者通常 1 天内回复