Lumaktaw sa nilalaman
Get Ranked On TopHalimbawang case studySignal plan

Isang kathang-isip na negosyo. Ang mga numero ay modeladong senaryo, hindi resulta ng kliyente.

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
6,040 docs URLM0 · 1,120M8 · 4,940
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).
Ang nakuha ng Googlebot
<html>
  <body>
    <div id="root"></div>
    <script src="/app.9f3c.js">
    <!-- 1.9 MB -->
  </body>
</html>
Ang nakita ng developer
# Configure the OTel collector

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

Diagnosis · fault log

Pitong sira sa pagitan ng docs at ng index.

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.

  1. 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

  2. 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

  3. 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

  4. 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

  5. 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%

  6. 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

  7. 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.

Orphan page: 4,100 → 0. Median click depth: 7 → 3.

CH3

Crawl budget

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.

  1. 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.

  2. 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.

  3. M03 · KALIBRE

    Rendering rollout

    Static rendering para sa lahat ng 6,040 page. Nadagdag ang CI parity check. Ginawang totoong link ang span navigation.

  4. 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.

  5. 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.

  6. M06 · FILTER

    Mga locale subfolder

    Inilipat sa /de/ at /ja/ ang German at Japanese na docs, server-rendered at may reciprocal hreflang.

  7. 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.

  8. 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.

QueryWikaVol/buwanM0M8
opentelemetry collector configEN6.6k48#3
structured logging kubernetesEN2.9k—#6
fluent bit json parserEN3.4k22#4
trace sampling strategiesEN1.6k—#8
promql vs logqlEN1.3k67#5
log retention policy gdprEN88031#2
log management dsgvoDE1.1k—#1
opentelemetry exporter einrichtenDE590—#3
ログ 監視 ツール 比較JA1.9k—#7

Isang results page, bago at pagkatapos

“opentelemetry collector config”, modelado.

M0 · #48

  1. 1. Tutorial ng kakumpitensya: OTel collector setup
  2. 2. Community wiki: reference sa collector config
  3. 3. Blog: pagpapadala ng log gamit ang collector

… nasa page 5 ang Ferrovane

M8 · #3

  1. 1. Docs ng OpenTelemetry project
  2. 2. Tutorial ng kakumpitensya: OTel collector setup
  3. 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.