RousselTMLEARNING

Artículo · ClickStack: del descubrimiento a la maestría

Explorar con la interfaz de ClickStack

Este artículo está disponible en francés.

1. Les sources #

Ce que l'interface interroge.

Le principe #

Disponible dans : ✓ Open source ✓ Managed ClickStack

Une source décrit une table ClickHouse et la façon de la lire : colonne de temps, corps du message, niveau, nom du service, identifiants de trace. ClickStack crée les sources par défaut au premier compte ; on peut en ajouter pour toute table ClickHouse, y compris vos propres données.

SourceTableUsage
Logsotel_logsrecherche, suivi en direct, graphiques
Tracesotel_tracesrecherche de spans, cascade, latence
Métriquesotel_metrics_gauge, _sum, _histogram…graphiques et dashboards
Sessionshyperdx_sessionsrejeu des sessions navigateur
Bonne Pratique : Reliez les sources entre elles (logs ↔ traces ↔ sessions) dans leurs réglages : c'est ce qui active les liens de corrélation dans l'interface.

2. Chercher #

Propriétés, plein texte ou SQL.

Syntaxe de recherche #

RechercheTrouve
timeoutles événements dont le corps contient « timeout »
"connection refused"l'expression exacte
level:errniveau d'erreur (propriété)
service:checkout level:errles deux conditions (ET implicite)
service:checkout OR service:paymentsl'une ou l'autre
-level:info / NOT level:infoexclure
http.status_code:500un attribut (clé de la colonne Map)

Le mode SQL accepte une condition WHERE directement : SeverityText = 'error' AND LogAttributes['http.route'] LIKE '/api/%'. Pratique pour les fonctions de ClickHouse (expressions régulières, comparaisons numériques).

Explorer les résultats #

  • Suivi en direct (live tail) : les nouveaux événements défilent pendant un déploiement ou un test.
  • Histogramme du nombre d'événements dans le temps : cliquez-glissez pour zoomer sur un pic.
  • Colonnes : ajoutez un attribut comme colonne, filtrez sur une valeur d'un clic depuis le détail d'un événement.
  • Recherches enregistrées : réutilisables, partageables, et base des alertes.

3. Traces, logs et sessions #

Corréler les signaux.

Le parcours #

Corrélation dans ClickStack
  • Trace : la cascade montre chaque span, sa durée et ses attributs ; les logs émis pendant chaque span sont affichés à côté.
  • Du log à la trace : un log qui porte un TraceId ouvre la trace complète de la requête.
  • De la trace à la session : si le SDK navigateur est en place, la session de l'utilisateur, son parcours et son rejeu.

Une enquête type #

  1. Une alerte signale des erreurs : recherchez service:checkout level:err sur la dernière heure.
  2. L'histogramme montre le début du problème ; le détail d'un log donne l'attribut http.route en cause.
  3. Ouvrez la trace : le span le plus long est un appel à la base de données qui expire.
  4. La session montre l'action de l'utilisateur et le message d'erreur affiché.
  5. Mesurez l'ampleur en SQL (nombre d'utilisateurs touchés) avant de communiquer.

4. Aller plus loin en SQL #

Quand l'interface ne suffit plus.

Requêtes utiles #

-- Utilisateurs distincts touchés par l'erreur sur la dernière heure
SELECT uniq(LogAttributes['user.id']) AS utilisateurs
FROM otel_logs
WHERE ServiceName = 'checkout' AND SeverityText ILIKE 'err%' AND Timestamp > now() - INTERVAL 1 HOUR;

-- Routes les plus lentes (p95) à partir des traces
SELECT SpanAttributes['http.route'] AS route, quantile(0.95)(Duration) / 1e6 AS p95_ms, count() AS appels
FROM otel_traces
WHERE ServiceName = 'checkout' AND SpanKind = 'Server' AND Timestamp > now() - INTERVAL 1 HOUR
GROUP BY route ORDER BY p95_ms DESC LIMIT 10;
À savoir : En Managed ClickStack, des notebooks assistés par l'IA aident à écrire ces analyses ; vérifiez toujours la requête générée avant de vous fier au résultat.

Commandes à connaître #

Commandes à connaître
  • service:checkout level:err : recherche par propriétés
  • "connection refused" : expression exacte
  • -level:info : exclusion
  • LogAttributes['http.route'] : lire un attribut en SQL
  • quantile(0.95)(Duration) / 1e6 : latence p95 en millisecondes

Sources #

Vérifié en novembre 2026 : ClickStack évolue vite (Managed ClickStack est en bêta), consultez la documentation de ClickHouse avant de vous appuyer sur un détail.

📄 Explorer avec l'interface ClickStack : sources, recherche, traces, sessions et SQL →

Mi seguimiento

  • ⏱ Duración estimada : ≈ 5 min

Inicia sesión para seguir tu progreso y tomar notas. Iniciar sesión

💬 Preguntas sobre esta lección

Todavía no hay preguntas: sé el primero en pedir ayuda o compartir tu configuración.

Hacer una pregunta sobre esta lección →

Artículos recomendados

Envoyer la télémétrie à ClickStack : SDK OpenTelemetry, collecteurs, logs, Kubernetes et sessions navigateur

Alimenter ClickStack : clé d'ingestion, variables OpenTelemetry des SDK, relais par un collecteur...

ClickStack : architecture, composants et offres (ClickHouse, HyperDX, OpenTelemetry)

ClickStack, la pile d'observabilité officielle de ClickHouse : rôle de ClickHouse, de l'interface...

Alertes et dashboards dans ClickStack

Construire des graphiques et des dashboards dans ClickStack, créer des alertes sur une recherche ...

L'observabilité sur ClickHouse : pourquoi une base colonne change la donne

Pourquoi de plus en plus de plateformes d'observabilité stockent logs, traces et métriques dans C...

La télémétrie dans ClickHouse : schéma, SQL, vues matérialisées et rétention

La télémétrie dans ClickHouse : tables otel_logs, otel_traces, otel_metrics_* et hyperdx_sessions...

Bonnes pratiques SigNoz, ClickStack et ClickHouse pour l'observabilité

Bonnes pratiques pour l'observabilité sur ClickHouse avec SigNoz ou ClickStack : instrumentation ...

Exploiter ClickHouse pour ClickStack : dimensionnement, réplication, surveillance, sécurité et sauvegarde

Faire tourner ClickHouse en production pour l'observabilité : estimer le volume et le disque, rép...

Installer et déployer ClickStack : tout-en-un, Docker Compose, Helm et Managed ClickStack

Déployer ClickStack selon le besoin : conteneur tout-en-un avec persistance, Docker Compose et se...

Exploiter une plateforme d'observabilité sur ClickHouse et choisir son outil

Exploiter ClickHouse pour la télémétrie (réplication, disques, fusions, stockage objet, supervisi...

Apoyar

♥ APOYAR

Apoya RousselTM Learning

Los cursos, artículos, prácticas y certificados siguen siendo gratuitos y sin publicidad intrusiva. Una contribución libre, por el importe que elijas, financia el alojamiento, los entornos de prácticas y nuevos contenidos.

Contribuir con PayPal Importe libre · tarjeta o cuenta PayPalMás información
QR code PayPal
O escanea este código QR con tu teléfono

¡Gracias, cada contribución cuenta!