README
¶
OTLP/HTTP Exporter
| Status | |
|---|---|
| Stability | beta: logs |
| stable: traces, metrics | |
| Distributions | core, contrib |
| Issues |   |
Export traces and/or metrics via HTTP using OTLP format.
The following settings are required:
endpoint(no default): The target base URL to send data to (e.g.: https://example.com:4318). To send each signal a corresponding path will be added to this base URL, i.e. for traces "/v1/traces" will appended, for metrics "/v1/metrics" will be appended, for logs "/v1/logs" will be appended.
The following settings can be optionally configured:
traces_endpoint(no default): The target URL to send trace data to (e.g.: https://example.com:4318/v1/traces). If this setting is present theendpointsetting is ignored for traces.metrics_endpoint(no default): The target URL to send metric data to (e.g.: https://example.com:4318/v1/metrics). If this setting is present theendpointsetting is ignored for metrics.logs_endpoint(no default): The target URL to send log data to (e.g.: https://example.com:4318/v1/logs). If this setting is present theendpointsetting is ignored logs.tls: see TLS Configuration Settings for the full set of available options.timeout(default = 30s): HTTP request time limit. For details see https://golang.org/pkg/net/http/#Clientread_buffer_size(default = 0): ReadBufferSize for HTTP client.write_buffer_size(default = 512 * 1024): WriteBufferSize for HTTP client.encoding(default = proto): The encoding to use for the messages (valid options:proto,json)
Example:
exporters:
otlphttp:
endpoint: https://example.com:4318
By default gzip compression is enabled. See compression comparison for details benchmark information. To disable, configure as follows:
exporters:
otlphttp:
...
compression: none
By default proto encoding is used, to change the content encoding of the message configure it as follows:
exporters:
otlphttp:
...
encoding: json
The full list of settings exposed for this exporter are documented here with detailed sample configurations here.
Documentation
¶
Overview ¶
Package otlphttpexporter exports data by using the OTLP format to an HTTP endpoint.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewFactory ¶
NewFactory creates a factory for OTLP exporter.
Types ¶
type Config ¶
type Config struct {
confighttp.ClientConfig `mapstructure:",squash"` // squash ensures fields are correctly decoded in embedded struct.
QueueConfig exporterhelper.QueueSettings `mapstructure:"sending_queue"`
RetryConfig configretry.BackOffConfig `mapstructure:"retry_on_failure"`
// The URL to send traces to. If omitted the Endpoint + "/v1/traces" will be used.
TracesEndpoint string `mapstructure:"traces_endpoint"`
// The URL to send metrics to. If omitted the Endpoint + "/v1/metrics" will be used.
MetricsEndpoint string `mapstructure:"metrics_endpoint"`
// The URL to send logs to. If omitted the Endpoint + "/v1/logs" will be used.
LogsEndpoint string `mapstructure:"logs_endpoint"`
// The encoding to export telemetry (default: "proto")
Encoding EncodingType `mapstructure:"encoding"`
}
Config defines configuration for OTLP/HTTP exporter.
type EncodingType ¶ added in v0.95.0
type EncodingType string
EncodingType defines the type for content encoding
const ( EncodingProto EncodingType = "proto" EncodingJSON EncodingType = "json" )
func (*EncodingType) UnmarshalText ¶ added in v0.95.0
func (e *EncodingType) UnmarshalText(text []byte) error
UnmarshalText unmarshalls text to an EncodingType.
Source Files
Directories