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
Tiempo/div
Voltios/div
Enfoque
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).
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.
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
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
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
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
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 %
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
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.
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.
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.
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.
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.
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».
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.
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.
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.
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úsqueda
Idioma
Vol./mes
M0
M8
opentelemetry collector config
EN
6,6 mil
48
#3
structured logging kubernetes
EN
2,9 mil
—
#6
fluent bit json parser
EN
3,4 mil
22
#4
trace sampling strategies
EN
1,6 mil
—
#8
promql vs logql
EN
1,3 mil
67
#5
log retention policy gdpr
EN
880
31
#2
log management dsgvo
DE
1,1 mil
—
#1
opentelemetry exporter einrichten
DE
590
—
#3
ログ 監視 ツール 比較
JA
1,9 mil
—
#7
Una página de resultados, antes y después
«opentelemetry collector config», modelado.
M0 · #48
1. Tutorial de la competencia: configurar el collector de OTel
2. Wiki de la comunidad: referencia de configuración del collector
3. Blog: enviar logs con el collector
… Ferrovane, en la página 5
M8 · #3
1. Documentación oficial del proyecto OpenTelemetry
2. Tutorial de la competencia: configurar el collector de OTel
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.