Skip to main content
Первый вопрос при всплеске задержек или ошибок обычно — не был ли развернут новый релиз. Временные графики на панели мониторинга позволяют сразу получить ответ: включите маркеры релизов, и на каждой плитке появится пунктирная вертикальная линия в момент первого появления версии сервиса в его телеметрии. Сведения о версиях берутся из уже отправляемой телеметрии с помощью выражения в источнике плитки. Не нужно настраивать интеграцию с CI или отправлять что-либо при развертывании.

​
Включение маркеров

По умолчанию маркеры релизов отключены. Откройте меню дополнительных действий панели мониторинга и выберите Показать маркеры релизов. Переключатель добавляет releaseMarkers=true в URL панели мониторинга, поэтому ссылка, которой вы делитесь, откроется с уже включёнными маркерами. Это состояние представления, а не конфигурация панели мониторинга: оно не сохраняется вместе с панелью мониторинга, а при отключении маркеров параметр снова удаляется. Маркеры отображаются на плитках временных рядов, источником которых являются логи или трассировки. Аннотации оповещений доступны в том же меню и могут отображаться одновременно — оба набора маркеров отображаются вместе, и каждый сохраняет собственные метки.

​
Настройка источника версии

По умолчанию ClickStack считывает ResourceAttributes['service.version'] — атрибут ресурса OpenTelemetry. Если ваши сервисы соответствуют семантическим соглашениям для ресурсов сервисов, маркеры работают без дополнительной настройки. Чтобы считывать версию из другого источника, задайте Service Version Expression для источника логов или трассировок. Отредактируйте источник в разделе Team Settings → Sources. Для источника логов это поле доступно в Configure Optional Fields; для источника трассировок оно отображается непосредственно в форме, под Service Name Expression. Значение — это SQL-выражение, а не имя атрибута, что позволяет охватить два распространённых случая:
  • Идентификатор релиза хранится в другом атрибуте. При использовании GitOps идентификатором релиза обычно служит тег образа контейнера, передаваемый как container.image.tag. Указать для источника ResourceAttributes['container.image.tag'] значительно проще, чем менять инструментацию во всех сервисах.
  • Сервисы в одной таблице используют разные атрибуты. Используйте coalesce для резервного перехода между атрибутами:
Это поле также доступно как serviceVersionExpression для источников журналов и трассировок в API источников, поэтому его можно задать при программном создании источников. Полный список настроек источников для журналов и трассировок.

​
Что означает маркер

Маркер фиксирует первое появление значения версии в данных плитки в пределах отображаемого окна. Это близко к развертыванию, но намеренно не означает то же самое, поэтому используются маркеры релизов, а не маркеры развертываний:
  • Развертывание, не изменяющее строку версии, вообще не создаёт маркер.
  • Если сервис бездействует дольше периода ретроспективного просмотра, при последующем масштабировании вверх появляется маркер.
Версия, которая уже работала на момент открытия окна, определяется и исключается, а не отображается как релиз, которого на самом деле не было. Для этого запрос просматривает данные до начала окна — на 30 минут или на 10 % длительности окна, если этот интервал больше, — чтобы найти исходную версию.

​
Какие релизы показывает плитка

Запрос релизов выполняется для источника самой плитки с её собственными предикатами: предложением WHERE, фильтром каждой серии и любыми фильтрами панели мониторинга. Набор отображаемых релизов зависит от того, что показывает плитка: В третьем случае для сервиса маркера на графике нет соответствующей линии, поэтому маркеры не отображаются. Если все релизы в окне относятся к одному сервису, вместо этого они отображаются в цвете маркеров по умолчанию.

​
Маркеры релизов на насыщенном графике

Наведите указатель на подпись маркера, чтобы увидеть все релизы в этой точке, а также сервис, выпустивший каждый из них, его версию и время. Цвет связывает маркер с его серией, но в легенде графика отображается не более четырёх записей, а остальные скрываются за «+N ещё». В этом случае на экране уже не с чем сопоставить цвет. В подсказке сервис указан напрямую, поэтому она работает независимо от количества серий на графике плитки. Маркеры, расположенные слишком близко друг к другу, чтобы подписать их по отдельности, объединяются в одну точку с подписью N релизов; при наведении перечисляются все релизы. Кластер, охватывающий несколько сервисов, отображается нейтральным цветом, а не цветом одного из них, поэтому количество остаётся точным и не создаёт впечатления, что у него есть владелец. Горизонтальное перетаскивание по графику по-прежнему позволяет масштабировать его при отображении маркеров.

​
Ограничения

  • Только плитки с временными рядами. Таблицы, числовые показатели и тепловые карты не отображают маркеры.
  • Только источники логов и трассировок. Для источника метрик таблица определяется отдельно для каждого типа метрик, поэтому нет единой таблицы для повторной агрегации и возможности осмысленно применить к ней фильтры плитки. Чтобы аннотировать данные метрик, разместите на той же панели мониторинга рядом плитку логов или трассировок.
  • Пустые значения версии пропускаются. Сервис, не передающий сведения о версии, не добавляет маркеров. Если плитка вообще не обнаруживает изменений версий, ClickStack сообщает No releases found, чтобы не возникало сомнений, работает ли эта возможность.
  • До 500 различных версий считываются для каждого окна.
Последнее изменение 26 августа 2026 г.