Releases: elastic/ecs-dotnet
Releases · elastic/ecs-dotnet
1.6.0-alpha1
This is an alpha release of the ECS .NET packages to gather feedback before a GA release:
New Features
-
#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
Basetype that should not have been. -
#146 Add span id to APM Logging integrations
View the full list of issues and PRs
API Changes: Elastic.CommonSchema.Serilog
Scanned: 📑 1 assemblies(s), Suggested change in version: Minor
+ 0 breaking change(s) detected.
+ 🌟 1 new additions
- 🔴 0 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.Serilog.dll
Click here to see the 1 differences
Elastic.CommonSchema.Serilog, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String) API Changes: Elastic.CommonSchema.NLog
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 0 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.NLog.dll
Click here to see the 2 differences
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 API Changes: Elastic.CommonSchema.BenchmarkDotNetExporter
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 2 removals
- 🔷 2 modifications📑 Elastic.CommonSchema.BenchmarkDotNetExporter.dll
Click here to see the 6 differences
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. 💥 API Changes: Elastic.Apm.NLog
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 0 removals
- 🔷 0 modifications📑 Elastic.Apm.NLog.dll
Click here to see the 2 differences
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 API Changes: Elastic.CommonSchema
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 21 new additions
- 🔴 26 removals
- 🔷 16 modifications📑 Elastic.CommonSchema.dll
Click here to see the 63 differences
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>. 💥 API Changes: Elastic.Apm.SerilogEnricher
Scanned: 📑 1 assemblies(s), Suggested change in version: Minor
+ 0 breaking change(s) detected.
+ 🌟 1 new additions
- 🔴 0 removals
- 🔷 0 modifications📑 Elastic.Apm.SerilogEnricher.dll
Click here to see the 1 differences
Elastic.Apm.SerilogEnricher, Version=1.0.0.0, Culture=neutral, PublicKeyToken=069ca2728db333c1
+ 🌟 System.Reflection.AssemblyMetadataAttribute::.ctor(System.String,System.String) 1.5.3
New Features
- #90 Filter Serilog
LogEventproperties from being added to serialized ECSBase.Metadata - #94 Add support for ExcludeProperties to NLog
EcsLayout
Bug Fixes
- #117 Handle missing StackFrames in Exception StackTrace formatting (issue: #102)
- #124 Use process thread id for
ProcessThread.IdinEcsLayout(issue: #123) - #138 Rename
_metadatatometadatafor elastic purposes (issue: #104) - #144 Write ECS formatted log event to
TextWriter(issue: #135) - #108 Don't write hostname to the
Server.IPfield (issue: #87)
Docs Improvements
- #92 Fix documentation for NLog EcsLayout to match Serilog
View the full list of issues and PRs
API Changes: Elastic.CommonSchema.Serilog
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 2 new additions
- 🔴 1 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.Serilog.dll
Click here to see the 3 differences
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 API Changes: Elastic.CommonSchema.NLog
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 1 new additions
- 🔴 1 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.NLog.dll
Click here to see the 2 differences
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 API Changes: Elastic.CommonSchema.BenchmarkDotNetExporter
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 0 new additions
- 🔴 1 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.BenchmarkDotNetExporter.dll
Click here to see the 1 differences
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 API Changes: Elastic.Apm.NLog
Scanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modificationsAPI Changes: Elastic.CommonSchema
Scanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modificationsAPI Changes: Elastic.Apm.SerilogEnricher
Scanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modifications1.5.2
NOTE: dummy release to test automation.
View the full list of issues and PRs
API Changes: Elastic.CommonSchema.Serilog
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 0 new additions
- 🔴 1 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.Serilog.dll
Click here to see the 1 differences
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 API Changes: Elastic.CommonSchema.NLog
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 0 new additions
- 🔴 1 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.NLog.dll
Click here to see the 1 differences
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 API Changes: Elastic.CommonSchema
Scanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modificationsAPI Changes: Elastic.Apm.NLog
Scanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modificationsAPI Changes: Elastic.CommonSchema.BenchmarkDotNetExporter
Scanned: 📑 1 assemblies(s), Suggested change in version: Major
+ 0 breaking change(s) detected.
+ 🌟 0 new additions
- 🔴 1 removals
- 🔷 0 modifications📑 Elastic.CommonSchema.BenchmarkDotNetExporter.dll
Click here to see the 1 differences
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 API Changes: Elastic.Apm.SerilogEnricher
Scanned: 📑 1 assemblies(s), Suggested change in version: Patch
+ 0 breaking change(s) detected.
🌟 0 new additions, 🔴 0 removals, 🔷 0 modifications1.5.1
Features
- #74 NLog Ecs Layout event Enrichment
- #78 NLog EcsLayout - Added support for Log Origin
- #81 add benchmarks for simple serialization cases
- #82 Expose Serialize(StringBuilder) overload
Bug Fixes
View the full list of issues and PRs
1.5.0
1.4.4
1.4.3
Compatibility
Compatible with ECS Schema version: 1.4.0
Fixes
- #62 [BUG] MapHttpAdapter is always null so no data from HttpContext is logged
Examples
- #63 Example to demonstrate registration of the EcsTextFormatter within an AspnetCore application.
View the full list of issues and PRs
1.4.2
1.4.1
Compatibility
Compatible with ECS Schema version: 1.4.0
Features & Enhancements
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. |  |
|---|
- #51 Adds formatting for additional Serilog objects
Fixes
- #42 Fix NullReferenceEception if job is not specified in benchmark configuration.
- #46 Fixes Serilog serialization by ensuring newlines are written to streams.
- #45 Elastic.CommonSchema.BenchmarkDotNetExporter assembly has a private asset reference to the client. This PR removes the
PrivateAssets="all"attribute so that the client reference flows to the project.
1.4.0
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:
- Elastic.CommonSchema.Serilog - Formats a Serilog log message into a JSON representation that can be indexed into Elasticsearch.
- Elastic.Apm.SerilogEnricher - Adds transaction id and trace id to every Serilog log message that is created during a transaction. This works in conjunction with the Elastic.CommonSchema.Serilog package and forms a solution to distributed tracing with Serilog.
- Elastic.Apm.NLog - Introduces two special place holder variables (ElasticApmTraceId, ElasticApmTransactionId) for use within your NLog templates.
- Elastic.CommonSchema.BenchmarkDotNetExporter - An exporter for BenchmarkDotnet that can index benchmarking results directly into Elasticsearch, this can be helpful to detect code-related performance problems over time.
- Elastic.CommonSchema - Foundational project that contains a full C# representation of ECS, used by the other integrations listed above.