
releaseMarkers=true が追加されます。そのため、共有したリンクを開くと、マーカーはすでにオンになっています。これはダッシュボードの設定ではなく表示状態です。ダッシュボードとともに保存されることはなく、オフにするとパラメータも削除されます。
マーカーは、ログソースまたはトレースソースをソースとする時系列タイルに描画されます。アラートアノテーションも同じメニューから表示でき、同時に表示できます。2 種類のマーカーは一緒に描画され、それぞれのラベルが維持されます。
デフォルトでは、ClickStack は OpenTelemetry リソース属性 ResourceAttributes['service.version'] を読み取ります。サービスがサービスリソースのセマンティック規約に従っている場合、設定なしでマーカーを使用できます。
別の場所からバージョンを読み取るには、ログまたはトレースソースで Service Version Expression を設定します。Team Settings → Sources でログソースを編集します。ログソースでは、このフィールドは Configure Optional Fields 内にあります。トレースソースでは、フォームの Service Name Expression の下に直接表示されます。
![ログソースの任意フィールドにある Service Version Expression フィールド。デフォルトのプレースホルダー ResourceAttributes['service.version'] が表示されている](https://mintcdn.com/private-7c7dfe99/-i0voiP_5BwPYqYV/images/clickstack/dashboards/service-version-expression.webp?fit=max&auto=format&n=-i0voiP_5BwPYqYV&q=85&s=4ea311f6c8f17a0f717a2355aab18246)
- リリース識別子が別の属性にある場合。 GitOps では、リリースを識別する情報は通常コンテナーイメージのタグであり、
container.image.tagとして送られます。ログソースにResourceAttributes['container.image.tag']を指定する方が、フリート全体のインストルメンテーションを変更するよりも大幅に低コストです。 - 同じテーブル内のサービスで値が一致しない場合。
coalesceを使用して属性をフォールバックします。
serviceVersionExpression として公開されているため、ソースをプログラムでプロビジョニングする際に設定できます。ログおよびトレースのソース設定の完全な一覧を参照してください。
マーカーは、表示中のウィンドウ内のタイルデータで、あるバージョン値が初めて現れたことを記録します。これはデプロイメントに近いものですが、意図的に同じ事象を示すものではありません。そのため、これらはデプロイメントマーカーではなくリリースマーカーと呼ばれます。
- バージョン文字列を変更しないデプロイでは、マーカーはまったく生成されません。
- ルックバック期間を超えてアイドル状態だったサービスは、再びスケールアップするとマーカーが描画されます。
WHERE 句、各系列のフィルター、ダッシュボードフィルター) を使用して実行されます。タイルに表示される内容は、何をチャート化しているかによって異なります。
3つ目のケースでは、マーカーに対応するサービスの線がチャート上にないため、マーカーは除外されます。ウィンドウ内のすべてのリリースが単一のサービスからのものである場合は、代わりにデフォルトのマーカー色で描画されます。
マーカーのラベルにカーソルを合わせると、その時点にあるすべてのリリースが一覧表示され、各リリースの提供元サービス、バージョン、時刻を確認できます。

N releases と表示された 1 つのアンカーにまとめられます。カーソルを合わせると、すべてのリリース名が表示されます。複数のサービスにまたがるクラスターは、いずれかのサービスの色ではなく中立色で描画されるため、所有者がいるように見せることなく件数を正確に示せます。
マーカーが表示されている場合でも、プロット上を水平方向にドラッグしてズームできます。
- **時系列タイルのみ。**テーブル、数値、ヒートマップにはマーカーを表示できません。
- **ログおよびトレースソースのみ。**メトリクスログソースでは、メトリクスタイプごとにテーブルが特定されるため、再集計対象となる単一のテーブルがなく、タイルのフィルターを意味のある形で適用することもできません。メトリクスデータに注釈を付けるには、同じダッシュボード上にログまたはトレースのタイルを並べて配置してください。
- **空のバージョン値はスキップされます。**バージョンを出力しないサービスはマーカーに反映されません。タイルでバージョンの変更がまったく見つからない場合、ClickStackは機能が壊れているのではないかと迷わせるのではなく、
No releases foundと表示します。 - ウィンドウごとに最大500個の異なるバージョンが読み取られます。