Información general

La extensión de Datadog para Visual Studio Code (VS Code) se integra con Datadog para acelerar tu desarrollo.

La extensión de Datadog para VS Code

Incluye varias funciones:

Requisitos

  • Una cuenta de Datadog: la extensión requiere una cuenta de Datadog (excepto cuando se utilizan las funciones de Análisis estático). Si eres nuevo en Datadog, visita el sitio web de Datadog para obtener más información sobre las herramientas de observabilidad de Datadog y regístrate para una prueba gratuita.

  • VS Code Git: la extensión funciona mejor cuando la integración de VS Code Git está habilitada. Puedes asegurarte de que la integración está habilitada al comprobar el ajuste git.enabled.

Configuración

Instala la extensión de Datadog desde Visual Studio Marketplace.

Información del código

El árbol Code Insights (Información del código) muestra información generada por la plataforma de Datadog que es relevante para tu código base. Los datos se agrupan en tres categorías: rendimiento, fiabilidad y seguridad.

La vista Información del código.

La Información del código incluye una descripción detallada de cada problema y enlaces a:

  • La localización de código fuente correspondiente
  • La plataforma de Datadog para más información

Puedes descartar información individual y establecer filtros para ver la información que te interese.

Tests Synthetic

La extensión de Datadog te permite ejecutar test Synthetic HTTP y tests de navegador en entornos locales directamente en VS Code. Puedes identificar y solucionar posibles problemas derivados de cambios en el código antes de que se desplieguen en producción y afecten a tus usuarios finales.

La extensión de Datadog en VS Code

Ejecuta tests Synthetic de forma local

  1. Selecciona una test Synthetic para ejecutarla. Puedes buscar tests específicas haciendo clic en el icono Search (Buscar).
  2. Cambia la configuración de la test para convertir la URL de inicio y especifica una URL localhost en la página Settings (Configuración).
  3. Haz la test.
El panel de configuración de test y página de Configuración donde puedes especificar la URL de inicio de una test Synthetics a una URL de host local

Si aún no has configurado las tests de Synthetic, crea una test en Datadog. Para obtener más información sobre la ejecución de tests en un entorno local, consulta Empezando con tests de API, Empezando con tests de navegador y la documentación de pruebas continuas.

Permisos

De manera predeterminada, solo los usuarios con los roles Administrador de Datadog y Estándar de Datadog pueden crear, editar y eliminar tests de navegador y HTTP Synthetic. Para poder crear, editar y eliminar tests de navegador y HTTP Synthetic, actualiza tu usuario a uno de esos dos roles predeterminados.

Si estás utilizando la función de rol personalizado, añade tu usuario a cualquier rol que incluya permisos synthetics_read (lectura de Synthetics) y synthetics_write (escritura de Synthetics).

Ver en VS Code

La función View in VS Code (Ver en VS Code) proporciona un enlace desde la plataforma de Datadog directamente a los archivos fuente. Busca el botón junto a los marcos en stack traces que se muestra en la interfaz de usuario (por ejemplo, en Rastreo de errores):

Una stack trace en la plataforma de Datadog que muestra el botón Ver en VS Code.
Para utilizar esta función, primero configura la integración de código fuente para tu servicio.

Puedes navegar al Log Explorer en la plataforma de Datadog directamente desde tus archivos de código fuente.

Si estás utilizando una biblioteca de registro compatible, la extensión es capaz de mostrarte lentes de código en las líneas en las que has detectado patrones de logs que coinciden con los registros de la plataforma de Datadog:

Las bibliotecas de registro compatibles son:

Alternativamente, puedes seleccionar algún texto en tu código fuente, haz clic con el botón derecho y busca la opción Datadog > Search Logs With Selected Text (Datadog > Buscar logs con texto seleccionado).

Uso de la característica Datadog Logs Explorer

Code Delta

Code Delta compara los números de línea incluidos en la telemetría de Datadog con los números de línea de los archivos en los que estás trabajando actualmente en VS Code.

Por ejemplo, todos los enlaces Ver en VS Code de la plataforma de Datadog codifican información sobre la versión en tiempo de ejecución, y la extensión la utiliza para calcular la línea de código correspondiente en el editor, teniendo en cuenta los cambios de versión.

Puedes modificar la configuración de Code Delta para cambiar el funcionamiento del algoritmo de coincidencia. En particular, puedes modificar el valor Minimum Affinity, que determina el grado de confianza necesario para que coincidan las líneas.

Análisis estático

La integración Análisis estático analiza tu código (localmente) en función de reglas predefinidas para detectar y corregir problemas.

La extensión de Datadog ejecuta reglas de Análisis estático en los archivos fuente que tienes abiertos en tu solución. El objetivo es detectar y corregir problemas de mantenimiento, errores o vulnerabilidades de seguridad en el código antes de confirmar los cambios.

El Análisis estático admite la exploración de muchos lenguajes de programación. Si deseas consultar la lista completa, consulta Reglas del análisis estático. Para los tipos de archivos pertenecientes a los lenguajes compatibles, los problemas se muestran en el editor de código fuente con el sistema de inspección de VS Code, y las correcciones sugeridas se pueden aplicar directamente:

Empezando

Cuando empieces a editar un archivo fuente, la extensión buscará static-analysis.datadog.yml en la raíz de tu repositorio fuente. Te pedirá que la crees si es necesario.

Un cartel para la incorporación.

Una vez creado el archivo de configuración, el analizador estático se ejecuta automáticamente en segundo plano.

La función de Análisis estático no requiere una cuenta en Datadog, ya que los archivos fuente se analizan localmente.

Licencia

Lee atentamente este Acuerdo de licencia de usuario final antes de descargar o utilizar Datadog Visual Studio Code Extension.

Datos y telemetría

Datadog recopila de forma anónima información sobre el uso que haces de este entorno de desarrollo integrado, incluyendo cómo interactúas con él, si se han producido errores mientras lo usabas, y qué causó esos errores, de acuerdo con la política de privacidad de Datadog y VS Code extension EULA de Datadog.

Si no deseas enviar estos datos a Datadog, puedes desactivar la opción en cualquier momento en la configuración de la extensión de VS Code: Datadog > Telemetry > Setup > Enable Telemetry y seleccionar disabled.

La extensión de Datadog también respeta la configuración de telemetría de VS Code.

Ayuda y comentarios

Para compartir tus comentarios, envía un correo electrónico a team-ide-integration@datadoghq.com o crea una incidencia en el repositorio público de la extensión.

Comprueba la sección Problemas para descubrir problemas conocidos.

Leer más