Ferrovane · Observability at logging platform · Berlin
Paano naipakita ng isang observability platform sa Google ang 6,000 docs page na nire-render ng JavaScript
+341%na-index na docs page sa loob ng 8 buwan · Signal
Time/div
Volts/div
Focus
CH1 · NA-INDEX NA DOCS
SWEEP = 8 BUWAN
TRIG · HANDA
Input signal · ang hamon
Anim na libong pahina ng docs, pero halos wala ang kayang basahin ng Google.
Client-side SPA ang documentation ng Ferrovane, kaya wala pang ikalimang bahagi nito ang na-index ng Google at sa mga gabay ng kakumpitensya napupunta ang mga developer.
Sa papel, ang docs ang pinakamagandang acquisition channel ng Ferrovane: 6,040 na gabay, collector recipe at API reference na isinulat mismo ng mga engineer na bumuo ng produkto. Pero client-rendered na single-page app ang site. Bakanteng shell lang ang nakukuha ng Googlebot; pinipila pa ito para i-render, at madalas sumusuko na bago pa mag-load ang content. Ang mga developer na naghahanap ng eksaktong error message at config snippet ay napupunta sa mga tutorial ng kakumpitensya, at marami pa sa mga iyon ang nagtuturo kung paano ikonekta ang Ferrovane.
18.5%ng mga docs URL ang na-index sa simula (1,120 sa 6,040).
Binasa namin ang 30 araw ng server log, ikinumpara ang raw at rendered na HTML ng bawat URL, at kinrawl ang site nang naka-off ang JavaScript. Nahati ang mga sira sa apat na grupo: rendering, architecture, crawl budget at international.
E-101KRITIKALRendering
Ang docs ay inihahatid bilang bakanteng <div id="root"> at isang 1.9 MB na bundle. Ilang araw ang lumilipas bago maabot ng render queue ng Googlebot ang karamihan ng page, at nagta-time out ito sa mga API-reference page na kumukuha ng content pagkatapos ng hydration.
> Bilang ng salita sa raw HTML: 0 sa 5,880 ng 6,040 URL
E-102KRITIKALRendering
Gawa ang navigation sa mga onClick handler sa mga <span> element, kaya walang makitang <a href> link ang crawler sa pagitan ng mga seksyon. Orphan ang karamihan ng mga gabay.
> Internal link sa raw HTML: 3 kada page sa karaniwan
E-207MALAKIArchitecture
Anim na release version (v3.0 hanggang v3.5) ang naka-publish sa magkakaibang path nang walang canonical. Paulit-ulit na pinipili ng Google ang lumang v3.1 na page bilang representative URL.
> Duplicate cluster: 2,310 URL sa 6 na version
E-214MALAKIArchitecture
Dahil sa hash-fragment routing (/docs#/collectors/otel), libo-libong page ang nagmukhang iisang URL lang para sa mga search engine.
> Natatanging URL na nakra-crawl: 412 sa 6,040
W-318MALAKICrawl budget
Ang mga faceted parameter ng API explorer at mga session token ay lumikha ng halos walang katapusang URL space. Doon napunta ang 71% ng mga request ng Googlebot.
> Crawl na napunta sa non-canonical URL: 71%
W-322MALIITCrawl budget
Soft 404 ang mga page na pinalitan ng pangalan: nagbabalik ng 200 na may 'not found' na component. May 1,400 URL sa mga sitemap na nagre-redirect.
> Crawl error na naitala kada linggo: 3,840
W-405MALAKIHreflang
Ini-inject sa client side ang German at Japanese na docs sa parehong URL ng English, kaya walang locale URL na malalagyan ng annotation at hindi kailanman na-index ang mga DE page.
> Na-index na DE/JA docs page: 0
Calibration · ang strategy
Apat na channel, isa-isang tinono.
Tumakbo ang trabaho sa aming Signal plan para sa technical SEO. Bawat tactic ay nag-ayos ng isang pinagmumulan ng ingay, at bawat isa ay may kasamang check para hindi tahimik na bumalik ang sira sa susunod na release.
CH1
JavaScript rendering
Inilipat namin ang docs mula sa client-only na SPA papunta sa static pre-rendering sa build time, na may incremental regeneration sa bawat release. Kumpleto na ang text, heading at code sample ng bawat page sa unang HTML response; interactivity na lang ang idinadagdag ng JavaScript.
Raw-HTML parity check sa CI: bumabagsak ang build kapag lumampas sa 2% ang pagkakaiba ng rendered at raw na text.
CH2
Docs architecture
Pinalitan ang mga hash route ng totoong path (/docs/collectors/otel), ginawang anchor link ang span navigation, at nagdagdag ng 'latest' na canonical na tinuturo ng mga versioned page. May breadcrumb at hanggang 3 click lang papunta sa kahit anong gabay.
Hinarang sa robots.txt ang mga explorer facet at session parameter, tinanggal ang mga token sa mga link, nagbalik ng totoong 404/410 status code, at hinati ang mga sitemap ayon sa seksyon na may tamang lastmod date mula sa docs repo.
Bahagi ng crawl na napunta sa canonical docs URL: 29% → 94%.
CH4
Hreflang
Binigyan ang bawat locale ng sariling subfolder (/de/, /ja/) na server-rendered, saka nagdagdag ng reciprocal hreflang at x-default sa HTML head at sa mga sitemap, na awtomatikong ginagawa mula sa translation manifest para hindi magkaiba-iba.
Hreflang return-tag error: 1,960 → 0.
Time base · 1 div = 1 buwan
8 buwan, mula probe hanggang lock.
M01 · PROBE
Crawl at render audit
Log-file analysis ng 30 araw ng pagbisita ng Googlebot, raw vs rendered HTML diff sa bawat URL, at baseline na 1,120 na-index na docs page.
M02 · PROBE
Pre-render pilot
Na-pre-render sa likod ng flag ang mga collector guide (420 page). Umakyat mula 61 hanggang 388 ang na-index sa seksyong iyon sa loob ng limang linggo.
M03 · KALIBRE
Rendering rollout
Static rendering para sa lahat ng 6,040 page. Nadagdag ang CI parity check. Ginawang totoong link ang span navigation.
M04 · KALIBRE
URL migration
Pinalitan ng path ang mga hash route, 6,000+ na one-to-one na 301, at itinuro sa 'latest' ang mga version canonical.
M05 · FILTER
Paglilinis ng crawl budget
Hinarang ang facet at token parameter, inayos ang mga soft 404, at hinati ang mga sitemap ayon sa seksyon na may totoong lastmod.
M06 · FILTER
Mga locale subfolder
Inilipat sa /de/ at /ja/ ang German at Japanese na docs, server-rendered at may reciprocal hreflang.
M07 · LOCK
Mga puwang sa content
Sumulat ng comparison at how-to page para sa 140 developer query kung saan nagra-rank ang mga gabay ng kakumpitensya pero walang page ang Ferrovane.
M08 · LOCK
Monitoring at hand-off
Ikinabit sa release pipeline ang render, index at hreflang check, na may alert sa docs team.
Readout · mga resulta
Tonohin ang bawat channel. Nandoon na pala ang signal mula pa noon.
Na-index na docs page 1,120 → 4,940
Organic sign-up +88%
Crawl error -93%
Top 10 sa developer query +620
Modeladong senaryo para sa isang kathang-isip na negosyo — hindi resulta ng kliyente. Hindi kailanman garantisado ang ranking at traffic; tingnan ang aming Mga Tuntunin.
Naka-lock na channel: 0/4
CH1 · page sa indexIngay
Na-index na docs page
1,120 → 4,940
CH2 · organic sign-up, index = 100Ingay
Organic sign-up
+88%
CH3 · crawl error / linggoIngay
Crawl error
-93%
CH4 · bagong top 10 sa developer queryIngay
Top 10 sa developer query
+620
Ikutin ang knob (i-drag, o i-focus at gamitin ang arrow keys) para mailabas ang bawat metric mula sa ingay.
Mga developer query, bago at pagkatapos
Posisyon sa Google, modelado. Ang “—” ay ibig sabihing wala sa top 100.
Query
Wika
Vol/buwan
M0
M8
opentelemetry collector config
EN
6.6k
48
#3
structured logging kubernetes
EN
2.9k
—
#6
fluent bit json parser
EN
3.4k
22
#4
trace sampling strategies
EN
1.6k
—
#8
promql vs logql
EN
1.3k
67
#5
log retention policy gdpr
EN
880
31
#2
log management dsgvo
DE
1.1k
—
#1
opentelemetry exporter einrichten
DE
590
—
#3
ログ 監視 ツール 比較
JA
1.9k
—
#7
Isang results page, bago at pagkatapos
“opentelemetry collector config”, modelado.
M0 · #48
1. Tutorial ng kakumpitensya: OTel collector setup
2. Community wiki: reference sa collector config
3. Blog: pagpapadala ng log gamit ang collector
… nasa page 5 ang Ferrovane
M8 · #3
1. Docs ng OpenTelemetry project
2. Tutorial ng kakumpitensya: OTel collector setup
3. Ferrovane Docs › Collectors › Configure the OTel collector
Dulo ng trace
Kumuha ng plan na ganito
Kung hindi nakikita ng mga search engine ang nakikita ng mga user ninyo, nagsisimula ang Signal sa render at crawl audit, at ginagawa nitong mga fix na kayang i-ship ng mga engineer ninyo ang mga natuklasan.