90 lines
2.5 KiB
Go
90 lines
2.5 KiB
Go
// Copyright 2016 The Prometheus Authors
|
|
// 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 version
|
|
|
|
import (
|
|
"bytes"
|
|
"fmt"
|
|
"runtime"
|
|
"strings"
|
|
"text/template"
|
|
|
|
"github.com/prometheus/client_golang/prometheus"
|
|
)
|
|
|
|
// Build information. Populated at build-time.
|
|
var (
|
|
Version string
|
|
Revision string
|
|
Branch string
|
|
BuildUser string
|
|
BuildDate string
|
|
GoVersion = runtime.Version()
|
|
)
|
|
|
|
// NewCollector returns a collector which exports metrics about current version information.
|
|
func NewCollector(program string) *prometheus.GaugeVec {
|
|
buildInfo := prometheus.NewGaugeVec(
|
|
prometheus.GaugeOpts{
|
|
Namespace: program,
|
|
Name: "build_info",
|
|
Help: fmt.Sprintf(
|
|
"A metric with a constant '1' value labeled by version, revision, branch, and goversion from which %s was built.",
|
|
program,
|
|
),
|
|
},
|
|
[]string{"version", "revision", "branch", "goversion"},
|
|
)
|
|
buildInfo.WithLabelValues(Version, Revision, Branch, GoVersion).Set(1)
|
|
return buildInfo
|
|
}
|
|
|
|
// versionInfoTmpl contains the template used by Info.
|
|
var versionInfoTmpl = `
|
|
{{.program}}, version {{.version}} (branch: {{.branch}}, revision: {{.revision}})
|
|
build user: {{.buildUser}}
|
|
build date: {{.buildDate}}
|
|
go version: {{.goVersion}}
|
|
`
|
|
|
|
// Print returns version information.
|
|
func Print(program string) string {
|
|
m := map[string]string{
|
|
"program": program,
|
|
"version": Version,
|
|
"revision": Revision,
|
|
"branch": Branch,
|
|
"buildUser": BuildUser,
|
|
"buildDate": BuildDate,
|
|
"goVersion": GoVersion,
|
|
}
|
|
t := template.Must(template.New("version").Parse(versionInfoTmpl))
|
|
|
|
var buf bytes.Buffer
|
|
if err := t.ExecuteTemplate(&buf, "version", m); err != nil {
|
|
panic(err)
|
|
}
|
|
return strings.TrimSpace(buf.String())
|
|
}
|
|
|
|
// Info returns version, branch and revision information.
|
|
func Info() string {
|
|
return fmt.Sprintf("(version=%s, branch=%s, revision=%s)", Version, Branch, Revision)
|
|
}
|
|
|
|
// BuildContext returns goVersion, buildUser and buildDate information.
|
|
func BuildContext() string {
|
|
return fmt.Sprintf("(go=%s, user=%s, date=%s)", GoVersion, BuildUser, BuildDate)
|
|
}
|