乐趣区

关于prometheus:prometheus-rangequery源码解读和高基数判定依据querylog各阶段统计耗时原理

在时序数据库中的高基数问题能够看我之前写的文章

  • 高基数和 prometheus 中断定高基数的三种办法

明天咱们解说下其中第二种断定办法的 range_query 原理

并且解说下 query_log 统计的原理

总结 range_query 查问过程

  • 解析参数
  • 设置超时并设置 opentracing
  • 依据 queryEngine 初始化 query 并解析 promql
  • exec 函数先设置 ExecTotalTime
  • exec 函数进入队列排队 设置并计算 ExecQueueTime
  • exec 函数 设置 EvalTotalTime 并执行 execEvalStmt 函数
  • execEvalStmt 函数 筹备存储上的 querier+select series 设置并计算 QueryPreparationTime
  • execEvalStmt 函数 设置 InnerEvalTime,从存储拿到 series 后在本地内存中执行 evaluator.Eval(s.Expr)
  • execEvalStmt 函数设置并计算 ResultSortTime

prometheus query_log 配置

配置

# global 段开启 log 即可
global:
  query_log_file: /opt/logs/prometheus_query_log

range_query_log 解析

{
   # 申请根底信息
    "httpRequest":{
        "clientIP":"192.168.43.114",
        "method":"POST",
        "path":"/api/v1/query_range"
    },
    # 参数段
    "params":{
        "end":"2021-05-03T02:32:45.000Z",
        "query":"rate(node_disk_reads_completed_total{instance=~"192\\.168\\.43\\.114:9100"}[2m])",
        "start":"2021-05-03T02:17:45.000Z",
        "step":15
    },
    # 统计段
    "stats":{
        "timings":{
            "evalTotalTime":0.000331799,
            "resultSortTime":0.000001235,
            "queryPreparationTime":0.000075478,
            "innerEvalTime":0.00024141,
            "execQueueTime":0.000012595,
            "execTotalTime":0.000354698
        }
    },
    # 申请工夫
    "ts":"2021-05-03T02:32:49.876Z"
}

上面从源码层看下 range_query 的查问原理

  • D:\nyy_work\go_path\pkg\mod\github.com\prometheus\prometheus@v1.8.2-0.20210220213500-8c8de46003d1\web\api\v1\api.go

    func (api *API) queryRange(r *http.Request) (result apiFuncResult) {}

step1: 参数解析

    // 解析 start
    start, err := parseTime(r.FormValue("start"))
    if err != nil {return invalidParamError(err, "start")
    }
    // 解析 end
    end, err := parseTime(r.FormValue("end"))
    if err != nil {return invalidParamError(err, "end")
    }
    // 判断 end 是否早于 start
    if end.Before(start) {return invalidParamError(errors.New("end timestamp must not be before start time"), "end")
    }
    // 解析 step
    step, err := parseDuration(r.FormValue("step"))
    if err != nil {return invalidParamError(err, "step")
    }
    
    if step <= 0 {return invalidParamError(errors.New("zero or negative query resolution step widths are not accepted. Try a positive integer"), "step")
    }

避免 point 过多

    // 这里怎么了解?// For safety, limit the number of returned points per timeseries.
    // This is sufficient for 60s resolution for a week or 1h resolution for a year.
    if end.Sub(start)/step > 11000 {err := errors.New("exceeded maximum resolution of 11,000 points per timeseries. Try decreasing the query resolution (?step=XX)")
        return apiFuncResult{nil, &apiError{errorBadData, err}, nil, nil}
    }

设置超时

    ctx := r.Context()
    if to := r.FormValue("timeout"); to != "" {
        var cancel context.CancelFunc
        timeout, err := parseDuration(to)
        if err != nil {return invalidParamError(err, "timeout")
        }

        ctx, cancel = context.WithTimeout(ctx, timeout)
        defer cancel()}

step2:依据 queryEngine 初始化 query 并解析 promql

func (ng *Engine) NewRangeQuery(q storage.Queryable, qs string, start, end time.Time, interval time.Duration) (Query, error) {expr, err := parser.ParseExpr(qs)
    if err != nil {return nil, err}
    if expr.Type() != parser.ValueTypeVector && expr.Type() != parser.ValueTypeScalar {return nil, errors.Errorf("invalid expression type %q for range query, must be Scalar or instant Vector", parser.DocumentedType(expr.Type()))
    }
    qry, err := ng.newQuery(q, expr, start, end, interval)
    if err != nil {return nil, err}
    qry.q = qs

    return qry, nil
}

queryEngine 从何而来?

expr, err := parser.ParseExpr(qs) 解析 promql

instance_query 和 range_query 调用同一 newQuery

step3:执行查问

// Exec implements the Query interface.
func (q *query) Exec(ctx context.Context) *Result {if span := opentracing.SpanFromContext(ctx); span != nil {span.SetTag(queryTag, q.stmt.String())
    }

    // Exec query.
    res, warnings, err := q.ng.exec(ctx, q)

    return &Result{Err: err, Value: res, Warnings: warnings}
}

应用分布式追踪 追踪查问分阶段耗时

外围函数 exec

func (ng *Engine) exec(ctx context.Context, q *query) (v parser.Value, ws storage.Warnings, err error) {
    // prometheus_engine_queries 计数器,示意以后 query 个数
    ng.metrics.currentQueries.Inc()
    defer ng.metrics.currentQueries.Dec()

    ctx, cancel := context.WithTimeout(ctx, ng.timeout)
    q.cancel = cancel
    // 收尾函数,记录日志或者 jager
    defer func() {ng.queryLoggerLock.RLock()
        if l := ng.queryLogger; l != nil {params := make(map[string]interface{}, 4)
            params["query"] = q.q
            if eq, ok := q.Statement().(*parser.EvalStmt); ok {params["start"] = formatDate(eq.Start)
                params["end"] = formatDate(eq.End)
                // The step provided by the user is in seconds.
                params["step"] = int64(eq.Interval / (time.Second / time.Nanosecond))
            }
            f := []interface{}{"params", params}
            if err != nil {f = append(f, "error", err)
            }
            f = append(f, "stats", stats.NewQueryStats(q.Stats()))
            if span := opentracing.SpanFromContext(ctx); span != nil {if spanCtx, ok := span.Context().(jaeger.SpanContext); ok {f = append(f, "spanID", spanCtx.SpanID())
                }
            }
            if origin := ctx.Value(QueryOrigin{}); origin != nil {for k, v := range origin.(map[string]interface{}) {f = append(f, k, v)
                }
            }
            if err := l.Log(f...); err != nil {ng.metrics.queryLogFailures.Inc()
                level.Error(ng.logger).Log("msg", "can't log query","err", err)
            }
        }
        ng.queryLoggerLock.RUnlock()}()
    // execTotalTime 代表 exec 函数执行全副耗时不算 log
    // defer 先进后出,这个 GetSpanTimer 最初执行
    execSpanTimer, ctx := q.stats.GetSpanTimer(ctx, stats.ExecTotalTime)
    defer execSpanTimer.Finish()
    
    // ExecQueueTime 代表队列中等待时间
    // 命令行参数 query.max-concurrency
    // 如果日志中这个耗时高,思考队列被慢查问占满了。对应在 data 目录下的 queries.active 文件


    queueSpanTimer, _ := q.stats.GetSpanTimer(ctx, stats.ExecQueueTime, ng.metrics.queryQueueTime)
    // Log query in active log. The active log guarantees that we don't run over
    // MaxConcurrent queries.
    if ng.activeQueryTracker != nil {queryIndex, err := ng.activeQueryTracker.Insert(ctx, q.q)
        if err != nil {queueSpanTimer.Finish()
            return nil, nil, contextErr(err, "query queue")
        }
        defer ng.activeQueryTracker.Delete(queryIndex)
    }
    queueSpanTimer.Finish()

    // Cancel when execution is done or an error was raised.
    defer q.cancel()

    const env = "query execution"
    // EvalTotalTime 代表 execEvalStmt 函数执行工夫
    evalSpanTimer, ctx := q.stats.GetSpanTimer(ctx, stats.EvalTotalTime)
    defer evalSpanTimer.Finish()

    // The base context might already be canceled on the first iteration (e.g. during shutdown).
    if err := contextDone(ctx, env); err != nil {return nil, nil, err}

    switch s := q.Statement().(type) {
    case *parser.EvalStmt:
        return ng.execEvalStmt(ctx, q, s)
    case parser.TestStmt:
        return nil, nil, s(ctx)
    }

    panic(errors.Errorf("promql.Engine.exec: unhandled statement of type %T", q.Statement()))
}

外围函数 execEvalStmt

func (ng *Engine) execEvalStmt(ctx context.Context, query *query, s *parser.EvalStmt) (parser.Value, storage.Warnings, error) {
    // QueryPreparationTime 代表筹备存储上的 querier+select series 工夫
    prepareSpanTimer, ctxPrepare := query.stats.GetSpanTimer(ctx, stats.QueryPreparationTime, ng.metrics.queryPrepareTime)
    mint, maxt := ng.findMinMaxTime(s)
    querier, err := query.queryable.Querier(ctxPrepare, mint, maxt)
    if err != nil {prepareSpanTimer.Finish()
        return nil, nil, err
    }
    defer querier.Close()
    // populateSeries 调用 select 返回 series
    ng.populateSeries(querier, s)
    prepareSpanTimer.Finish()
    // InnerEvalTime 代表从存储拿到 series 后在本地内存中执行 evaluator.Eval(s.Expr)的工夫
    // evaluator.Eval 须要判断 instance_query 还是 range_query
    evalSpanTimer, ctxInnerEval := query.stats.GetSpanTimer(ctx, stats.InnerEvalTime, ng.metrics.queryInnerEval)
    ...
    // ResultSortTime 代表排序耗时
    sortSpanTimer, _ := query.stats.GetSpanTimer(ctx, stats.ResultSortTime, ng.metrics.queryResultSort)
    sort.Sort(mat)
    sortSpanTimer.Finish()}

总结查问过程

  • 解析参数
  • 设置超时并设置 opentracing
  • 依据 queryEngine 初始化 query 并解析 promql
  • exec 函数先设置 ExecTotalTime
  • exec 函数进入队列排队 设置并计算 ExecQueueTime
  • exec 函数 设置 EvalTotalTime 并执行 execEvalStmt 函数
  • execEvalStmt 函数 筹备存储上的 querier+select series 设置并计算 QueryPreparationTime
  • execEvalStmt 函数 设置 InnerEvalTime,从存储拿到 series 后在本地内存中执行 evaluator.Eval(s.Expr)
  • execEvalStmt 函数设置并计算 ResultSortTime

所以这几个耗时的关系为

  • EvalTotalTime=QueryPreparationTime+InnerEvalTime+ResultSortTime

    • 计算值 0.000075478+0.00024141+0.000001235=0.000318123
    • 实在值 0.000331799 > 0.000318123
    • 不一样就对了,还有两头的局部代码执行
  • ExecTotalTime=ExecQueueTime+EvalTotalTime

    • 计算值 0.000331799+0.000012595=0.000344394
    • 实在值 0.000354698 > 0.000344394
    {
     # 申请根底信息
      "httpRequest":{
          "clientIP":"192.168.43.114",
          "method":"POST",
          "path":"/api/v1/query_range"
      },
      # 参数段
      "params":{
          "end":"2021-05-03T02:32:45.000Z",
          "query":"rate(node_disk_reads_completed_total{instance=~"192\\.168\\.43\\.114:9100"}[2m])",
          "start":"2021-05-03T02:17:45.000Z",
          "step":15
      },
      # 统计段
      "stats":{
          "timings":{
              "evalTotalTime":0.000331799,
              "resultSortTime":0.000001235,
              "queryPreparationTime":0.000075478,
              "innerEvalTime":0.00024141,
              "execQueueTime":0.000012595,
              "execTotalTime":0.000354698
          }
      },
      # 申请工夫
      "ts":"2021-05-03T02:32:49.876Z"
    }

几个耗时的问题

  • 最多的重查问在于 QueryPreparationTime,也就是 select series 阶段
  • execQueueTime 如果很高,不要轻易的调大 query.max-concurrency,应该找出慢查并解决

    • 自觉调大队列深度会导致更重大的 oom 问题
    • 失常来说每个 query 在队列中等待时间很短
  • innerEvalTime resultSortTime 个别耗时不高

预聚合的计划能够看我之前写的文章

  • 文章地址:开源我的项目 pre_query: 给 prometheus 重 (heavy_query) 查问提速
  • 我的项目地址:https://github.com/ning1875/pre_query
退出移动版