From f6555f973069bb4c47aba9d0c87fba5e352b3735 Mon Sep 17 00:00:00 2001 From: agustinoli Date: Wed, 1 Jul 2026 14:29:07 -0300 Subject: [PATCH 1/3] docs(tutorials): stop implying Grafana alert setup (SLEAK-5896) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per Mati's review, the cost-vs-risk intro no longer says "configure alerts in Grafana" — that reads as a how-to we don't cover. It now points to reviewing latency/error-rate metrics that aren't included by default. Also fixed the Section 6 anchor link, which was already broken (missing "y alertas"/"and Alerts" suffix). --- content/tutorials/en/environment-exhaustive-testing-guide.mdx | 2 +- content/tutorials/es/environment-exhaustive-testing-guide.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/tutorials/en/environment-exhaustive-testing-guide.mdx b/content/tutorials/en/environment-exhaustive-testing-guide.mdx index 2f3657cf3..a35d615d2 100644 --- a/content/tutorials/en/environment-exhaustive-testing-guide.mdx +++ b/content/tutorials/en/environment-exhaustive-testing-guide.mdx @@ -22,7 +22,7 @@ A comprehensive checklist of tests to validate that your application is fully fu Each section in this guide has a cost: preparation time, infrastructure overhead, and development effort. Before running a section, evaluate whether the risk it addresses is real for your application and whether the investment is proportional. -Sometimes the same risk can be managed at a lower cost. Instead of building a full load-testing suite, for example, you could configure latency and error-rate alerts in Grafana that notify you before degraded performance reaches your users. Observability and alerting are covered in [Section 6 — Observability](#section-6-observability). +Sometimes the same risk can be managed at a lower cost. Instead of building a full load-testing suite, for example, you could check latency and error-rate metrics in Grafana that we don't include by default, to catch degraded performance before it reaches your users. Observability is covered in [Section 6 — Observability and Alerts](#section-6-observability-and-alerts). Think of this guide as a menu. Pick the sections that match your risk tolerance and application criticality — you don't have to run everything. diff --git a/content/tutorials/es/environment-exhaustive-testing-guide.mdx b/content/tutorials/es/environment-exhaustive-testing-guide.mdx index 435fbfce5..aab7dd098 100644 --- a/content/tutorials/es/environment-exhaustive-testing-guide.mdx +++ b/content/tutorials/es/environment-exhaustive-testing-guide.mdx @@ -22,7 +22,7 @@ Un checklist completo de pruebas para validar que tu aplicación funciona correc Cada sección de esta guía tiene un costo: tiempo de preparación, overhead de infraestructura y esfuerzo de desarrollo. Antes de ejecutar una sección, evaluá si el riesgo que cubre es real para tu aplicación y si la inversión es proporcional. -A veces el mismo riesgo se puede mitigar de forma más económica. En lugar de montar un stack completo de load testing, por ejemplo, podés configurar alertas de latencia y tasa de errores en Grafana que te avisen antes de que el rendimiento degradado llegue a tus usuarios. La observabilidad y las alertas se cubren en la [Sección 6 — Observabilidad](#sección-6-observabilidad). +A veces el mismo riesgo se puede mitigar de forma más económica. En lugar de montar un stack completo de load testing, por ejemplo, podés revisar en Grafana métricas de latencia y tasa de errores que no incluimos por defecto, para detectar el rendimiento degradado antes de que llegue a tus usuarios. La observabilidad se cubre en la [Sección 6 — Observabilidad y alertas](#sección-6-observabilidad-y-alertas). Pensá en esta guía como un menú. Elegí las secciones que correspondan a tu tolerancia al riesgo y la criticidad de tu aplicación — no tenés que correrlo todo. From 918f2837b6697007d5c06d1151a3d6e806f4ba86 Mon Sep 17 00:00:00 2001 From: agustinoli Date: Wed, 1 Jul 2026 14:35:10 -0300 Subject: [PATCH 2/3] docs(tutorials): disambiguate metrics-vs-alerting wording (SLEAK-5896) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Section 6 already says Grafana dashboards include latency and error rate by default, so the previous phrasing ("metrics we don't include by default") contradicted it. What's not on by default is alerting on those metrics — reworded to say that instead. --- content/tutorials/en/environment-exhaustive-testing-guide.mdx | 2 +- content/tutorials/es/environment-exhaustive-testing-guide.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/tutorials/en/environment-exhaustive-testing-guide.mdx b/content/tutorials/en/environment-exhaustive-testing-guide.mdx index a35d615d2..888c68371 100644 --- a/content/tutorials/en/environment-exhaustive-testing-guide.mdx +++ b/content/tutorials/en/environment-exhaustive-testing-guide.mdx @@ -22,7 +22,7 @@ A comprehensive checklist of tests to validate that your application is fully fu Each section in this guide has a cost: preparation time, infrastructure overhead, and development effort. Before running a section, evaluate whether the risk it addresses is real for your application and whether the investment is proportional. -Sometimes the same risk can be managed at a lower cost. Instead of building a full load-testing suite, for example, you could check latency and error-rate metrics in Grafana that we don't include by default, to catch degraded performance before it reaches your users. Observability is covered in [Section 6 — Observability and Alerts](#section-6-observability-and-alerts). +Sometimes the same risk can be managed at a lower cost. Instead of building a full load-testing suite, for example, you could keep an eye on the latency and error-rate metrics in Grafana — we don't set up alerting on those by default, so it's on you to check them proactively and catch degraded performance before it reaches your users. Observability is covered in [Section 6 — Observability and Alerts](#section-6-observability-and-alerts). Think of this guide as a menu. Pick the sections that match your risk tolerance and application criticality — you don't have to run everything. diff --git a/content/tutorials/es/environment-exhaustive-testing-guide.mdx b/content/tutorials/es/environment-exhaustive-testing-guide.mdx index aab7dd098..e7fe2e85e 100644 --- a/content/tutorials/es/environment-exhaustive-testing-guide.mdx +++ b/content/tutorials/es/environment-exhaustive-testing-guide.mdx @@ -22,7 +22,7 @@ Un checklist completo de pruebas para validar que tu aplicación funciona correc Cada sección de esta guía tiene un costo: tiempo de preparación, overhead de infraestructura y esfuerzo de desarrollo. Antes de ejecutar una sección, evaluá si el riesgo que cubre es real para tu aplicación y si la inversión es proporcional. -A veces el mismo riesgo se puede mitigar de forma más económica. En lugar de montar un stack completo de load testing, por ejemplo, podés revisar en Grafana métricas de latencia y tasa de errores que no incluimos por defecto, para detectar el rendimiento degradado antes de que llegue a tus usuarios. La observabilidad se cubre en la [Sección 6 — Observabilidad y alertas](#sección-6-observabilidad-y-alertas). +A veces el mismo riesgo se puede mitigar de forma más económica. En lugar de montar un stack completo de load testing, por ejemplo, podés seguirle el pulso a las métricas de latencia y tasa de errores en Grafana — no configuramos alertas sobre ellas por defecto, así que queda en vos revisarlas de forma proactiva y detectar el rendimiento degradado antes de que llegue a tus usuarios. La observabilidad se cubre en la [Sección 6 — Observabilidad y alertas](#sección-6-observabilidad-y-alertas). Pensá en esta guía como un menú. Elegí las secciones que correspondan a tu tolerancia al riesgo y la criticidad de tu aplicación — no tenés que correrlo todo. From a07db836ed456dd88308c82d878f5353ac55f153 Mon Sep 17 00:00:00 2001 From: agustinoli Date: Wed, 1 Jul 2026 15:58:56 -0300 Subject: [PATCH 3/3] docs(tutorials): keep monitoring guidance tool-agnostic (SLEAK-5896) Cost-vs-risk intro now says "any monitoring stack" instead of naming Grafana specifically. Trimmed the default metrics list in the Observability section to what dashboards reliably show out of the box. --- content/tutorials/en/environment-exhaustive-testing-guide.mdx | 4 ++-- content/tutorials/es/environment-exhaustive-testing-guide.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/tutorials/en/environment-exhaustive-testing-guide.mdx b/content/tutorials/en/environment-exhaustive-testing-guide.mdx index 888c68371..97da639ca 100644 --- a/content/tutorials/en/environment-exhaustive-testing-guide.mdx +++ b/content/tutorials/en/environment-exhaustive-testing-guide.mdx @@ -22,7 +22,7 @@ A comprehensive checklist of tests to validate that your application is fully fu Each section in this guide has a cost: preparation time, infrastructure overhead, and development effort. Before running a section, evaluate whether the risk it addresses is real for your application and whether the investment is proportional. -Sometimes the same risk can be managed at a lower cost. Instead of building a full load-testing suite, for example, you could keep an eye on the latency and error-rate metrics in Grafana — we don't set up alerting on those by default, so it's on you to check them proactively and catch degraded performance before it reaches your users. Observability is covered in [Section 6 — Observability and Alerts](#section-6-observability-and-alerts). +Sometimes the same risk can be managed at a lower cost. Instead of building a full load-testing suite, for example, any monitoring stack you already have in place can let you act proactively before performance degrades and reaches your users. Observability is covered in [Section 6 — Observability and Alerts](#section-6-observability-and-alerts). Think of this guide as a menu. Pick the sections that match your risk tolerance and application criticality — you don't have to run everything. @@ -377,7 +377,7 @@ Observability is not optional — if something goes wrong after the migration, y ### Metrics in Grafana 1. Open **Grafana** (available as an addon in your Cluster) -2. Verify that dashboards exist for your application showing at minimum: CPU usage, memory usage, requests/sec, error rate, and response latency +2. Verify that dashboards exist for your application showing at minimum: CPU usage and memory usage 3. **Pass:** All metrics are populated with recent data 4. **Fail:** Metrics are missing or show "No data" — check that Prometheus is scraping your application's metrics endpoint diff --git a/content/tutorials/es/environment-exhaustive-testing-guide.mdx b/content/tutorials/es/environment-exhaustive-testing-guide.mdx index e7fe2e85e..186a619bc 100644 --- a/content/tutorials/es/environment-exhaustive-testing-guide.mdx +++ b/content/tutorials/es/environment-exhaustive-testing-guide.mdx @@ -22,7 +22,7 @@ Un checklist completo de pruebas para validar que tu aplicación funciona correc Cada sección de esta guía tiene un costo: tiempo de preparación, overhead de infraestructura y esfuerzo de desarrollo. Antes de ejecutar una sección, evaluá si el riesgo que cubre es real para tu aplicación y si la inversión es proporcional. -A veces el mismo riesgo se puede mitigar de forma más económica. En lugar de montar un stack completo de load testing, por ejemplo, podés seguirle el pulso a las métricas de latencia y tasa de errores en Grafana — no configuramos alertas sobre ellas por defecto, así que queda en vos revisarlas de forma proactiva y detectar el rendimiento degradado antes de que llegue a tus usuarios. La observabilidad se cubre en la [Sección 6 — Observabilidad y alertas](#sección-6-observabilidad-y-alertas). +A veces el mismo riesgo se puede mitigar de forma más económica. En lugar de montar un stack completo de load testing, por ejemplo, cualquier stack de monitoreo que ya tengas te permite accionar de forma proactiva antes de que el rendimiento se degrade y llegue a tus usuarios. La observabilidad se cubre en la [Sección 6 — Observabilidad y alertas](#sección-6-observabilidad-y-alertas). Pensá en esta guía como un menú. Elegí las secciones que correspondan a tu tolerancia al riesgo y la criticidad de tu aplicación — no tenés que correrlo todo. @@ -377,7 +377,7 @@ La observabilidad no es opcional — si algo falla después de la migración, ne ### Métricas en Grafana 1. Abrí **Grafana** (disponible como addon en tu Cluster) -2. Verificá que existan dashboards para tu aplicación mostrando como mínimo: uso de CPU, uso de memoria, requests/seg, tasa de errores, y latencia de respuesta +2. Verificá que existan dashboards para tu aplicación mostrando como mínimo: uso de CPU y uso de memoria 3. **Pasa:** Todas las métricas están pobladas con datos recientes 4. **Falla:** Faltan métricas o muestran "No data" — verificá que Prometheus esté scrapeando el endpoint de métricas de tu aplicación