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

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

Управляемый ClickStack
ClickStack с открытым исходным кодом

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

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

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

Перейдите в интерфейс ClickStack (HyperDX)

Выберите ClickStack в левом меню, чтобы перейти в интерфейс 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.Выберите 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. До достижения максимального размера кэш явно рос, после чего начали возникать ошибки.

В следующем примере предполагается, что вы запустили Open Source ClickStack по инструкциям для образа all-in-one и подключились к локальному экземпляру ClickHouse.

Перейдите в интерфейс ClickStack (HyperDX)

Чтобы открыть интерфейс ClickStack, перейдите по адресу http://localhost:8080.

Скопируйте ключ API для приёма данных

Перейдите в Team Settings и скопируйте Ingestion API Key из раздела API Keys. Этот ключ API обеспечивает безопасный приём данных через OpenTelemetry Collector.

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

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

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

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

Чтобы загрузить эти данные, просто отправьте их на HTTP-конечную точку развернутого коллектора OpenTelemetry (OTel).Сначала экспортируйте API-ключ, скопированный выше.

# export API key
export CLICKSTACK_API_KEY=<YOUR_INGESTION_API_KEY>

Выполните следующую команду, чтобы отправить данные в 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

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

Предположим, нам поступают сообщения о том, что у пользователей возникают проблемы с оплатой товаров. Мы можем посмотреть, что происходило, с помощью функции воспроизведения сеанса в HyperDX.Выберите Client Sessions в левом меню.В этом представлении можно увидеть фронтенд-сеансы нашего интернет-магазина. Сеансы остаются анонимными, пока пользователи не переходят к оформлению заказа и не пытаются завершить покупку.Обратите внимание: у некоторых сеансов, связанных с адресами электронной почты, есть ошибка, что может подтверждать сообщения о неуспешных транзакциях.Выберите трассировку со сбоем и связанным адресом электронной почты. В следующем представлении можно воспроизвести сеанс пользователя и изучить проблему. Нажмите play, чтобы просмотреть сеанс.На записи видно, как пользователь перемещается по сайту и добавляет товары в корзину. При желании можно перейти к более позднему моменту сеанса, где он пытается завершить оплату.

Все ошибки помечены на временной шкале красным цветом.

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

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

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

Чтобы получить больше сведений, можно вернуться к представлению Search:В списке источников выберите Logs и примените фильтр по сервису payment.Мы видим, что, хотя проблема возникла недавно, число затронутых платежей велико. Кроме того, похоже, проблемы вызывает кэш, связанный с платежами Visa.

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

Возможности

Руководства

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