2021-03-18

Introducing the Axiom CLI

Tola Ore-Aruwaji
@thecraftman_

We’re excited to announce the release of Axiom CLI, and we want to highlight some of its awesome features in this post!

cli

The Axiom team have been working really hard on the first version of the Axiom CLI, a powerful way to use Axiom directly from the comfort of your terminal.

Here are some of the CLI’s key features:

  • Easily ingest data in multiple formats from your local machine into your Axiom instance

  • Stream data live, allowing you to monitor your services without leaving the comfort of your terminal

  • Work with different Axiom deployments, easily switching between them

  • Easy to install, simple to get started with

  • Cross-platform; works on Linux, macOS, and Windows

  • Open Source; we’d love your contributions and ideas

Let’s dive into some of our favourite features:

Ingest Data

Using the Axiom CLI you can ingest the contents of a JSON logfile into any dataset name. The structured data follows the JSON specification for which field types are supported, an event could look like this:

{
  "service": "api-http",
  "severity": "error",
  "duration": 231,
  "customer_id": "ghj34g32poiu4",
  "tags": ["aws-east-1", "zone-b"],
  "metadata": {
    "version": "3.1.2"
  }
}

Before ingesting data, create the dataset using your Ingest API Token or personal token, this can be generated from the settings → tokens page in Axiom. Once you have generated the Token, you can format and upload your dataset in any of the supported input formats: JSON, NDJSON, and CSV.

cli

Stream Data

Axiom CLI makes it very easy to view your data as it’s being ingested live. This allows you to inspect individual events and watch as they are logged, just like you were running your service locally.

cli

# Ingest the contents of a JSON file
# into a dataset named "nginx-logs":
$ axiom ingest nginx-logs -f nginx-logs.json

# Ingest the contents of all files inside /var/logs/nginx
# with extension ".log" into a dataset named "nginx-logs":
$ axiom ingest nginx-logs -f /var/logs/nginx/*.log

Manage Datasets

You can quickly and easily view and manage datasets inside your Axiom deployment via Axiom CLI:

cli

Try Axiom CLI now

You can try Axiom CLI right now if you have an Axiom deployment. Check out our GitHub repo to get started, and check out our additional documentation too.

If you run into any issues or have feedback, feel free to reach out via GitHub, Slack, or support@axiom.co.

For more information on Axiom CLI visit our links:

Happy hacking – we can’t wait to see what you do with it!

Join us in changing how developers think about data