package loki import ( "bytes" "context" "encoding/json" "fmt" "io" "net/http" "net/url" "path" "strconv" "github.com/grafana/grafana-plugin-sdk-go/data" jsoniter "github.com/json-iterator/go" "github.com/grafana/grafana/pkg/infra/log" "github.com/grafana/grafana/pkg/infra/tracing" "github.com/grafana/grafana/pkg/util/converter" ) type LokiAPI struct { client *http.Client url string log log.Logger } type RawLokiResponse struct { Body []byte Status int Encoding string } func newLokiAPI(client *http.Client, url string, log log.Logger) *LokiAPI { return &LokiAPI{client: client, url: url, log: log} } func makeDataRequest(ctx context.Context, lokiDsUrl string, query lokiQuery) (*http.Request, error) { qs := url.Values{} qs.Set("query", query.Expr) qs.Set("direction", string(query.Direction)) // MaxLines defaults to zero when not received, // and Loki does not like limit=0, even when it is not needed // (for example for metric queries), so we // only send it when it's set if query.MaxLines > 0 { qs.Set("limit", fmt.Sprintf("%d", query.MaxLines)) } lokiUrl, err := url.Parse(lokiDsUrl) if err != nil { return nil, err } switch query.QueryType { case QueryTypeRange: { qs.Set("start", strconv.FormatInt(query.Start.UnixNano(), 10)) qs.Set("end", strconv.FormatInt(query.End.UnixNano(), 10)) // NOTE: technically for streams-producing queries `step` // is ignored, so it would be nicer to not send it in such cases, // but we cannot detect that situation, so we always send it. // it should not break anything. // NOTE2: we do this at millisecond precision for two reasons: // a. Loki cannot do steps with better precision anyway, // so the microsecond & nanosecond part can be ignored. // b. having it always be number+'ms' makes it more robust and // precise, as Loki does not support step with float number // and time-specifier, like "1.5s" qs.Set("step", fmt.Sprintf("%dms", query.Step.Milliseconds())) lokiUrl.Path = path.Join(lokiUrl.Path, "/loki/api/v1/query_range") } case QueryTypeInstant: { qs.Set("time", strconv.FormatInt(query.End.UnixNano(), 10)) lokiUrl.Path = path.Join(lokiUrl.Path, "/loki/api/v1/query") } default: return nil, fmt.Errorf("invalid QueryType: %v", query.QueryType) } lokiUrl.RawQuery = qs.Encode() req, err := http.NewRequestWithContext(ctx, "GET", lokiUrl.String(), nil) if err != nil { return nil, err } if query.SupportingQueryType != SupportingQueryNone { value := getSupportingQueryHeaderValue(req, query.SupportingQueryType) if value != "" { req.Header.Set("X-Query-Tags", "Source="+value) } } return req, nil } type lokiResponseError struct { Message string `json:"message"` TraceID string `json:"traceID,omitempty"` } type lokiError struct { Message string } func makeLokiError(bytes []byte) error { var data lokiError err := json.Unmarshal(bytes, &data) if err != nil { // we were unable to convert the bytes to JSON, we return the whole text return fmt.Errorf("%v", string(bytes)) } if data.Message == "" { // we got no usable error message, we return the whole text return fmt.Errorf("%v", string(bytes)) } return fmt.Errorf("%v", data.Message) } // we know there is an error, // based on the http-response-body // we have to make an informative error-object func readLokiError(body io.ReadCloser) error { var buf bytes.Buffer _, err := buf.ReadFrom(body) if err != nil { return err } bytes := buf.Bytes() // the error-message is probably a JSON structure, // with a string-field named "message". we want the // value of that field. // but, the response might be just a simple string, // this was used in older Loki versions. // so our approach is this: // - we try to convert the bytes to JSON // - we take the value of the field "message" // - if any of these steps fail, or if "message" is empty, we return the whole text return makeLokiError(bytes) } func (api *LokiAPI) DataQuery(ctx context.Context, query lokiQuery, responseOpts ResponseOpts) (data.Frames, error) { req, err := makeDataRequest(ctx, api.url, query) if err != nil { return nil, err } resp, err := api.client.Do(req) if err != nil { return nil, err } defer func() { if err := resp.Body.Close(); err != nil { api.log.Warn("Failed to close response body", "err", err) } }() if resp.StatusCode/100 != 2 { return nil, readLokiError(resp.Body) } iter := jsoniter.Parse(jsoniter.ConfigDefault, resp.Body, 1024) res := converter.ReadPrometheusStyleResult(iter, converter.Options{MatrixWideSeries: false, VectorWideSeries: false, Dataplane: responseOpts.metricDataplane}) if res.Error != nil { return nil, res.Error } return res.Frames, nil } func makeRawRequest(ctx context.Context, lokiDsUrl string, resourcePath string) (*http.Request, error) { lokiUrl, err := url.Parse(lokiDsUrl) if err != nil { return nil, err } resourceUrl, err := url.Parse(resourcePath) if err != nil { return nil, err } // we take the path and the query-string only lokiUrl.RawQuery = resourceUrl.RawQuery lokiUrl.Path = path.Join(lokiUrl.Path, resourceUrl.Path) req, err := http.NewRequestWithContext(ctx, "GET", lokiUrl.String(), nil) if err != nil { return nil, err } return req, nil } func (api *LokiAPI) RawQuery(ctx context.Context, resourcePath string) (RawLokiResponse, error) { req, err := makeRawRequest(ctx, api.url, resourcePath) if err != nil { return RawLokiResponse{}, err } resp, err := api.client.Do(req) if err != nil { return RawLokiResponse{}, err } defer func() { if err := resp.Body.Close(); err != nil { api.log.Warn("Failed to close response body", "err", err) } }() // server errors are handled by the plugin-proxy to hide the error message if resp.StatusCode/100 == 5 { return RawLokiResponse{}, readLokiError(resp.Body) } body, err := io.ReadAll(resp.Body) if err != nil { return RawLokiResponse{}, err } // client errors are passed as a json struct to the client if resp.StatusCode/100 != 2 { lokiResponseErr := lokiResponseError{Message: makeLokiError(body).Error()} traceID := tracing.TraceIDFromContext(ctx, false) if traceID != "" { lokiResponseErr.TraceID = traceID } body, err = json.Marshal(lokiResponseErr) if err != nil { return RawLokiResponse{}, err } } rawLokiResponse := RawLokiResponse{ Body: body, Status: resp.StatusCode, Encoding: resp.Header.Get("Content-Encoding"), } return rawLokiResponse, nil } func getSupportingQueryHeaderValue(req *http.Request, supportingQueryType SupportingQueryType) string { value := "" switch supportingQueryType { case SupportingQueryLogsVolume: value = "logvolhist" case SupportingQueryLogsSample: value = "logsample" case SupportingQueryDataSample: value = "datasample" default: //ignore } return value }