npx skills add ...
npx skills add axiomhq/cli --skill axiom-apl
npx skills add axiomhq/cli --skill axiom-apl
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.
APL 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
Never guess field names. The schema shows all fields with their types.
See references for operators, functions, and patterns.
Always filter by time first - it's the most selective filter.
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 skillfield_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// 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))