am
is the autometrics companion command line interface (CLI). It makes it easier to create a
local Prometheus environment and inspect the metrics using the explorer.
- Download, configure and start various Prometheus components such as,
- Prometheus - this will scrape, store and expose the metrics data
- Pushgateway - allow for pushing metrics from batch jobs or short-lived processes
- OTEL collector (coming soon!)
- Visualize your metrics using the explorer
- Inspect your Service Level Objectives
The recommended installation for macOS is via Homebrew:
brew install autometrics-dev/tap/am
Alternatively, you can download the latest version from the releases page
The following will download, configure and start Prometheus. Assuming you've created an application that is running locally on port 3000
it will start scraping the metrics for that service on that port:
am start :3000
You can also specify a host, scheme or a path:
am start https://example.com:3000/api/metrics
It is also possible to specify multiple endpoints:
am start :3000 :3030
Now you can visualize and inspect your metrics using the explorer by visiting http://localhost:6789/
.
We provide a container that packages am
. For more details see docs/container.md.
Visit the autometrics docs site for more details on how to use am
and more
details about autometrics: https://docs.autometrics.dev/
am
support defining a few configuration details in a am.toml
file. These
will be used by am start
. Committing the am.toml
file into git allows your
entire team to have the settings as they are for your application. Example:
pushgateway-enabled = true
[[endpoint]]
job-name = "main_app"
url = "http://localhost:3030"
See https://docs.autometrics.dev/local-development#configration for more details.
Issues, feature suggestions, and pull requests are very welcome!
If you are interested in getting involved:
- Join the conversation on Discord
- Ask questions and share ideas in the Github Discussions
- Take a look at the overall Autometrics Project Roadmap
If you are cloning this repository to make changes, be sure to clone it with submodules:
git clone --recurse-submodules https://github.com/autometrics-dev/am.git
Planning to release a new version of am
? Take a look at our releasing guide.
am
is distributed under the terms of both the MIT license and the Apache. See
LICENSE-APACHE and LICENSE-MIT for details.