Microsoft.VisualStudio.LiveShare.Tracing
Supports formatting various fields for logging purposes, including optional
hashing of potentially sensitive information to protect privacy.
This class implements `IFormatProvider`, so an instance can be passed as the
first parameter to `String.Format()`. For example this line:
String.Format(new DataFormatter(), "{0:P}", filePath);
will use the `DataFormatter` to hash the file path when formatting it.
Use an instance of this class as the format provider for a class that extends
`TraceListenerBase` to enable smart formatting of traced data objects.
Registers a format for a data contract class. Equivalent to applying a `[DataFormat]`
attribute to the class.
Registers a format for a property. Equivalent to applying a `[DataFormat]` attribute
to the property.
Formats an object using the object's default format.
This static method does NOT use hashing, regardless of any instance setting.
Manages a key used to hash sensitive data to ensure privacy.
Once generated (or set by a client), the key is stored in .NET isolated storage,
so that it remains consistent across sessions. The key does not need to be
stored in a secure vault because it is only used as an HMAC key for hashing
the current user's data for tracing and telemetry; the hashed data is then
uploaded without the key.
Gets the key, generating it if not found in storage,
or sets the key and stores it for later use.
Writes trace events to stdout.
Abstract thread-safe trace listener that puts events into a queue and writes them asynchronously
Writes trace events (with basic metadata) to a log file in the temp directory.
Enables filtering based on a combination of trace source name and trace level.
Creates a new filter with a default level and optional specific levels for
certain sources.
Default levels to be traced, for sources for which
no specific levels are specified.
Optional mapping from source names to trace levels,
to use non-default levels for specific components.
Optional enumeration of event ids that go to console unfiltered, ignoring console verbosity.
Async trace source that doesn't use trace global lock, .
To avoid race enumerating TraceListeners (which the global lock protects against),
add thread-safe trace listeners first, then call .
After that methods will use the snapshot and avoid the lock.
Initializes a new instance of class, using
the specified name for the source.
The name of the source (typically, the name of the application).
name is null.
name is an empty string ("").
Initializes a new instance of the class, using
the specified name for the source and the default source level at which tracing
is to occur.
The name of the source, typically the name of the application.
A bitwise combination of the enumeration values that specifies the default source
level at which to trace.
name is null.
name is an empty string ("").
Get a value indicating whether the async trace source is configured and ready to run trace listeners async
Add a thread-safe trace listener and capture trace listeners snapshot.
A thread-safe trace listener
If is null.
If is not thread-safe.
Assert that all trace listeners are thread-safe (see cref="TraceListener.IsThreadSafe"/> true) and
and captures a snapshot of them to be used for tracing events via AsyncTraceEvent.
No trace listeners registered, or some of trace listeners are not thread safe.
Parses trace output to extract an event id associated with the message.
Trace output line.
Event ID or null if the line doesn't match expected pattern
Abstract thread-safe trace listener
Trace event data that can be created at the time of tracing and traced later by trace listener in the background.
This object captures the trace event data (e.g. exact time and call stack)
and then trace listener could use this data later.
Trace message formatted by the trace listener.
Trace event type.
Write HTTP request and response details to a trace source.
True to turn on tracing of request and response headers. Off by default.
True trace request and response body content. Off by default.
Note trace listeners may truncate tracing messages to some reasonable length.