Ferrovane · Платформа за наблюдаемост и логове · Берлин
Как платформа за наблюдаемост направи видими за Google 6000 страници с документация, рендерирани с JavaScript
+341%индексирани страници с документация за 8 месеца · Signal
Време/дел.
Волта/дел.
Фокус
CH1 · ИНДЕКСИРАНИ СТРАНИЦИ
РАЗВИВКА = 8 МЕСЕЦА
ТРИГЕР · ГОТОВ
Входен сигнал · предизвикателството
Шест хиляди страници документация, а Google не можеше да прочете почти нито една.
Документацията на Ferrovane беше SPA, рендерирано в браузъра, затова Google индексираше под една пета от нея, а разработчиците попадаха на ръководствата на конкурентите.
На хартия документацията беше най-добрият канал на Ferrovane за привличане на клиенти: 6040 ръководства, рецепти за колектори и API справочници, написани от самите инженери, създали продукта. Но сайтът беше single-page приложение, рендерирано в браузъра. Googlebot изтегляше празна обвивка, слагаше я на опашка за рендериране и често се отказваше, преди съдържанието да се зареди. Разработчиците, които търсеха точни съобщения за грешки и конфигурационни фрагменти, попадаха на уроци на конкуренти – много от тях обясняваха как се свързва Ferrovane.
18,5%от URL адресите с документация бяха индексирани в началото (1120 от 6040).
Прочетохме 30 дни сървърни логове, сравнихме суровия и рендерирания HTML за всеки URL и обходихме сайта с изключен JavaScript. Повредите се разделиха в четири групи: рендериране, архитектура, crawl бюджет и международни версии.
E-101КРИТИЧНОРендериране
Документацията се доставяше като празен <div id="root"> плюс пакет от 1,9 МБ. Опашката за рендериране на Googlebot стигаше до повечето страници с дни закъснение, а при API справочниците, които зареждаха съдържанието си след хидратацията, времето изтичаше.
> Думи в суровия HTML: 0 при 5880 от 6040 URL
E-102КРИТИЧНОРендериране
Навигацията беше изградена от onClick обработчици върху <span> елементи, така че роботът не намираше нито една <a href> връзка между разделите. Повечето ръководства бяха страници сираци.
> Вътрешни връзки в суровия HTML: средно по 3 на страница
E-207СЕРИОЗНОАрхитектура
Шест версии (от v3.0 до v3.5) бяха публикувани под различни пътища без canonical. Google упорито избираше стари страници от v3.1 за представителен URL.
> Клъстери с дублирано съдържание: 2310 URL в 6 версии
E-214СЕРИОЗНОАрхитектура
Маршрутизацията с хеш фрагменти (/docs#/collectors/otel) сливаше хиляди страници в един-единствен URL от гледна точка на търсачките.
> Уникални URL, достъпни за обхождане: 412 от 6040
W-318СЕРИОЗНОCrawl бюджет
Фасетните параметри на API експлорера и сесийните токени създаваха практически безкрайно пространство от URL адреси. Googlebot харчеше там 71% от заявките си.
> Обхождане на неканонични URL: 71%
W-322НЕЗНАЧИТЕЛНОCrawl бюджет
Преименуваните страници връщаха soft 404: код 200 с компонент „не е намерено“. Картите на сайта съдържаха 1400 URL, които пренасочваха.
> Грешки при обхождане на седмица: 3840
W-405СЕРИОЗНОHreflang
Документацията на немски и японски се зареждаше в браузъра на същия URL като английската, така че нямаше езиков URL, който да се анотира, и немските страници така и не бяха индексирани.
> Индексирани страници на DE/JA: 0
Калибриране · стратегията
Четири канала, всеки настроен поотделно.
Работата мина по нашия план Signal за техническо SEO. Всяка тактика премахваше един източник на шум и идваше с проверка, за да не може поправката тихомълком да се върне назад при следващото издание.
CH1
Рендериране на JavaScript
Преместихме документацията от SPA, което работи само в браузъра, към статично предварително рендериране при build, с инкрементално регенериране при всяко издание. Всяка страница вече носи пълния си текст, заглавията и примерите с код още в първия HTML отговор; JavaScript само добавя интерактивност.
Проверка за съответствие на суровия HTML в CI: build-ът се проваля, ако рендерираният и суровият текст се различават с над 2%.
CH2
Архитектура на документацията
Заменихме хеш маршрутите с истински пътища (/docs/collectors/otel), превърнахме span навигацията в нормални връзки и въведохме canonical „latest“, към който сочат версионните страници. Навигационни пътеки и най-много 3 клика до всяко ръководство.
Блокирахме фасетите на експлорера и сесийните параметри в robots.txt, махнахме токените от връзките, върнахме истински кодове 404/410 и разделихме картите на сайта по раздели с точни дати lastmod от хранилището на документацията.
Дял на обхождането върху канонични URL с документация: 29% → 94%.
CH4
Hreflang
Дадохме на всеки език собствена подпапка (/de/, /ja/) със сървърно рендериране, после добавихме взаимни hreflang и x-default както в HTML head, така и в картите на сайта – генерирани от манифеста на преводите, за да не се разминават.
Грешки в обратните hreflang тагове: 1960 → 0.
Времева база · 1 деление = 1 месец
8 месеца – от сондиране до захват.
М01 · СОНДА
Одит на обхождането и рендерирането
Анализ на логовете за 30 дни посещения на Googlebot, сравнение на суров и рендериран HTML за всеки URL и изходна база от 1120 индексирани страници с документация.
М02 · СОНДА
Пилот с предварително рендериране
Ръководствата за колектори (420 страници) бяха рендерирани предварително зад флаг. Индексираните страници в раздела се увеличиха от 61 на 388 за пет седмици.
М03 · НАСТРОЙКА
Рендериране навсякъде
Статично рендериране за всички 6040 страници. Добавена е проверка за съответствие в CI. Span навигацията е изградена наново с истински връзки.
М04 · НАСТРОЙКА
Миграция на URL
Хеш маршрутите са заменени с пътища, над 6000 пренасочвания 301 едно към едно, canonical на версиите сочат към „latest“.
М05 · ФИЛТЪР
Почистване на crawl бюджета
Блокирани фасетни и токен параметри, поправени soft 404, карти на сайта по раздели с реален lastmod.
М06 · ФИЛТЪР
Езикови подпапки
Документацията на немски и японски е преместена в /de/ и /ja/, със сървърно рендериране и взаимни hreflang.
М07 · ЗАХВАТ
Празноти в съдържанието
Сравнителни страници и ръководства за 140 заявки на разработчици, по които се класираха уроци на конкуренти, а Ferrovane нямаше страница.
М08 · ЗАХВАТ
Мониторинг и предаване
Проверките за рендериране, индексиране и hreflang са вградени в процеса по издаване, с известия към екипа на документацията.
Отчитане · резултати
Настройте всеки канал. Сигналът е бил там през цялото време.
Индексирани страници с документация 1120 → 4940
Органични регистрации +88%
Грешки при обхождане -93%
Топ 10 по заявки на разработчици +620
Моделиран сценарий за измислен бизнес — не е резултат на клиент. Класирането и трафикът никога не са гарантирани; вижте нашите Общи условия.
Захванати канали: 0/4
CH1 · страници в индексаШум
Индексирани страници с документация
1120 → 4940
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 започва с одит на рендерирането и обхождането и превръща находките в поправки, които инженерите ви могат да пуснат.