Integrations: Configuration
-
Use the configuration keys listed below to set the SNMP and OpenTelemetry integration options for your RavenDB server.
-
Learn how to set these keys in the configuration overview.
-
The general monitoring keys (CPU and disk metrics collection) are listed in the monitoring configuration page.
-
In this article:
- SNMP configuration keys
Monitoring.Snmp.AuthenticationPassword
Monitoring.Snmp.AuthenticationPassword.Secondary
Monitoring.Snmp.AuthenticationProtocol
Monitoring.Snmp.AuthenticationProtocol.Secondary
Monitoring.Snmp.AuthenticationUser
Monitoring.Snmp.AuthenticationUser.Secondary
Monitoring.Snmp.Community
Monitoring.Snmp.DisableTimeWindowChecks
Monitoring.Snmp.Enabled
Monitoring.Snmp.Port
Monitoring.Snmp.PrivacyPassword
Monitoring.Snmp.PrivacyPassword.Secondary
Monitoring.Snmp.PrivacyProtocol
Monitoring.Snmp.PrivacyProtocol.Secondary
Monitoring.Snmp.SupportedVersions - OpenTelemetry configuration keys
Monitoring.OpenTelemetry.ConsoleExporter
Monitoring.OpenTelemetry.Enabled
Monitoring.OpenTelemetry.Meters.AspNetCore.Enabled
Monitoring.OpenTelemetry.Meters.Runtime.Enabled
Monitoring.OpenTelemetry.Meters.Server.CPUCredits.Enabled
Monitoring.OpenTelemetry.Meters.Server.Enabled
Monitoring.OpenTelemetry.Meters.Server.GC.Enabled
Monitoring.OpenTelemetry.Meters.Server.General.Enabled
Monitoring.OpenTelemetry.Meters.Server.Requests.Enabled
Monitoring.OpenTelemetry.Meters.Server.Resources.Enabled
Monitoring.OpenTelemetry.Meters.Server.Storage.Enabled
Monitoring.OpenTelemetry.Meters.Server.TotalDatabases.Enabled
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Enabled
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Endpoint
Monitoring.OpenTelemetry.OpenTelemetryProtocol.ExportProcessorType
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Headers
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Protocol
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Timeout
Monitoring.OpenTelemetry.ServiceInstanceId
Monitoring.OpenTelemetry.ServiceName
Monitoring.OpenTelemetry.ServiceNamespace
- SNMP configuration keys
SNMP configuration keys
Monitoring.Snmp.AuthenticationPassword
Authentication password used for SNMP v3 authentication.
When set to null, the value from Monitoring.Snmp.Community is used.
- Type:
string - Default:
null - Scope: Server-wide only
Monitoring.Snmp.AuthenticationPassword.Secondary
Authentication password used by secondary user for SNMP v3 authentication.
- Type:
string - Default:
null - Scope: Server-wide only
Monitoring.Snmp.AuthenticationProtocol
Authentication protocol used for SNMP v3 authentication.
- Type:
SnmpAuthenticationProtocol - Default:
SHA1 - Scope: Server-wide only
Monitoring.Snmp.AuthenticationProtocol.Secondary
Authentication protocol used by secondary user for SNMP v3 authentication.
- Type:
SnmpAuthenticationProtocol - Default:
SHA1 - Scope: Server-wide only
Monitoring.Snmp.AuthenticationUser
Authentication user used for SNMP v3 authentication.
- Type:
string - Default:
"ravendb" - Scope: Server-wide only
Monitoring.Snmp.AuthenticationUser.Secondary
Authentication secondary user used for SNMP v3 authentication.
- Type:
string - Default:
null (disabled) - Scope: Server-wide only
Monitoring.Snmp.Community
Community string used for SNMP v2c authentication.
- Type:
string - Default:
"ravendb" - Scope: Server-wide only
Monitoring.Snmp.DisableTimeWindowChecks
EXPERT ONLY.
Disables time window checks, which are problematic for some SNMP engines.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.Snmp.Enabled
Indicates if SNMP endpoint is enabled or not.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.Snmp.Port
Port at which SNMP listener will be active.
- Type:
int - Default:
161 - Scope: Server-wide only
Monitoring.Snmp.PrivacyPassword
Privacy password used for SNMP v3 privacy.
- Type:
string - Default:
"ravendb" - Scope: Server-wide only
Monitoring.Snmp.PrivacyPassword.Secondary
Privacy password used by secondary user for SNMP v3 privacy.
- Type:
string - Default:
null - Scope: Server-wide only
Monitoring.Snmp.PrivacyProtocol
Privacy protocol used for SNMP v3 privacy.
- Type:
SnmpPrivacyProtocol - Default:
SnmpPrivacyProtocol.None - Scope: Server-wide only
Monitoring.Snmp.PrivacyProtocol.Secondary
Privacy protocol used by secondary user for SNMP v3 privacy.
- Type:
SnmpPrivacyProtocol - Default:
SnmpPrivacyProtocol.None - Scope: Server-wide only
Monitoring.Snmp.SupportedVersions
List of supported SNMP versions. Values must be semicolon separated.
- Type:
string[] - Default:
V2C;V3 - Scope: Server-wide only
OpenTelemetry configuration keys
Monitoring.OpenTelemetry.ConsoleExporter
Indicates if metrics should be exported to the console output.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.OpenTelemetry.Enabled
Indicates if OpenTelemetry is enabled or not.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.AspNetCore.Enabled
Indicates if AspNetCore metric is enabled or not.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Runtime.Enabled
Indicates if Runtime metric is enabled or not.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.CPUCredits.Enabled
Expose metrics related to CPU credits.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.Enabled
Indicates if RavenDB's OpenTelemetry metrics are enabled or not.
- Type:
bool - Default:
true - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.GC.Enabled
Expose metrics related to GC.
- Type:
bool - Default:
false - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.General.Enabled
Expose metrics related to general information about the cluster and its licensing.
- Type:
bool - Default:
true - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.Requests.Enabled
Expose metrics related to requests.
- Type:
bool - Default:
true - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.Resources.Enabled
Expose metrics related to resources usage.
- Type:
bool - Default:
true - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.Storage.Enabled
Expose metrics related to server storage.
- Type:
bool - Default:
true - Scope: Server-wide only
Monitoring.OpenTelemetry.Meters.Server.TotalDatabases.Enabled
Expose metrics related to aggregated database statistics.
- Type:
bool - Default:
true - Scope: Server-wide only
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Enabled
Indicates if metrics should be exported via the OpenTelemetry protocol.
- Type:
bool - Default:
true - Scope: Server-wide only
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Endpoint
Endpoint where OpenTelemetryProtocol should sends data.
- Type:
string - Default:
null(internal OTLP default settings) - Scope: Server-wide only
Monitoring.OpenTelemetry.OpenTelemetryProtocol.ExportProcessorType
OpenTelemetryProtocol export processor type.
- Type:
enum ExportProcessorType(Simple | Batch) - Default:
null - Scope: Server-wide only
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Headers
OpenTelemetryProtocol custom headers.
- Type:
string - Default:
null - Scope: Server-wide only
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Protocol
Defines the protocol that OpenTelemetryProtocol should use to send data.
- Type:
enum OtlpExportProtocol(Grpc | HttpProtobuf) - Default:
null(internal OTLP default settings) - Scope: Server-wide only
Monitoring.OpenTelemetry.OpenTelemetryProtocol.Timeout
OpenTelemetryProtocol timeout value.
- Type:
int? - Default:
null - Scope: Server-wide only
Monitoring.OpenTelemetry.ServiceInstanceId
-
OpenTelemetry monitoring requires a service instance ID for initialization.
You can set the OpenTelemetry service instance ID using this configuration option. -
If this configuration key is not set, RavenDB will default to using the server's public URL hostname.
If the public hostname is unavailable, RavenDB will use the node tag as the identifier.
- Type:
string - Default:
null - Scope: Server-wide only
Monitoring.OpenTelemetry.ServiceName
-
Sets the OpenTelemetry service name. This value is reported as the
service.nameresource attribute and is used to identify the RavenDB service in observability tools, such as the .NET Aspire dashboard. -
If Monitoring.OpenTelemetry.Enabled is set to
true, the effective value must not benull, empty, or whitespace.
Otherwise, the server will fail to start.
- Type:
string - Default:
server - Scope: Server-wide only
Monitoring.OpenTelemetry.ServiceNamespace
-
Sets the OpenTelemetry service namespace. This value is reported as the
service.namespaceresource attribute and is used to group related services together in observability tools. -
If Monitoring.OpenTelemetry.Enabled is set to
true, the effective value must not benull, empty, or whitespace.
Otherwise, the server will fail to start.
- Type:
string - Default:
ravendb - Scope: Server-wide only