NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #1123 most downloaded on NuGet
Maps Elastic Common Schema (ECS) to .NET types including (de)serialization using System.Text.Json
Latest stable
9.0.0
Last release 1 years ago
13 Aug 2025
Release timing varies
gaps range from 2 weeks to 8 months
Nearly every release is documented
notes for 21 of 21 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
27 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
https://github.com/elastic/ecs-dotnet/compare/8.19.0...9.0.0
https://github.com/elastic/ecs-dotnet/compare/8.19.0...9.0.0
https://github.com/elastic/ecs-dotnet/compare/8.18.2...8.19.0
https://github.com/elastic/ecs-dotnet/compare/8.18.2...8.19.0
8.19.0
Compare
Your coding agent can read these notes before it upgrades. Set up the MCP server →
https://github.com/elastic/ecs-dotnet/compare/8.18.1...8.18.2
https://github.com/elastic/ecs-dotnet/compare/8.18.1...8.18.2
https://github.com/elastic/ecs-dotnet/compare/8.18.0...8.18.1
https://github.com/elastic/ecs-dotnet/compare/8.18.0...8.18.1
https://github.com/elastic/ecs-dotnet/compare/8.12.3...8.18.0
https://github.com/elastic/ecs-dotnet/compare/8.12.3...8.18.0
https://github.com/elastic/ecs-dotnet/compare/8.12.2...8.12.3
https://github.com/elastic/ecs-dotnet/compare/8.12.2...8.12.3
https://github.com/elastic/ecs-dotnet/compare/8.12.1...8.12.2
https://github.com/elastic/ecs-dotnet/compare/8.12.1...8.12.2
View the full list of issues and PRs
https://github.com/elastic/ecs-dotnet/compare/8.12.0...8.12.1
8.12.1: Remove WriteEvent usages (#453)
Compare
https://github.com/elastic/ecs-dotnet/compare/8.11.1...8.12.0
https://github.com/elastic/ecs-dotnet/compare/8.11.1...8.12.0
https://github.com/elastic/ecs-dotnet/compare/8.11.0...8.11.1
https://github.com/elastic/ecs-dotnet/compare/8.11.0...8.11.1
https://github.com/elastic/ecs-dotnet/compare/8.6.1...8.11.0
https://github.com/elastic/ecs-dotnet/compare/8.6.1...8.11.0
https://github.com/elastic/ecs-dotnet/compare/8.6.0...8.6.1
https://github.com/elastic/ecs-dotnet/compare/8.6.0...8.6.1
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha4...8.6.0
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha4...8.6.0
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha3...8.4.0-alpha4
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha3...8.4.0-alpha4
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha2...8.4.0-alpha3
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha2...8.4.0-alpha3
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha1...8.4.0-alpha2
https://github.com/elastic/ecs-dotnet/compare/8.4.0-alpha1...8.4.0-alpha2
https://github.com/elastic/ecs-dotnet/compare/1.6.0-alpha1...8.4.0-alpha1
https://github.com/elastic/ecs-dotnet/compare/1.6.0-alpha1...8.4.0-alpha1
https://github.com/elastic/ecs-dotnet/compare/1.5.3...1.6.0-alpha1
https://github.com/elastic/ecs-dotnet/compare/1.5.3...1.6.0-alpha1
This is an alpha release of the ECS .NET packages to gather feedback before a GA release:
#85 Stand alone logger provider for Microsoft.Extensions.Logging that uses ECS to log directly to Elasticsearch
#145 Generate types from ECS 1.6 version (issues: #71, #129)
types in Elastic.CommonSchema are generated from ECS schema 1.6, which adds support for Spans and fixes an issue in code generation that included properties on the root Base type that should not have been.
#146 Add span id to APM Logging integrations
Elastic.CommonSchema.SerilogScanned: 📑 1 assemblies(s), Suggested change in version: Minor
+ 0 breaking change(s) detected.
+ 🌟 1 new additions
- 🔴 0 removals
- 🔷 0 modifications
<details> <summary><b>📑 Elastic.CommonSchema.Serilog.dll </b> <pre><b> Click here to see the 1 differences </b> </summary>
Elastic.CommonSchema.Serilog, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String)
</details>
Elastic.CommonSchema.NLogScanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 0 removals
- 🔷 0 modifications
<details> <summary><b>📑 Elastic.CommonSchema.NLog.dll </b> <pre><b> Click here to see the 2 differences </b> </summary>
Elastic.CommonSchema.NLog, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String)
Elastic.CommonSchema.NLog.dll
Elastic.CommonSchema.NLog.EcsLayout
+ 🌟 ApmSpanId
</details>
Elastic.CommonSchema.BenchmarkDotNetExporterScanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 2 removals
- 🔷 2 modifications
<details> <summary><b>📑 Elastic.CommonSchema.BenchmarkDotNetExporter.dll </b> <pre><b> Click here to see the 6 differences </b> </summary>
Elastic.CommonSchema.BenchmarkDotNetExporter, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String)
Elastic.CommonSchema.BenchmarkDotNetExporter.dll
- 🔴 BenchmarkDotNet, Version=0.12.0.0, Culture=neutral, PublicKeyToken=aa0ca2f9092cefc4
Elastic.CommonSchema.BenchmarkDotNetExporter.Domain.BenchmarkConfidence
- 🔴 BenchmarkConfidence(ConfidenceInterval) 💥
+ 🌟 BenchmarkConfidence(ConfidenceInterval)
+ 🔷 Level 💥
+ 🔷 Member type changed from ConfidenceLevel to ConfidenceLevel. 💥
</details>
Elastic.Apm.NLogScanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 0 removals
- 🔷 0 modifications
<details> <summary><b>📑 Elastic.Apm.NLog.dll </b> <pre><b> Click here to see the 2 differences </b> </summary>
Elastic.Apm.NLog, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String)
Elastic.Apm.NLog.dll
+ 🌟 Elastic.Apm.NLog.ApmSpanIdLayoutRenderer
</details>
Elastic.CommonSchemaScanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 21 new additions
- 🔴 26 removals
- 🔷 16 modifications
<details> <summary><b>📑 Elastic.CommonSchema.dll </b> <pre><b> Click here to see the 63 differences </b> </summary>
Elastic.CommonSchema, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String)
Elastic.CommonSchema.dll
- 🔴 System.Text.Encodings.Web, Version=4.0.5.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
- 🔴 System.Text.Json, Version=4.0.1.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
- 🔴 System.Threading.Tasks.Extensions, Version=4.2.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
+ 🌟 Elastic.CommonSchema.AgentBuild
- 🔴 Elastic.CommonSchema.ClientHash 💥
+ 🌟 Elastic.CommonSchema.CloudProject
- 🔴 Elastic.CommonSchema.EgressInterface 💥
- 🔴 Elastic.CommonSchema.EgressVlan 💥
- 🔴 Elastic.CommonSchema.IngressInterface 💥
- 🔴 Elastic.CommonSchema.IngressVlan 💥
- 🔴 Elastic.CommonSchema.InnerVlan 💥
+ 🌟 Elastic.CommonSchema.LogFile
- 🔴 Elastic.CommonSchema.ParentCodeSignature 💥
- 🔴 Elastic.CommonSchema.ParentHash 💥
- 🔴 Elastic.CommonSchema.ParentThread 💥
- 🔴 Elastic.CommonSchema.ProcessParent 💥
- 🔴 Elastic.CommonSchema.ServerHash 💥
+ 🌟 Elastic.CommonSchema.Span
+ 🌟 Elastic.CommonSchema.X509
+ 🌟 Elastic.CommonSchema.X509Issuer
+ 🌟 Elastic.CommonSchema.X509Subject
Elastic.CommonSchema.Agent
+ 🌟 Build
Elastic.CommonSchema.Cloud
+ 🌟 Project
Elastic.CommonSchema.CloudAccount
+ 🌟 Name
Elastic.CommonSchema.Container
+ 🔷 Labels 💥
+ 🔷 Member type changed from Object to IDictionary<String, String>. 💥
Elastic.CommonSchema.Event
+ 🌟 Reason
Elastic.CommonSchema.File
+ 🌟 X509
Elastic.CommonSchema.Log
+ 🌟 File
Elastic.CommonSchema.NetworkInner
+ 🔷 Vlan 💥
+ 🔷 Member type changed from InnerVlan to Vlan. 💥
Elastic.CommonSchema.Process
+ 🔷 Parent 💥
+ 🔷 Member type changed from ProcessParent to Process. 💥
Elastic.CommonSchema.Related
+ 🌟 Hosts
Elastic.CommonSchema.User
+ 🌟 Roles
Elastic.CommonSchema.Observer
- 🔴 Interface 💥
- 🔴 Vlan 💥
Elastic.CommonSchema.ObserverEgress
+ 🔷 Interface 💥
+ 🔷 Member type changed from EgressInterface to Interface. 💥
+ 🔷 Vlan 💥
+ 🔷 Member type changed from EgressVlan to Vlan. 💥
Elastic.CommonSchema.ObserverIngress
+ 🔷 Interface 💥
+ 🔷 Member type changed from IngressInterface to Interface. 💥
+ 🔷 Vlan 💥
+ 🔷 Member type changed from IngressVlan to Vlan. 💥
Elastic.CommonSchema.Pe
+ 🌟 Architecture
+ 🌟 Imphash
Elastic.CommonSchema.TlsClient
- 🔴 Hash 💥
+ 🌟 X509
Elastic.CommonSchema.TlsServer
- 🔴 Hash 💥
+ 🌟 X509
Elastic.CommonSchema.Base
- 🔴 As 💥
- 🔴 CodeSignature 💥
- 🔴 Geo 💥
- 🔴 Hash 💥
- 🔴 Interface 💥
- 🔴 Os 💥
- 🔴 Pe 💥
+ 🌟 Span
- 🔴 Vlan 💥
+ 🔷 Labels 💥
+ 🔷 Member type changed from IDictionary<String, Object> to IDictionary<String, String>. 💥
</details>
Elastic.Apm.SerilogEnricherScanned: 📑 1 assemblies(s), Suggested change in version: Minor
+ 0 breaking change(s) detected.
+ 🌟 1 new additions
- 🔴 0 removals
- 🔷 0 modifications
<details> <summary><b>📑 Elastic.Apm.SerilogEnricher.dll </b> <pre><b> Click here to see the 1 differences </b> </summary>
Elastic.Apm.SerilogEnricher, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String)
</details>
https://github.com/elastic/ecs-dotnet/compare/1.5.1...1.5.3
https://github.com/elastic/ecs-dotnet/compare/1.5.1...1.5.3
LogEvent properties from being added to serialized ECS Base.MetadataEcsLayoutProcessThread.Id in EcsLayout (issue: #123)_metadata to metadata for elastic purposes (issue: #104)TextWriter (issue: #135)Server.IP field (issue: #87)Elastic.CommonSchema.SerilogScanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 1 removals
- 🔷 0 modifications
<details> <summary><b>📑 Elastic.CommonSchema.Serilog.dll </b> <pre><b> Click here to see the 3 differences </b> </summary>
Elastic.CommonSchema.Serilog, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
Elastic.CommonSchema.Serilog.dll
- 🔴 Elastic.CommonSchema, Version=1.5.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
Elastic.CommonSchema.Serilog.EcsTextFormatterConfiguration
+ 🌟 LogEventPropertiesToFilter(ISet<String>)
Elastic.CommonSchema.Serilog.IEcsTextFormatterConfiguration
+ 🌟 LogEventPropertiesToFilter
</details>
Elastic.CommonSchema.NLogScanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 1 new additions
- 🔴 1 removals
- 🔷 0 modifications
<details> <summary><b>📑 Elastic.CommonSchema.NLog.dll </b> <pre><b> Click here to see the 2 differences </b> </summary>
Elastic.CommonSchema.NLog, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
Elastic.CommonSchema.NLog.dll
- 🔴 Elastic.CommonSchema, Version=1.5.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
Elastic.CommonSchema.NLog.EcsLayout
+ 🌟 ExcludeProperties
</details>
Elastic.CommonSchema.BenchmarkDotNetExporterScanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 0 new additions
- 🔴 1 removals
- 🔷 0 modifications
<details> <summary><b>📑 Elastic.CommonSchema.BenchmarkDotNetExporter.dll </b> <pre><b> Click here to see the 1 differences </b> </summary>
Elastic.CommonSchema.BenchmarkDotNetExporter, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
Elastic.CommonSchema.BenchmarkDotNetExporter.dll
- 🔴 Elastic.CommonSchema, Version=1.5.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
</details>
Elastic.Apm.NLogScanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modifications
Elastic.CommonSchemaScanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modifications
Elastic.Apm.SerilogEnricherScanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modifications
https://github.com/elastic/ecs-dotnet/compare/1.5.0...1.5.1
https://github.com/elastic/ecs-dotnet/compare/1.5.0...1.5.1
This release brings the packages up to date with ECS 1.5.0.
This release brings the packages up to date with ECS 1.5.0.
Compatible with ECS Schema version: 1.5.0
b5bbe25
This commit was created on GitHub.com and signed with GitHub’s verified signature . The key has expired.
GPG key ID: 4AEE18F83AFDEB23 Expired
Verified Learn about vigilant mode .
In this release, we continue fleshing out categorization by introducing the "network" and "iam" categories, with related event types.
We're adding new field sets: "dll", "pe", "code_signature", "interface" & "vlan". We're also adding a few fields here and there (check out the details below).
Implementers consuming ECS artifacts like generated/ecs/*.yml programmatically will be happy to know that we now clearly identify which fields are expected to contain an array of values. Shout-out to contributors on the ecs-logging libraries for raising this 👋🏼.
Finally, starting with ECS 1.5.0, the project is using Python 3.7.
Added dll.* fields #679
Added related.hash to keep track of all hashes seen on an event. #711
Added fieldset for PE metadata. #731
Added code_signature fieldset. #733
Added missing hash fields at process.parent.hash.* . #739
Added globally unique identifier entity_id to process and process.parent . #747
Added interface, vlan, observer zone fields #752
Added rule.author , rule.license fields #754
Added iam value for event.category and three related values for event.type . #756
Added fields event.reference and event.url to hold link to additional event info/actions. #757
Added file.mime_type to include MIME type information on file structures #760
Added event.category value of network and associated event.type values. #761
Temporary workaround for Beats templates' default_field growing too big. #687
Identify which fields should contain arrays of values, rather than scalar values. #727 , #661
Clarified examples and definitions regarding vulnerabilities. #758
Updated definition of event.outcome based on community feedback. #759
ECS scripts now use Python 3.6+. #674
schema_reader.py now reliably supports chaining reusable fieldsets together. #722
Allow the artifact generator to consider and output only a subset of fields. #737
Add support for reusing fields in places other than the top level of the destination fieldset. #739
Add support for specifying the directory to write the generated files. #748
Compatible with ECS Schema version: 1.4.0
Compatible with ECS Schema version: 1.4.0
Compatible with ECS Schema version: 1.4.0
Compatible with ECS Schema version: 1.4.0
Compatible with ECS Schema version: 1.4.0
Compatible with ECS Schema version: 1.4.0
Compatible with ECS Schema version: 1.4.0
Compatible with ECS Schema version: 1.4.0
The focus of this release has been around a logging integration for NLog, with the introduction of a new package:
| Elastic.CommonSchema.NLog | Formats an NLog message into a JSON representation that can be indexed into Elasticsearch. |
|---|
PrivateAssets="all" attribute so that the client reference flows to the project.Blog post announcement: https://www.elastic.co/blog/elastic-common-schema-dotnet-library-and-integrations-released-for-elasticsearch
Blog post announcement: https://www.elastic.co/blog/elastic-common-schema-dotnet-library-and-integrations-released-for-elasticsearch
General release of the ECS .NET library; a full C# representation of ECS using .NET types. This library forms a reliable and correct basis for integrations with Elasticsearch, that use both Microsoft .NET and ECS. These types can be used as-is, in conjunction with the Official .NET clients for Elasticsearch, or as a foundation for other integrations.
We have also shipped integrations for Elastic APM Logging with Serilog and NLog, vanilla Serilog and for BenchmarkDotnet.
There are a number of NuGet packages available for ECS version 1.4.0:
Initial alpha pre-release of the ECS .NET library, compatible with ECS Schema version v1.2.0
Initial alpha pre-release of the ECS .NET library, compatible with ECS Schema version v1.2.0
Feedback very much welcome!
One column per quarter.