Class LoggerOptions (4.4.0)

[Obsolete("Use Google.Cloud.Diagnostics.Common.LoggingOptions andGoogle.Cloud.Diagnostics.Common.LoggingServiceOptions instead.")]
public sealed class LoggerOptions

Options for a GoogleLogger.

Inheritance

Object > LoggerOptions

Namespace

Google.Cloud.Diagnostics.AspNetCore

Assembly

Google.Cloud.Diagnostics.AspNetCore.dll

Properties

BufferOptions

public BufferOptions BufferOptions { get; }

The buffer options for the logger.

Property Value
TypeDescription
BufferOptions

Labels

public Dictionary<string, string> Labels { get; }

Custom labels for log entries.

Property Value
TypeDescription
Dictionary<String, String>
Remarks

Keys and values added to Labels should not be null. If they are, an exception will be throw when attempting to log an entry. The entry won't be logged and the exception will be propagated depending on the value of ExceptionHandling.

LoggerDiagnosticsOutput

public TextWriter LoggerDiagnosticsOutput { get; }

A TextWriter to write diagnostics info about loggers created with these LoggerOptions. Currently the only diagnostics info we provide is the URL where the logs written with these options can be found.

Property Value
TypeDescription
TextWriter

LogLevel

public LogLevel LogLevel { get; }

The minimum log level.

Property Value
TypeDescription
LogLevel

LogName

public string LogName { get; }

The name for the all logs.

Property Value
TypeDescription
String

MonitoredResource

public MonitoredResource MonitoredResource { get; }
Property Value
TypeDescription
MonitoredResource

RetryOptions

public RetryOptions RetryOptions { get; }

The retry options for the logger.

Property Value
TypeDescription
RetryOptions

ServiceName

public string ServiceName { get; }

An identifier of the service, such as the name of the executable or job. May be null. When set, it will be included in the

serviceContext
field of the log entry JSON payload.

Property Value
TypeDescription
String

Version

public string Version { get; }

A string that represents the version of the service or the source code that logs are written for. When set, it will be included in the

serviceContext
field of the log entry JSON payload.

Property Value
TypeDescription
String

Methods

Create(LogLevel, String, Dictionary<String, String>, MonitoredResource, BufferOptions, RetryOptions, TextWriter)

public static LoggerOptions Create(LogLevel logLevel = LogLevel.Information, string logName = null, Dictionary<string, string> labels = null, MonitoredResource monitoredResource = null, BufferOptions bufferOptions = null, RetryOptions retryOptions = null, TextWriter loggerDiagnosticsOutput = null)

Create a new instance of LoggerOptions.

Parameters
NameDescription
logLevelLogLevel

Optional, the minimum log level. Defaults to Information

logNameString

Optional, the name of the log. Defaults to 'aspnetcore'.

labelsDictionary<String, String>

Optional, custom labels to be added to log entries. Keys and values added to labels should not be null. If they are, an exception will be throw when attempting to log an entry. The entry won't be logged and the exception will be propagated depending on the value of ExceptionHandling.

monitoredResourceMonitoredResource

Optional, the monitored resource. The monitored resource will be automatically detected if it is not set and will default to the global resource if the detection fails. See: https://cloud.google.com/logging/docs/api/v2/resource-list

bufferOptionsBufferOptions

Optional, the buffer options. Defaults to a Timed

retryOptionsRetryOptions

Optional, the retry options. Defaults to a None

loggerDiagnosticsOutputTextWriter

Optional. If set some logger diagnostics info will be written to the given TextWriter. Currently the only diagnostics info we provide is the URL where the logs written with these options can be found.

Returns
TypeDescription
LoggerOptions

CreateWithDetectedServiceContext(LogLevel, String, Dictionary<String, String>, MonitoredResource, BufferOptions, RetryOptions, TextWriter)

public static LoggerOptions CreateWithDetectedServiceContext(LogLevel logLevel = LogLevel.Information, string logName = null, Dictionary<string, string> labels = null, MonitoredResource monitoredResource = null, BufferOptions bufferOptions = null, RetryOptions retryOptions = null, TextWriter loggerDiagnosticsOutput = null)

Create a new instance of LoggerOptions with default service context. If monitoredResource is provided, the service context will be obtained from it. Else, if running on GAE, the service context will be obtained from the platform.

Parameters
NameDescription
logLevelLogLevel

Optional, the minimum log level. Defaults to Information

logNameString

Optional, the name of the log. Defaults to 'aspnetcore'.

labelsDictionary<String, String>

Optional, custom labels to be added to log entries. Keys and values added to labels should not be null. If they are, an exception will be throw when attempting to log an entry. The entry won't be logged and the exception will be propagated depending on the value of ExceptionHandling.

monitoredResourceMonitoredResource

Optional, the monitored resource. The monitored resource will be automatically detected if it is not set and will default to the global resource if the detection fails. See: https://cloud.google.com/logging/docs/api/v2/resource-list

bufferOptionsBufferOptions

Optional, the buffer options. Defaults to a Timed

retryOptionsRetryOptions

Optional, the retry options. Defaults to a None

loggerDiagnosticsOutputTextWriter

Optional. If set some logger diagnostics info will be written to the given TextWriter. Currently the only diagnostics info we provide is the URL where the logs written with these options can be found.

Returns
TypeDescription
LoggerOptions

CreateWithServiceContext(LogLevel, String, Dictionary<String, String>, MonitoredResource, BufferOptions, RetryOptions, TextWriter, String, String)

public static LoggerOptions CreateWithServiceContext(LogLevel logLevel = LogLevel.Information, string logName = null, Dictionary<string, string> labels = null, MonitoredResource monitoredResource = null, BufferOptions bufferOptions = null, RetryOptions retryOptions = null, TextWriter loggerDiagnosticsOutput = null, string serviceName = null, string version = null)

Create a new instance of LoggerOptions.

Parameters
NameDescription
logLevelLogLevel

Optional, the minimum log level. Defaults to Information

logNameString

Optional, the name of the log. Defaults to 'aspnetcore'.

labelsDictionary<String, String>

Optional, custom labels to be added to log entries. Keys and values added to labels should not be null. If they are, an exception will be throw when attempting to log an entry. The entry won't be logged and the exception will be propagated depending on the value of ExceptionHandling.

monitoredResourceMonitoredResource

Optional, the monitored resource. The monitored resource will be automatically detected if it is not set and will default to the global resource if the detection fails. See: https://cloud.google.com/logging/docs/api/v2/resource-list

bufferOptionsBufferOptions

Optional, the buffer options. Defaults to a Timed

retryOptionsRetryOptions

Optional, the retry options. Defaults to a None

loggerDiagnosticsOutputTextWriter

Optional. If set some logger diagnostics info will be written to the given TextWriter. Currently the only diagnostics info we provide is the URL where the logs written with these options can be found.

serviceNameString

A string that represents the version of the service or the source code that logs are written for. When set, it will be included in the

serviceContext
field of the log entry JSON payload.

versionString

A string that represents the version of the service or the source code that logs are written for. When set, it will be included in the

serviceContext
field of the log entry JSON payload.

Returns
TypeDescription
LoggerOptions