Tu equipo necesita algo que ninguna pantalla estándar ofrece: una vista que cruce equipos, servicios y una consulta DQL propia. La decisión operativa es sencilla de plantear: seguir con un dashboard y capturas pegadas en un wiki, o construir una pequeña aplicación que viva dentro de tu entorno. El Dynatrace App Toolkit es la herramienta de línea de comandos que hace asequible la segunda opción. Este artículo la aborda al revés que la documentación: primero lo que conviene decidir antes de escribir código y después el ciclo mínimo para tener una app funcionando.
Lo que sigue vale solo para Dynatrace SaaS (direcciones en apps.dynatrace.com); Managed queda fuera. span.observer no ha desplegado ninguna app para escribir este texto: los comandos y las opciones salen de la documentación para desarrolladores y de la entrada del fabricante, enlazadas más abajo, y no se inventa ninguna salida.
La entrada del fabricante presenta App Toolkit 1.0 como una única cadena de herramientas: crear, desarrollar y desplegar, añadir funciones de app y actualizar paquetes desde el mismo binario, dt-app. Quédate con esa idea, porque ordena todo lo demás.
Dynatrace App Toolkit: ¿de verdad necesitas una app?
Antes de abrir el terminal, hazle tres preguntas al equipo. Te ahorran mantener código sin necesidad.
- ¿Basta un dashboard? Si la vista se reduce a tiles de DQL, quédate con el dashboard: cero código y ningún ciclo de despliegue.
- ¿Quién mantiene la app? Una app tiene versión, dependencias y responsable. Ponle nombre antes de la primera línea, igual que a cualquier servicio.
- ¿Qué datos va a leer? Los
scopesse declaran en la configuración de la app: cuantos menos pidas, más corta será la revisión de seguridad.
Si la balanza se inclina hacia la app (interfaz a medida, navegación, lógica de presentación), pasa a la puesta en marcha. Para la parte de consultas de tus páginas, el artículo sobre técnicas avanzadas de DQL es un buen punto de partida.
Requisitos que debes comprobar antes de lanzar el comando
La página de App Toolkit enumera requisitos concretos. Estos son, tal como aparecen en la documentación:
- Node.js 24 instalado en local (compruébalo con
node --version); - la dirección de tu entorno, con la forma
https://{identificador}.apps.dynatrace.com/, que puedes copiar de la barra del navegador; - acceso de red a
dt-cdn.net,registry.npmjs.org, tu entorno ygithub.com(para las plantillas); - puertos libres: del 3000 al 3005 para el servidor de desarrollo, el 30000 para la ejecución local de las funciones de app y el 5343 para la autenticación SSO (si está ocupado, el toolkit prueba con el siguiente).
En un equipo corporativo, la red es lo primero que falla: pide que abran los cuatro hosts antes de perder una hora con un error de instalación.
Crear la app: el ciclo mínimo
La documentación «First app in 5 minutes» propone este recorrido. Los pasos van en el orden en que yo los ejecutaría.
- En el terminal de tu editor, ejecuta
npx dt-app@latest create. - Ponle un nombre a la app, por ejemplo
my-first-app, e introduce la dirección del entorno (el comando puede rellenarla si ya tienes sesión iniciada). - Entra en la carpeta con
cd my-first-app. - Arranca el servidor local con
npx dt-app dev. La app se abre en el navegador. - Abre
ui/app/pages/Home.tsx, cambia el texto del elementoHeadingpor «My first app» y guarda: el navegador se actualiza solo.

Esta captura es un montaje de comandos sacados de la documentación, no una sesión grabada. Fíjate en un detalle del navegador: según la documentación, Chrome 142 o posterior pide permiso para conectarse a dispositivos de la red local; si la página se queda en blanco, mira primero ese aviso.
Lo que más destaca la entrada del fabricante es la velocidad del ciclo. Anuncia una recompilación que baja de unos 2,7 segundos a 0,05 segundos gracias a la detección de cambios (solo se recompilan y se verifican los componentes modificados), y una comprobación de tipos incremental que solo revisa los archivos cambiados y sus dependencias. Son cifras del fabricante; span.observer no las ha medido.
Leer la carpeta creada y la configuración
La versión 1.x del toolkit separa la interfaz de las funciones de app. El workspace que describe la documentación se parece a esto:

El archivo que debes conocer es app.config.json (o app.config.ts). En el nivel superior, environmentUrl es obligatorio. Dentro de app, la documentación exige id (en minúsculas, con el espacio de nombres separado por puntos), name, version, description y scopes.

El ejemplo anterior se ha construido a partir de los campos documentados, con valores ficticios: el identificador de entorno abc12345 no existe y tus scopes dependerán de lo que lea la app. El campo version merece una regla de equipo: increméntalo en cada despliegue, será tu referencia para volver atrás.
Desplegar sin sorpresas: dry-run y después despliegue
El servidor de desarrollo no comparte nada. Para que tus compañeros vean la app hay que desplegarla. El comando npx dt-app deploy compila y despliega en el entorno configurado. Dos opciones útiles, según la documentación:
--dry-rungenera enout/un archivo.zipdistribuible sin desplegar: es la comprobación que conviene hacer antes de un primer paso a producción;--skip-buildreutiliza una compilación existente, cómodo cuando un pipeline ya ha construido la app.
Para retirar la app existe también dt-app uninstall, con su propio --dry-run. Lo que la documentación consultada no detalla es el desarrollo exacto de la autenticación interactiva ni lo que aparece en el entorno tras el despliegue. Por eso no lo describo; sigue la guía «deploy your app» del sitio para desarrolladores.
Automatizar: lo que importa para la guardia
La entrada insiste en algo útil para los equipos SRE: todos los comandos pueden ejecutarse en scripts o pipelines, con argumentos y opciones en línea de comandos en lugar de preguntas interactivas. La documentación da las palancas: la opción --non-interactive y varias variables de entorno. DT_APP_PLATFORM_TOKEN se salta el flujo de autenticación por defecto; DT_APP_OAUTH_CLIENT_ID y DT_APP_OAUTH_CLIENT_SECRET automatizan la obtención del token SSO, lo que viene bien en integración continua. Esos secretos no deben entrar nunca en el repositorio: guárdalos en el almacén de secretos de tu herramienta de CI.
Hay dos comandos de mantenimiento más: dt-app update actualiza los paquetes y dt-app migration execute acompaña el salto entre versiones (opciones --from y --to). Planifica una actualización por trimestre en lugar de hacerla con prisas. Si ya gestionas tu plataforma como código, la lógica es la de Terraform para alertas y dashboards: la app pasa a ser un artefacto versionado como los demás. Y para entender cómo se identifican los datos de tus páginas, consulta el artículo sobre el identificador de entidad.
Buenas prácticas
- Un responsable con nombre y un repositorio por app, con revisión de código como en cualquier servicio.
scopesmínimos, revisados con cada página nueva.- Un
deploy --dry-runantes de cualquier paso a producción y laversionincrementada. - Secretos de CI fuera del repositorio; existe
DT_APP_DISABLE_TELEMETRY=1si tu política prohíbe la telemetría del toolkit. - Empezar por una página sencilla que lea una sola consulta DQL y ampliar después.
Preguntas frecuentes
¿Qué versión de Node.js necesita el Dynatrace App Toolkit?
La documentación indica Node.js 24. Compruébala con node --version antes de ejecutar npx dt-app@latest create.
¿Funciona el toolkit con Dynatrace Managed?
Las fuentes consultadas hablan de entornos en apps.dynatrace.com, es decir, SaaS. No se ha verificado nada para Managed, así que este artículo no lo afirma.
¿Se pueden lanzar los comandos en CI sin interacción?
Sí, según la documentación: la opción --non-interactive y las variables DT_APP_OAUTH_CLIENT_ID y DT_APP_OAUTH_CLIENT_SECRET están pensadas para ese caso. Prueba antes con --dry-run.
Conclusión
Construir una app de Dynatrace es una decisión de mantenimiento antes que técnica. Si la respuesta es sí, el ciclo create, dev, deploy --dry-run, deploy cabe en cinco comandos. Para el detalle oficial, lee la entrada del fabricante sobre App Toolkit 1.0 y la documentación para desarrolladores.
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.