Terminal
Terminal/Skill
APL query language reference for Axiom. Provides operators, functions, patterns, and CLI usage. Auto-invoked by specialized Axiom skills when writing or debugging APL queries.
By Axiom
Works with
npx skills add axiomhq/cli --skill axiom-aplAPL is Axiom's query language for analyzing observability data. This skill provides comprehensive guidance for writing, debugging, and optimizing APL queries.
Documentation: https://axiom.co/docs/apl/introduction
CLI usage: See references/cli.md
axiom dataset list -f json
['<dataset>'] | getschema
Never guess field names. The schema shows all fields with their types.
['<dataset>'] | limit 10
See references for operators, functions, and patterns.
['dataset-name'] // Bracket notation (required for names with dots/dashes)
dataset_name // Plain identifier (only for simple names)
field_name // Plain field
['field.with.dots'] // Bracket notation for dotted fields
['service.name'] // OTel data (see references/otel.md for field mappings)
['dataset']
| where <condition>
| extend <new_field> = <expression>
| summarize <aggregation> by <grouping>
| project <fields>
| sort by <field> desc
| limit 100
Always filter by time first - it's the most selective filter.
// Relative time
| where _time >= ago(1h)
| where _time >= ago(24h) and _time < ago(1h)
// Absolute time
| where _time >= datetime(2024-01-15T10:00:00Z)
| where _time between (datetime(2024-01-15) .. datetime(2024-01-16))
Time functions:
ago(timespan) - Relative past timenow() - Current timedatetime(string) - Parse datetimebin(_time, 5m) - Time bucketingbin_auto(_time) - Automatic bucketinggetschema directly instead of invoking the full skill