Serilog.Sinks.MongoDB 7.1.0

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Standard 2.1 This package targets .NET Standard 2.1. The package is compatible with this framework or higher. .NET Framework 4.7.2 This package targets .NET Framework 4.7.2. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Serilog.Sinks.MongoDB --version 7.1.0
                    


                    

                
NuGet\Install-Package Serilog.Sinks.MongoDB -Version 7.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Serilog.Sinks.MongoDB" Version="7.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Serilog.Sinks.MongoDB" Version="7.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Serilog.Sinks.MongoDB" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Serilog.Sinks.MongoDB --version 7.1.0
                    


                    

                
#r "nuget: Serilog.Sinks.MongoDB, 7.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Serilog.Sinks.MongoDB@7.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Serilog.Sinks.MongoDB&version=7.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Serilog.Sinks.MongoDB&version=7.1.0
                    


                            Install as a Cake Tool

mongo icon Serilog.Sinks.MongoDB

NuGet version Downloads Build status

A Serilog sink that writes events as documents to MongoDB.

Package - Serilog.Sinks.MongoDB Platforms - .NET 4.7.2, .NET 6.0, .NET Standard 2.1

Whats New

New in v7.x
  • Upgrade MongoDB.Driver to v3.0 - .NET Standard 2.0 support has been removed.
New in v6.x
  • Upgrade MongoDB.Driver to v2.28.0 (Thanks to Memoyu)
  • Add trace context to LogEntry (Thanks to fernandovmp)
New in v5.x
  • Output structured MongoDB Bson logs by switching to .MongoDBBson() extensions. Existing .MongoDB() extensions will continue to work converting logs to Json and then to Bson.
  • Rolling Log Collection Naming (Thanks to Revazashvili for the PR!). MongoDBBson sink only.
  • Expire TTL support. MongoDBBson sink only.

Installation

Install the sink via NuGet Package Manager Console:

Install-Package Serilog.Sinks.MongoDB

or via the .NET CLI:

dotnet add package Serilog.Sinks.MongoDB

Usage Examples

In the examples below, the sink is writing to the database logs with structured Bson. The default collection name is log, but a custom collection can be supplied with the optional CollectionName parameter. The database and collection will be created if they do not exist.

Basic:

using Serilog;

// use BSON structured logs
var log = new LoggerConfiguration()
    .WriteTo.MongoDBBson("mongodb://mymongodb/logs")
    .CreateLogger();

log.Information("This is a test log message");

Capped Collection:

// capped collection using BSON structured logs
var log = new LoggerConfiguration()
    .WriteTo.MongoDBBson("mongodb://mymongodb/logs", cfg =>
    {
        // optional configuration options:
        cfg.SetCollectionName("log");
        cfg.SetBatchPeriod(TimeSpan.FromSeconds(1));

        // create capped collection that is max 100mb
        cfg.SetCreateCappedCollection(100);
    })
    .CreateLogger();

Custom Mongodb Settings:

// create sink instance with custom mongodb settings.
var log = new LoggerConfiguration()
	.WriteTo.MongoDBBson(cfg =>
    {
		// custom MongoDb configuration
		var mongoDbSettings = new MongoClientSettings
		{
			UseTls = true,			
			AllowInsecureTls = true,
			Credential = MongoCredential.CreateCredential("databaseName", "username", "password"),
			Server = new MongoServerAddress("127.0.0.1")
		};

		var mongoDbInstance = new MongoClient(mongoDbSettings).GetDatabase("serilog");
		
		// sink will use the IMongoDatabase instance provided
		cfg.SetMongoDatabase(mongoDbInstance);
		cfg.SetRollingInterval(RollingInterval.Month);
    })
	.CreateLogger();

JSON (Microsoft.Extensions.Configuration)

Keys and values are not case-sensitive. This is an example of configuring the MongoDB sink arguments from Appsettings.json:

{
  "Serilog": {
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft": "Error",
        "System": "Warning"
      }
    },
    "WriteTo": [
      { 
      	"Name": "MongoDBBson", 
        "Args": { 
            "databaseUrl": "mongodb://username:password@ip:port/dbName?authSource=admin",
            "collectionName": "logs",
            "cappedMaxSizeMb": "1024",
            "cappedMaxDocuments": "50000",
            "rollingInterval": "Month"
        }
      } 
    ]
  }
}

Icon

MongoDB icon by Icons8

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (57)

Showing the top 5 NuGet packages that depend on Serilog.Sinks.MongoDB:

Package Downloads
RG3.PF.Web.StartUsed

1、【核心业务使用包RG3.PF.Web.StartUsed】(可配置化，标准化，灵活配置，集成百度、腾讯、阿里、短信通等巨头接口，可脱离开发环境，集成nodejs中间件、统一认证中心) 2、以Rg3.开头且类继承 IService 或 IRepository的在Starup里面不用注入，案例如下 3、public class ListRepository : IRepository 4、public class ListService : IService 5、使用请到github获取 RG3.PF.WebApp.Host 6、Quartz集成redis订阅、Quartz 7、修复多引用CLDC 8、接入微信公众号wxconfig 9、Prometheus+Grafana https://doc.rg1008.com/docs/rg_pass_log/rg_pass_log-1dpcuns9s6r8c 10、Headers添加VerifyApiValue 用于验证 11、添加时间戳 Convert.ToInt64(DateTimePFUtil.ToTimestampSecond(this.Expires)); 12、版本记录：https://doc.rg1008.com/docs/rg_pass_log/rg_pass_log-1dpubsabl25v4 13、 20240815 升级到.netcore sdk 8.0
TianCheng.Model

实体对象基类，及其常用操作。 常用操作包括：对象转换、序列化、日志、常用异常处理、依赖注入。
Basic.Logging.Serilog

Package Description
uBeac.Logging.MongoDB

Easily implement logging with MongoDB in your .NET projects!
PegasusLoggingService

Package Description

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Serilog.Sinks.MongoDB:

Repository Stars
serilog-contrib/serilog-ui
Simple Serilog log viewer UI for several sinks.
keremvaris/Sennedjem
Sennedjem CQRS (Command Query Responsibility Segregation) yaklaşımını benimseyen ve SOLID prensiplerini ve Clean Architecture yöntemlerini odaklayan bir yazılım geliştirme alt yapısıdır. RabbitMq, ElasticSearch vb araçlara entegre olmak konusunda çok yeteneklidir.
Version Downloads Last Updated
7.2.0 7,570 10/26/2025
7.1.0 12,089 10/5/2025
7.0.0 348,590 11/5/2024
6.0.0 118,140 9/20/2024
5.4.1 386,947 2/18/2024
5.3.1 1,137,323 9/28/2022
5.2.2 8,184 9/26/2022
5.2.1 33,295 9/3/2022
5.2.1-tags-v5-2-0-0000 415 9/3/2022
5.2.0 1,128 9/3/2022
5.1.5 309,833 4/24/2022
5.1.2 181,019 1/19/2022
5.1.2-dev-00124 471 3/12/2022
5.1.2-dev-00123 682 1/19/2022
5.1.2-dev-00121 661 1/19/2022
5.1.1 260,101 9/25/2021
5.1.1-dev-00120 720 1/19/2022
5.1.1-dev-00119 651 1/19/2022
5.1.1-dev-00118 689 1/19/2022
5.1.1-dev-00116 528 9/25/2021
5.1.0-dev-00114 552 9/25/2021
5.0.0 82,391 9/2/2021
5.0.0-dev-00112 588 9/24/2021
5.0.0-dev-00111 642 9/12/2021
5.0.0-dev-00110 595 9/12/2021
5.0.0-dev-00109 526 9/2/2021
5.0.0-dev-00107 538 9/2/2021
5.0.0-dev-00105 827 8/1/2021
5.0.0-dev-00104 2,058 5/8/2021
5.0.0-dev-00103 614 5/7/2021
5.0.0-dev-00100 24,560 5/6/2021
5.0.0-dev-00099 600 5/6/2021
5.0.0-dev-00098 586 5/6/2021
5.0.0-dev-00097 952 5/6/2021
4.1.0 454,913 5/6/2021
4.1.0-dev-00096 583 5/6/2021
4.1.0-dev-00094 562 5/6/2021
4.1.0-dev-00084 10,752 10/21/2020
4.1.0-dev-00069 20,740 1/29/2019
4.0.0 1,696,585 11/9/2018
4.0.0-dev-00068 699 1/29/2019
4.0.0-dev-00064 811 11/9/2018
4.0.0-dev-00062 7,669 2/15/2018
4.0.0-dev-00060 1,349 11/30/2017
3.1.1-dev-00059 1,131 11/30/2017
3.1.0 519,126 11/1/2016
3.1.0-dev-00049 1,304 10/30/2016
3.1.0-dev-00046 1,774 10/7/2016
3.1.0-dev-00044 1,181 10/7/2016
3.1.0-dev-00042 1,160 10/5/2016
3.1.0-dev-00037 1,251 10/5/2016
3.1.0-dev-00035 1,219 9/9/2016
3.1.0-dev-00033 1,180 9/8/2016
3.0.0 3,803 8/9/2016
3.0.0-dev-00030 1,202 8/9/2016
3.0.0-dev-00029 1,168 8/9/2016
3.0.0-beta-24 1,611 4/26/2016
2.0.19 13,304 2/16/2016
2.0.18 1,691 2/16/2016
2.0.14 23,199 1/26/2016
2.0.13 4,717 7/26/2015
2.0.11 2,626 4/18/2015
2.0.8-pre 1,319 4/2/2015
2.0.7-pre 1,284 3/26/2015
2.0.6-pre 1,252 3/16/2015
2.0.3-pre 1,265 3/10/2015
2.0.1-pre 1,282 2/1/2015
2.0.0-beta-27 1,176 5/6/2016
1.4.139 2,431 1/23/2015
1.4.118 1,680 1/13/2015
1.4.113 1,833 1/6/2015
1.4.102 2,192 12/21/2014
1.4.99 2,106 12/18/2014
1.4.97 1,942 12/18/2014
1.4.76 2,058 12/8/2014
1.4.39 1,914 11/26/2014
1.4.34 1,878 11/24/2014
1.4.28 1,934 11/24/2014
1.4.27 1,945 11/23/2014
1.4.23 2,043 11/21/2014
1.4.21 1,925 11/21/2014
1.4.18 2,029 11/18/2014
1.4.15 2,975 11/4/2014
1.4.14 1,886 10/23/2014
1.4.13 1,760 10/23/2014
1.4.12 1,840 10/12/2014
1.4.11 1,783 10/8/2014
1.4.10 1,801 9/26/2014
1.4.9 1,883 9/17/2014
1.4.8 1,798 9/11/2014
1.4.7 1,831 9/1/2014
1.4.6 1,752 8/31/2014
1.4.5 1,922 8/27/2014
1.4.4 1,791 8/27/2014
1.4.3 1,894 8/25/2014
1.4.2 1,827 8/23/2014
1.4.1 1,802 8/23/2014
1.3.43 2,080 8/4/2014
1.3.42 1,825 7/30/2014
1.3.41 1,793 7/28/2014
1.3.40 1,735 7/26/2014
1.3.39 1,756 7/25/2014
1.3.36 1,762 7/20/2014
1.3.35 1,752 7/17/2014
1.3.34 2,447 7/6/2014
1.3.33 1,767 6/30/2014
1.3.30 1,819 6/19/2014
1.3.29 1,811 6/19/2014
1.3.28 1,741 6/19/2014
1.3.27 1,773 6/18/2014
1.3.25 1,828 6/9/2014
1.3.24 1,886 5/21/2014
1.3.23 1,780 5/20/2014
1.3.20 1,832 5/18/2014
1.3.19 1,765 5/17/2014
1.3.18 1,736 5/17/2014
1.3.17 1,760 5/17/2014
1.3.16 1,772 5/17/2014
1.3.15 1,767 5/16/2014
1.3.14 1,874 5/16/2014
1.3.13 1,773 5/16/2014
1.3.12 1,782 5/14/2014
1.3.7 1,773 5/11/2014
1.3.6 1,807 5/9/2014
1.3.5 1,781 5/6/2014
1.3.4 1,899 5/4/2014
1.3.3 1,963 4/28/2014
1.3.1 1,807 4/26/2014
1.2.53 1,827 4/26/2014
1.2.52 2,058 4/24/2014
1.2.51 1,973 4/18/2014
1.2.50 1,944 4/18/2014
1.2.49 1,930 4/17/2014
1.2.48 1,903 4/14/2014
1.2.47 2,025 4/14/2014
1.2.45 2,058 4/13/2014
1.2.44 1,961 4/9/2014
1.2.41 1,913 4/7/2014
1.2.40 1,884 4/7/2014
1.2.39 1,864 3/29/2014
1.2.37 1,873 3/29/2014
1.2.29 1,893 3/16/2014
1.2.26 1,810 3/12/2014
1.2.25 1,936 2/20/2014
0.9.9 1,975 11/23/2013
0.9.1 1,953 8/24/2013
0.8.5 1,974 7/22/2013
0.8.1 2,020 7/9/2013
0.7.2 2,045 7/6/2013
0.6.1 1,969 6/13/2013
0.5.2 1,931 5/27/2013
0.5.1 1,934 5/26/2013
0.4.3 1,941 5/25/2013
0.3.2 1,896 5/19/2013
0.3.1 1,878 5/19/2013
0.2.10 1,922 5/13/2013
0.2.9 1,844 5/10/2013
0.2.7 1,847 5/8/2013
0.2.6 1,919 5/8/2013
0.2.5 1,891 5/7/2013
0.2.1 1,914 4/8/2013
0.1.18 1,937 4/6/2013
0.1.17 1,886 4/4/2013
0.1.16 1,889 4/3/2013
0.1.12 1,943 4/1/2013
0.1.11 3,978 3/30/2013

v7.1 - Bug fixes: Guid to BsonValue mapping (#91), RollingInterval collection naming (#95), SetRollingInterval method name correction (#97).