Ferrovane · Платформа наблюдаемости и логирования · Берлин
Как платформа наблюдаемости сделала 6 000 страниц документации на JavaScript видимыми для Google
+341%проиндексированных страниц документации за 8 месяцев · Signal
Время/дел.
Вольт/дел.
Фокус
CH1 · ДОКУМЕНТАЦИЯ В ИНДЕКСЕ
РАЗВЁРТКА = 8 МЕСЯЦЕВ
ТРИГГЕР · ВЗВЕДЁН
Входной сигнал · задача
Шесть тысяч страниц документации, и Google почти ни одну не мог прочитать.
Документация Ferrovane была клиентским SPA, поэтому Google индексировал меньше пятой её части, а разработчики попадали на руководства конкурентов.
На бумаге документация была лучшим каналом привлечения Ferrovane: 6 040 руководств, рецептов для коллекторов и справочников по API, написанных теми же инженерами, что создали продукт. Но сайт был одностраничным приложением с рендерингом на клиенте. Googlebot получал пустую оболочку, ставил её в очередь на рендеринг и часто сдавался, не дождавшись контента. Разработчики, искавшие точные тексты ошибок и фрагменты конфигов, находили туториалы конкурентов, и многие из них объясняли, как подключить Ferrovane.
18,5 %URL документации были в индексе на старте (1 120 из 6 040).
Семь неисправностей между документацией и индексом.
Мы изучили серверные логи за 30 дней, сравнили исходный и отрендеренный HTML для каждого URL и просканировали сайт с выключенным JavaScript. Неисправности разделились на четыре группы: рендеринг, архитектура, краулинговый бюджет и мультиязычность.
E-101КРИТИЧНОРендеринг
Документация отдавалась как пустой <div id="root"> плюс бандл на 1,9 МБ. Очередь рендеринга Googlebot добиралась до большинства страниц с опозданием на несколько дней, а на страницах справочника API, подгружавших контент после гидратации, срабатывал тайм-аут.
> Слов в исходном HTML: 0 на 5 880 из 6 040 URL
E-102КРИТИЧНОРендеринг
Навигация была собрана из обработчиков onClick на элементах <span>, поэтому краулер не находил ни одной ссылки <a href> между разделами. Большинство руководств оказались страницами-сиротами.
> Внутренних ссылок в исходном HTML: в среднем 3 на страницу
E-207СЕРЬЁЗНОАрхитектура
Шесть версий релизов (с v3.0 по v3.5) публиковались по разным путям без canonical. Google раз за разом выбирал старые страницы v3.1 в качестве основного URL.
> Кластеры дублей: 2 310 URL в 6 версиях
E-214СЕРЬЁЗНОАрхитектура
Маршрутизация через хеш-фрагменты (/docs#/collectors/otel) для поисковиков схлопывала тысячи страниц в один URL.
> Уникальных URL, доступных для обхода: 412 из 6 040
W-318СЕРЬЁЗНОКраулинговый бюджет
Фасетные параметры API-обозревателя и токены сессий порождали практически бесконечное пространство URL. Googlebot тратил на него 71% своих запросов.
> Обход неканонических URL: 71%
W-322НЕЗНАЧИТЕЛЬНОКраулинговый бюджет
Переименованные страницы отдавали soft 404: код 200 и компонент «не найдено». В картах сайта было 1 400 URL с редиректами.
> Ошибок сканирования в неделю: 3 840
W-405СЕРЬЁЗНОHreflang
Документация на немецком и японском подставлялась на клиенте по тому же URL, что и английская, так что для разметки не было отдельного языкового URL, и немецкие страницы так и не попали в индекс.
> Страниц документации DE/JA в индексе: 0
Калибровка · стратегия
Четыре канала, каждый настроен отдельно.
Работа шла на нашем тарифе Signal для технического SEO. Каждая тактика устраняла один источник шума и сопровождалась проверкой, чтобы исправление не откатилось незаметно в следующем релизе.
CH1
Рендеринг JavaScript
Перевели документацию с чисто клиентского SPA на статический пререндеринг при сборке с инкрементальной регенерацией в каждом релизе. Теперь каждая страница отдаёт полный текст, заголовки и примеры кода уже в первом HTML-ответе, а JavaScript лишь добавляет интерактивность.
Проверка соответствия исходного HTML в CI: сборка падает, если отрендеренный и исходный текст расходятся больше чем на 2%.
CH2
Архитектура документации
Заменили хеш-маршруты настоящими путями (/docs/collectors/otel), превратили навигацию на span в обычные ссылки и ввели canonical «latest», на который указывают версионные страницы. Хлебные крошки и не больше 3 кликов до любого руководства.
Закрыли в robots.txt фасеты обозревателя и параметры сессий, убрали токены из ссылок, начали отдавать настоящие коды 404/410 и разбили карты сайта по разделам с точными датами lastmod из репозитория документации.
Доля обхода, приходящаяся на канонические URL документации: 29% → 94%.
CH4
Hreflang
Выделили каждому языку свою папку (/de/, /ja/) с серверным рендерингом, затем добавили взаимные hreflang и x-default и в head HTML, и в карты сайта. Они генерируются из манифеста переводов, поэтому не могут разойтись.
Ошибок обратных тегов hreflang: 1 960 → 0.
Развёртка · 1 деление = 1 месяц
8 месяцев: от зондирования до захвата.
М01 · ЗОНД
Аудит обхода и рендеринга
Анализ логов за 30 дней визитов Googlebot, сравнение исходного и отрендеренного HTML для каждого URL и базовая точка: 1 120 страниц документации в индексе.
М02 · ЗОНД
Пилот пререндеринга
Руководства по коллекторам (420 страниц) пререндерились за фича-флагом. За пять недель число страниц раздела в индексе выросло с 61 до 388.
М03 · НАСТРОЙКА
Рендеринг для всех
Статический рендеринг запущен для всех 6 040 страниц. В CI добавлена проверка соответствия. Навигация на span переделана на настоящие ссылки.
М04 · НАСТРОЙКА
Миграция URL
Хеш-маршруты заменены путями, более 6 000 редиректов 301 один к одному, canonical версий указывают на «latest».
М05 · ФИЛЬТР
Чистка краулингового бюджета
Параметры фасетов и токенов закрыты, soft 404 исправлены, карты сайта разбиты по разделам с реальным lastmod.
М06 · ФИЛЬТР
Языковые папки
Немецкая и японская документация переехала в /de/ и /ja/, рендерится на сервере и получила взаимные hreflang.
М07 · ЗАХВАТ
Пробелы в контенте
Сравнительные страницы и инструкции для 140 запросов разработчиков, по которым ранжировались руководства конкурентов, а у Ferrovane страницы не было.
М08 · ЗАХВАТ
Мониторинг и передача
Проверки рендеринга, индексации и hreflang встроены в релизный пайплайн, с оповещениями команде документации.
Показания · результаты
Настройте каждый канал. Сигнал был там всё это время.
Страниц документации в индексе 1 120 → 4 940
Органические регистрации +88%
Ошибки сканирования -93%
Топ-10 по запросам разработчиков +620
Смоделированный сценарий для вымышленной компании — не результат клиента. Позиции и трафик никогда не гарантируются; см. наши Условия.
Захвачено каналов: 0/4
CH1 · страниц в индексеШум
Страниц документации в индексе
1 120 → 4 940
CH2 · органические регистрации, индекс = 100Шум
Органические регистрации
+88%
CH3 · ошибок сканирования / неделяШум
Ошибки сканирования
-93%
CH4 · новых топ-10 по запросам разработчиковШум
Топ-10 по запросам разработчиков
+620
Поверните ручку (перетащите её или выберите и нажимайте стрелки), чтобы вытащить каждый показатель из шума.
Запросы разработчиков: до и после
Позиция в Google, модель. «—» означает вне топ-100.
Запрос
Язык
Част./мес.
М0
М8
opentelemetry collector config
EN
6,6 тыс.
48
#3
structured logging kubernetes
EN
2,9 тыс.
—
#6
fluent bit json parser
EN
3,4 тыс.
22
#4
trace sampling strategies
EN
1,6 тыс.
—
#8
promql vs logql
EN
1,3 тыс.
67
#5
log retention policy gdpr
EN
880
31
#2
log management dsgvo
DE
1,1 тыс.
—
#1
opentelemetry exporter einrichten
DE
590
—
#3
ログ 監視 ツール 比較
JA
1,9 тыс.
—
#7
Одна страница выдачи: до и после
«opentelemetry collector config», модель.
М0 · #48
1. Туториал конкурента: настройка OTel-коллектора
2. Вики сообщества: справочник по конфигурации коллектора
3. Блог: отправка логов через коллектор
… Ferrovane только на 5-й странице
М8 · #3
1. Документация проекта OpenTelemetry
2. Туториал конкурента: настройка OTel-коллектора
3. Ferrovane Docs › Collectors › Configure the OTel collector
Конец развёртки
Получите такой же план
Если поисковики не видят того, что видят ваши пользователи, Signal начинается с аудита рендеринга и обхода и превращает находки в исправления, которые ваши инженеры смогут выкатить.