Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Liens profonds

View as MarkdownEdit this pageReport an issueSet up docs MCP

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.

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
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
isLive true false
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
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
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.

Exemple : Lister les tableaux de bord avec le tag infra

<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
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
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
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>

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

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