18 KiB
Changelog
Unreleased
-
Renamed
HistogramConfigurationtoExplicitBucketHistogramConfigurationand changed its memberBucketBoundstoBoundaries. (#2638) -
Metrics with the same name but from different meters are allowed. (#2634)
-
Metrics SDK will not provide inactive Metrics to delta exporter. (#2629)
-
Histogram bounds are validated when added to a View. (#2573)
-
Changed
BatchExportActivityProcessorOptionsconstructor to throwFormatExceptionif it fails to parse any of the supported environment variables. -
Added
BaseExporter.ForceFlush. (#2525) -
Exposed public
Batch(T[] items, int count)constructor onBatch<T>struct (#2542) -
Added wildcard support for AddMeter. (#2459)
-
Add support for multiple Metric readers (#2596)
-
Add ability to configure MaxMetricStreams, MaxMetricPointsPerMetricStream (#2635)
1.2.0-beta1
Released 2021-Oct-08
-
Exception from Observable instrument callbacks does not result in entire metrics being lost.
-
SDK is allocation-free on recording of measurements with upto 8 tags.
-
TracerProviderBuilder.AddLegacySource now supports wildcard activity names. (#2183)
-
Instrument and View names are validated according with the spec. (#2470)
1.2.0-alpha4
Released 2021-Sep-23
BatchExportProcessor.OnShutdownwill now log the count of dropped telemetry items. (#2331)- Changed
CompositeProcessor<T>.OnForceFlushto meet with the spec requirement. Now the SDK will invokeForceFlushon all registered processors, even if there is a timeout. (#2388)
1.2.0-alpha3
Released 2021-Sep-13
-
Metrics perf improvements, bug fixes. Replace MetricProcessor with MetricReader. (#2306)
-
Add
BatchExportActivityProcessorOptionswhich supports field value overriding usingOTEL_BSP_SCHEDULE_DELAY,OTEL_BSP_EXPORT_TIMEOUT,OTEL_BSP_MAX_QUEUE_SIZE,OTEL_BSP_MAX_EXPORT_BATCH_SIZEenvionmental variables as defined in the specification. (#2219)
1.2.0-alpha2
Released 2021-Aug-24
-
More Metrics features. All instrument types, push/pull exporters, Delta/Cumulative temporality supported.
-
ResourceBuilder.CreateDefaulthas detectors forOTEL_RESOURCE_ATTRIBUTES,OTEL_SERVICE_NAMEenvironment variables so that explicitAddEnvironmentVariableDetectorcall is not needed. (#2247) -
ResourceBuilder.AddEnvironmentVariableDetectorhandlesOTEL_SERVICE_NAMEenvironmental variable. (#2209) -
Removes upper constraint for Microsoft.Extensions.Logging dependencies. (#2179)
-
OpenTelemetryLogger modified to not throw, when the formatter supplied in ILogger.Log call is null. (#2200)
1.2.0-alpha1
Released 2021-Jul-23
-
Add basic Metrics support with a single pipeline, and supporting Counter (sync) instrument. Push and Pull exporters are supported. (#2174)
-
Removes .NET Framework 4.5.2, .NET 4.6 support. The minimum .NET Framework version supported is .NET 4.6.1. (#2138)
1.1.0
Released 2021-Jul-12
1.1.0-rc1
Released 2021-Jun-25
- Moved
IDeferredTracerProviderBuilderto API library. (#2058)
1.1.0-beta4
Released 2021-Jun-09
1.1.0-beta3
Released 2021-May-11
-
AddLegacySource()moved out ofTracerProviderBuilderExtensionsand into public API (#2019) -
Fixed an issue causing inconsistent log scopes when using
BatchLogRecordExportProcessor. To make parsing scopes easier theLogRecord.ForEachScopesignature has been changed to receive instances ofLogRecordScope(a new type which implementsIEnumerator<KeyValuePair<string, object>>for accessing scope items) (#2026)
1.1.0-beta2
Released 2021-Apr-23
- Use
AssemblyFileVersionAttributeinstead ofFileVersionInfo.GetVersionInfoto get the SDK version attribute to ensure that it works when the assembly is not loaded directly from a file on disk (#1908)
1.1.0-beta1
Released 2021-Mar-19
-
Removed SuppressScope Increment/Decrement from DiagnosticSourceListeners. (1893)
-
Added
TracerProviderBuilder.SetErrorStatusOnExceptionwhich automatically sets the activity status toErrorwhen exception happened. (#1858 #1875) -
Added
ForceFlushtoTracerProvider. (#1837) -
Added a TracerProviderBuilder extension method called
AddLegacySourcewhich is used by instrumentation libraries that use DiagnosticSource to get activities processed without ActivitySourceAdapter. #1836 #1860 -
Added new constructor with optional parameters to allow customization of
ParentBasedSamplerbehavior. (#1727) -
The application base directory is now tested after the current directory when searching for the self diagnostic configuration file. (#1865)
-
Resource Attributes now accept primitive arrays as values. (#1852)
-
Fixed #1846:
ParentBasedSamplerwill no longer explicitly consider Activity links. (#1851) -
Added
IncludeScopes,IncludeFormattedMessage, &ParseStateValuesonOpenTelemetryLoggerOptions. AddedFormattedMessage,StateValues, &ForEachScopeonLogRecord. (#1869 & #1883) -
Added
SetResourceBuildersupport toOpenTelemetryLoggerOptions. (#1913) -
Added
IDeferredTracerProviderBuilderandTracerProviderBuilderBaseto support dependency injection through OpenTelemetry.Extensions.Hosting. (#1889)
1.0.1
Released 2021-Feb-10
1.0.0-rc4
Released 2021-Feb-09
1.0.0-rc3
Released 2021-Feb-04
- Default
Resourcewill now contain service.name instead of Telemetry SDK. (#1744) - Added GetDefaultResource() method to
Provider. (#1768)
1.0.0-rc2
Released 2021-Jan-29
- The following extension methods on
ResourceBuilderhas been moved from theOpenTelemetrynamespace to theOpenTelemetry.Resourcesnamespace:AddEnvironmentVariableDetector,AddAttributes,AddService, andAddTelemetrySdk. (#1576) - Metrics API/SDK support is in an experimental state and is not recommended for
production use. All metric APIs have been marked with the
Obsoleteattribute. See #1501 for more information. (#1611) - Modified SimpleExportProcessor and BatchExportProcessor to abstract classes; Added SimpleActivityExportProcessor, SimpleLogRecordExportProcessor, BatchActivityExportProcessor, BatchLogRecordExportProcessor; Added the check for Activity.Recorded in SimpleActivityExportProcessor and BatchActivityExportProcessor (#1622)
- Added check in
ActivitySourceAdapterclass for root activity if traceid is overridden by callingSetParentId(#1355) - Resource Attributes now accept int, short, and float as values, converting them to supported data types (long for int/short, double for float). For invalid attributes we now throw an exception instead of logging an error. (#1720)
- Merging "this" resource with an "other" resource now prioritizes the "other" resource's attributes in a conflict. We've rectified to follow a recent change to the spec. We previously prioritized "this" resource's tags. (#1728)
BatchExportProcessorwill now flush any remaining spans left in aBatchafter the export operation has completed. (#1726)- Fixed a bug to allow the Self Diagnostics log file to be opened simutaneously by another process in read-only mode for .NET Framework. (#1693)
- Metrics removed as it is not part 1.0.0 release. See issue #1501 for details on Metric release plans.
- Fix Resource attribute telemetry.sdk.version to have correct file version.
- Metrics removed as it is not part 1.0.0 release. See issue #1501 for details on Metric release plans.
1.0.0-rc1.1
Released 2020-Nov-17
- Removed
GetResourceandSetResourceActivityextension methods. AddedGetResourceextension method onBaseProvider(#1463) - Added
ParentProviderproperty onBaseProcessorandBaseExporterclasses. (#1463) Resourceis no longer added to observedActivityobjects as aCustomProperty. (#1463)- Removed
ReentrantExportProcessoras it is not required by spec. (#1496) ActivitySourceAdaptersupports settingActivitySourcefor Activities created withoutActivitySource. (#1515)- Implemented
ShutdownforTracerProvider. (#1489) Resources.CreateServiceResourcehas been removed in favor of theResourceBuilderAPI. (#1533)TracerProviderBuilder.SetResourcehas been changed toTracerProviderBuilder.SetResourceBuilder. (#1533)- By default
TracerProviderwill set aResourcecontaining Telemetry SDK details (#1533):telemetry.sdk.name=opentelemetrytelemetry.sdk.language=dotnettelemetry.sdk.version= [SDK version]
Resourceconstructor marked as internal, asResourceBuilderis the recommended API to build resources. (#1566)- Changed BaseExportProcessor to have it override OnExport instead of OnEnd; Added check for ActivityTraceFlags to BaseExportProcessor OnEnd (#1574)
0.8.0-beta.1
Released 2020-Nov-5
- TracerProviderBuilder API changes Renamed AddInstrumentation to AddDiagnosticSourceInstrumentation and made internal. Added AddInstrumentation (#1454)
- DiagnosticSource subscription helper classes (DiagnosticSourceSubscriber, ListenerHandler,PropertyFetcher) are made internal.
0.7.0-beta.1
Released 2020-Oct-16
- Changed
ActivityExporter.OnShutdown,ActivityExporter.Shutdown,ActivityProcessor.OnShutdownandActivityProcessor.Shutdownto return boolean value (#1282 #1285) - Renamed
SamplingDecisionoptions (NotRecordtoDrop,RecordtoRecordOnly, andRecordAndSampledtoRecordAndSample) (#1297) - Added
ILogger/Microsoft.Extensions.Loggingintegration (#1308 #1315) - Changed exporter and processor to generic types
(#1328):
ActivityExporterchanged toBaseExporter<Activity>ActivityProcessorchanged toBaseProcessor<Activity>BatchExportActivityProcessorchanged toBatchExportProcessor<Activity>ReentrantExportActivityProcessorchanged toReentrantExportProcessor<Activity>SimpleExportActivityProcessorchanged toSimpleExportProcessor<Activity>
0.6.0-beta.1
Released 2020-Sep-15
- Fixes 953
- Changes arising from
DiagnosticSourcechanges (#1203) PropertyFetcheris now public (#1232)PropertyFetcherchanged toPropertyFetcher<T>(#1238)
0.5.0-beta.2
Released 2020-08-28
- Changed
ActivityProcessorto implementIDisposable(#975) - Samplers now get the actual TraceId of the Activity to be created. (#1007)
- Changed the default sampler from
AlwaysOntoParentOrElse(AlwaysOn)to match the spec (#1013) - Added
SuppressInstrumentationScopeAPI (#988 #1067) - Changed
BroadcastActivityProcessortoFanOutActivityProcessor(#1015) - Changed
TracerProviderBuilderandTracerProviderSdkdesign to simply the flow and usage (#1008 #1027 #1035) - Changed
AddActivitySourcetoAddSourcewith params support (#1036) - Modified Sampler implementation to match the spec (#1037)
- Refactored simple export and batch export APIs (#1078 #1081 #1083 #1085 #1087 #1094 #1113 #1127 #1129 #1135)
- Changed
MeterProviderBuilderandMeterProviderSdkdesign to simply the flow and usage (#1149) - Renamed
ParentOrElseSamplertoParentBasedSampler(#1173) - Renamed
ProbabilitySamplertoTraceIdRatioBasedSampler(#1174)
0.4.0-beta.2
Released 2020-07-24
- First beta release
0.3.0-beta
Released 2020-07-23
- Initial release