Skip to content

Axiom

Axiom is a log management and observability platform. Connecting it to OpsTower gives your agents the ability to query structured logs using APL (Axiom Processing Language), returning up to 100 results per query.

Once connected, agents can:

  • Query structured log data from your Axiom datasets using APL syntax.
  • Filter, aggregate, and search log entries to investigate issues or answer operational questions.

Agents construct APL queries automatically based on your natural language questions — you do not need to write APL yourself.

Each query returns a maximum of 100 results.

To set up this connection, you will need:

  1. API Token — an Axiom API token with read access to your datasets.
  2. Dataset Name — the name of the Axiom dataset you want to query.
  1. Log in to Axiom at app.axiom.co.
  2. Click your profile icon in the bottom-left corner and go to Settings.
  3. Navigate to API Tokens in the settings menu.
  4. Click New API Token.
  5. Give the token a descriptive name (e.g., “OpsTower Read Access”).
  6. Select the datasets that this token should have access to. For security, grant access only to the datasets you plan to query from OpsTower.
  7. Click Create and copy the token immediately — it will not be shown again.

Your API token will start with xaat- (personal token) or xapt- (advanced API token).

  1. In Axiom, click Datasets in the left sidebar.
  2. Your datasets are listed with their names displayed as identifiers. Dataset names are alphanumeric and may include hyphens or underscores (e.g., my-app-logs, production_events).
  3. Copy the exact dataset name and enter it when configuring the connection in OpsTower.
  1. In OpsTower, navigate to Connections in the sidebar.
  2. Click Add Connection and select Axiom.
  3. Enter your API Token and Dataset Name.
  4. Save the connection.

Once the connection shows a green status indicator, you can enable it on any Debugger agent to start querying your logs.