axiom-alerting

Create and manage Axiom monitors and notifiers through the v2 public API.

9.4k|1.5k|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/openclaw/clawhub --skill axiom-alerting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-alerting
Source: https://github.com/openclaw/clawhub/tree/main/.agents/skills/axiom-alerting
Command: npx skills add https://github.com/openclaw/clawhub --skill axiom-alerting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) components.

What problem does it solve?

Managing Axiom alerting configuration manually through the UI or raw API calls is repetitive and error-prone, especially when wiring notifiers to monitors and validating alert behavior across deployments.

Core Features & Use Cases

  • Monitor Lifecycle Management: List, get, create, update, delete monitors, and inspect monitor history over time ranges via the Axiom v2 API.
  • Notifier Lifecycle Management: Create and maintain email, Slack, and custom webhook notifiers, then attach them to monitors using notifierIds.
  • Alert Tuning & Validation: Diagnose noisy or silent monitors by checking history and adjusting thresholds, rangeMinutes, intervalMinutes, and N-of-M trigger fields.
  • Use Case: You need to alert the on-call team when error logs spike. Create a Slack notifier, attach it to a Threshold monitor with an APL query, then verify firing behavior with monitor history.

Quick Start

Run the setup script, then ask the agent to list existing notifiers and create a threshold monitor for error logs wired to an email notifier in the prod deployment.

Frequently Asked Questions about axiom-alerting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Axiom monitor with the v2 API?

Write a JSON payload with name, type, query, threshold, and notifierIds, then run the monitor-create script with your deployment name and the JSON file. The script POSTs the body to /v2/monitors using credentials from ~/.axiom.toml.

How do I attach a notifier to an Axiom monitor?

Create the notifier first with notifier-create, then include its ID in the monitor's notifierIds array when creating or updating the monitor. The monitor payload references notifiers only by ID.

What monitor types does the Axiom v2 API support?

The API supports Threshold, MatchEvent, and AnomalyDetection monitor types. Threshold monitors use operators like Above or BelowOrEqual, while anomaly monitors use AboveOrBelow with a columnName field.

Why is my Axiom monitor not firing alerts?

Common causes are thresholds set too strict, a query window that misses data, or N-of-M trigger settings requiring more positive runs. Inspect firing behavior with monitor-history over a known active period, then lower the threshold or widen rangeMinutes.

Why does Axiom notifier creation return 400 Bad Request?

The payload shape is likely invalid. Use exactly one channel inside properties, and for email notifiers use the emails field rather than recipients. Validate against a known-good example before retrying.

What credentials are required to use the Axiom v2 API?

You need an Axiom API token, organization ID, and deployment URL stored in ~/.axiom.toml under a [deployments.<name>] section. The scripts read these values and send them as Bearer token and X-Axiom-Org-Id headers.