9c3fe750dd
Registry is now a struct, which implements two interfaces, Registrerer and Deliverer. The latter is particularly important as it is now the argument type for pushes and HTTP handler construction (i.e. it is easy to implement a custom Deliverer for testing or other purposes). The Registerer interface is not used as a parameter type but can (and should) be used by users of custom registries so that they can easily do things like mocking it out for testing purposes. With the broken up interfaces, adding MustRegister to the interface is not such a big deal anymore (interface is still small). And since setting the injection hook is such a rare thing to happen, it is acceptable to not have it in any of the interfaces. The renaming from `Collect` to `Deliver` was done to avoid confusion with Collectors. (The registry _collects_ from the Collectors, and then _delivers_ to the exposition mechanism.) |
||
---|---|---|
api/prometheus | ||
examples | ||
prometheus | ||
.gitignore | ||
.travis.yml | ||
AUTHORS.md | ||
CHANGELOG.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
NOTICE | ||
README.md | ||
VERSION |
README.md
Prometheus Go client library
This is the Go client library for Prometheus. It has two separate parts, one for instrumenting application code, and one for creating clients that talk to the Prometheus HTTP API.
Instrumenting applications
The
prometheus
directory
contains the instrumentation library. See the
best practices section of the
Prometheus documentation to learn more about instrumenting applications.
The
examples
directory
contains simple examples of instrumented code.
Client for the Prometheus HTTP API
The
api/prometheus
directory
contains the client for the
Prometheus HTTP API. It allows you
to write Go applications that query time series data from a Prometheus server.
Where is model
, extraction
, and text
?
The model
packages has been moved to
prometheus/common/model
.
The extraction
and text
packages are now contained in
prometheus/common/expfmt
.
Contributing and community
See the contributing guidelines and the Community section of the homepage.