// Copyright 2013 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package ast import ( "encoding/json" "errors" "fmt" "sort" "strings" clientmodel "github.com/prometheus/client_golang/model" "github.com/prometheus/prometheus/stats" "github.com/prometheus/prometheus/storage/metric" "github.com/prometheus/prometheus/utility" ) // OutputFormat is an enum for the possible output formats. type OutputFormat int // Possible output formats. const ( TEXT OutputFormat = iota JSON ) func (opType BinOpType) String() string { opTypeMap := map[BinOpType]string{ ADD: "+", SUB: "-", MUL: "*", DIV: "/", MOD: "%", GT: ">", LT: "<", EQ: "==", NE: "!=", GE: ">=", LE: "<=", AND: "AND", OR: "OR", } return opTypeMap[opType] } func (aggrType AggrType) String() string { aggrTypeMap := map[AggrType]string{ SUM: "SUM", AVG: "AVG", MIN: "MIN", MAX: "MAX", COUNT: "COUNT", } return aggrTypeMap[aggrType] } func (exprType ExprType) String() string { exprTypeMap := map[ExprType]string{ SCALAR: "scalar", VECTOR: "vector", MATRIX: "matrix", STRING: "string", } return exprTypeMap[exprType] } func (vector Vector) String() string { metricStrings := make([]string, 0, len(vector)) for _, sample := range vector { metricStrings = append(metricStrings, fmt.Sprintf("%s => %v @[%v]", sample.Metric, sample.Value, sample.Timestamp)) } return strings.Join(metricStrings, "\n") } func (matrix Matrix) String() string { metricStrings := make([]string, 0, len(matrix)) for _, sampleSet := range matrix { metricName, ok := sampleSet.Metric[clientmodel.MetricNameLabel] if !ok { panic("Tried to print matrix without metric name") } labelStrings := make([]string, 0, len(sampleSet.Metric)-1) for label, value := range sampleSet.Metric { if label != clientmodel.MetricNameLabel { labelStrings = append(labelStrings, fmt.Sprintf("%s=%q", label, value)) } } sort.Strings(labelStrings) valueStrings := make([]string, 0, len(sampleSet.Values)) for _, value := range sampleSet.Values { valueStrings = append(valueStrings, fmt.Sprintf("\n%v @[%v]", value.Value, value.Timestamp)) } metricStrings = append(metricStrings, fmt.Sprintf("%s{%s} => %s", metricName, strings.Join(labelStrings, ", "), strings.Join(valueStrings, ", "))) } sort.Strings(metricStrings) return strings.Join(metricStrings, "\n") } // ErrorToJSON converts the given error into JSON. func ErrorToJSON(err error) string { errorStruct := struct { Type string Value string }{ Type: "error", Value: err.Error(), } errorJSON, err := json.Marshal(errorStruct) if err != nil { return "" } return string(errorJSON) } // TypedValueToJSON converts the given data of type 'scalar', // 'vector', or 'matrix' into its JSON representation. func TypedValueToJSON(data interface{}, typeStr string) string { dataStruct := struct { Type string Value interface{} }{ Type: typeStr, Value: data, } dataJSON, err := json.Marshal(dataStruct) if err != nil { return ErrorToJSON(err) } return string(dataJSON) } // EvalToString evaluates the given node into a string of the given format. func EvalToString(node Node, timestamp clientmodel.Timestamp, format OutputFormat, storage metric.PreloadingPersistence, queryStats *stats.TimerGroup) string { viewTimer := queryStats.GetTimer(stats.TotalViewBuildingTime).Start() viewAdapter, err := viewAdapterForInstantQuery(node, timestamp, storage, queryStats) viewTimer.Stop() if err != nil { panic(err) } evalTimer := queryStats.GetTimer(stats.InnerEvalTime).Start() switch node.Type() { case SCALAR: scalar := node.(ScalarNode).Eval(timestamp, viewAdapter) evalTimer.Stop() switch format { case TEXT: return fmt.Sprintf("scalar: %v @[%v]", scalar, timestamp) case JSON: return TypedValueToJSON(scalar, "scalar") } case VECTOR: vector := node.(VectorNode).Eval(timestamp, viewAdapter) evalTimer.Stop() switch format { case TEXT: return vector.String() case JSON: return TypedValueToJSON(vector, "vector") } case MATRIX: matrix := node.(MatrixNode).Eval(timestamp, viewAdapter) evalTimer.Stop() switch format { case TEXT: return matrix.String() case JSON: return TypedValueToJSON(matrix, "matrix") } case STRING: str := node.(StringNode).Eval(timestamp, viewAdapter) evalTimer.Stop() switch format { case TEXT: return str case JSON: return TypedValueToJSON(str, "string") } } panic("Switch didn't cover all node types") } // EvalToVector evaluates the given node into a Vector. Matrices aren't supported. func EvalToVector(node Node, timestamp clientmodel.Timestamp, storage metric.PreloadingPersistence, queryStats *stats.TimerGroup) (Vector, error) { viewTimer := queryStats.GetTimer(stats.TotalViewBuildingTime).Start() viewAdapter, err := viewAdapterForInstantQuery(node, timestamp, storage, queryStats) viewTimer.Stop() if err != nil { panic(err) } evalTimer := queryStats.GetTimer(stats.InnerEvalTime).Start() switch node.Type() { case SCALAR: scalar := node.(ScalarNode).Eval(timestamp, viewAdapter) evalTimer.Stop() return Vector{&clientmodel.Sample{Value: scalar}}, nil case VECTOR: vector := node.(VectorNode).Eval(timestamp, viewAdapter) evalTimer.Stop() return vector, nil case MATRIX: return nil, errors.New("Matrices not supported by EvalToVector") case STRING: str := node.(StringNode).Eval(timestamp, viewAdapter) evalTimer.Stop() return Vector{&clientmodel.Sample{ Metric: clientmodel.Metric{"__value__": clientmodel.LabelValue(str)}}}, nil } panic("Switch didn't cover all node types") } // NodeTreeToDotGraph returns a DOT representation of the scalar // literal. func (node *ScalarLiteral) NodeTreeToDotGraph() string { return fmt.Sprintf("%#p[label=\"%v\"];\n", node, node.value) } func functionArgsToDotGraph(node Node, args []Node) string { graph := "" for _, arg := range args { graph += fmt.Sprintf("%#p -> %#p;\n", node, arg) } for _, arg := range args { graph += arg.NodeTreeToDotGraph() } return graph } // NodeTreeToDotGraph returns a DOT representation of the function // call. func (node *ScalarFunctionCall) NodeTreeToDotGraph() string { graph := fmt.Sprintf("%#p[label=\"%s\"];\n", node, node.function.name) graph += functionArgsToDotGraph(node, node.args) return graph } // NodeTreeToDotGraph returns a DOT representation of the expression. func (node *ScalarArithExpr) NodeTreeToDotGraph() string { graph := fmt.Sprintf(` %#p[label="%s"]; %#p -> %#p; %#p -> %#p; %s %s }`, node, node.opType, node, node.lhs, node, node.rhs, node.lhs.NodeTreeToDotGraph(), node.rhs.NodeTreeToDotGraph()) return graph } // NodeTreeToDotGraph returns a DOT representation of the vector selector. func (node *VectorSelector) NodeTreeToDotGraph() string { return fmt.Sprintf("%#p[label=\"%s\"];\n", node, node) } // NodeTreeToDotGraph returns a DOT representation of the function // call. func (node *VectorFunctionCall) NodeTreeToDotGraph() string { graph := fmt.Sprintf("%#p[label=\"%s\"];\n", node, node.function.name) graph += functionArgsToDotGraph(node, node.args) return graph } // NodeTreeToDotGraph returns a DOT representation of the vector // aggregation. func (node *VectorAggregation) NodeTreeToDotGraph() string { groupByStrings := make([]string, 0, len(node.groupBy)) for _, label := range node.groupBy { groupByStrings = append(groupByStrings, string(label)) } graph := fmt.Sprintf("%#p[label=\"%s BY (%s)\"]\n", node, node.aggrType, strings.Join(groupByStrings, ", ")) graph += fmt.Sprintf("%#p -> %#p;\n", node, node.vector) graph += node.vector.NodeTreeToDotGraph() return graph } // NodeTreeToDotGraph returns a DOT representation of the expression. func (node *VectorArithExpr) NodeTreeToDotGraph() string { graph := fmt.Sprintf(` %#p[label="%s"]; %#p -> %#p; %#p -> %#p; %s %s `, node, node.opType, node, node.lhs, node, node.rhs, node.lhs.NodeTreeToDotGraph(), node.rhs.NodeTreeToDotGraph()) return graph } // NodeTreeToDotGraph returns a DOT representation of the matrix // selector. func (node *MatrixSelector) NodeTreeToDotGraph() string { return fmt.Sprintf("%#p[label=\"%s\"];\n", node, node) } // NodeTreeToDotGraph returns a DOT representation of the string // literal. func (node *StringLiteral) NodeTreeToDotGraph() string { return fmt.Sprintf("%#p[label=\"'%q'\"];\n", node, node.str) } // NodeTreeToDotGraph returns a DOT representation of the function // call. func (node *StringFunctionCall) NodeTreeToDotGraph() string { graph := fmt.Sprintf("%#p[label=\"%s\"];\n", node, node.function.name) graph += functionArgsToDotGraph(node, node.args) return graph } func (nodes Nodes) String() string { nodeStrings := make([]string, 0, len(nodes)) for _, node := range nodes { nodeStrings = append(nodeStrings, node.String()) } return strings.Join(nodeStrings, ", ") } func (node *ScalarLiteral) String() string { return fmt.Sprint(node.value) } func (node *ScalarFunctionCall) String() string { return fmt.Sprintf("%s(%s)", node.function.name, node.args) } func (node *ScalarArithExpr) String() string { return fmt.Sprintf("(%s %s %s)", node.lhs, node.opType, node.rhs) } func (node *VectorSelector) String() string { labelStrings := make([]string, 0, len(node.labelMatchers)-1) var metricName clientmodel.LabelValue for _, matcher := range node.labelMatchers { if matcher.Name != clientmodel.MetricNameLabel { labelStrings = append(labelStrings, fmt.Sprintf("%s%s%q", matcher.Name, matcher.Type, matcher.Value)) } else { metricName = matcher.Value } } switch len(labelStrings) { case 0: return string(metricName) default: sort.Strings(labelStrings) return fmt.Sprintf("%s{%s}", metricName, strings.Join(labelStrings, ",")) } } func (node *VectorFunctionCall) String() string { return fmt.Sprintf("%s(%s)", node.function.name, node.args) } func (node *VectorAggregation) String() string { aggrString := fmt.Sprintf("%s(%s)", node.aggrType, node.vector) if len(node.groupBy) > 0 { return fmt.Sprintf("%s BY (%s)", aggrString, node.groupBy) } return aggrString } func (node *VectorArithExpr) String() string { return fmt.Sprintf("(%s %s %s)", node.lhs, node.opType, node.rhs) } func (node *MatrixSelector) String() string { vectorString := (&VectorSelector{labelMatchers: node.labelMatchers}).String() intervalString := fmt.Sprintf("[%s]", utility.DurationToString(node.interval)) return vectorString + intervalString } func (node *StringLiteral) String() string { return fmt.Sprintf("%q", node.str) } func (node *StringFunctionCall) String() string { return fmt.Sprintf("%s(%s)", node.function.name, node.args) }