Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Примеры журналов, трассировок и метрик

View as MarkdownEdit this pageReport an issueSet up docs MCP

В этом руководстве демонстрируются как ClickStack с открытым исходным кодом, так и Управляемый ClickStack на примере набора данных.

В этом руководстве предполагается, что вы выполнили руководство по началу работы с Управляемым ClickStack и сохранили учётные данные для подключения.

Выберите сервис

На главной странице ClickHouse Cloud выберите сервис с Управляемым ClickStack.

Выберите сервис

Скачайте пример данных

Чтобы заполнить интерфейс примером данных, скачайте следующий файл:

Пример данных

# curl
curl -O https://storage.googleapis.com/hyperdx/sample.tar.gz
# or
# wget https://storage.googleapis.com/hyperdx/sample.tar.gz

Этот файл содержит примеры журналов, метрик и трассировок из нашего публичного демо-приложения OpenTelemetry — простого интернет-магазина на микросервисах. Скопируйте этот файл в любой каталог по вашему выбору.

Загрузите пример данных

Чтобы загрузить эти данные, достаточно отправить их в HTTP-конечную точку развернутого OTel collector OpenTelemetry.

Выполните следующую команду, чтобы отправить данные в OTel collector:

for filename in $(tar -tf sample.tar.gz); do
  endpoint="http://localhost:4318/v1/${filename%.json}"
  echo "loading ${filename%.json}"
  tar -xOf sample.tar.gz "$filename" | while read -r line; do
    printf '%s\n' "$line" | curl -s -o /dev/null -X POST "$endpoint" \
    -H "Content-Type: application/json" \
    -H "authorization: ${CLICKSTACK_API_KEY}" \
    --data-binary @-
  done
done

Это имитирует отправку данных в OTel collector из OTLP-источников логов, трассировок и метрик. В рабочей среде такими источниками могут быть клиентские библиотеки разных языков или даже другие экземпляры OTel collector.

Вернувшись к представлению Search, вы должны увидеть, что данные начали загружаться (измените временной диапазон на Last 1 hour, если данные не отображаются):

Поиск HyperDX

Загрузка данных займет несколько минут. Прежде чем переходить к следующим шагам, дождитесь ее завершения.

Изучение сеансов

Предположим, нам поступают сообщения о том, что у пользователей возникают проблемы с оплатой товаров. Мы можем просмотреть их действия с помощью функции воспроизведения сеанса в HyperDX.

Выберите Client Sessions в левом меню.

Сеансы

В этом представлении отображаются фронтенд-сеансы для нашего интернет-магазина. Сеансы остаются Anonymous, пока пользователи не переходят к оформлению заказа и не пытаются завершить покупку.

Обратите внимание, что некоторые сеансы с адресами электронной почты связаны с ошибкой, что может подтверждать сообщения о неудачных транзакциях.

Выберите трейс со сбоем и связанным с ним адресом электронной почты. В следующем представлении можно воспроизвести сеанс пользователя и разобраться в его проблеме. Нажмите play, чтобы просмотреть сеанс.

Воспроизведение сеанса

На записи видно, как пользователь перемещается по сайту и добавляет товары в корзину. При желании можно перейти к более позднему моменту сеанса, где он пытается завершить оплату.

Пользователь не смог оформить заказ, при этом явной ошибки не видно. Прокрутите левую панель вниз — в ней показаны сетевые события и события консоли из браузера пользователя. Вы заметите, что при вызове /api/checkout возникла ошибка 500.

Ошибка в сеансе

Выберите эту ошибку 500. Ни Overview, ни Column Values не указывают на источник проблемы, кроме того, что ошибка является неожиданной и приводит к Internal Error.

Просмотр трассировок

Перейдите на вкладку Trace, чтобы увидеть полную распределенную трассировку.

Трассировка сеанса

Прокрутите трассировку вниз, чтобы увидеть источник ошибки — спан сервиса checkout. Выберите спан сервиса Payment.

Спан

Выберите вкладку Column Values и прокрутите вниз. Мы видим, что проблема связана с переполнением кэша.

Значения столбцов

Если прокрутить вверх и вернуться к трассировке, видно, что журналы коррелируются со спаном благодаря выполненной ранее настройке. Это дает дополнительный контекст.

Скоррелированный журнал

Мы установили, что в сервисе Payment заполняется кэш, из-за чего платежи не могут завершиться.

Просмотр журналов

Чтобы узнать больше, можно вернуться к Search:

Выберите Logs в списке источников и примените фильтр по сервису payment.

Журналы

Мы видим, что, хотя проблема возникла недавно, количество затронутых платежей велико. Кроме того, похоже, что проблемы вызывает кэш, связанный с платежами Visa.

Метрики диаграммы

Хотя в коде явно была внесена ошибка, мы можем использовать метрики, чтобы проверить размер кэша. Перейдите в представление Chart Explorer.

Выберите Metrics в качестве источника данных. Настройте диаграмму в конструкторе так, чтобы построить Maximum для visa_validation_cache.size (Gauge), и нажмите кнопку play. До достижения максимального размера кэш явно рос, после чего начали возникать ошибки.

Метрики
Navigation