> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Axiom

> Ingest, query, manage, and react to Axiom observability data.

Use the Axiom integration to ingest structured events, query logs and traces with APL, query OpenTelemetry metrics with MPL, manage observability resources, and start automations from monitor state changes.

## Connect Axiom

Create an API token in Axiom and connect it from your Automate.ax project. Advanced tokens must grant every capability used by your automation. Query and ingestion actions need dataset and query access; resource actions need matching datasets, monitors, notifiers, saved queries, or dashboards permissions. Monitor triggers need read and write access to monitors and notifiers.

```ts automations/investigate-axiom-alerts.automation.ts theme={null}
import { automation } from "automate.ax"
import { axiom } from "automate.ax/axiom"

export default automation("Investigate Axiom alerts", () => {
  const alert = axiom.onMonitorOpened({ monitorId: "monitor-id" })

  axiom.queryData({
    apl: "['production'] | where severity == 'error' | take 20",
    startTime: alert.event.queryStartTime,
    endTime: alert.event.queryEndTime,
  })
})
```

`axiomAccount` declares a named static project binding when an automation uses more than one Axiom account. Every action and trigger also accepts an optional `account` binding.

## Query and ingest endpoints

APL, MPL, metrics discovery, and ingest actions accept an optional `edgeUrl`. It defaults to the US East 1 (AWS) edge at `https://us-east-1.aws.edge.axiom.co`; set it to the edge that stores the target dataset. Automate.ax accepts only HTTPS `*.edge.axiom.co` origins and never follows redirects. Query windows default to the 30 minutes before execution. Metrics discovery accepts fixed RFC3339 timestamps because Axiom's discovery endpoints require them.

## Monitor triggers

Automate.ax creates one custom webhook notifier, attaches it without replacing the monitor's existing notifier IDs, authenticates deliveries with a managed secret header, and emits an ordinary root event. When no deployment needs the source, Automate.ax detaches and deletes only its managed notifier.

Axiom API errors include the HTTP status and provider details. Automate.ax retries `429` request-rate limits and `430` ingest or query limits using Axiom's reset timing when available.

## Exports

```ts theme={null}
import { axiom, axiomAccount } from "automate.ax/axiom"
```

* `axiom` contains the packaged Axiom actions and triggers.
* `axiomAccount("name")` selects a named Axiom connection.

## Triggers

* [On monitor notification](/reference/integrations/axiom/triggers/on-monitor-notification)
* [On monitor opened](/reference/integrations/axiom/triggers/on-monitor-opened)
* [On monitor closed](/reference/integrations/axiom/triggers/on-monitor-closed)

## Actions

* [Ingest events](/reference/integrations/axiom/actions/ingest-events)
* [Query data](/reference/integrations/axiom/actions/query-data)
* [Query metrics](/reference/integrations/axiom/actions/query-metrics)
* [List metrics](/reference/integrations/axiom/actions/list-metrics)
* [Search metrics](/reference/integrations/axiom/actions/search-metrics)
* [List metric tags](/reference/integrations/axiom/actions/list-metric-tags)
* [List metric tags for a metric](/reference/integrations/axiom/actions/list-metric-tags-for-metric)
* [List metric tag values](/reference/integrations/axiom/actions/list-metric-tag-values)
* [List metric tag values for a metric](/reference/integrations/axiom/actions/list-metric-tag-values-for-metric)
* [List datasets](/reference/integrations/axiom/actions/list-datasets)
* [Create dataset](/reference/integrations/axiom/actions/create-dataset)
* [Get dataset](/reference/integrations/axiom/actions/get-dataset)
* [Update dataset](/reference/integrations/axiom/actions/update-dataset)
* [Delete dataset](/reference/integrations/axiom/actions/delete-dataset)
* [Trim dataset](/reference/integrations/axiom/actions/trim-dataset)
* [Vacuum dataset](/reference/integrations/axiom/actions/vacuum-dataset)
* [List dataset fields](/reference/integrations/axiom/actions/list-dataset-fields)
* [Get dataset field](/reference/integrations/axiom/actions/get-dataset-field)
* [Update dataset field](/reference/integrations/axiom/actions/update-dataset-field)
* [List map fields](/reference/integrations/axiom/actions/list-map-fields)
* [Replace map fields](/reference/integrations/axiom/actions/replace-map-fields)
* [Create map field](/reference/integrations/axiom/actions/create-map-field)
* [Delete map field](/reference/integrations/axiom/actions/delete-map-field)
* [List annotations](/reference/integrations/axiom/actions/list-annotations)
* [Create annotation](/reference/integrations/axiom/actions/create-annotation)
* [Get annotation](/reference/integrations/axiom/actions/get-annotation)
* [Update annotation](/reference/integrations/axiom/actions/update-annotation)
* [Delete annotation](/reference/integrations/axiom/actions/delete-annotation)
* [List monitors](/reference/integrations/axiom/actions/list-monitors)
* [Create monitor](/reference/integrations/axiom/actions/create-monitor)
* [Get monitor](/reference/integrations/axiom/actions/get-monitor)
* [Update monitor](/reference/integrations/axiom/actions/update-monitor)
* [Delete monitor](/reference/integrations/axiom/actions/delete-monitor)
* [List monitor history](/reference/integrations/axiom/actions/list-monitor-history)
* [List notifiers](/reference/integrations/axiom/actions/list-notifiers)
* [Create notifier](/reference/integrations/axiom/actions/create-notifier)
* [Get notifier](/reference/integrations/axiom/actions/get-notifier)
* [Update notifier](/reference/integrations/axiom/actions/update-notifier)
* [Delete notifier](/reference/integrations/axiom/actions/delete-notifier)
* [List saved queries](/reference/integrations/axiom/actions/list-saved-queries)
* [Create saved query](/reference/integrations/axiom/actions/create-saved-query)
* [Get saved query](/reference/integrations/axiom/actions/get-saved-query)
* [Update saved query](/reference/integrations/axiom/actions/update-saved-query)
* [Delete saved query](/reference/integrations/axiom/actions/delete-saved-query)
* [List dashboards](/reference/integrations/axiom/actions/list-dashboards)
* [Create dashboard](/reference/integrations/axiom/actions/create-dashboard)
* [Get dashboard](/reference/integrations/axiom/actions/get-dashboard)
* [Update dashboard](/reference/integrations/axiom/actions/update-dashboard)
* [Delete dashboard](/reference/integrations/axiom/actions/delete-dashboard)
* [Update dashboard chart](/reference/integrations/axiom/actions/update-dashboard-chart)
