Axiom est un service fermé de collecte de logs et d'événements, avec son propre langage de requête APL et des clients JavaScript sous licence MIT. La version actuelle de @axiomhq/js est la 2.0.0, publiée le 4 août 2026, et le passage depuis la version 1 change la forme par défaut du résultat d'une requête : ce n'est donc pas une mise à jour qu'on fait sans lire la documentation.
Ce qu'Axiom fait et ne fait pas
L'hypothèse de départ est que tu envoies les logs en entier, pas sous forme d'échantillon. Au lieu de décider à l'écriture quels événements garder, tu envoies tout dans un dataset, et le coût se reporte sur le stockage et sur la puissance de calcul consommée par les requêtes. Le moteur s'appelle EventDB, il est en colonnes et sans schéma, donc un nouveau champ dans un événement ne demande aucune migration préalable.
Les requêtes s'écrivent en APL, un langage dans le style de Kusto avec des opérateurs reliés par un caractère pipe. La documentation énonce clairement une limitation importante : APL n'interroge pas les métriques. Les métriques utilisent un langage distinct, MPL, avec son propre endpoint et son propre type de résultat dans le client. Si tu comptais sur un seul langage pour tout, il faut tenir compte de cette séparation dès le départ.
Ce qu'Axiom ne fait pas. Il ne regroupe pas les exceptions en issues avec un responsable assigné, ce qui est le terrain de Sentry. Il ne calcule pas les entonnoirs d'inscription ni la rétention des utilisateurs, le travail de PostHog. Il ne décompose pas un appel à un modèle de langage en étapes avec le coût en tokens, ce qui revient à Langfuse ou Helicone. Ce n'est pas non plus une base de données généraliste que tu brancherais sur des rapports financiers, comme tu le ferais avec ClickHouse.
La licence : MIT s'arrête au client
J'ai vérifié la licence sous trois angles et cette fois les trois concordent sans réserve, au moins pour les bibliothèques.
D'abord, le dépôt. Le fichier LICENSE sur la branche principale de axiomhq/axiom-js répond 200 et contient dix-neuf lignes du texte MIT complet, avec l'en-tête Copyright (c) 2021, Axiom, Inc.. Le fichier ne commence pas par une ligne de titre MIT License, donc les scanners qui cherchent un titre plutôt qu'un corps de texte peuvent le signaler comme non reconnu. Il n'y a pas de LICENSE.md dans ce dépôt ; l'adresse renvoie 404.
Ensuite, le registre. Le champ license dans le registre npm indique MIT pour chaque paquet vérifié de l'espace de noms @axiomhq, c'est-à-dire js, logging, nextjs, react, pino, winston et tanstack-start.
Enfin, le contenu de l'archive publiée. L'archive de @axiomhq/js 2.0.0 contient LICENSE, README.md, CHANGELOG.md, un dossier src avec les sources TypeScript, et un dossier dist d'environ 668 kilo-octets avec les builds CommonJS et ESM plus les source maps. C'est du vrai code, pas un paquet vide qui ne fait que réserver un nom. L'archive de @axiomhq/logging 0.4.0 a le même aspect, avec en plus un dossier test.
Et maintenant ce qu'il faut dire clairement, car une licence MIT sur les clients peut endormir la vigilance. MIT ne couvre que les bibliothèques clientes. Le stockage des données et le moteur de requête sont fermés, et il n'existe aucune variante auto-hébergée. Le tableau de comparaison des offres sur la page de tarifs liste un seul mode de déploiement, géré, et ne comporte aucune ligne pour une option installée soi-même.
La conséquence est plus lourde ici que pour la plupart des services. Les données de logs comptent parmi les plus pénibles à migrer : le volume se chiffre en téraoctets, le format est sans schéma, et les requêtes et tableaux de bord écrits en APL ne se portent nulle part, car APL n'est pas un standard. Quitter Axiom, c'est réécrire chaque requête, chaque alerte, et exporter un historique que tu paieras en puissance de calcul de requêtes. Si tu y conserves des données d'audit avec une fenêtre de rétention d'un an, le verrouillage chez le fournisseur est un vrai risque métier et non théorique.
Versions des paquets et passage à la 2.0
La famille de paquets sort d'un seul dépôt via un outillage qui synchronise les numéros de version par lots. Au 22 août 2026, l'état est le suivant.
| Paquet | Version | Publication npm | Remarques |
|---|---|---|---|
@axiomhq/js | 2.0.0 | 2026-08-04 | une dépendance, fetch-retry, engines.node au moins 20 |
@axiomhq/logging | 0.4.0 | 2026-08-04 | aucune dépendance de production, peer @axiomhq/js dans la plage ^1.0.0 |
@axiomhq/nextjs | 0.4.0 | 2026-08-04 | peer next au moins 13, peer @axiomhq/logging exactement 0.4.0 |
@axiomhq/react | 0.4.0 | 2026-08-04 | dépend de web-vitals et use-deep-compare |
@axiomhq/pino | 2.0.0 | 2026-08-04 | dépend de @axiomhq/js exactement 2.0.0 |
@axiomhq/winston | 2.0.0 | 2026-08-04 | dépend de @axiomhq/js exactement 2.0.0 |
@axiomhq/tanstack-start | 0.2.0 | 2026-06-29 | peer @axiomhq/logging exactement 0.3.0 |
@axiomhq/ai | 0.8.0 | 2025-08-04 | abandonné, remplacé par le paquet axiom |
Trois incohérences apparaissent tout de suite. La première est la plus grave, car elle touche la combinaison que la plupart des gens choisiront : @axiomhq/logging 0.4.0, publié le même jour que le cœur 2.0, déclare une dépendance peer sur @axiomhq/js dans la plage ^1.0.0. Le cœur actuel est numéroté 2.0.0, donc la plage ne le couvre pas, et installer ensemble les deux paquets actuels signale un conflit. Le contournement consiste à garder le cœur sur la ligne version 1 ou à faire taire l'avertissement, ce qui revient à tourner sur une combinaison que le fournisseur n'a jamais déclarée comme prise en charge.
Deuxième point : @axiomhq/tanstack-start n'a pas été incrémenté dans le lot d'août et épingle toujours @axiomhq/logging à exactement 0.3.0. Installe @axiomhq/nextjs 0.4.0 dans le même projet et tu obtiens un conflit de dépendances peer, car les deux déclarations sont rigides, sans plage.
La troisième incohérence est pire parce qu'elle est silencieuse. @axiomhq/ai s'est arrêté à la 0.8.0 le 4 août 2025 et porte toujours le tag latest, mais n'a jamais été marqué comme déprécié. Le développement est passé à un paquet nommé simplement axiom, version 0.52.2 du 12 mai 2026, qui pointe vers le dépôt axiomhq/ai sous packages/ai. J'ai vérifié s'il s'agissait d'un nom squatté : la description, l'adresse du dépôt et la liste des mainteneurs correspondent au reste des paquets Axiom. Cette archive contient un LICENSE.md avec le texte MIT et un dossier dist d'environ 2 mégaoctets, mais pas de dossier src. Dans le dépôt axiomhq/ai, le fichier de licence s'appelle LICENSE.md, donc un scanner qui cherche LICENSE le signalera comme absent.
Le passage à la 2.0 lui-même contient exactement un changement cassant, détaillé dans le changelog : les requêtes APL sans format explicite renvoient désormais un résultat tabulaire. Le défaut précédent était le format legacy, avec une structure de réponse différente. La migration revient à décider si tu ajoutes format: 'legacy' à chaque appel existant ou si tu réécris le code qui lit le résultat. Par ailleurs, une option fetch est arrivée dans ClientOptions, qui te permet de fournir ta propre implémentation, ainsi que la gestion des réponses qui ne sont pas du JSON.
Les versions précédentes valent la peine d'être retracées, car plusieurs changements affectent le comportement à l'exécution. La version 1.6.0 du 30 mars 2026 a activé par défaut la compression gzip des charges d'ingestion. La version 1.6.1 du 6 mai 2026 a corrigé la logique de regroupement des événements. La version 1.7.0, publiée le 17 juin 2026, est passée à l'API v2 des datasets, a ajouté les métriques et la prise en charge de MPL, ainsi que des opérations en lecture seule pour les tableaux de bord, les requêtes enregistrées et les utilisateurs. La version 1.8.0 du 29 juin 2026 a ajouté l'en-tête X-Axiom-Client.
Attention aux dates. Le changelog date la 1.7.0 du 9 juin et la 1.8.0 du 25 juin, alors que les publications npm datent respectivement des 17 et 29 juin. C'est un écart normal entre la fusion et la publication, mais si tu construis une chronologie à partir d'une seule source, tu obtiendras des chiffres différents de ceux de l'autre. Une curiosité du registre : plus de treize mois se sont écoulés entre les publications 1.3.1 et 1.4.0, du 16 décembre 2024 au 27 janvier 2026.
Chaque paquet actuel exige Node 20 ou supérieur. Le README du paquet Next.js le dit sans ambiguïté : Node 18 n'est plus pris en charge.
À quoi ça ressemble dans le code
Installer l'ensemble pour une application Next.js tient en une commande tirée du README du paquet.
npm install @axiomhq/js @axiomhq/logging @axiomhq/nextjs @axiomhq/reactLe client lui-même n'exige que token comme champ obligatoire. orgId n'est nécessaire qu'avec un token personnel, url pointe vers l'adresse de l'API pour les opérations d'administration, et edge route l'ingestion et les requêtes vers un domaine edge.
import { Axiom } from '@axiomhq/js'
const axiom = new Axiom({
token: process.env.AXIOM_TOKEN!,
orgId: process.env.AXIOM_ORG_ID,
url: 'https://api.eu.axiom.co'
})
const status = await axiom.ingest('web-logs', [{ path: '/checkout', ms: 128 }], {
timestampField: 'ts',
timestampFormat: 'unix'
})
console.log(status.ingested, status.failed, status.processedBytes)
await axiom.flush()La classe Axiom regroupe les événements par lots, donc dans un processus de courte durée, une fonction serverless par exemple, flush est obligatoire. Si tu préfères une livraison immédiate, utilise la classe AxiomWithoutBatching exportée à côté. L'IngestStatus renvoyé contient ingested, failed, failures, processedBytes, blocksCreated et walLength.
Une requête APL, et l'endroit où le changement de la 2.0 se fait sentir.
const tabular = await axiom.query(`
['web-logs']
| where ms > 500
| summarize count() by bin_auto(_time), path
`, {
startTime: '2026-08-01T00:00:00Z',
endTime: '2026-08-22T00:00:00Z',
noCache: true
})
const legacy = await axiom.query("['web-logs'] | count", { format: 'legacy' })Sans champ format, tu obtiens un TabularQueryResult. Avec 'legacy', tu obtiens un QueryResult dans l'ancienne forme. Les signatures sont surchargées, donc TypeScript signale la différence immédiatement, mais le code JavaScript pur ne cassera qu'à l'exécution.
Le logger est un paquet séparé, et depuis la 0.4.0 il peut valider les champs d'un événement avec n'importe quel validateur qui implémente Standard Schema.
import { z } from 'zod'
import { Logger, ConsoleTransport, AxiomJSTransport } from '@axiomhq/logging'
const LogFieldsSchema = z.object({
userId: z.string(),
action: z.enum(['login', 'logout'])
}).strict()
export const logger = new Logger({
transports: [
new AxiomJSTransport({ axiom, dataset: process.env.AXIOM_DATASET!, logLevel: 'info' }),
new ConsoleTransport({ prettyPrint: true })
],
schema: LogFieldsSchema,
onValidationError: (context) => {
console.warn('Dropped invalid log', context.stage, context.reason, context.issues)
}
})
logger.info('User action', { userId: '123', action: 'login' })Un événement qui échoue à la validation est abandonné avant d'atteindre un transport, donc onValidationError est le seul endroit où tu en seras informé. La méthode logger.raw contourne la validation. Un champ outputSchema vérifie l'événement après son passage par les formatters.
Le brancher à une route Next.js ressemble à ceci.
import { createAxiomRouteHandler, nextJsFormatters } from '@axiomhq/nextjs'
export const withAxiom = createAxiomRouteHandler(logger)
export const GET = withAxiom(async () => {
logger.info('Hello World!')
return new Response('Hello World!')
})Tarifs : trois compteurs et l'arithmétique
La page de tarifs s'affiche sans JavaScript, donc les chiffres ci-dessous viennent du HTML brut récupéré le 22 août 2026, et non de la lecture d'un écran.
Il y a trois compteurs, et c'est l'essentiel à comprendre : le chargement des données mesuré en gigaoctets, la puissance de calcul des requêtes mesurée en gigaoctets-heures, et le stockage mesuré en gigaoctets. La réponse à la question de savoir si les requêtes sont facturées séparément est donc oui, via un compteur distinct en gigaoctets-heures.
| Élément | Personal | Axiom Cloud |
|---|---|---|
| Frais fixes | 0 USD par mois, de façon permanente | 25 USD par mois plus l'usage |
| Chargement de données inclus | 500 Go par mois | 1 To par mois |
| Calcul de requêtes inclus | 10 Go-heures par mois | 100 Go-heures par mois |
| Stockage inclus | 25 Go | 100 Go |
| Rétention | 30 jours | configurable |
| Remises de volume | aucune | automatiques, selon des seuils |
| Crédits prépayés | aucun | jusqu'à 30 pour cent de remise, sans expiration |
| Plafond de dépenses | non applicable | oui, dans la console |
| Support | communauté | e-mail inclus, SLA en option |
Les options entreprise s'achètent dans la console à prix fixes : SAML SSO à 100 USD par mois, SCIM Directory Sync à 100 USD par mois, contrôle d'accès basé sur les rôles à 50 USD par mois, journal d'audit à 50 USD par mois. Les quatre ensemble reviennent à 300 USD par mois, soit douze fois les frais fixes et 3 600 USD par an en plus de l'usage. Quiconque a besoin du SSO pour des raisons de conformité devrait commencer son calcul par ce chiffre, pas par vingt-cinq dollars.
Ce qui se passe au-delà de l'allocation. La section des questions dit que le paiement à l'usage se déclenche automatiquement, mais la portée de cette phrase est restreinte à l'offre Axiom Cloud. Les tarifs unitaires baisseraient aux seuils supérieurs. Une question distincte sur les limites de dépenses répond que l'usage au-delà de la limite est mis en pause plutôt que facturé automatiquement. Cela signifie que tu achètes un plafond de dépenses strict au prix d'une perte de données, car une ingestion en pause, ce sont des événements que tu ne récupéreras pas plus tard.
Ce que la page ne te donne pas. Nulle part dans le HTML récupéré on ne trouve de tarifs unitaires par gigaoctet chargé, par gigaoctet-heure ou par gigaoctet de stockage. Le calculateur les calcule dans le navigateur. La page annonce une grille tarifaire lisible par machine à /pricing.md, mais cette adresse renvoie 404, ce que j'ai vérifié le même jour. Une facture au-delà de l'allocation ne peut donc pas être calculée à partir de chiffres publiés, et je ne devinerai pas ces tarifs.
Voici maintenant les exemples promis. Je suppose que le stockage compte le volume réellement conservé dans la fenêtre de rétention, car la page ne précise pas s'il s'agit des données avant ou après compression. C'est une hypothèse, pas une règle confirmée.
Une application qui produit 10 Go de logs par mois. Le chargement tient largement dans les deux offres. Avec une rétention de trente jours, environ 10 Go sont en stockage, sous la limite de 25 Go de Personal. Les requêtes tiennent dans dix gigaoctets-heures, tant que tu ne rafraîchis pas des tableaux de bord sur tout l'historique toutes les quelques secondes. La facture Personal est de zéro. Sur Axiom Cloud, elle est de 25 USD par mois, soit 300 USD par an, et ces 300 dollars paient les frais fixes et les options, pas le volume de logs, car le volume ne contribue à rien ici.
Une application qui produit 100 Go de logs par mois. Le chargement tient encore dans l'allocation des deux offres. Le stockage, lui, ne tient plus. Avec une rétention de trente jours, tu conserves environ 100 Go, soit quatre fois la limite de Personal. La page ne dit pas ce qui se passe alors sur une offre sans paiement à l'usage, car la réponse sur les dépassements est limitée à Axiom Cloud. Sur Axiom Cloud, 100 Go correspond exactement à la limite de l'allocation, donc la facture est de 25 USD par mois tant que tu ne la dépasses pas d'un seul gigaoctet. Au-dessus s'appliquent des tarifs que le fournisseur ne publie pas.
Enfin, une divergence que j'ai trouvée sur cette même page. La carte de l'offre et le tableau de comparaison placent tous deux l'allocation de stockage d'Axiom Cloud à 100 Go. Le calculateur, dans son réglage par défaut, à un téraoctet chargé par mois, affiche dans le détail une ligne de stockage indiquant 12 TB retained · within free allowance avec la valeur Included. Douze téraoctets, c'est cent vingt fois cent gigaoctets. Je rapporte les deux chiffres, car les deux figurent dans le même document et je ne peux pas déterminer lequel décrit la règle de facturation.
Axiom face à Sentry, PostHog et les autres
L'erreur la plus courante dans cette catégorie n'est pas de choisir le mauvais outil, c'est d'en acheter quatre à la fois et de payer quatre fois le même événement. Ces outils ne se remplacent pas, ils répondent à des questions différentes.
| Outil | Question à laquelle il répond | Unité de données | Modèle |
|---|---|---|---|
| Axiom | ce qui s'est exactement passé dans le système à 3 h 14 | un événement avec des champs arbitraires | service fermé, clients MIT |
| Sentry | quelle exception casse le plus de sessions | une erreur avec stack trace et regroupement | service avec variante auto-hébergée |
| PostHog | les utilisateurs terminent-ils l'inscription | un événement produit avec une identité | service avec variante auto-hébergée |
| Langfuse, Helicone | ce qu'un appel au modèle a coûté et où il a calé | une trace d'appel avec des tokens | service avec variante auto-hébergée |
| ClickHouse | n'importe quoi, si tu construis toi-même la plateforme | une ligne dans une table au schéma imposé | une base de données que tu exploites |
La différence avec Sentry est celle qu'on brouille le plus souvent, donc je la détaille à part. Sentry prend une exception, calcule son empreinte, replie mille occurrences en une seule issue, attache le contexte de la release et assigne un responsable. Axiom prend un événement brut et ne suppose rien à son sujet. Quand tu sais que quelque chose casse et que tu veux comprendre pourquoi, tu vas dans Axiom chercher le contexte complet de la requête. Quand tu veux savoir ce qui casse le plus souvent et depuis quel déploiement, tu vas dans Sentry. Envoyer chaque exception dans Axiom et essayer de reconstituer le regroupement en APL finit avec ton propre Sentry maintenu après les heures de travail.
Face à la pile de logs classique, Elasticsearch avec une couche de recherche par-dessus, Axiom vend surtout l'absence d'un cluster à exploiter. C'est une vraie économie dans une équipe sans administrateur, mais tu l'achètes au prix du verrouillage décrit plus haut. Face à ClickHouse, le schéma est encore plus simple : ClickHouse est un moteur, Axiom est une plateforme finie construite sur un moteur de cette classe. La question est de savoir si tu veux exploiter une base de données, pas quel moteur est le plus rapide.
Deux couches valent la peine d'être distinguées, car on les confond facilement. Axiom stocke des événements et te permet de les interroger, tandis que Grafana ne stocke rien : il dessine des tableaux de bord sur des données qui vivent ailleurs. Ce ne sont donc pas des alternatives, et dans beaucoup de déploiements elles coexistent. Deux choses sur Grafana valent la peine d'être connues avant de décider : depuis la version 8 il est sous AGPL, avec un LICENSING.md distinct qui liste treize dossiers restés sous Apache 2.0, et un tableau complet exige tout de même des sources de données, car Grafana ne collecte rien lui-même.
Erreurs courantes
Passer à la 2.0.0 sans lire une seule ligne du changelog. Une requête sans champ format renvoie désormais une autre forme de résultat. En TypeScript tu obtiens une erreur de compilation, en JavaScript pur tu obtiens undefined en production.
Installer @axiomhq/ai en croyant que c'est le paquet actuel pour tracer les appels aux modèles. Il porte le tag latest, il n'est pas marqué comme déprécié, et sa dernière publication date d'août 2025. Le développement vit dans le paquet axiom.
Poser @axiomhq/tanstack-start à côté d'un @axiomhq/nextjs actuel. Le premier épingle @axiomhq/logging à la 0.3.0, le second à la 0.4.0, les deux déclarations sans plage.
Rester sur Node 18. Chaque paquet actuel fixe engines.node à au moins 20, et le README le dit sans détour.
Acheter un plafond de dépenses strict sans comprendre ce qu'il fait. L'usage au-delà de la limite est mis en pause, donc tu protèges la facture au prix d'un trou dans les données précisément quand quelque chose s'est mal passé et que les logs sont les plus volumineux.
Ne surveiller que le compteur de chargement. Le calcul des requêtes est facturé séparément, donc un tableau de bord qui se rafraîchit toutes les dix secondes sur une fenêtre d'un an peut consommer l'allocation en gigaoctets-heures pour un volume de logs négligeable.
Faire confiance à un scanner de licences automatique. Dans axiomhq/axiom-js le fichier s'appelle LICENSE et n'a pas de ligne de titre, dans axiomhq/ai il s'appelle LICENSE.md, et l'archive du paquet axiom n'a pas de dossier src. N'importe lequel de ces points peut produire une fausse alerte ou un faux réconfort.
FAQ
Axiom peut-il être auto-hébergé ?
Non. La licence MIT ne couvre que les bibliothèques clientes du dépôt axiom-js. Le stockage EventDB et le moteur de requête sont fermés, et le tableau de comparaison des offres liste un seul mode de déploiement, géré par le fournisseur.
Combien coûtent réellement cent gigaoctets de logs par mois ?
Sur Axiom Cloud, 25 USD par mois tant que tu restes dans l'allocation de stockage de cent gigaoctets, ce qui, avec une rétention de trente jours, est une limite à un cheveu près. Les tarifs au-delà de l'allocation ne sont pas publiés sur la page de tarifs, et la grille annoncée à /pricing.md renvoie 404.
Qu'est-ce qui a changé dans la version 2.0.0 du client JavaScript ?
Un changement cassant : une requête APL sans champ format explicite renvoie désormais un résultat tabulaire au lieu de l'ancien format legacy. La version est sortie le 4 août 2026. Une option fetch a aussi été ajoutée à ClientOptions.
Axiom remplace-t-il Sentry ?
Non. Sentry regroupe les exceptions en issues avec une empreinte, un contexte de release et un responsable. Axiom stocke des événements bruts et ne suppose rien de leur structure. Les deux répondent à des questions différentes et se retrouvent le plus souvent côte à côte.
L'offre gratuite est-elle prête pour la production ?
Pour un petit service, oui : 500 Go de chargement par mois et 30 jours de rétention couvrent de nombreuses applications. Les contraintes sont 25 Go de stockage, dix gigaoctets-heures de requêtes et un support limité à la communauté. La page ne précise pas ce qui se passe une fois l'allocation dépassée sur Personal.
APL interroge-t-il les métriques ?
Non. La documentation indique clairement que les métriques utilisent un langage distinct, MPL, avec son propre endpoint. Le client reflète cette séparation via mplQuery et le type MetricsQueryOptions à côté du query ordinaire.