RepoMirrors
/
prometheus
mirror of https://github.com/prometheus/prometheus
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
791 Commits 210 Branches 425 Tags 699 MiB
Go 85%
TypeScript 13.7%
Yacc 0.5%
Shell 0.2%
SCSS 0.2%
Other 0.1%
Go to file
Matt T. Proud 9c8112a053 Revert "Add flags to build prometheus statically" 
This reverts commit 0e9e3e068d.

Not only do we know this to produce problematic artifacts, it refuses
to build on Mac OS X.

    TMPDIR=/tmp GOROOT=/Users/mattproud/Development/go/src/github.com/prometheus/prometheus/.build/root/go GOPATH=/Users/mattproud/Development/go/src/github.com/prometheus/prometheus/.build/root/gopath /Users/mattproud/Development/go/src/github.com/prometheus/prometheus/.build/root/go/bin/go build -o prometheus -ldflags " -X main.buildVersion c7052ed -X main.buildBranch refactor/storage/modify-append-signature -X main.buildUser mattproud@Berlin.local -X main.buildDate 20130815-11:15:49 -X main.goVersion 1.1 -X main.leveldbVersion 1.12.0 -X main.protobufVersion 2.5.0 -X main.snappyVersion 1.1.0 -linkmode external -extldflags '-lstdc++ -lpthread -static /Users/mattproud/Development/go/src/github.com/prometheus/prometheus/.build/root/lib/libleveldb.a /Users/mattproud/Development/go/src/github.com/prometheus/prometheus/.build/root/lib/libsnappy.a'" .
    # _/Users/mattproud/Development/go/src/github.com/prometheus/prometheus
    ld: library not found for -lcrt0.o

Change-Id: I4f42161aebfd35a6f09cd7f984b78cc4498774aa
 		2013-08-15 11:19:44 +02:00
.build Run prometheus in foreground. 2013-08-12 11:19:55 +02:00
coding Destroy naked returns in half of corpus. 2013-05-16 10:53:25 +03:00
config Add global label support via Ingesters. 2013-08-13 16:54:15 +02:00
documentation/examples Include long-tail data deletion mechanism. 2013-05-13 10:54:36 +02:00
model Update "build" -> ".build" in remaining Makefiles. 2013-06-26 16:09:37 +02:00
notification Add needed trailing spaces in logs. 2013-08-12 18:22:48 +02:00
retrieval Add global label support via Ingesters. 2013-08-13 16:54:15 +02:00
rules Add needed trailing spaces in logs. 2013-08-12 18:22:48 +02:00
stats Add debug timers to instant and range queries. 2013-06-05 18:32:54 +02:00
storage Include forgotten imports. 2013-08-14 18:52:55 +02:00
tools Add needed trailing spaces in logs. 2013-08-12 18:22:48 +02:00
utility Add variable interpolation to notification messages. 2013-08-12 12:29:08 +02:00
web Kill the curation state channel. 2013-08-13 17:20:22 +02:00
.gitignore Revert "Add flags to build prometheus statically" 2013-08-15 11:19:44 +02:00
.pkgignore Make prometheus build on bazooka repo manager 2013-06-13 16:31:33 +02:00
.travis.yml Trailing build system cleanups. 2013-06-13 15:38:03 +02:00
CONTRIBUTORS.md Update community documentation. 2013-03-28 10:46:41 +01:00
Dockerfile Fix entrypoint and use base image 2013-08-12 11:19:35 +02:00
LICENSE Address outstanding comments from PR/47 and other cleanups. 2013-02-07 11:38:01 +01:00
MANIFEST Add MANIFEST listing 3rd party libs and versions. 2013-04-09 13:31:56 +02:00
Makefile Revert "Add flags to build prometheus statically" 2013-08-15 11:19:44 +02:00
Makefile.INCLUDE Revert "Add flags to build prometheus statically" 2013-08-15 11:19:44 +02:00
README.md Strip notes about GVM. 2013-08-13 02:26:20 +02:00
build_info.go Implement batch database sample curator. 2013-04-27 17:38:18 +02:00
main.go Handle SIGTERM in addition to SIGINT. 2013-08-14 12:38:21 +02:00
tests-for-die-in-a-fire-travis.sh Remove gvm on travis. 2013-06-13 14:36:00 +02:00

README.md

Prometheus

Bedecke deinen Himmel, Zeus! A new kid is in town.

Prometheus is a generic time series collection and computation server that is useful in the following fields:

  • Industrial Experimentation / Real-Time Behavioral Validation / Software Release Qualification
  • Econometric and Natural Sciences
  • Operational Concerns and Monitoring

The system is designed to collect telemetry from named targets on given intervals, evaluate rule expressions, display the results, and trigger an action if some condition is observed to be true.

Prerequisites

If you read below in the Getting Started section, the build infrastructure will take care of the following things for you in most cases:

  1. Go 1.1.
  2. LevelDB: https://code.google.com/p/leveldb/.
  3. Protocol Buffers Compiler: http://code.google.com/p/protobuf/.
  4. goprotobuf: the code generator and runtime library: http://code.google.com/p/goprotobuf/.
  5. Levigo, a Go-wrapper around LevelDB's C library: https://github.com/jmhodges/levigo.
  6. GoRest, a RESTful style web-services framework: http://code.google.com/p/gorest/.
  7. Prometheus Client, Prometheus in Prometheus https://github.com/prometheus/client_golang.
  8. Snappy, a compression library for LevelDB and Levigo http://code.google.com/p/snappy/.

Getting Started

For basic help how to get started:

  • The source code is periodically indexed: Prometheus Core.
  • For UNIX-like environment users users, please consult the Travis CI configuration in .travis.yml and Makefile.
  • All of the core developers are accessible via the Prometheus Developers Mailinglist.

General

For first time users, simply run the following:

$ make

If you run into problems, try the following:

$ SILENCE_THIRD_PARTY_BUILDS=false make

Upon having a satisfactory build, it's possible to create an artifact for end-user distribution:

$ make package
$ find build/package

build/package will be sufficient for whatever archiving mechanism you choose. The important thing to note is that Go presently does not staticly link against C dependency libraries, so including the lib directory is paramount. Providing LD_LIBRARY_PATH or DYLD_LIBRARY_PATH in a scaffolding shell script is advised.

Executing the following target will start up Prometheus for lazy users:

$ ARGUMENTS="-foo -bar -baz" make run

${ARGUMENTS} is passed verbatim into the makefile and thusly Prometheus as $(ARGUMENTS). This is useful for quick one-off invocations and smoke testing.

Problems

If at any point you run into an error with the make build system in terms of its not properly scaffolding things on a given environment, please file a bug or open a pull request with your changes if you can fix it yourself.

Please note that we're explicitly shooting for stable runtime environments and not the latest-whiz bang releases; thusly, we ask you to provide ample architecture and release identification remarks for us.

Testing

$ make test

Packaging

$ make package

Race Detector

Go 1.1 includes a race detector which can be enabled at build time. Here's how to use it with Prometheus (assumes that you've already run a successful build).

To run the tests with race detection:

$ GORACE="log_path=/tmp/foo" go test -race ./...

To run the server with race detection:

$ go build -race .
$ GORACE="log_path=/tmp/foo" ./prometheus

Build Status

Contributing

  1. To start, reach out via our mailing list (mentioned above) and ask us what the current priorities are. We can find a good isolated starter project for you.

  2. Keeping code hygiene is important. We thusly have a practical preference for the following:

    1. Run make format to ensure the correctness of the Go code's layout.

    2. Run make advice to find facial errors with a static analyzer.

    3. Try to capture your changes in some form of a test. Go makes it easy to write Table Driven Tests. There is no mandate to use this said scaffolding mechanism, but it can make your life easier in the right circumstances.

  3. Welcome aboard!

License

Apache License 2.0