Class GrafanaCloudTelemetryExportOptions
Namespace: Cephalon.Observability.GrafanaCloud.Configuration
Assembly: Cephalon.Observability.GrafanaCloud.dll
Configures Grafana Cloud observability defaults on top of the shared Cephalon telemetry contract.
public sealed class GrafanaCloudTelemetryExportOptionsInheritance
Section titled “Inheritance”object ← GrafanaCloudTelemetryExportOptions
Inherited Members
Section titled “Inherited Members”object.Equals(object?), object.Equals(object?, object?), object.GetHashCode(), object.GetType(), object.ReferenceEquals(object?, object?), object.ToString()
Constructors
Section titled “Constructors”GrafanaCloudTelemetryExportOptions()
Section titled “ GrafanaCloudTelemetryExportOptions()”Initializes a new instance of the
public GrafanaCloudTelemetryExportOptions()Properties
Section titled “Properties”AccessPolicyToken
Section titled “ AccessPolicyToken”Gets or sets the Grafana Cloud access-policy token used as the Basic-auth password when the package should build the Authorization header from structured settings.
public string? AccessPolicyToken { get; set; }Property Value
Section titled “Property Value”Endpoint
Section titled “ Endpoint”Gets or sets the base Grafana Cloud OTLP endpoint used for direct ingestion.
public string? Endpoint { get; set; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Set this to the Grafana Cloud OTLP endpoint generated by the stack administration console.
For OTLP/HTTP the package treats this as the base endpoint and appends the signal-specific
/v1/traces, /v1/metrics, or /v1/logs suffix automatically.
Headers
Section titled “ Headers”Gets or sets the raw OTLP headers string used for direct Grafana Cloud ingestion.
public string? Headers { get; set; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Use the standard OTLP key=value comma-separated format. This value usually comes
directly from the generated OTEL_EXPORTER_OTLP_HEADERS environment variable.
InstanceId
Section titled “ InstanceId”Gets or sets the Grafana Cloud instance identifier used as the Basic-auth username when the package should build the Authorization header from structured settings.
public string? InstanceId { get; set; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”This value is unrelated to the OpenTelemetry service.instance.id resource attribute.
Use it together with
ServiceNamespace
Section titled “ ServiceNamespace”Gets or sets the optional service.namespace resource attribute to stamp onto exported telemetry.
public string? ServiceNamespace { get; set; }Property Value
Section titled “Property Value”UseDirectGrafanaCloudEndpoint
Section titled “ UseDirectGrafanaCloudEndpoint”Gets or sets a value indicating whether the package should target the Grafana Cloud OTLP endpoint when no shared collector endpoint is configured.
public bool UseDirectGrafanaCloudEndpoint { get; set; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”This direct path is intended for the connection details Grafana Cloud generates through
OTEL_EXPORTER_OTLP_ENDPOINT and OTEL_EXPORTER_OTLP_HEADERS. Teams that prefer a
collector or gateway can keep using the shared Endpoint or UseSelfHostedDefaults
contract instead.
Methods
Section titled “Methods”FromConfiguration(IConfiguration, string)
Section titled “ FromConfiguration(IConfiguration, string)”Binds Grafana Cloud telemetry export options from configuration.
public static GrafanaCloudTelemetryExportOptions FromConfiguration(IConfiguration configuration, string sectionPath = "Engine")Parameters
Section titled “Parameters”configuration IConfiguration
The application configuration root.
sectionPath string
The configuration section path that contains the engine settings. The default is Engine.
Returns
Section titled “Returns”GrafanaCloudTelemetryExportOptions
The bound Grafana Cloud telemetry export options.