Перейти к содержанию
Get Ranked On TopИллюстративный кейсТариф Signal

Вымышленный бизнес. Цифры — смоделированный сценарий, а не результат клиента.

Ferrovane · Платформа наблюдаемости и логирования · Берлин

Как платформа наблюдаемости сделала 6 000 страниц документации на JavaScript видимыми для Google

+341%проиндексированных страниц документации
за 8 месяцев · Signal
6 040 URL документацииМ0 · 1 120М8 · 4 940
CH1 · ДОКУМЕНТАЦИЯ В ИНДЕКСЕ
РАЗВЁРТКА = 8 МЕСЯЦЕВ
ТРИГГЕР · ВЗВЕДЁН

Входной сигнал · задача

Шесть тысяч страниц документации, и Google почти ни одну не мог прочитать.

Документация Ferrovane была клиентским SPA, поэтому Google индексировал меньше пятой её части, а разработчики попадали на руководства конкурентов.

На бумаге документация была лучшим каналом привлечения Ferrovane: 6 040 руководств, рецептов для коллекторов и справочников по API, написанных теми же инженерами, что создали продукт. Но сайт был одностраничным приложением с рендерингом на клиенте. Googlebot получал пустую оболочку, ставил её в очередь на рендеринг и часто сдавался, не дождавшись контента. Разработчики, искавшие точные тексты ошибок и фрагменты конфигов, находили туториалы конкурентов, и многие из них объясняли, как подключить Ferrovane.

18,5 %URL документации были в индексе на старте (1 120 из 6 040).
Что получал Googlebot
<html>
  <body>
    <div id="root"></div>
    <script src="/app.9f3c.js">
    <!-- 1.9 MB -->
  </body>
</html>
Что видел разработчик
# Configure the OTel collector

exporters:
  ferrovane:
    endpoint: ingest.eu.ferrovane.example
    compression: zstd

Диагностика · журнал неисправностей

Семь неисправностей между документацией и индексом.

Мы изучили серверные логи за 30 дней, сравнили исходный и отрендеренный HTML для каждого URL и просканировали сайт с выключенным JavaScript. Неисправности разделились на четыре группы: рендеринг, архитектура, краулинговый бюджет и мультиязычность.

  1. E-101КРИТИЧНОРендеринг

    Документация отдавалась как пустой <div id="root"> плюс бандл на 1,9 МБ. Очередь рендеринга Googlebot добиралась до большинства страниц с опозданием на несколько дней, а на страницах справочника API, подгружавших контент после гидратации, срабатывал тайм-аут.

    > Слов в исходном HTML: 0 на 5 880 из 6 040 URL

  2. E-102КРИТИЧНОРендеринг

    Навигация была собрана из обработчиков onClick на элементах <span>, поэтому краулер не находил ни одной ссылки <a href> между разделами. Большинство руководств оказались страницами-сиротами.

    > Внутренних ссылок в исходном HTML: в среднем 3 на страницу

  3. E-207СЕРЬЁЗНОАрхитектура

    Шесть версий релизов (с v3.0 по v3.5) публиковались по разным путям без canonical. Google раз за разом выбирал старые страницы v3.1 в качестве основного URL.

    > Кластеры дублей: 2 310 URL в 6 версиях

  4. E-214СЕРЬЁЗНОАрхитектура

    Маршрутизация через хеш-фрагменты (/docs#/collectors/otel) для поисковиков схлопывала тысячи страниц в один URL.

    > Уникальных URL, доступных для обхода: 412 из 6 040

  5. W-318СЕРЬЁЗНОКраулинговый бюджет

    Фасетные параметры API-обозревателя и токены сессий порождали практически бесконечное пространство URL. Googlebot тратил на него 71% своих запросов.

    > Обход неканонических URL: 71%

  6. W-322НЕЗНАЧИТЕЛЬНОКраулинговый бюджет

    Переименованные страницы отдавали soft 404: код 200 и компонент «не найдено». В картах сайта было 1 400 URL с редиректами.

    > Ошибок сканирования в неделю: 3 840

  7. 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 кликов до любого руководства.

Страниц-сирот: 4 100 → 0. Медианная глубина клика: 7 → 3.

CH3

Краулинговый бюджет

Закрыли в robots.txt фасеты обозревателя и параметры сессий, убрали токены из ссылок, начали отдавать настоящие коды 404/410 и разбили карты сайта по разделам с точными датами lastmod из репозитория документации.

Доля обхода, приходящаяся на канонические URL документации: 29% → 94%.

CH4

Hreflang

Выделили каждому языку свою папку (/de/, /ja/) с серверным рендерингом, затем добавили взаимные hreflang и x-default и в head HTML, и в карты сайта. Они генерируются из манифеста переводов, поэтому не могут разойтись.

Ошибок обратных тегов hreflang: 1 960 → 0.

Развёртка · 1 деление = 1 месяц

8 месяцев: от зондирования до захвата.

  1. М01 · ЗОНД

    Аудит обхода и рендеринга

    Анализ логов за 30 дней визитов Googlebot, сравнение исходного и отрендеренного HTML для каждого URL и базовая точка: 1 120 страниц документации в индексе.

  2. М02 · ЗОНД

    Пилот пререндеринга

    Руководства по коллекторам (420 страниц) пререндерились за фича-флагом. За пять недель число страниц раздела в индексе выросло с 61 до 388.

  3. М03 · НАСТРОЙКА

    Рендеринг для всех

    Статический рендеринг запущен для всех 6 040 страниц. В CI добавлена проверка соответствия. Навигация на span переделана на настоящие ссылки.

  4. М04 · НАСТРОЙКА

    Миграция URL

    Хеш-маршруты заменены путями, более 6 000 редиректов 301 один к одному, canonical версий указывают на «latest».

  5. М05 · ФИЛЬТР

    Чистка краулингового бюджета

    Параметры фасетов и токенов закрыты, soft 404 исправлены, карты сайта разбиты по разделам с реальным lastmod.

  6. М06 · ФИЛЬТР

    Языковые папки

    Немецкая и японская документация переехала в /de/ и /ja/, рендерится на сервере и получила взаимные hreflang.

  7. М07 · ЗАХВАТ

    Пробелы в контенте

    Сравнительные страницы и инструкции для 140 запросов разработчиков, по которым ранжировались руководства конкурентов, а у Ferrovane страницы не было.

  8. М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 configEN6,6 тыс.48#3
structured logging kubernetesEN2,9 тыс.—#6
fluent bit json parserEN3,4 тыс.22#4
trace sampling strategiesEN1,6 тыс.—#8
promql vs logqlEN1,3 тыс.67#5
log retention policy gdprEN88031#2
log management dsgvoDE1,1 тыс.—#1
opentelemetry exporter einrichtenDE590—#3
ログ 監視 ツール 比較JA1,9 тыс.—#7

Одна страница выдачи: до и после

«opentelemetry collector config», модель.

М0 · #48

  1. 1. Туториал конкурента: настройка OTel-коллектора
  2. 2. Вики сообщества: справочник по конфигурации коллектора
  3. 3. Блог: отправка логов через коллектор

… Ferrovane только на 5-й странице

М8 · #3

  1. 1. Документация проекта OpenTelemetry
  2. 2. Туториал конкурента: настройка OTel-коллектора
  3. 3. Ferrovane Docs › Collectors › Configure the OTel collector

Конец развёртки

Получите такой же план

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