Liens profonds

Vous pouvez ouvrir des pages ClickStack à l’aide de liens profonds et de paramètres de requête d’URL, afin d’accéder directement à une recherche, un tableau de bord ou un panneau spécifique depuis un système externe (notification d’alerte, runbook, job d’intégration continue, message de chat, etc.). Les exemples de cette page utilisent <YOUR_CLICKSTACK_URL>. Remplacez-le par votre URL ClickStack — par exemple http://localhost:8080 pour un déploiement local open source, ou https://hyperdx.clickhouse.cloud pour Managed ClickStack dans ClickHouse Cloud.

Les exemples présentent des paramètres de requête sans encodage d’URL pour faciliter la lecture. Lorsque vous générez des liens par programmation, encodez chaque valeur de paramètre de requête dans l’URL.

Paramètre d’ID de service Managed ClickStackLorsque vous utilisez Managed ClickStack dans ClickHouse Cloud, les liens doivent inclure le paramètre ?chcServiceId= afin d’identifier le service ClickHouse Cloud à charger si l’utilisateur authentifié qui suit le lien est autorisé à utiliser plusieurs services ClickHouse Cloud.Exemple : ouvrir Search pour un service Cloud spécifique

https://hyperdx.clickhouse.cloud/search?chcServiceId=abc123

Search — `/search`

La principale vue de recherche de logs et de traces. Consultez Search pour plus de détails sur la syntaxe de recherche.

Paramètre	Format	Description
`source`	string	La source à rechercher — accepte un ID de source ou un nom de source (par ex. `Logs`). Seules les sources Log et Trace sont prises en charge sur cette page.
`where`	string	Texte de la requête de filtre, en syntaxe Lucene ou SQL (voir `whereLanguage`).
`whereLanguage`	`lucene`	`sql`	Langage de requête dans lequel est écrit `where`.
`select`	string	Liste de colonnes et d’expressions SQL à afficher dans le tableau des résultats.
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	Filtres de facettes structurés, appliqués en plus de `where`.
`orderBy`	string	Expression de tri SQL pour le tableau des résultats.
`mode`	`results`	`delta`	`pattern`	Mode d’analyse actif. `delta` est disponible uniquement pour les sources de traces.
`isLive`	`true`	`false`	Indique si le suivi en direct est activé (valeur par défaut : `true`).
`traceId`	string	Accède directement à une vue en cascade de trace correspondant à l’ID de trace indiqué.
`from`, `to`	millisecondes depuis l’époque Unix	Intervalle de temps absolu. S’ils sont omis, les 15 dernières minutes sont utilisées par défaut.

Une recherche enregistrée peut également être ouverte directement à l’adresse /search/<savedSearchId>.

Exemple : rechercher les erreurs du service `checkout` dans la source `Logs` sur un intervalle de temps

<YOUR_CLICKSTACK_URL>/search?source=Logs&from=1735689600000&to=1735693200000&where=level:error&filters=[{"type":"sql","condition":"ServiceName IN ('checkout')"}]

Exemple : accéder directement à la vue en cascade d’une trace

<YOUR_CLICKSTACK_URL>/search?source=Traces&traceId=ba7217967eb90d040b7eb39f97ecc5c4

Recherches enregistrées — `/search/list`

Liste des recherches enregistrées.

Paramètre	Format	Description
`tag`	chaîne	Filtre la liste pour n’afficher que les recherches enregistrées associées à ce tag.

Exemple : lister les recherches enregistrées avec le tag `production`

<YOUR_CLICKSTACK_URL>/search/list?tag=production

Tableaux de bord — `/dashboards/<dashboardId>`

Un tableau de bord enregistré. Omettez <dashboardId> (/dashboards) pour ouvrir un tableau de bord temporaire non enregistré. Consultez Tableaux de bord pour en savoir plus sur la création de tableaux de bord.

Paramètre	Format	Description
`from`, `to`	millisecondes depuis l’époque Unix	Intervalle de temps appliqué à toutes les vignettes. S’ils sont omis, les 15 dernières minutes sont utilisées par défaut.
`where`	string	Texte de requête de filtre au niveau du tableau de bord, appliqué à toutes les vignettes.
`whereLanguage`	`lucene`	`sql`	Langage de requête dans lequel `where` est écrit.
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	Valeurs de filtres structurés du tableau de bord, sélectionnant deux éléments dans le menu déroulant du filtre `ServiceName`.
`granularity`	`auto`	`30 second`	`1 minute`	`5 minute`	`10 minute`	`15 minute`	`30 minute`	`1 hour`	`12 hour`	`1 day`	`7 day`	Taille des compartiments pour les vignettes de séries temporelles. `auto` choisit une taille de compartiment selon l’intervalle de temps sélectionné.
`highlightedTileId`	string	Fait défiler la page jusqu’à une vignette spécifique et la met en évidence — utile pour créer un lien depuis une alerte.

Exemple : ouvrir un tableau de bord sur un intervalle de temps avec une vignette mise en évidence

Utile pour créer un lien depuis une notification d’alerte directement vers la vignette qui l’a déclenchée.

<YOUR_CLICKSTACK_URL>/dashboards/64f1c2a1e8b9f3a1b0d2e5c7?from=1735689600000&to=1735693200000&highlightedTileId=chart-1

Liste des tableaux de bord — `/dashboards/list`

Paramètre	Format	Description
`tag`	string	Filtre la liste des tableaux de bord par tag.

<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra

Chart Explorer — `/chart`

Un générateur de graphiques ponctuels et partageables.

Paramètre	Format	Description
`config`	JSON	La configuration complète du graphique (source, select, where, type de graphique, etc.). Généralement générée par les liens « Share » dans l’application plutôt que rédigée manuellement.
`from`, `to`	millisecondes depuis l’époque Unix	Intervalle de temps. S’ils sont omis, les 15 dernières minutes sont utilisées par défaut.

Exemple : ouvrir la configuration d’un graphique de latence p99 pour un intervalle de temps

<YOUR_CLICKSTACK_URL>/chart?granularity=auto&from=1785759381784&to=1785762981785&config={"name":"","select":[{"aggFn":"quantile","aggCondition":"","aggConditionLanguage":"lucene","valueExpression":"Duration","level":0.99,"alias":"p99"}],"where":"","whereLanguage":"lucene","displayType":"line","alignDateRangeToGranularity":true,"source":"68814eb5d40a9d0449afc1f2","connection":"68814b6fd40a9d0449afbe78","groupBy":"ServiceName"}

Alertes — `/alerts`

Consultez la page Alertes pour plus d’informations sur la création et la gestion des alertes.

Paramètre	Format	Description
`search`	string	Filtre textuel sur le nom ou la description de l’alerte.
`tag`	string	Filtre par tag.
`creator`	string	Filtre par nom du créateur de l’alerte.

Exemple : répertorier les alertes associées au tag `on-call`

<YOUR_CLICKSTACK_URL>/alerts?tag=on-call

Relecture de session — `/sessions`

Navigation et lecture des relectures de session. Consultez Relecture de session pour plus de détails sur cette fonctionnalité.

Paramètre	Format	Description
`sessionSource`	string	ID ou nom de la source de session.
`where`	string	Texte de la requête de filtre appliquée à la liste des sessions.
`whereLanguage`	`lucene`	`sql`	Langage de requête dans lequel `where` est écrit.
`from`, `to`	millisecondes depuis l’époque Unix	Intervalle de temps de la liste des sessions. S’ils sont omis, les 15 dernières minutes sont utilisées par défaut.
`sid`	string	Ouvre une session spécifique par ID.
`sfrom`, `sto`	millisecondes depuis l’époque Unix	Fenêtre temporelle de la session ouverte (utilisée avec `sid`).

Exemple : parcourir les relectures de session sur un intervalle de temps

<YOUR_CLICKSTACK_URL>/sessions?from=1735689600000&to=1735693200000

Exemple : ouvrir une relecture de session spécifique dans la fenêtre temporelle enregistrée

<YOUR_CLICKSTACK_URL>/sessions?sid=6712abf0e4b0f2a1c3d4e5f6&sfrom=1735689600000&sto=1735690200000

Carte des services — `/service-map`

Consultez la page Carte des services pour plus de détails sur cette fonctionnalité.

Paramètre	Format	Description
`source`	string	ID ou nom de la source de traces.
`samplingFactor`	entier	Diviseur d’échantillonnage des traces (`1` = 100 % des traces, `2` = 50 %, `4` = 25 %, etc.).
`from`, `to`	millisecondes depuis l’époque Unix	Intervalle de temps. S’il n’est pas indiqué, les 15 dernières minutes sont utilisées par défaut.

Exemple : afficher la carte des services sur un intervalle de temps

<YOUR_CLICKSTACK_URL>/service-map?from=1735689600000&to=1735693200000

Services — `/services`

Tableaux de bord HTTP, de bases de données et d’erreurs par service.

Paramètre	Format	Description
`tab`	`http`	`database`	`errors`	Sous-onglet affiché du tableau de bord du service. Par défaut : `http`
`source`	string	ID de la source de traces.
`service`	string	Nom du service sélectionné.
`where`	string	Texte de la requête de filtrage.
`whereLanguage`	`lucene`	`sql`	Langage de requête dans lequel `where` est écrit (par défaut, `sql` sur cette page).
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	Valeurs de la barre de filtres du tableau de bord.
`from`, `to`	millisecondes depuis l’époque Unix	Intervalle de temps. S’il est omis, les 15 dernières minutes sont utilisées par défaut.

Exemple : afficher le tableau de bord de la base de données d’un service sur un intervalle de temps

<YOUR_CLICKSTACK_URL>/services?tab=database&service=checkout&from=1735689600000&to=1735693200000

Exemple : afficher le tableau de bord des erreurs d’un service

<YOUR_CLICKSTACK_URL>/services?tab=errors&service=payments

Kubernetes — `/kubernetes`

Paramètre	Format	Description
`logSource`, `metricSource`	chaîne	ID des sources de logs et de métriques. Si une seule est fournie, l’autre correspond par défaut à une source corrélée.
`tab`	p. ex. `pods`, `nodes`, `namespaces`	Sous-vue active.
`q`	chaîne	Requête Lucene pour la liste des ressources.
`podName`, `nodeName`, `namespaceName`	chaîne	Ouvre le panneau de détails d’un pod, d’un nœud ou d’un espace de noms spécifique.
`from`, `to`	millisecondes depuis l’époque Unix	Intervalle de temps. S’il est omis, l’intervalle par défaut couvre les 15 dernières minutes.

Exemple : ouvrez le panneau de détails d’un pod spécifique

<YOUR_CLICKSTACK_URL>/kubernetes?tab=pods&podName=checkout-7d9f8b5c-2xk9p

Notebooks — `/notebook/<notebookId>`

Uniquement dans Managed ClickStackLes Notebooks sont disponibles uniquement dans les déploiements Managed ClickStack. Consultez AI Notebooks pour en savoir plus sur cette fonctionnalité.

Exemple : ouvrir un notebook spécifique dans un service Cloud donné

<YOUR_CLICKSTACK_URL>/notebook/64f1c2a1e8b9f3a1b0d2e5c7?chcServiceId=abc123

Get started

Features

Managing ClickStack

Guides

Integration partners

Search — `/search`

Exemple : rechercher les erreurs du service `checkout` dans la source `Logs` sur un intervalle de temps

Exemple : accéder directement à la vue en cascade d’une trace

Recherches enregistrées — `/search/list`

Exemple : lister les recherches enregistrées avec le tag `production`

Tableaux de bord — `/dashboards/<dashboardId>`

Exemple : ouvrir un tableau de bord sur un intervalle de temps avec une vignette mise en évidence

Liste des tableaux de bord — `/dashboards/list`

Chart Explorer — `/chart`

Exemple : ouvrir la configuration d’un graphique de latence p99 pour un intervalle de temps

Alertes — `/alerts`

Exemple : répertorier les alertes associées au tag `on-call`

Relecture de session — `/sessions`

Exemple : parcourir les relectures de session sur un intervalle de temps

Exemple : ouvrir une relecture de session spécifique dans la fenêtre temporelle enregistrée

Carte des services — `/service-map`

Exemple : afficher la carte des services sur un intervalle de temps

Services — `/services`

Exemple : afficher le tableau de bord de la base de données d’un service sur un intervalle de temps

Exemple : afficher le tableau de bord des erreurs d’un service

Kubernetes — `/kubernetes`

Exemple : ouvrez le panneau de détails d’un pod spécifique

Notebooks — `/notebook/<notebookId>`

Exemple : ouvrir un notebook spécifique dans un service Cloud donné

​Search — /search

​Exemple : rechercher les erreurs du service checkout dans la source Logs sur un intervalle de temps

​Exemple : accéder directement à la vue en cascade d’une trace

​Recherches enregistrées — /search/list

​Exemple : lister les recherches enregistrées avec le tag production

​Tableaux de bord — /dashboards/<dashboardId>

​Exemple : ouvrir un tableau de bord sur un intervalle de temps avec une vignette mise en évidence

​Liste des tableaux de bord — /dashboards/list

​Exemple : Lister les tableaux de bord avec le tag infra

​Chart Explorer — /chart

​Exemple : ouvrir la configuration d’un graphique de latence p99 pour un intervalle de temps

​Alertes — /alerts

​Exemple : répertorier les alertes associées au tag on-call

​Relecture de session — /sessions

​Exemple : parcourir les relectures de session sur un intervalle de temps

​Exemple : ouvrir une relecture de session spécifique dans la fenêtre temporelle enregistrée

​Carte des services — /service-map

​Exemple : afficher la carte des services sur un intervalle de temps

​Services — /services

​Exemple : afficher le tableau de bord de la base de données d’un service sur un intervalle de temps

​Exemple : afficher le tableau de bord des erreurs d’un service

​Kubernetes — /kubernetes

​Exemple : ouvrez le panneau de détails d’un pod spécifique

​Notebooks — /notebook/<notebookId>

​Exemple : ouvrir un notebook spécifique dans un service Cloud donné

Search — `/search`

Exemple : rechercher les erreurs du service `checkout` dans la source `Logs` sur un intervalle de temps

Exemple : accéder directement à la vue en cascade d’une trace

Recherches enregistrées — `/search/list`

Exemple : lister les recherches enregistrées avec le tag `production`

Tableaux de bord — `/dashboards/<dashboardId>`

Exemple : ouvrir un tableau de bord sur un intervalle de temps avec une vignette mise en évidence

Liste des tableaux de bord — `/dashboards/list`

Exemple : Lister les tableaux de bord avec le tag `infra`

Chart Explorer — `/chart`

Exemple : ouvrir la configuration d’un graphique de latence p99 pour un intervalle de temps

Alertes — `/alerts`

Exemple : répertorier les alertes associées au tag `on-call`

Relecture de session — `/sessions`

Exemple : parcourir les relectures de session sur un intervalle de temps

Exemple : ouvrir une relecture de session spécifique dans la fenêtre temporelle enregistrée

Carte des services — `/service-map`

Exemple : afficher la carte des services sur un intervalle de temps

Services — `/services`

Exemple : afficher le tableau de bord de la base de données d’un service sur un intervalle de temps

Exemple : afficher le tableau de bord des erreurs d’un service

Kubernetes — `/kubernetes`

Exemple : ouvrez le panneau de détails d’un pod spécifique

Notebooks — `/notebook/<notebookId>`

Exemple : ouvrir un notebook spécifique dans un service Cloud donné