Руководство по разработке приложения Stremlit, развертыванию с помощью Railway и мониторингу с помощью аналитического решения под названием Umami.

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

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

В посте будут объяснены необходимые шаги для разработки приложения Streamlit, за которым будет следить аналитическое решение под названием Umami, развернутое с помощью Railway.

Умами

Umami — это простое, удобное в использовании решение для веб-аналитики с собственным хостингом. Их цель — предоставить более удобную, ориентированную на конфиденциальность альтернативу Google Analytics и бесплатную альтернативу платным решениям с открытым исходным кодом.

Платформа позволяет собирать показатели, связанные с посещениями веб-сайтов, а также любые настраиваемые события, такие как нажатия кнопок.

Железнодорожный

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

Он содержит бесплатный уровень, которого должно быть достаточно для запуска вашего приложения Umami.

Гид

  • Создать учетную запись GitHub
  • Создать учетную запись Железная дорога
  • Перейдите на панель инструментов и создайте свой первый проект, выберите «развернуть стартер» и выберите Umami.
  • Настройте репозиторий и подождите, пока ваш проект будет развернут.
  • Перейдите по адресу вашего приложения (должно быть что-то вроде umami-demo-production.up.railway.app, вы можете найти его на странице вашего проекта на вкладке Развертывания)
  • Войдите, используя учетные данные (admin/umami)
  • На этом этапе я предлагаю вам изменить свой пароль, перейдя в «Настройки»> «Профиль»> «Изменить пароль».
  • Добавить сайт в Умами
  • Скопируйте код отслеживания, нажав кнопку «‹/›».
  • Теперь вы можете вставить этот код внутрь компонента Streamlit следующим образом (это необходимо вызвать до того, как будет отрисован какой-либо компонент пользовательского интерфейса).
import streamlit.components.v1 as components
components.html('<script async defer data-website-id="YOUR_ID" src="<https://YOUR_URL-production.up.railway.app/umami.js>"></script>')

В моем случае я развернул свое приложение Streamlit с помощью Railway, если вы хотите попробовать это, просто создайте форк моего демо-репозитория, перейдите на панель инструментов Железнодорожный, создайте новый проект из репозитория и выберите свой форк. Если вы используете любую другую платформу, такую ​​как Streamlit Cloud, просто вставьте код в начале своего проекта, и все тоже должно быть в порядке.

Следующие шаги

  • Umami включает отслеживание пользовательских событий (ссылка), на момент написания этого поста я не смог реализовать это в Streamlit. Если вы заинтересованы и хотите помочь, вот ветка, где я пытался это реализовать. ("ветвь")
  • Я обновлю этот пост, если найду решение для добавления отслеживания пользовательских событий :)

Это все на данный момент. Спасибо за чтение.

Больше контента на plainenglish.io