am

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.

Features

• 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

Getting started

Installation

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

Quickstart

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/.

Container

We provide a container that packages am. For more details see docs/container.md.

Documentation

Visit the autometrics docs site for more details on how to use am and more details about autometrics: https://docs.autometrics.dev/

Configuration

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.

Contributing

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.

License

am is distributed under the terms of both the MIT license and the Apache. See LICENSE-APACHE and LICENSE-MIT for details.