リリースマーカーをオンにする
releaseMarkers=true が追加されます。そのため、共有したリンクを開くと、マーカーはすでにオンになっています。これはダッシュボードの設定ではなく表示状態です。ダッシュボードとともに保存されることはなく、オフにするとパラメータも削除されます。
マーカーは、ログソースまたはトレースソースをソースとする時系列タイルに描画されます。アラートアノテーションも同じメニューから表示でき、同時に表示できます。2 種類のマーカーは一緒に描画され、それぞれのラベルが維持されます。
バージョンの取得元を設定する
ResourceAttributes['service.version'] を読み取ります。サービスがサービスリソースのセマンティック規約に従っている場合、設定なしでマーカーを使用できます。
別の場所からバージョンを読み取るには、ログまたはトレースソースで Service Version Expression を設定します。Team Settings → Sources でログソースを編集します。ログソースでは、このフィールドは Configure Optional Fields 内にあります。トレースソースでは、フォームの Service Name Expression の下に直接表示されます。
この値は属性名ではなく SQL 式であり、よくある次の 2 つのケースに対応できます。
- リリース識別子が別の属性にある場合。 GitOps では、リリースを識別する情報は通常コンテナーイメージのタグであり、
container.image.tagとして送られます。ログソースにResourceAttributes['container.image.tag']を指定する方が、フリート全体のインストルメンテーションを変更するよりも大幅に低コストです。 - 同じテーブル内のサービスで値が一致しない場合。
coalesceを使用して属性をフォールバックします。
serviceVersionExpression として公開されているため、ソースをプログラムでプロビジョニングする際に設定できます。ログおよびトレースのソース設定の完全な一覧を参照してください。
マーカーの意味
- バージョン文字列を変更しないデプロイでは、マーカーはまったく生成されません。
- ルックバック期間を超えてアイドル状態だったサービスは、再びスケールアップするとマーカーが描画されます。
タイルに表示されるリリース
WHERE 句、各系列のフィルター、ダッシュボードフィルター) を使用して実行されます。タイルに表示される内容は、何をチャート化しているかによって異なります。
3つ目のケースでは、マーカーに対応するサービスの線がチャート上にないため、マーカーは除外されます。ウィンドウ内のすべてのリリースが単一のサービスからのものである場合は、代わりにデフォルトのマーカー色で描画されます。
混み合ったチャートでマーカーを確認する
N releases と表示された 1 つのアンカーにまとめられます。カーソルを合わせると、すべてのリリース名が表示されます。複数のサービスにまたがるクラスターは、いずれかのサービスの色ではなく中立色で描画されるため、所有者がいるように見せることなく件数を正確に示せます。
マーカーが表示されている場合でも、プロット上を水平方向にドラッグしてズームできます。
制限事項
- **時系列タイルのみ。**テーブル、数値、ヒートマップにはマーカーを表示できません。
- **ログおよびトレースソースのみ。**メトリクスログソースでは、メトリクスタイプごとにテーブルが特定されるため、再集計対象となる単一のテーブルがなく、タイルのフィルターを意味のある形で適用することもできません。メトリクスデータに注釈を付けるには、同じダッシュボード上にログまたはトレースのタイルを並べて配置してください。
- **空のバージョン値はスキップされます。**バージョンを出力しないサービスはマーカーに反映されません。タイルでバージョンの変更がまったく見つからない場合、ClickStackは機能が壊れているのではないかと迷わせるのではなく、
No releases foundと表示します。 - ウィンドウごとに最大500個の異なるバージョンが読み取られます。