dtwiz Dynatrace: instalar y supervisar un host desde la línea de comandos

dtwiz Dynatrace: instala la recopilación y supervisa un host por línea de comandos, con QuickStart renovado y hosts OpenTelemetry en GA.
dtwiz Dynatrace : installer et superviser un hôte en ligne de commande

dtwiz Dynatrace es una herramienta de línea de comandos, publicada en GitHub dentro de la organización dynatrace-oss, que analiza una máquina y luego instala el método de recopilación de Dynatrace que mejor le conviene. La versión 1.347 de Dynatrace SaaS (despliegue iniciado el 16 de septiembre de 2026) la destaca en tres novedades: un flujo QuickStart renovado, la supervisión de hosts durante la instalación del colector OpenTelemetry y la disponibilidad general de los hosts OpenTelemetry en Infrastructure & Operations.

Para un equipo SRE el interés es sencillo: reducir el tiempo entre «una máquina sin supervisión» y «las primeras métricas del host en la herramienta». Menos pasos manuales significan menos toil y menos máquinas olvidadas. Este artículo recoge lo que dicen las notas de versión y el repositorio, leídos el 27 de octubre de 2026, y da los comandos tal como figuran en el README.

Aclaración de honestidad: span.observer es un blog independiente y no ha instalado ni ejecutado dtwiz para escribir estas líneas. Las capturas son extractos del README renderizados a partir de su texto, una imagen del README del repositorio (licencia Apache 2.0) o una página de la documentación oficial. El ámbito es Dynatrace SaaS: nada de esto concierne a Dynatrace Managed.

dtwiz Dynatrace: qué dice el repositorio

  • Naturaleza: una herramienta escrita en Go, llamada «Dynatrace Ingest CLI» en su README. Detecta la plataforma, los contenedores, Kubernetes, los agentes ya presentes, la nube y los servicios, y después recomienda un método.
  • Licencia: el archivo LICENSE es el texto de la Apache License 2.0.
  • Madurez: el README habla de «early development» y pide abrir una issue en GitHub si hay errores. No pude leer un número de versión publicado; el repositorio cambia rápido.
  • Telemetría hacia tu tenant: en cada comando, dtwiz envía un evento CUSTOM_INFO a tu entorno. El README advierte de que estos eventos cuentan en la cuota de ingesta de eventos.

Los comandos principales del README: dtwiz setup (flujo interactivo de análisis, recomendación e instalación), dtwiz analyze, dtwiz recommend, dtwiz install (oneagent, kubernetes, otel, otel-collector, otel-java, otel-node, otel-python, demo, aws, aws-lambda, azure, gcp; docker figura como experimental), dtwiz uninstall, dtwiz update, dtwiz watch y dtwiz status.

Qué cambia en Dynatrace SaaS 1.347

La página «What’s new in Dynatrace SaaS 1.347» (despliegue del 16 de septiembre de 2026, actualizada el 6 de octubre de 2026) contiene cuatro elementos ligados a nuestro tema. No tienen fecha individual; la redacción de abajo es mía.

  1. QuickStart: un flujo guiado de dtwiz actualizado, con los asistentes de integración manual reunidos bajo «Manual install» y la posibilidad de instrumentar la aplicación de demostración Schnitzel mediante dtwiz setup.
  2. Dynatrace Assist en QuickStart: explicación de los hallazgos con IA y búsqueda en la topología para los servicios.
  3. Supervisión de hosts con dtwiz: durante la instalación del colector OpenTelemetry, dtwiz prepara la extensión OpenTelemetry necesaria y las rutas dinámicas de OpenPipeline. Según la nota, las métricas del host aparecen en Infrastructure & Operations en pocos minutos; se accede desde QuickStart, en «Add more data».
  4. Hosts OpenTelemetry en disponibilidad general: aparecen en el menú Compute de Infrastructure & Operations, junto a OneAgent. El concepto de Datacenter se elimina de la aplicación; los Primary Tags sirven ahora para agrupar hosts.

El resumen general de la documentación (entrada del 22 de septiembre de 2026) solo contiene una línea de título que cita dtwiz: no da más detalles.

Página de la documentación de Dynatrace sobre QuickStart: arriba, mosaicos Auto Discovery, OpenTelemetry, Kubernetes, AWS, Azure, GCP, Windows y Linux; en el centro el botón Add data; abajo las secciones Access data y Popular integrations
Source : docs.dynatrace.com

Instalar dtwiz y supervisar un host paso a paso

Requisitos previos

El README pide dos variables de entorno: DT_ENVIRONMENT (la URL de tu entorno) y DT_PLATFORM_TOKEN (un token de plataforma, prefijo dt0s16.). Recomienda generar ese token desde la aplicación QuickStart de tu tenant, el camino probado que crea los permisos necesarios. Si lo creas a mano, el README da una lista de scopes (adquisición de datos, extensiones, fleet management, OpenPipeline, settings, storage…) que describe como una base práctica, no siempre necesaria por completo. Un token Classic (dt0c01.) solo se usa si pasas --access-token de forma explícita.

Paso 1 — Instalar y lanzar

Comandos del README para Linux y macOS (bash o zsh):

export DT_ENVIRONMENT="https://<your-tenant-domain>"
export DT_PLATFORM_TOKEN="dt0s16.XXXX..."
source <(curl -sSL https://raw.githubusercontent.com/dynatrace-oss/dtwiz/main/scripts/install.sh)
dtwiz setup

La primera línea exporta la dirección del tenant, la segunda el token, la tercera descarga y ejecuta el script de instalación en el shell actual (source deja dtwiz disponible sin abrir otra terminal) y la cuarta inicia el flujo interactivo. Lee el script antes de ejecutarlo: la regla vale para cualquier curl | source. En Windows, el README ofrece la variante PowerShell con install.ps1.

Terminal con los comandos de inicio rápido del README de dtwiz: dos export de variables de entorno, la descarga de install.sh y después dtwiz setup

Paso 2 — Analizar, recomendar, instalar

Si prefieres separarlo, el README describe la misma secuencia en comandos independientes:

dtwiz analyze
dtwiz recommend
dtwiz install kubernetes
dtwiz status

Para un host, el objetivo es dtwiz install oneagent (OneAgent en esta máquina) o dtwiz install otel-collector (solo el colector OpenTelemetry de Dynatrace). La nota 1.347 vincula la incorporación del host a la instalación del colector OpenTelemetry; no indica el nombre exacto del subcomando que desencadena esa preparación, así que comprueba el comportamiento en el asistente de dtwiz setup. Dos opciones útiles: --yes (o -y) omite las confirmaciones, y --json en analyze y recommend da una salida estructurada para un script.

Paso 3 — Seguir la llegada de datos

dtwiz watch vigila en directo los datos que llegan a Dynatrace (servicios, logs, trazas…). La imagen del README de abajo procede de una demostración de la aplicación Schnitzel instrumentada por dtwiz: enumera los servicios, relaciones, logs y solicitudes detectados.

Captura del README de dtwiz: el comando dtwiz watch muestra 4 servicios Schnitzel, logs y solicitudes detectados en Dynatrace, con un enlace Open Dynatrace QuickStart

Cómo comprobar que funciona

  1. En la terminal, dtwiz status muestra el estado de la conexión y del sistema; dtwiz watch muestra los datos recibidos.
  2. En Dynatrace, abre Infrastructure & Operations, menú Compute: el host debería aparecer en pocos minutos, según la nota 1.347.
  3. Consulta la autosupervisión de dtwiz en Notebooks o Dashboards. Consulta que da el README:
fetch events
| filter event.type == "CUSTOM_INFO" and startsWith(event.name, "dtwiz")
| fields timestamp, event.name, step, command, subcommand, error, version, os
| sort timestamp desc
| limit 100

El campo step toma los valores invoked, install, completed, failed o cancelled, y error una categoría como auth_error o dependency_missing, lo que ayuda a diagnosticar un fallo sin releer toda la terminal.

Consulta DQL del README de dtwiz: fetch events, filtro por CUSTOM_INFO y nombres que empiezan por dtwiz, campos timestamp, event.name, step, command, subcommand, error, version y os, orden descendente y límite de 100

¿OneAgent u OpenTelemetry para un host?

Con la disponibilidad general, ambos métodos tienen su lugar en la misma pantalla. OneAgent se describe en la documentación de instalación de OneAgent en Linux (el lado Managed en nuestro artículo) y dtwiz también sabe instalarlo. La opción OpenTelemetry encaja si ya estandarizas tus colectores; para los conceptos, consulta OpenTelemetry de extremo a extremo con Dynatrace y el colector OpenTelemetry para Dynatrace.

Para situar la herramienta en un enfoque completo, sigue el itinerario de formación Dynatrace SaaS.

Límites y puntos de atención

  • Proyecto en desarrollo activo: relee el README antes de cada uso, la lista de comandos evoluciona.
  • El token de plataforma tiene amplios permisos: resérvalo a una cuenta dedicada y no lo pegues nunca en una captura o un registro.
  • Cada comando genera un evento en tu tenant: tenlo en cuenta en tu presupuesto de ingesta si automatizas.
  • Las notas de versión no dicen qué sistemas operativos cubre la preparación de hosts OpenTelemetry; consulta la documentación de tu versión.

Buenas prácticas

  • Prueba primero en una máquina desechable antes de un parque entero.
  • Usa dtwiz analyze --json para documentar lo existente antes de instalar.
  • Reserva --yes para scripts revisados, no para la primera ejecución.
  • Tras la instalación, comprueba los hosts en Infrastructure & Operations en lugar de fiarte solo de la terminal.

Preguntas frecuentes

¿dtwiz es un producto con soporte de Dynatrace?

El repositorio está en la organización dynatrace-oss y se presenta como en desarrollo temprano, con los problemas que se notifican en GitHub. La página QuickStart de la documentación lo menciona y enlaza a ese repositorio. Para un compromiso de soporte, consulta tu contrato.

¿dtwiz funciona con Dynatrace Managed?

Las fuentes leídas describen un tenant SaaS (URL de entorno, token de plataforma, QuickStart, Infrastructure & Operations). Nada indica un uso con Managed.

¿Qué significa «hosts OpenTelemetry en disponibilidad general»?

Según la nota 1.347, la supervisión de hosts con OpenTelemetry está en disponibilidad general y es visible en el menú Compute de Infrastructure & Operations, como OneAgent. Los Primary Tags sustituyen al concepto de Datacenter para agrupar hosts.

Conclusión

dtwiz acorta el camino entre una máquina desnuda y datos en Dynatrace, y la versión 1.347 lo une a QuickStart y a los hosts OpenTelemetry. Mantén la mentalidad SRE: comprueba el host en la aplicación, limita los permisos del token y lee los scripts antes de lanzarlos. Fuentes: notas de versión SaaS 1.347, repositorio dynatrace-oss/dtwiz (README, LICENSE) y la guía QuickStart, leídos el 27 de octubre de 2026.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Las funciones SaaS evolucionan rápido: comprueba su disponibilidad en tu entorno y en la documentación oficial.

Total
0
Shares
Leave a Reply

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

Previous Post
Dynatrace Assist agentique : ce qu'il fait, ce qu'il ne fait pas

Dynatrace Assist agéntico: qué hace, qué no hace y sus barreras

Next Post
Rachat Arize Dynatrace finalisé : ce que ça change pour l'observabilité de l'IA

Adquisición Arize Dynatrace cerrada: qué cambia para la observabilidad de la IA

Related Posts