Versión mínima de SDK
SDK Java: v1.44.0 o posterior
Versiones de tiempo de ejecución compatibles
Para obtener una lista completa de las versiones de Java compatibles, consulta la documentación de compatibilidad del SDK Java.
Limitaciones
Por defecto, SSI no instrumenta algunas aplicaciones y librerías Java para evitar sobrecargas de rendimiento o trazas (traces) no accionables. Estas exclusiones se definen en la lista de denegación del SDK Java. Si tu carga de trabajo está incluida, SSI omite la carga del SDK Java.
Problemas conocidos
Longitud de las variables de entorno: Si tu aplicación utiliza varias opciones de línea de comandos o variables de entorno, puedes experimentar fallos de inicialización. Esto suele ocurrir cuando tienes varios argumentos de máquinas virtuales Java u otras configuraciones de inicio. Para solucionarlo tienes que:
- Minimizar los argumentos no esenciales de la máquina virtual Java
- Considerar la posibilidad de mover algunas configuraciones a un archivo
.properties - Analizar los logs de la aplicación en busca de errores de inicialización específicos
Advertencias de Java v24 o posterior: Al utilizar SSI para Java v24 o posterior*, es posible que aparezcan advertencias relacionadas con el acceso nativo JNI o el acceso a memoria sun.misc.Unsafe. Estas advertencias pueden suprimirse con las variables de entorno --illegal-native-access=allow y --sun-misc-unsafe-memory-access=allow. Consulta JEP 472 y JEP 498 para obtener más información.
Versión mínima de SDK
SDK Python: v2.20.1 o posterior
Versiones de tiempo de ejecución compatibles
Versión mínima de Python: v3.7 o posterior
Para obtener una lista completa de las versiones de Python compatibles, consulta la documentación de compatibilidad del SDK Python.
Consideraciones sobre el sistema operativo
Python v3.7 o posterior solo está disponible por defecto en:
- CentOS Stream v8 o posterior
- Red Hat Enterprise Linux v8 o posterior
Para otras distribuciones, puede que necesite instalar Python v3.7 o posterior por separado.
Versión mínima de SDK
SDK Ruby: v2.5.0 o posterior
Versiones de tiempo de ejecución compatibles
Para obtener una lista completa de las versiones de Ruby compatibles, consulta la documentación de compatibilidad del SDK Ruby.
Requisitos del sistema operativo
- Requiere distribuciones Linux que utilicen glibc v2.27 o posterior.
- No compatible con Alpine Linux u otras distribuciones basadas en musl.
Problemas conocidos
Desinstalación de SSI: Cuando desinstales la instrumentación de un solo paso de una aplicación Ruby, sigue estos pasos para evitar errores:
- Antes de desinstalar: Haz una copia de seguridad de tu
Gemfile y Gemfile.lock. - Después de desinstalar, realiza una de las siguientes acciones:
- Restaura tus
Gemfile y Gemfile.lock originales. - Ejecuta
bundle install para volver a crear tus dependencias.
Versión mínima de SDK
SDK Node.js: v4.0 o posterior
Versiones de tiempo de ejecución compatibles
Para obtener una lista completa de las versiones de Node.js compatibles, consulta la documentación de compatibilidad del SDK Node.js.
Consideraciones sobre el sistema operativo
Las versiones de Node.js compatibles solo están disponibles por defecto en:
- CentOS Stream v9 o posterior
- Red Hat Enterprise Linux v9 o posterior
Para otras distribuciones, puede que necesites instalar Node.js por separado.
Limitaciones
- Módulos ESM: No se admite la instrumentación de ESM (módulos ECMAScript).
Versión mínima de SDK
SDK .NET: v3.7.0 o posterior
Versiones de tiempo de ejecución compatibles
SSI es compatible con los tiempos de ejecución de .NET Core y .NET Framework. Para obtener una lista completa de las versiones compatibles, consulta:
Versión mínima de SDK
SDK PHP: v1.6.0 o posterior
Versiones de tiempo de ejecución compatibles
Para obtener una lista completa de las versiones de PHP compatibles, consulta la documentación de compatibilidad del SDK PHP.
Limitaciones
SSI se desactiva automáticamente cuando detecta:
- Compilación justo a tiempo (JIT) de PHP
- Cualquiera de las siguientes extensiones:
- Xdebug
- ionCube Loader
- NewRelic
- Blackfire
- pcov
Si necesitas ejecutar SSI junto con estas herramientas, puedes forzar su activación configurando DD_INJECT_FORCE=true.
