Skip to content

docs(dotnet): Document NLog's MinimumLogLevel for SDK 7.0.0 - #20743

Merged
jamescrosswell merged 1 commit into
dotnet-v7from
docs/dotnet-v7-nlog-minimum-log-level
Nov 12, 2026
Merged

jamescrosswell merged 1 commit into
dotnet-v7from
docs/dotnet-v7-nlog-minimum-log-level

Conversation

@ric-oliv

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

getsentry/sentry-dotnet#5913 added MinimumLogLevel to the NLog target. It defaults to Info, and enableLogs="false" now turns logs off. The NLog pages on dotnet-v7 were written before it merged, so they still said the target sends every entry it receives as a log and that enableLogs has no effect.

This documents the new option in the NLog guide and on the logs page, says that logs start at Info, and fixes the enableLogs lines in the migration guide. The migration guide also notes that 6.x sent every entry once logs were on, so apps that want Trace or Debug logs need to lower minimumLogLevel. With Info as the default, the NLog snippets go back to a plain config.AddSentry().

It targets dotnet-v7, so it goes live with the rest of the 7.0.0 docs in #20641.

Refs getsentry/sentry-dotnet#5913

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've supplied a deadline.

Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

EXTRA RESOURCES

getsentry/sentry-dotnet#5913 adds MinimumLogLevel to the NLog target. Logs now start at Info,
and enableLogs="false" turns them off. The NLog guide, the logs pages and the migration guide
still said the target sends every entry it receives and that enableLogs has no effect.

Add the option, say that logs start at Info, fix the enableLogs lines, and go back to
config.AddSentry() in the NLog snippets.

Refs getsentry/sentry-dotnet#5913

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Nov 12, 2026 9:28am UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Nov 12, 2026 9:28am UTC

Request Review

@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Nov 12, 2026
@codeowner-assignment
codeowner-assignment Bot requested a review from a team November 12, 2026 09:20
@ric-oliv
ric-oliv marked this pull request as ready for review November 12, 2026 09:27
@github-actions

Copy link
Copy Markdown
Contributor

Please update the IS YOUR CHANGE URGENT? section of the PR description:

  • Select exactly one option.
  • If you selected an urgent or other deadline, provide the date as YYYY-MM-DD.

This information helps the Docs team prioritize your review.

@codeowner-assignment
codeowner-assignment Bot requested a review from a team November 12, 2026 09:27
@cursor

cursor Bot commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Getting ready to monitor this change · Rollout details

Status Service Environment
⏳ Getting ready to monitor this change

@jamescrosswell
jamescrosswell merged commit f52a4c6 into dotnet-v7 Nov 12, 2026
12 checks passed
@jamescrosswell
jamescrosswell deleted the docs/dotnet-v7-nlog-minimum-log-level branch November 12, 2026 21:00
@ric-oliv ric-oliv mentioned this pull request Nov 13, 2026
6 of 8 tasks
ric-oliv added a commit that referenced this pull request Nov 15, 2026
## DESCRIBE YOUR PR

This updates the .NET docs for sentry-dotnet 7.0.0, which has been on
NuGet since 2026-11-12. Each change was reviewed in its own PR against
the `dotnet-v7` branch, so the 7.x docs go live together:

- #20311 docs(dotnet): Add a Generic Host guide for SDK 7.0.0
- #20642 docs(dotnet): Add supported versions to the MAUI guide for SDK
7.0.0
- #19960 docs(dotnet): Document release and environment resolution for
SDK 7.0.0
- #19961 docs(dotnet): Update Microsoft.Extensions.Logging guide for SDK
7.0.0
- #19924 docs(dotnet): Update OTLP propagation docs for SDK 7.0.0
- #19925 docs(dotnet): Update logging docs for SDK 7.0.0
- #20715 docs(dotnet): Document ClearProviders() in the ASP.NET Core
guide for SDK 7.0.0
- #20752 docs(dotnet): Tell .NET Framework apps to install
Microsoft.Extensions.Logging for SDK 7.0.0
- #20743 docs(dotnet): Document NLog's MinimumLogLevel for SDK 7.0.0
- #20742 docs(dotnet): Link the Generic Host guide from the other .NET
pages for SDK 7.0.0
- #20689 docs(dotnet): Update the 7.x migration guide for 7.0.0
- #20780 docs(dotnet): Fix Serilog flushing, Serilog usings and the
Azure Functions package for SDK 7.0.0
- #20781 docs(dotnet): Fix the .NET logs and metrics examples and other
pages for SDK 7.0.0

### Issues this closes

Closes getsentry/sentry-dotnet#5710

The other docs issues for 7.0.0 were closed when their PRs merged into
`dotnet-v7`.

### Before merging

- [x] sentry-dotnet 7.0.0 is on NuGet.
- [x] The release candidate alert is gone from
`includes/dotnet-v7-migration-overview.mdx`.
- [x] The links that #20311, #19961 and #19925 left for after the other
PRs merge are in.
- [x] `master` is merged into `dotnet-v7`, and the Vercel preview looks
right.
- [x] This description has a `Closes` line for every issue that's still
open.

## IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs
to go live.
Select exactly one option. For deadlines, replace `YYYY-MM-DD` with the
due date. You can update this information later by editing the PR
description.

- [x] Urgent deadline (GA date, etc.): 2026-11-13
- [ ] Other deadline: YYYY-MM-DD
- [ ] No deadline: Not urgent, can wait up to 1 week+

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: James Crosswell <jamescrosswell@users.noreply.github.com>
Co-authored-by: ric-oliv <ric-oliv@users.noreply.github.com>
Co-authored-by: ric-oliv <5938598+ric-oliv@users.noreply.github.com>
Co-authored-by: Alex Krawiec <alex.krawiec@sentry.io>

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 47ef6264 Deployed Nov 12, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Needs Triage The PR description is missing valid priority information

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants