Key requests Dynatrace: marcar una solicitud clave y usarla para alertar

Key requests Dynatrace: marca una solicitud clave en la UI o con la API Settings, dale sus umbrales de alerta y métricas dedicadas, en SaaS y Managed.
Key requests Dynatrace : marquer une requête clé et l'utiliser pour alerter

Las key requests Dynatrace resuelven un problema clásico de guardia: la solicitud que más importa al negocio no siempre es la que más pesa en el tráfico. Un /login o un /cart/checkout puede representar solo una fracción del throughput de un servicio, y sus degradaciones pasan entonces por debajo del radar de las alertas por defecto.

Marcar una solicitud como key request le da métricas dedicadas, un histórico largo, una alerta garantizada incluso con poco volumen y, si hace falta, sus propios umbrales. Para un equipo SRE, es la forma más directa de convertir «la solicitud que da de comer a la empresa» en una señal vigilada y después en un SLI.

Esta guía vale para Dynatrace Managed y para los entornos Dynatrace SaaS que todavía usan los servicios clásicos (Services Classic). Atención: la documentación indica que la creación de key requests no está disponible para los entornos SaaS creados en la versión 1.330 o posterior; volveremos sobre ello.

Lo que cambian las key requests Dynatrace

Una key request es una solicitud de servicio que declaras importante, ya sea porque mide el éxito del negocio (inicio de sesión, pago) o porque soporta una función técnica de la que depende la aplicación. En concreto, marcarla aporta cuatro cosas:

  • Alerting siempre activo. Por defecto, una solicitud que pesa menos del 1 % de la carga de un servicio no dispara alerta, salvo que degrade el tiempo de respuesta o la tasa de fallos del servicio entero. Una key request conserva los umbrales de alerta estándar sea cual sea su volumen.
  • Umbrales propios. Puedes definir umbrales de tiempo de respuesta y de tasa de fallos a nivel de la solicitud; tienen prioridad sobre los del servicio.
  • Métricas dedicadas, de la familia builtin:service.keyRequest.*, utilizables en el Data Explorer, los dashboards y los SLO.
  • Retención ampliada: datos detallados a nivel de código 10 días, datos agregados a nivel de código 35 días, histórico de métricas a largo plazo 5 años.

Las key requests aparecen en la sección Key requests/endpoints de la página de cada servicio, en lugar de perderse al final de Top requests.

Límites que conviene conocer antes de marcar

  • 500 key requests por entorno, sumando todos los servicios;
  • 100 key requests por servicio;
  • los tiles de dashboard solo contienen los datos recogidos después de marcar: no se recupera el histórico;
  • la detección se basa en el nombre de la solicitud. Una regla de nombres (request naming rule) que renombre la solicitud rompe el vínculo si no añades el nuevo nombre.

Más allá de estos límites, o para un desglose más fino, la documentación recomienda las métricas calculadas de servicio (consulta la Multidimensional analysis en Managed).

Requisitos previos

  • Un servicio detectado por OneAgent, con tráfico en la solicitud que se va a marcar.
  • Para la interfaz: acceso de configuración al entorno.
  • Para la API: un token de acceso con los scopes settings.read y settings.write.
  • El ID de entidad del servicio (formato SERVICE-…), obtenido con la API GET /api/v2/entities: el método se detalla en encontrar el ID de una entidad de Dynatrace.

En la práctica: marcar una key request

Paso 1: encontrar la solicitud en la interfaz

  1. Abre Services (Managed) o Services Classic (SaaS).
  2. Selecciona el servicio en la lista.
  3. En la página del servicio, haz clic en un botón View (View requests, View dynamic requests o View resource requests).
  4. Baja hasta Top requests y selecciona la solicitud.

Paso 2: marcarla

En la página de la solicitud, abre el menú More (…) y elige Mark as key request. La opción Pin to dashboard, en el mismo menú, fija además un tile dedicado a la solicitud en un dashboard clásico.

Página de detalle de una solicitud de servicio de Dynatrace con el menú More abierto: botones Mute, Pin to dashboard y Mark as key request
Source : docs.dynatrace.com

Una vez marcada manualmente la solicitud, sus curvas de tendencia se conservan sin límite de duración.

Paso 3: proteger el marcado frente a los cambios de nombre

Si aplicas una request naming rule después, añade el nuevo nombre a la lista: Services, selecciona el servicio, More (…) > Settings, pestaña Key requests y después Add item. Sin esto, la solicitud renombrada deja de reconocerse como key request y sus alertas dedicadas desaparecen sin hacer ruido.

Paso 4: automatizar con la API Settings

Para versionar la lista (y recrearla idéntica en varios entornos), usa la API Settings. El esquema se llama builtin:settings.subscriptions.service y su scope es siempre un servicio, designado por su ID de entidad.

Cuerpo JSON de un objeto Settings builtin:settings.subscriptions.service con el scope SERVICE-123456789 y el array keyRequestNames que contiene /cart/checkout
# Managed : https://{votre-domaine}/e/{id-environnement}
# SaaS    : https://{id-environnement}.live.dynatrace.com
curl -X POST "$DT_URL/api/v2/settings/objects" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"schemaId":"builtin:settings.subscriptions.service",
        "scope":"SERVICE-123456789",
        "value":{"keyRequestNames":["/cart/checkout"]}}]'

Punto crítico: la documentación precisa que esta creación sobrescribe la configuración existente del servicio. Para modificar una lista ya existente, lee primero el objeto, recupera su objectId y su updateToken y envía después la lista completa con PUT:

curl -s "$DT_URL/api/v2/settings/objects?schemaIds=builtin:settings.subscriptions.service&scopes=SERVICE-123456789" \
  -H "Authorization: Api-Token $DT_TOKEN"

curl -X PUT "$DT_URL/api/v2/settings/objects/{objectId}" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"updateToken":"{updateToken}",
       "value":{"keyRequestNames":["/cart/checkout","/cart"]}}'

Usar una key request en el día a día

Umbrales de alerta propios de la solicitud

El esquema builtin:anomaly-detection.services acepta tres scopes: SERVICE_METHOD (la solicitud), SERVICE y HOST_GROUP. Un objeto colocado a nivel de la solicitud lleva sus propios ajustes responseTime y failureRate, en modo auto o fixed. Es útil para un pago sujeto a un compromiso contractual estricto, mientras el resto del servicio tolera una latencia mayor.

Métricas para dashboards y SLO

Algunas claves de la familia builtin:service.keyRequest, tal como figuran en la referencia de métricas builtin:

Clave Medida Unidad
builtin:service.keyRequest.response.time Tiempo de respuesta de la key request Microsegundo
builtin:service.keyRequest.count.total Número de solicitudes Count
builtin:service.keyRequest.errors.server.rate Tasa de fallos del lado del servidor Percent (%)
builtin:service.keyRequest.errors.server.successCount Llamadas sin error del lado del servidor Count

En el Data Explorer, builtin:service.keyRequest.response.time:percentile(90) da un p90 por solicitud, más elocuente que una media. Para el SLI de disponibilidad de un recorrido de pago, la relación entre errors.server.successCount y count.server es el candidato natural; la puesta en marcha de un SLO se detalla en crear un SLO en Managed.

Dynatrace SaaS: ¿qué hacer en un entorno reciente?

La página oficial es explícita: la creación de key requests no está disponible para los entornos creados en la versión 1.330 o posterior. Recomienda activar la función Enhanced endpoints for SDv1, que muestra todos los endpoints en la aplicación Services, y no solo las key requests. En un entorno SaaS más antiguo, el procedimiento anterior sigue siendo válido mediante Services Classic. En Managed se aplica tal cual.

Buenas prácticas

  • Marca las solicitudes por recorrido de negocio (inicio de sesión, búsqueda, pago), no por reflejo: 100 por servicio es un tope, no un objetivo.
  • Da prioridad a las solicitudes de bajo volumen y alto impacto: son las que la alerta por defecto ignora.
  • Gestiona la lista por API y versiónala; un POST sobrescribe, un PUT modifica.
  • Tras cada nueva request naming rule, revisa la pestaña Key requests del servicio.
  • Vincula cada key request a un SLO o a un umbral explícito; si no, solo sirve para decorar la página del servicio.

Cómo comprobar que funciona

  • La solicitud aparece en Key requests/endpoints en la página del servicio.
  • Con la API, la lectura GET /api/v2/settings/objects?schemaIds=builtin:settings.subscriptions.service&scopes=SERVICE-… devuelve tu array keyRequestNames.
  • En el Data Explorer, builtin:service.keyRequest.count.total muestra puntos a partir de la hora del marcado.

Si los puntos no llegan, compara el nombre exacto de la solicitud (mayúsculas, prefijo) con el de la lista: casi siempre es un cambio de nombre. Para reducir el ruido que a veces acompaña a unos umbrales demasiado ajustados, consulta también reducir el ruido de las alertas de Davis y, para las métricas de servicio genéricas, las métricas de servicio builtin. Referencia oficial: Monitor key requests.

Preguntas frecuentes

¿Recupera una key request el histórico anterior al marcado?

No: la documentación precisa que los tiles de dashboard solo contienen los datos recogidos después del marcado. Marca, por tanto, tus solicitudes críticas antes de necesitarlas, no durante el incidente.

¿Qué diferencia hay con una métrica calculada de servicio?

La key request sigue una solicitud con nombre, con alerting integrado y umbrales propios. La métrica calculada filtra y desglosa libremente (por código HTTP, por request attribute), cuenta con otros límites y se usa como una métrica builtin para el alerting.

¿Por qué ha desaparecido mi key request tras un paso a producción?

La detección se basa en el nombre. Si la ruta o una regla de nombres ha cambiado, añade el nuevo nombre en la pestaña Key requests de los ajustes del servicio o en keyRequestNames.

Conclusión

Las key requests son un ajuste modesto de gran rendimiento: unas pocas solicitudes de negocio marcadas, umbrales adecuados y un SLI derivado bastan para no perderse la caída del pago ahogada en el tráfico de las páginas estáticas. Haz la lista con los equipos de producto, gestiónala por API y revísala con cada cambio de nombres.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Host groups Dynatrace : à quoi ils servent et comment les définir

Host groups Dynatrace: para qué sirven y cómo definirlos

Next Post
ID entité Dynatrace : le trouver dans un Notebook, par l'API entitySelector ou en DQL

ID de entidad de Dynatrace: encuéntralo en un Notebook, con la API entitySelector o en DQL

Related Posts