Saltar al contenido
Get Ranked On TopCaso de estudio ilustrativoPlan Signal

Un negocio ficticio. Las cifras son un escenario modelado, no un resultado de un cliente.

Ferrovane · Plataforma de observabilidad y logs · Berlín

Cómo una plataforma de observabilidad hizo visibles para Google 6000 páginas de documentación renderizadas con JavaScript

+341 %de páginas de documentación indexadas
en 8 meses · Signal
6040 URL de documentaciónM0 · 1120M8 · 4940
CH1 · DOCS INDEXADAS
BARRIDO = 8 MESES
DISPARO · ARMADO

Señal de entrada · el reto

Seis mil páginas de documentación, y Google no podía leer casi ninguna.

La documentación de Ferrovane era una SPA renderizada en el cliente, así que Google indexaba menos de una quinta parte y los desarrolladores acababan en las guías de la competencia.

Sobre el papel, la documentación era el mejor canal de captación de Ferrovane: 6040 guías, recetas de collectors y referencias de API escritas por los mismos ingenieros que crearon el producto. Pero el sitio era una single-page app renderizada en el cliente. Googlebot recibía una carcasa vacía, la ponía en cola para renderizarla y a menudo se rendía antes de que cargara el contenido. Los desarrolladores que buscaban mensajes de error exactos y fragmentos de configuración daban con tutoriales de la competencia, muchos de ellos explicando cómo conectar Ferrovane.

18,5 %de las URL de documentación estaban indexadas al empezar (1120 de 6040).
Lo que recibía Googlebot
<html>
  <body>
    <div id="root"></div>
    <script src="/app.9f3c.js">
    <!-- 1.9 MB -->
  </body>
</html>
Lo que veía un desarrollador
# Configure the OTel collector

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

Diagnóstico · registro de fallos

Siete fallos entre la documentación y el índice.

Leímos 30 días de logs del servidor, comparamos el HTML en bruto y el renderizado de cada URL y rastreamos el sitio con JavaScript desactivado. Los fallos se agrupaban en cuatro bandas: renderizado, arquitectura, presupuesto de rastreo e internacional.

  1. E-101CRÍTICORenderizado

    La documentación se servía como un <div id="root"> vacío más un bundle de 1,9 MB. La cola de renderizado de Googlebot llegaba a la mayoría de las páginas con días de retraso, y en las páginas de referencia de la API, que cargaban el contenido después de la hidratación, se agotaba el tiempo.

    > Palabras en el HTML en bruto: 0 en 5880 de 6040 URL

  2. E-102CRÍTICORenderizado

    La navegación se basaba en manejadores onClick sobre elementos <span>, así que el rastreador no encontraba ningún enlace <a href> entre secciones. La mayoría de las guías eran páginas huérfanas.

    > Enlaces internos en el HTML en bruto: 3 por página de media

  3. E-207GRAVEArquitectura

    Seis versiones (de la v3.0 a la v3.5) publicadas en rutas distintas y sin canonicals. Google elegía una y otra vez páginas antiguas de la v3.1 como URL representativa.

    > Clústeres duplicados: 2310 URL en 6 versiones

  4. E-214GRAVEArquitectura

    El enrutado por fragmento hash (/docs#/collectors/otel) reducía miles de páginas a una sola URL a ojos de los buscadores.

    > URL únicas rastreables: 412 de 6040

  5. W-318GRAVEPresupuesto de rastreo

    Los parámetros de facetas del explorador de la API y los tokens de sesión creaban un espacio de URL prácticamente infinito. Googlebot gastaba ahí el 71 % de sus peticiones.

    > Rastreo dedicado a URL no canónicas: 71 %

  6. W-322LEVEPresupuesto de rastreo

    Las páginas renombradas daban soft 404: devolvían un 200 con un componente de «no encontrado». Los sitemaps incluían 1400 URL que redirigían.

    > Errores de rastreo registrados por semana: 3840

  7. W-405GRAVEHreflang

    La documentación en alemán y japonés se inyectaba en el cliente sobre la misma URL que la inglesa, de modo que no había ninguna URL por idioma que anotar y las páginas en alemán nunca llegaron a indexarse.

    > Páginas de documentación DE/JA indexadas: 0

Calibración · la estrategia

Cuatro canales, cada uno afinado por separado.

El trabajo se hizo con nuestro plan Signal de SEO técnico. Cada táctica eliminaba una fuente de ruido y venía con una comprobación para que el arreglo no pudiera deshacerse sin que nadie lo notara en la siguiente versión.

CH1

Renderizado de JavaScript

Pasamos la documentación de una SPA solo de cliente a un prerenderizado estático en el build, con regeneración incremental en cada versión. Ahora cada página entrega su texto completo, sus encabezados y sus ejemplos de código en la primera respuesta HTML; JavaScript solo añade interactividad.

Comprobación de paridad del HTML en bruto en CI: el build falla si el texto renderizado y el bruto difieren en más de un 2 %.

CH2

Arquitectura de la documentación

Sustituimos las rutas hash por rutas reales (/docs/collectors/otel), convertimos la navegación con span en enlaces de verdad e introdujimos un canonical «latest» al que apuntan las páginas versionadas. Migas de pan y un máximo de 3 clics hasta cualquier guía.

Páginas huérfanas: 4100 → 0. Profundidad mediana de clics: 7 → 3.

CH3

Presupuesto de rastreo

Bloqueamos en robots.txt las facetas del explorador y los parámetros de sesión, quitamos los tokens de los enlaces, devolvimos códigos 404/410 reales y dividimos los sitemaps por secciones con fechas lastmod exactas sacadas del repositorio de la documentación.

Parte del rastreo en URL canónicas de documentación: 29 % → 94 %.

CH4

Hreflang

Dimos a cada idioma su propia subcarpeta (/de/, /ja/) renderizada en el servidor y añadimos hreflang recíprocos y x-default tanto en el head del HTML como en los sitemaps, generados desde el manifiesto de traducciones para que nunca se desincronicen.

Errores de etiquetas de retorno hreflang: 1960 → 0.

Base de tiempos · 1 div = 1 mes

8 meses: de sondear a fijar la señal.

  1. M01 · SONDEAR

    Auditoría de rastreo y renderizado

    Análisis de logs de 30 días de visitas de Googlebot, comparación del HTML en bruto y renderizado de cada URL y una línea base de 1120 páginas de documentación indexadas.

  2. M02 · SONDEAR

    Piloto de prerenderizado

    Las guías de collectors (420 páginas) se prerenderizaron tras un flag. Las páginas indexadas de esa sección pasaron de 61 a 388 en cinco semanas.

  3. M03 · CALIBRAR

    Despliegue del renderizado

    Renderizado estático para las 6040 páginas. Comprobación de paridad añadida a CI. Navegación con span rehecha con enlaces reales.

  4. M04 · CALIBRAR

    Migración de URL

    Rutas hash sustituidas por rutas reales, más de 6000 redirecciones 301 una a una y canonicals de versión apuntando a «latest».

  5. M05 · FILTRAR

    Limpieza del presupuesto de rastreo

    Parámetros de facetas y tokens bloqueados, soft 404 corregidos y sitemaps divididos por secciones con lastmod real.

  6. M06 · FILTRAR

    Subcarpetas por idioma

    La documentación en alemán y japonés, trasladada a /de/ y /ja/, renderizada en el servidor y con hreflang recíprocos.

  7. M07 · FIJAR

    Huecos de contenido

    Páginas comparativas y guías prácticas para 140 búsquedas de desarrolladores en las que posicionaban tutoriales de la competencia y Ferrovane no tenía página.

  8. M08 · FIJAR

    Monitorización y traspaso

    Comprobaciones de renderizado, indexación y hreflang integradas en el pipeline de publicación, con alertas para el equipo de documentación.

Lectura · resultados

Afina cada canal. La señal siempre estuvo ahí.

  • Páginas de documentación indexadas
    1120 → 4940
  • Altas orgánicas
    +88 %
  • Errores de rastreo
    -93 %
  • Top 10 en búsquedas de desarrolladores
    +620

Escenario modelado para un negocio ficticio, no un resultado de un cliente. Los rankings y el tráfico nunca están garantizados; consulta nuestros Términos.

Canales fijados: 0/4

CH1 · páginas en el índiceRuido

Páginas de documentación indexadas

1120 → 4940

CH2 · altas orgánicas, índice = 100Ruido

Altas orgánicas

+88 %

CH3 · errores de rastreo / semanaRuido

Errores de rastreo

-93 %

CH4 · nuevos top 10 en búsquedas de desarrolladoresRuido

Top 10 en búsquedas de desarrolladores

+620

Gira un mando (arrástralo, o selecciónalo y usa las flechas) para sacar cada métrica del ruido.

Búsquedas de desarrolladores, antes y después

Posición en Google, modelada. «—» significa fuera del top 100.

BúsquedaIdiomaVol./mesM0M8
opentelemetry collector configEN6,6 mil48#3
structured logging kubernetesEN2,9 mil—#6
fluent bit json parserEN3,4 mil22#4
trace sampling strategiesEN1,6 mil—#8
promql vs logqlEN1,3 mil67#5
log retention policy gdprEN88031#2
log management dsgvoDE1,1 mil—#1
opentelemetry exporter einrichtenDE590—#3
ログ 監視 ツール 比較JA1,9 mil—#7

Una página de resultados, antes y después

«opentelemetry collector config», modelado.

M0 · #48

  1. 1. Tutorial de la competencia: configurar el collector de OTel
  2. 2. Wiki de la comunidad: referencia de configuración del collector
  3. 3. Blog: enviar logs con el collector

… Ferrovane, en la página 5

M8 · #3

  1. 1. Documentación oficial del proyecto OpenTelemetry
  2. 2. Tutorial de la competencia: configurar el collector de OTel
  3. 3. Ferrovane Docs › Collectors › Configure the OTel collector

Fin de la traza

Consigue un plan como este

Si los buscadores no ven lo que ven tus usuarios, Signal empieza con una auditoría de renderizado y rastreo y convierte lo encontrado en arreglos que tus ingenieros pueden publicar.