providers

type BigQueryOptions struct {
	// Project overrides the project carried by the connection.
	Project string `json:"project,omitempty"`

	// Mapping names the columns that carry the message, timestamp and severity.
	// Worth setting: with no mapping the searcher has no defaults to fall back
	// on and every row's message becomes the whole row, stringified.
	Mapping *logs.FieldMappingConfig `json:"mapping,omitempty"`
}

type HTTPOptions struct {
	// URL is an inline HTTP base URL used when no stored connection is referenced.
	URL string `json:"url,omitempty"`

	// Method is the HTTP method (default GET).
	Method string `json:"method,omitempty"`

	// Body is the request body for POST/PUT/PATCH.
	Body string `json:"body,omitempty"`

	// JSONPath extracts an inner array/object from a wrapper response,
	// e.g. "$.Traces" for {"Traces": [...]}.
	JSONPath string `json:"jsonpath,omitempty"`
}

type JaegerOptions struct {
	// URL is an inline Jaeger query base URL used when no stored connection is referenced.
	URL string `json:"url,omitempty"`

	Service     string `json:"service,omitempty"`
	Operation   string `json:"operation,omitempty"`
	Lookback    string `json:"lookback,omitempty"`
	Start       string `json:"start,omitempty"`
	End         string `json:"end,omitempty"`
	Limit       string `json:"limit,omitempty"`
	MinDuration string `json:"minDuration,omitempty"`
	MaxDuration string `json:"maxDuration,omitempty"`
	Tags        string `json:"tags,omitempty"`
}

type OpenSearchOptions struct {
	// Address is an inline OpenSearch URL used when no stored connection is referenced.
	Address string `json:"address,omitempty"`

	// Index is the OpenSearch index to query.
	Index string `json:"index,omitempty"`

	// Limit is the maximum number of hits to return.
	Limit string `json:"limit,omitempty"`

	// Search is the structured search specification. It is mutually exclusive
	// with the profile's raw query.
	Search *esdsl.Search `json:"search,omitempty"`

	// TailPoll is how long a caught-up tail waits before asking the index
	// again. Empty is openSearchDefaultTailPoll. It has no effect on a query.
	TailPoll string `json:"tailPoll,omitempty"`

	// TailLag holds a tail's cursor that far behind now, so a document indexed
	// later than it was written still lands ahead of the cursor rather than
	// behind it. Empty is no lag: lines appear as soon as they are searchable,
	// and one that arrives late is never emitted. See openSearchTailBound.
	TailLag string `json:"tailLag,omitempty"`
}

type OpenSearchTimeFieldMappingRequest struct {
	Searcher   *opensearch.Searcher
	Index      string
	Search     esdsl.Search
	Params     []esdsl.ParamBinding
	Inspection query.InspectionOptions
}

type OpenTelemetryOptions struct {
	Format         string   `json:"format,omitempty"`
	Index          string   `json:"index,omitempty"`
	DateField      string   `json:"dateField,omitempty"`
	TraceIDField   string   `json:"traceIdField,omitempty"`
	SpanIDField    string   `json:"spanIdField,omitempty"`
	ParentIDField  string   `json:"parentIdField,omitempty"`
	ParentRefType  string   `json:"parentRefType,omitempty"`
	ServiceField   string   `json:"serviceField,omitempty"`
	OperationField string   `json:"operationField,omitempty"`
	StatusFields   []string `json:"statusFields,omitempty"`
	SelectFields   []string `json:"selectFields,omitempty"`
	SourceExcludes []string `json:"sourceExcludes,omitempty"`
	Limit          int      `json:"limit,omitempty"`

	// Search is the structured search specification. The trace-shaped options
	// above fill whatever it leaves unset.
	Search *esdsl.Search `json:"search,omitempty"`
}

type OpenTelemetryRead struct {
	// Connection is the opentelemetry connection, and Options the
	// opentelemetry provider's options for its index and fields.
	Connection string
	Options    map[string]any
	// From and To bound the read on the date field, as date math such as
	// now-1h or RFC3339; empty leaves that side open.
	From, To string
	// Follow keeps reading the spans indexed after the read caught up, until
	// ctx ends; it has no To.
	Follow bool
	// Poll is how long a caught-up follow waits before asking again; zero is
	// two seconds. Lag holds a follow behind now, so spans indexed late still
	// land before the read passes their instant.
	Poll, Lag time.Duration
}

type PostgRESTOptions struct {
	// URL is an inline PostgREST base URL used when no stored connection is referenced.
	URL string `json:"url,omitempty"`

	// JSONPath optionally extracts an inner array from the response.
	JSONPath string `json:"jsonpath,omitempty"`
}

type PrometheusOptions struct {
	// Language is promql (the default) or sql, which runs metric SQL over range samples.
	Language string `json:"language,omitempty"`

	// URL is an inline Prometheus address used when no stored connection is referenced.
	URL string `json:"url,omitempty"`

	// Range, when set, runs a PromQL range query.
	Range *PrometheusRange `json:"range,omitempty"`

	// SelectLabels restricts result labels to a deterministic subset.
	SelectLabels []string `json:"selectLabels,omitempty"`
}

type PrometheusRange struct {
	Start string `json:"start"`
	End   string `json:"end"`
	Step  string `json:"step"`
}