<PackageReference Include="System.Diagnostics.DiagnosticSource" Version="8.0.0-preview.1.23110.8" />

---

API Differences between 8.0.0-preview.1.23110.8 and 4.6.0

250 Additions 1 Removals

System.Diagnostics

• public class Activity : IDisposable
  • public struct Enumerator<T>
  • public static Func<ActivityTraceId> TraceIdGenerator { get; set; }
  • public ActivityContext Context { get; }
  • public string DisplayName { get; set; }
  • public IEnumerable<ActivityEvent> Events { get; }
  • public bool HasRemoteParent { get; }
  • public bool IsAllDataRequested { get; set; }
  • public bool IsStopped { get; }
  • public ActivityKind Kind { get; }
  • public IEnumerable<ActivityLink> Links { get; }
  • public ActivitySource Source { get; }
  • public ActivityStatusCode Status { get; }
  • public string StatusDescription { get; }
  • public IEnumerable<KeyValuePair<string, object>> TagObjects { get; }
  • public static event EventHandler<ActivityChangedEventArgs> CurrentChanged
  • public Activity AddEvent(ActivityEvent e)
  • public Activity AddTag(string key, object value)
  • public void Dispose()
  • protected virtual void Dispose(bool disposing)
  • public Enumerator<ActivityEvent> EnumerateEvents()
  • public Enumerator<ActivityLink> EnumerateLinks()
  • public Enumerator<KeyValuePair<string, object>> EnumerateTagObjects()
  • public object GetCustomProperty(string propertyName)
  • public object GetTagItem(string key)
  • public Activity SetBaggage(string key, string value)
  • public void SetCustomProperty(string propertyName, object propertyValue)
  • public Activity SetStatus(ActivityStatusCode code, string description = null)
  • public Activity SetTag(string key, object value)
• public struct ActivityChangedEventArgs
  • public Activity Current { get; set; }
  • public Activity Previous { get; set; }
• public struct ActivityContext : IEquatable<ActivityContext>
  • public bool IsRemote { get; }
  • public ActivitySpanId SpanId { get; }
  • public ActivityTraceFlags TraceFlags { get; }
  • public ActivityTraceId TraceId { get; }
  • public string TraceState { get; }
  • public ActivityContext(ActivityTraceId traceId, ActivitySpanId spanId, ActivityTraceFlags traceFlags, string traceState = null, bool isRemote = false)
  • public static bool op_Equality(ActivityContext left, ActivityContext right)
  • public static bool op_Inequality(ActivityContext left, ActivityContext right)
  • public static ActivityContext Parse(string traceParent, string traceState)
  • public static bool TryParse(string traceParent, string traceState, bool isRemote, out ActivityContext context)
  • public static bool TryParse(string traceParent, string traceState, out ActivityContext context)
  • public bool Equals(ActivityContext value)
• public struct ActivityCreationOptions<T>
  • public ActivityKind Kind { get; }
  • public IEnumerable<ActivityLink> Links { get; }
  • public string Name { get; }
  • public T Parent { get; }
  • public ActivityTagsCollection SamplingTags { get; }
  • public ActivitySource Source { get; }
  • public IEnumerable<KeyValuePair<string, object>> Tags { get; }
  • public ActivityTraceId TraceId { get; }
  • public string TraceState { get; set; }
• public struct ActivityEvent
  • public string Name { get; }
  • public IEnumerable<KeyValuePair<string, object>> Tags { get; }
  • public DateTimeOffset Timestamp { get; }
  • public ActivityEvent(string name)
  • public ActivityEvent(string name, DateTimeOffset timestamp = default, ActivityTagsCollection tags = null)
  • public Enumerator<KeyValuePair<string, object>> EnumerateTagObjects()
• public enum ActivityKind
  • Client = 2
  • Consumer = 4
  • Internal = 0
  • Producer = 3
  • Server = 1
• public struct ActivityLink : IEquatable<ActivityLink>
  • public ActivityContext Context { get; }
  • public IEnumerable<KeyValuePair<string, object>> Tags { get; }
  • public ActivityLink(ActivityContext context, ActivityTagsCollection tags = null)
  • public static bool op_Equality(ActivityLink left, ActivityLink right)
  • public static bool op_Inequality(ActivityLink left, ActivityLink right)
  • public Enumerator<KeyValuePair<string, object>> EnumerateTagObjects()
  • public bool Equals(ActivityLink value)
• public sealed class ActivityListener : IDisposable
  • public Action<Activity> ActivityStarted { get; set; }
  • public Action<Activity> ActivityStopped { get; set; }
  • public SampleActivity<ActivityContext> Sample { get; set; }
  • public SampleActivity<string> SampleUsingParentId { get; set; }
  • public Func<ActivitySource, bool> ShouldListenTo { get; set; }
  • public ActivityListener()
  • public void Dispose()
• public enum ActivitySamplingResult
  • AllData = 2
  • AllDataAndRecorded = 3
  • None = 0
  • PropagationData = 1
• public sealed class ActivitySource : IDisposable
  • public string Name { get; }
  • public string Version { get; }
  • public ActivitySource(string name, string version = "")
  • public static void AddActivityListener(ActivityListener listener)
  • public Activity CreateActivity(string name, ActivityKind kind)
  • public Activity CreateActivity(string name, ActivityKind kind, ActivityContext parentContext, IEnumerable<KeyValuePair<string, object>> tags = null, IEnumerable<ActivityLink> links = null, ActivityIdFormat idFormat = 0)
  • public Activity CreateActivity(string name, ActivityKind kind, string parentId, IEnumerable<KeyValuePair<string, object>> tags = null, IEnumerable<ActivityLink> links = null, ActivityIdFormat idFormat = 0)
  • public void Dispose()
  • public bool HasListeners()
  • public Activity StartActivity(string name = "", ActivityKind kind = 0)
  • public Activity StartActivity(string name, ActivityKind kind, ActivityContext parentContext, IEnumerable<KeyValuePair<string, object>> tags = null, IEnumerable<ActivityLink> links = null, DateTimeOffset startTime = default)
  • public Activity StartActivity(string name, ActivityKind kind, string parentId, IEnumerable<KeyValuePair<string, object>> tags = null, IEnumerable<ActivityLink> links = null, DateTimeOffset startTime = default)
  • public Activity StartActivity(ActivityKind kind, ActivityContext parentContext = default, IEnumerable<KeyValuePair<string, object>> tags = null, IEnumerable<ActivityLink> links = null, DateTimeOffset startTime = default, string name = "")
• public enum ActivityStatusCode
  • Error = 2
  • Ok = 1
  • Unset = 0
• public class ActivityTagsCollection : IDictionary<string, object>, ICollection<KeyValuePair<string, object>>, IEnumerable<KeyValuePair<string, object>>, IEnumerable
  • public struct Enumerator : IEnumerator<KeyValuePair<string, object>>, IEnumerator, IDisposable
  • public int Count { get; }
  • public bool IsReadOnly { get; }
  • public object this[string key] { get; set; }
  • public ICollection<string> Keys { get; }
  • public ICollection<object> Values { get; }
  • public ActivityTagsCollection()
  • public ActivityTagsCollection(IEnumerable<KeyValuePair<string, object>> list)
  • public void Add(string key, object value)
  • public void Add(KeyValuePair<string, object> item)
  • public void Clear()
  • public bool Contains(KeyValuePair<string, object> item)
  • public bool ContainsKey(string key)
  • public void CopyTo(KeyValuePair<string, object>[] array, int arrayIndex)
  • public Enumerator GetEnumerator()
  • public bool Remove(string key)
  • public bool Remove(KeyValuePair<string, object> item)
  • public bool TryGetValue(string key, out object value)
• public class DiagnosticListener : DiagnosticSource, IObservable<KeyValuePair<string, object>>, IDisposable
  • public virtual IDisposable Subscribe(IObserver<KeyValuePair<string, object>> observer, Func<string, object, object, bool> isEnabled, Action<Activity, object> onActivityImport = null, Action<Activity, object> onActivityExport = null)
  • public virtual IDisposable Subscribe(IObserver<KeyValuePair<string, object>> observer, Func<string, object, object, bool> isEnabled, Action<Activity, object> onActivityImport = null, Action<Activity, object> onActivityExport = null)
• public abstract class DiagnosticSource
  • public Activity StartActivity<T>(Activity activity, T args)
  • public void StopActivity<T>(Activity activity, T args)
  • public void Write<T>(string name, T value)
• public abstract class DistributedContextPropagator
  • public sealed delegate PropagatorGetterCallback : MulticastDelegate
  • public sealed delegate PropagatorSetterCallback : MulticastDelegate
  • public static DistributedContextPropagator Current { get; set; }
  • public abstract IReadOnlyCollection<string> Fields { get; }
  • protected DistributedContextPropagator()
  • public static DistributedContextPropagator CreateDefaultPropagator()
  • public static DistributedContextPropagator CreateNoOutputPropagator()
  • public static DistributedContextPropagator CreatePassThroughPropagator()
  • public abstract IEnumerable<KeyValuePair<string, string>> ExtractBaggage(object carrier, PropagatorGetterCallback getter)
  • public abstract void ExtractTraceIdAndState(object carrier, PropagatorGetterCallback getter, out string traceId, out string traceState)
  • public abstract void Inject(Activity activity, object carrier, PropagatorSetterCallback setter)
• public sealed delegate SampleActivity<T> : MulticastDelegate
  • public SampleActivity(object object, IntPtr method)
  • public virtual IAsyncResult BeginInvoke(ref ActivityCreationOptions options, AsyncCallback callback, object object)
  • public virtual ActivitySamplingResult EndInvoke(ref ActivityCreationOptions options, IAsyncResult result)
  • public virtual ActivitySamplingResult Invoke(ref ActivityCreationOptions options)
• public struct TagList : IList<KeyValuePair<string, object>>, ICollection<KeyValuePair<string, object>>, IEnumerable<KeyValuePair<string, object>>, IEnumerable, IReadOnlyList<KeyValuePair<string, object>>, IReadOnlyCollection<KeyValuePair<string, object>>
  • public struct Enumerator : IEnumerator<KeyValuePair<string, object>>, IEnumerator, IDisposable
  • public int Count { get; }
  • public bool IsReadOnly { get; }
  • public KeyValuePair<string, object> this[int index] { get; set; }
  • public TagList(ReadOnlySpan<KeyValuePair<string, object>> tagList)
  • public void Add(string key, object value)
  • public void Add(KeyValuePair<string, object> tag)
  • public void Clear()
  • public bool Contains(KeyValuePair<string, object> item)
  • public void CopyTo(Span<KeyValuePair<string, object>> tags)
  • public void CopyTo(KeyValuePair<string, object>[] array, int arrayIndex)
  • public IEnumerator<KeyValuePair<string, object>> GetEnumerator()
  • public int IndexOf(KeyValuePair<string, object> item)
  • public void Insert(int index, KeyValuePair<string, object> item)
  • public bool Remove(KeyValuePair<string, object> item)
  • public void RemoveAt(int index)

System.Diagnostics.Metrics

• public sealed class Counter<T> : Instrument<T> where T : struct
  • public void Add(T delta)
  • public void Add(T delta, KeyValuePair<string, object> tag)
  • public void Add(T delta, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2)
  • public void Add(T delta, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2, KeyValuePair<string, object> tag3)
  • public void Add(T delta, ReadOnlySpan<KeyValuePair<string, object>> tags)
  • public void Add(T delta, KeyValuePair<string, object>[] tags)
  • public void Add(T delta, ref TagList tagList)
• public sealed class Histogram<T> : Instrument<T> where T : struct
  • public void Record(T value)
  • public void Record(T value, KeyValuePair<string, object> tag)
  • public void Record(T value, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2)
  • public void Record(T value, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2, KeyValuePair<string, object> tag3)
  • public void Record(T value, ReadOnlySpan<KeyValuePair<string, object>> tags)
  • public void Record(T value, KeyValuePair<string, object>[] tags)
  • public void Record(T value, ref TagList tagList)
• public abstract class Instrument
  • public string Description { get; }
  • public bool Enabled { get; }
  • public virtual bool IsObservable { get; }
  • public Meter Meter { get; }
  • public string Name { get; }
  • public string Unit { get; }
  • protected Instrument(Meter meter, string name, string unit, string description)
  • protected void Publish()
• public abstract class Instrument<T> : Instrument where T : struct
  • protected Instrument(Meter meter, string name, string unit, string description)
  • protected void RecordMeasurement(T measurement)
  • protected void RecordMeasurement(T measurement, ReadOnlySpan<KeyValuePair<string, object>> tags)
  • protected void RecordMeasurement(T measurement, KeyValuePair<string, object> tag)
  • protected void RecordMeasurement(T measurement, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2)
  • protected void RecordMeasurement(T measurement, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2, KeyValuePair<string, object> tag3)
  • protected void RecordMeasurement(T measurement, ref TagList tagList)
• public struct Measurement<T> where T : struct
  • public ReadOnlySpan<KeyValuePair<string, object>> Tags { get; }
  • public T Value { get; }
  • public Measurement(T value)
  • public Measurement(T value, IEnumerable<KeyValuePair<string, object>> tags)
  • public Measurement(T value, KeyValuePair<string, object>[] tags)
  • public Measurement(T value, ReadOnlySpan<KeyValuePair<string, object>> tags)
• public sealed delegate MeasurementCallback<T> : MulticastDelegate where T : struct
  • public MeasurementCallback(object object, IntPtr method)
  • public virtual IAsyncResult BeginInvoke(Instrument instrument, T measurement, ReadOnlySpan<KeyValuePair<string, object>> tags, object state, AsyncCallback callback, object object)
  • public virtual void EndInvoke(IAsyncResult result)
  • public virtual void Invoke(Instrument instrument, T measurement, ReadOnlySpan<KeyValuePair<string, object>> tags, object state)
• public class Meter : IDisposable
  • public string Name { get; }
  • public string Version { get; }
  • public Meter(string name)
  • public Meter(string name, string version)
  • public Counter<T> CreateCounter<T>(string name, string unit = null, string description = null) where T : struct
  • public Histogram<T> CreateHistogram<T>(string name, string unit = null, string description = null) where T : struct
  • public ObservableCounter<T> CreateObservableCounter<T>(string name, Func<T> observeValue, string unit = null, string description = null) where T : struct
  • public ObservableCounter<T> CreateObservableCounter<T>(string name, Func<Measurement<T>> observeValue, string unit = null, string description = null) where T : struct
  • public ObservableCounter<T> CreateObservableCounter<T>(string name, Func<IEnumerable<Measurement<T>>> observeValues, string unit = null, string description = null) where T : struct
  • public ObservableGauge<T> CreateObservableGauge<T>(string name, Func<T> observeValue, string unit = null, string description = null) where T : struct
  • public ObservableGauge<T> CreateObservableGauge<T>(string name, Func<Measurement<T>> observeValue, string unit = null, string description = null) where T : struct
  • public ObservableGauge<T> CreateObservableGauge<T>(string name, Func<IEnumerable<Measurement<T>>> observeValues, string unit = null, string description = null) where T : struct
  • public ObservableUpDownCounter<T> CreateObservableUpDownCounter<T>(string name, Func<T> observeValue, string unit = null, string description = null) where T : struct
  • public ObservableUpDownCounter<T> CreateObservableUpDownCounter<T>(string name, Func<Measurement<T>> observeValue, string unit = null, string description = null) where T : struct
  • public ObservableUpDownCounter<T> CreateObservableUpDownCounter<T>(string name, Func<IEnumerable<Measurement<T>>> observeValues, string unit = null, string description = null) where T : struct
  • public UpDownCounter<T> CreateUpDownCounter<T>(string name, string unit = null, string description = null) where T : struct
  • public void Dispose()
• public sealed class MeterListener : IDisposable
  • public Action<Instrument, MeterListener> InstrumentPublished { get; set; }
  • public Action<Instrument, object> MeasurementsCompleted { get; set; }
  • public MeterListener()
  • public object DisableMeasurementEvents(Instrument instrument)
  • public void Dispose()
  • public void EnableMeasurementEvents(Instrument instrument, object state = null)
  • public void RecordObservableInstruments()
  • public void SetMeasurementEventCallback<T>(MeasurementCallback<T> measurementCallback) where T : struct
  • public void Start()
• public sealed class ObservableCounter<T> : ObservableInstrument<T> where T : struct
• public sealed class ObservableGauge<T> : ObservableInstrument<T> where T : struct
• public abstract class ObservableInstrument<T> : Instrument where T : struct
  • protected ObservableInstrument(Meter meter, string name, string unit, string description)
  • protected abstract IEnumerable<Measurement<T>> Observe()
• public sealed class ObservableUpDownCounter<T> : ObservableInstrument<T> where T : struct
• public sealed class UpDownCounter<T> : Instrument<T> where T : struct
  • public void Add(T delta)
  • public void Add(T delta, KeyValuePair<string, object> tag)
  • public void Add(T delta, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2)
  • public void Add(T delta, KeyValuePair<string, object> tag1, KeyValuePair<string, object> tag2, KeyValuePair<string, object> tag3)
  • public void Add(T delta, ReadOnlySpan<KeyValuePair<string, object>> tags)
  • public void Add(T delta, KeyValuePair<string, object>[] tags)
  • public void Add(T delta, ref TagList tagList)