` | Obligatorio si falta `rum.session.sample.rate` o `rum.session.replay.sample.rate` |
+
+{{% rum-browser-auto-instrumentation-update-user-attributes %}}
+
+## Solucionar problemas
+
+Check los logs del servidor de aplicaciones web de Java si no ves la tag (etiqueta) RUM JavaScript insertada.
+
+Busca el mensaje de error de análisis de configuración `"Unable to configure RUM injection"` en los logs. Si está presente, muestra un mensaje detallado sobre la causa.
+
+Además, si se activan los logs de depuración mediante la propiedad del sistema `dd.trace.debug=true` o la variable de entorno `DD_TRACE_DEBUG=true`, se volcará la configuración de la biblioteca del cliente Java al iniciarse:
+
+```shell
+DEBUG datadog.trace.api.Config - New instance: Config{..., rumEnabled=true, rumInjectorConfig={"applicationId":"appid","clientToken":"token","site":"datadoghq.com","remoteConfigurationId":"remoteconfigid"}, ...}
+```
+
+## Referencias adicionales
+
+{{< partial name="whats-next/whats-next.html" >}}
\ No newline at end of file
diff --git a/content/es/security/cloud_siem/detect_and_monitor/custom_detection_rules/impossible_travel.md b/content/es/security/cloud_siem/detect_and_monitor/custom_detection_rules/impossible_travel.md
new file mode 100644
index 00000000000..abd68805b76
--- /dev/null
+++ b/content/es/security/cloud_siem/detect_and_monitor/custom_detection_rules/impossible_travel.md
@@ -0,0 +1,38 @@
+---
+disable_toc: false
+title: Viaje imposible
+---
+
+## Información general
+
+El método de viaje imposible detecta accesos desde diferentes localizaciones cuya distancia es mayor que la distancia que puede recorrer un humano en el tiempo que transcurre entre los dos eventos de acceso. Consulte [Crear regla][1] para obtener instrucciones detalladas sobre cómo crear una regla de viaje imposible.
+
+## Funcionamiento del método de viaje imposible
+
+### Localizaciones de usuario de referencia
+
+{{< img src="security/security_monitoring/detection_rules/impossible_travel_baseline_location.png" alt="Consulta de una regla de viaje imposible con la opción de localizaciones de referencia resaltada" style="width:100%;" >}}
+
+Cuando configures una consulta para tu regla de viaje imposible, puedes activar **Localizaciones de usuario de referencia** si quieres que Datadog aprenda las localizaciones habituales de cada usuario antes de que la regla comience a crear señales.
+
+#### Localizaciones de usuario de referencia desactivadas
+
+Cuando la opción **Baseline User Locations** (Localizaciones de usuario de referencia) está desactivada (por defecto):
+
+- Cada log se evalúa para ver si contiene una localización a la que sea imposible llegar desde una localización ya encontrada.
+
+- Es imposible viajar entre dos localizaciones si la velocidad de desplazamiento es superior a 1.000 km/h y la distancia es superior a 500 km.
+
+#### Localizaciones de usuario de referencia activadas
+
+Cuando la opción **Baseline User Locations** (Localizaciones de usuario de referencia) está activada:
+
+- Hay un periodo de aprendizaje de 24 horas para cada usuario. Durante este tiempo, Datadog aprende las localizaciones habituales (ciudad y país) de cada usuario y no se crean señales.
+- Las localizaciones encontradas se olvidan al cabo de 30 días si no se han vuelto a encontrar.
+- Si se encuentra una nueva localización, Datadog:
+ - Comprueba si la localización es una de las localizaciones habituales. Si lo es, Datadog pasa al siguiente log o evento.
+ - Comprueba si se trata de una situación de viaje imposible.
+ - Si no lo es, Datadog pasa al siguiente log o evento.
+ - Si se trata de una situación de viaje imposible, Datadog comprueba si existe un patrón de transición IP. Por ejemplo, si un usuario viaja de la localización A a la localización B y ese patrón de viaje se ha producido en el pasado, no se activa una señal.
+
+[1]: /es/security/cloud_siem/detect_and_monitor/custom_detection_rules/create_rule/real_time_rule
\ No newline at end of file
diff --git a/content/es/serverless/google_cloud_run/functions/java.md b/content/es/serverless/google_cloud_run/functions/java.md
new file mode 100644
index 00000000000..767281783ea
--- /dev/null
+++ b/content/es/serverless/google_cloud_run/functions/java.md
@@ -0,0 +1,121 @@
+---
+code_lang: java
+code_lang_weight: 40
+further_reading:
+- link: /tracing/trace_collection/automatic_instrumentation/dd_libraries/java/
+ tag: Documentación
+ text: Rastreo de aplicaciones Java
+- link: /tracing/other_telemetry/connect_logs_and_traces/java/
+ tag: Documentación
+ text: Correlación de logs y trazas de Java
+title: Instrumentación de una función de ejecución de Java Cloud
+type: multi-code-lang
+---
+
+
+
+## Configuración
+
+1. **Instalar el rastreador de Java de Datadog**.
+
+ 1. Descarga el rastreador de Java de Datadog y asegúrate de que se despliegue con tu función:
+
+ {{< code-block lang="bash" disable_copy="false" >}}
+wget -O dd-java-agent.jar 'https://dtdg.co/latest-java-tracer'
+{{< /code-block >}}
+
+ Añade la variable de entorno `JAVA_TOOL_OPTIONS: -javaagent:/path/to/dd-java-agent.jar` a tu aplicación.
+
+ 2. Añade los artefactos del rastreador.
+ {{< tabs >}}
+ {{% tab "Maven" %}}
+{{< code-block lang="xml" disable_copy="false" >}}
+
+ com.datadoghq
+ dd-trace-api
+ DD_TRACE_JAVA_VERSION_HERE
+
+{{< /code-block >}}
+ {{% /tab %}}
+
+ {{% tab "Gradle" %}}
+{{< code-block lang="groovy" disable_copy="false" >}}
+implementation 'com.datadoghq:dd-trace-api:DD_TRACE_JAVA_VERSION_HERE'
+{{< /code-block >}}
+ {{% /tab %}}
+ {{< /tabs >}}
+
+ Consulta [versiones de dd-trace-java][1] para obtener la última versión del rastreador.
+
+ 3. Añade la anotación `@Trace` a todos los métodos que desees rastrear.
+
+ Para obtener más información, consulta [Rastreo de aplicaciones Java][2].
+
+2. **Instalar serverless-init como sidecar**.
+
+ {{< tabs >}}
+
+ {{% tab "CLI de Datadog" %}}
+ {{% gcr-install-sidecar-datadog-ci %}}
+ {{% /tab %}}
+
+ {{% tab "Terraform" %}}
+ {{% gcr-install-sidecar-terraform function="true" %}}
+ {{% /tab %}}
+
+ {{% tab "Otros" %}}
+ {{% gcr-install-sidecar-other function="true" %}}
+ {{% /tab %}}
+
+ {{< /tabs >}}
+
+3. **Configurar logs**.
+
+ En el step (UI) / paso (generic) anterior, creaste un volumen compartido. Es posible que también hayas configurado la variable de entorno `DD_SERVERLESS_LOG_PATH`, que en forma predeterminada es `/shared-volume/logs/app.log`.
+
+ En este step (UI) / paso (generic), configura tu biblioteca de logging para escribir logs en el archivo configurado en `DD_SERVERLESS_LOG_PATH`. En Java, Datadog recomienda escribir logs en el formato JSON. Por ejemplo, puedes utilizar una biblioteca de logging de terceros como `Log4j 2`:
+
+ {{< code-block lang="java" disable_copy="false" >}}
+private static final Logger logger = LogManager.getLogger(App.class);
+logger.info("Hello World!");
+{{< /code-block >}}
+
+ {{< code-block lang="xml" filename="resources/log4j2.xml" disable_copy="false" >}}
+
+
+
+
+
+
+
+
+
+{{< /code-block >}}
+
+ Datadog recomienda configurar las variables de entorno `DD_LOGS_INJECTION=true` (en el contenedor principal) y `DD_SOURCE=java` (en el contenedor secundario) para permitir el análisis avanzado de logs de Datadog.
+
+ Para obtener más información, consulta [Correlación de logs y traces (trazas) de Java][3].
+
+4. {{% gcr-service-label %}}
+
+5. **Enviar métricas personalizadas**.
+
+ Para enviar métricas personalizadas, [instala el cliente DogStatsD ][4] y [mira ejemplos de código][5]. En Serverless Monitoring, solo se admite el tipo de métrica *distribution*.
+
+{{% serverless-init-env-vars-sidecar language="java" function="true" defaultSource="cloudrun" %}}
+
+{{% svl-tracing-env %}}
+
+## Solucionar problemas
+
+{{% serverless-init-troubleshooting productNames="Cloud Run services" %}}
+
+## Referencias adicionales
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://github.com/DataDog/dd-trace-java/releases
+[2]: /es/tracing/trace_collection/automatic_instrumentation/dd_libraries/java/
+[3]: /es/tracing/other_telemetry/connect_logs_and_traces/java/
+[4]: /es/extend/dogstatsd/?tab=java#install-the-dogstatsd-client
+[5]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/?tab=java#code-examples-5
\ No newline at end of file
diff --git a/content/es/service_management/incident_management/incident_settings/information.md b/content/es/service_management/incident_management/incident_settings/information.md
new file mode 100644
index 00000000000..999d6e30094
--- /dev/null
+++ b/content/es/service_management/incident_management/incident_settings/information.md
@@ -0,0 +1,86 @@
+---
+title: Información
+---
+
+## Información general
+
+Desde la página de [Información de configuración de incidentes][1], puedes personalizar los estados y la gravedad de tus incidentes y activar las funciones principales para incidente, como incidentes privados, incidentes de test y anulaciones de fecha y hora.
+
+## Niveles de gravedad
+
+ {{< img src="/service_management/incidents/incident_settings/settings_info_severity_levels.png" alt="Niveles de gravedad personalizables en la configuración del incidente" style="width:100%;" >}}
+
+Utiliza la configuración del nivel de gravedad para:
+
+1. Define tu gravedad más crítica como `SEV-0` o `SEV-1` (por defecto `SEV-1`)
+2. Personalizar las subetiquetas de las gravedades (**Por defecto:** Crítica, Alta, Moderada, Baja, Menor)
+3. Personaliza las descripciones de tus gravedades
+4. Añade o elimina gravedades desde el final de tu lista, con un mínimo de una y un máximo de diez
+5. Activar la gravedad "Desconocido"
+
+**Nota**: Si intentas eliminar una gravedad a la que se hace referencia en una [regla de notificación][2], se te pedirá que confirmes tu decisión. Si decides continuar, se desactivarán las reglas de notificación afectadas, ya que dejarán de ser válidas. La eliminación de una gravedad o el cambio de la gravedad inicial no actualiza automáticamente ninguna consulta de [Incident Management Analytics][3].
+
+## Niveles de estado
+
+{{< img src="/service_management/incidents/incident_settings/settings_info_status_levels.png" alt="Niveles de estado personalizables en la configuración del incidente" style="width:100%;" >}}
+
+Utiliza la configuración de nivel de estado para:
+
+1. Personalizar las descripciones de los estados
+2. Activar el estado opcional `Completed`
+
+**Nota**: La eliminación del estado `Completed` no actualiza automáticamente los incidentes en el estado `Completed` y no actualiza automáticamente ninguna consulta de [Incident Management Analytics][3] que haga referencia explícita al mismo. Cualquier regla de notificación que haga referencia al estado `Completed` se desactiva.
+
+## Texto auxiliar
+
+{{< img src="/service_management/incidents/incident_settings/settings_info_helper_text.png" alt="Configuración del texto auxiliar de Declarar incidente" style="width:100%;">}}
+
+El texto auxiliar aparece junto al [Modal de creación de incidentes][4] y ayuda a tus respondedores a entender cómo deben definir el incidente.
+
+Puedes utilizar markdown en el texto auxiliar para añadir listas con sangría, texto formateado e hipervínculos a otros recursos.
+
+## Incidentes privados (visibilidad del incidente)
+
+_Por defecto: desactivado_
+
+La **visibilidad** de un incidente determina qué usuarios de tu organización de Datadog pueden verlo. Si la visibilidad del incidente es **organización**, cualquier usuario con permiso **Lectura de incidentes** puede verlo. Si la visibilidad del incidente es **privada**, solo podrán verla los respondedores del incidente o los usuarios con el permiso **Acceso global a incidentes privados**.
+
+En la [página de incidentes de Datadog][5], puedes buscar incidentes privados utilizando la faceta **Visibilidad** de la izquierda. También puedes añadir condiciones en torno a la visibilidad del incidente al definir [reglas de notificación][2] del incidente.
+
+### Incidentes privados en Slack
+
+Al declarar incidentes privados, Datadog crea canales privados de Slack en lugar de canales públicos.
+
+Si conviertes un incidente en privado, Datadog archiva el canal de incidentes existente, crea un nuevo canal privado y añade a él todos los respondedores existentes.
+
+Para convertir un incidente en privado en Slack, utiliza `/datadog incident private`.
+
+## Eliminación del incidente
+
+_Por defecto: desactivado_
+
+Cuando la eliminación del incidente está habilitada para un tipo de incidente, cualquier usuario con el permiso **Escritura de incidentes** puede eliminar cualquier incidente del tipo de incidente.
+
+Una vez eliminado un incidente, ya no influye en los análisis del incidente y ningún usuario puede acceder a él. Los incidentes eliminados no se pueden recuperar.
+
+## Anular las marcas de tiempo de estado
+
+_Por defecto: desactivado_
+
+Cuando se habilitan las anulaciones de fecha y hora en un tipo de incidente, cualquier usuario con el permiso **Escritura de incidente** puede definir anulaciones de fecha y hora en cualquier incidente de ese tipo de incidente.
+
+Cuando está activada, puedes definir anulaciones para las marcas de tiempo `declared`, `detected` y `resolved` en un incidente. Para obtener más información, consulta [Incident Analytics][3].
+
+## Incidentes de test
+
+_Por defecto: desactivado_
+
+Cuando los incidentes de test están habilitados en un tipo de incidente, cualquier usuario con el permiso **Escritura de incidentes** puede declarar incidentes de test del tipo de incidente.
+
+Los incidentes de test se distinguen visualmente por un banner morado. Por defecto, los incidentes de test no aparecen en la búsqueda del incidente, no ejecutan automatizaciones, no ejecutan reglas de notificación ni afectan a los análisis. El declarante puede optar por estas funciones durante la declaración.
+
+[1]: https://app.datadoghq.com/incidents/settings#Information
+[2]: /es/service_management/incident_management/incident_settings/notification_rules
+[3]: /es/service_management/incident_management/analytics
+[4]: /es/service_management/incident_management/#from-the-incidents-page
+[5]: https://app.datadoghq.com/incidents
\ No newline at end of file
diff --git a/content/es/tests/setup/javascript.md b/content/es/tests/setup/javascript.md
index 7b1cfee224c..0100a4eabac 100644
--- a/content/es/tests/setup/javascript.md
+++ b/content/es/tests/setup/javascript.md
@@ -12,82 +12,76 @@ further_reading:
- link: /continuous_integration/tests
tag: Documentación
text: Exploración de los resultados de tests y del rendimiento
-- link: /continuous_integration/intelligent_test_runner/javascript
+- link: /tests/test_impact_analysis/javascript
tag: Documentación
- text: Acelerar tus tests con Intelligent Test Runner
-- link: /continuous_integration/troubleshooting/
+ text: Acelera tus jobs (generic) de test con el análisis del efecto de los tests
+- link: /tests/troubleshooting/
tag: Documentación
- text: Solucionar problemas de CI Visibility
+ text: Solucionar problemas de Test Optimization (optimización de tests)
title: Tests de JavaScript y TypeScript
type: multi-code-lang
---
## Compatibilidad
-Marcos de test compatibles:
+Frameworks para tests compatibles:
-| Marco de test | Versión | Notas |
+| Framework para tests | Versión | Notas |
|---|---|---|
-| Jest | >= 24.8.0 | Solo `jsdom` (en el paquete `jest-environment-jsdom`) y `node` (en el paquete `jest-environment-node`) son compatibles como entornos de test. Los entornos personalizados como `@jest-runner/electron/environment` en `jest-electron-runner` no son compatibles.
Solo [`jest-circus`][1] es compatible como [`testRunner`][2].
[`test.concurrent`](#jests-testconcurrent) no es compatible. |
-| Mocha | >= 5.2.0 | Mocha >= 9.0.0 tiene [compatibilidad parcial](#known-limitations). |
+| Jest | >= 24.8.0 | Solo `jsdom` (en el paquete `jest-environment-jsdom` ) y `node` (en el paquete `jest-environment-node` ) se admiten como entornos de test. Los entornos personalizados como `@jest-runner/electron/environment` en `jest-electron-runner` no son compatibles.
Solo [`jest-circus`][1] se admite como [`testRunner`][2].
[`test.concurrent`](#jests-testconcurrent) no es compatible. |
+| Mocha | >= 5.2.0 |
| Cucumber | >= 7.0.0 |
| Cypress | >= 6.7.0 |
| Playwright | >= 1.18.0 |
-| Vitest | >= 1.16.0 | Compatible desde `dd-trace>=4.42.0` y `dd-trace>=5.18.0`. Solo es compatible desde Node.js>=18.19 o Node.js>=20.6 |
+| Vitest | >= 1.16.0 | Compatible a partir de `dd-trace>=4.42.0` y `dd-trace>=5.18.0`. Solo es compatible a partir de Node.js>=18.19 o de Node.js>=20.6 |
-La instrumentación funciona en el tiempo de ejecución, por lo que los transcompiladores como TypeScript, Webpack o Babel son compatibles de forma predefinida.
+La instrumentación funciona en tiempo de ejecución, por lo que cualquier transpilador como TypeScript, Webpack o Babel es compatible desde el primer momento.
-## Configuración del método de informes
+## Configuración del método de notificación
-Para informar resultados de tests a Datadog, debes configurar la librería de Datadog JavaScript:
+Para informar de los resultados de tests a Datadog, debes configurar la biblioteca de JavaScript de Datadog:
{{< tabs >}}
-{{% tab "Acciones de Github" %}}
-Puedes usar la [acción Datadog Test Visibility Github][1] dedicada para activar la visibilidad de test.
-Si lo haces, el resto de los pasos de configuración a continuación pueden omitirse.
+{{% tab "Proveedor de CI compatible con instrumentación automática" %}}
+{{% ci-autoinstrumentation %}}
-[1]: https://github.com/marketplace/actions/configure-datadog-test-visibility
-{{% /tab %}}
-
-{{% tab "Jenkins" %}}
-Puedes usar la [configuración basada en la interfaz de usuario][1] para activar la Visibilidad de test para tus trabajos y pipelines.
-Si lo haces, el resto de los pasos de configuración a continuación pueden omitirse.
+
+ Nota: La instrumentación automática no es compatible con los tests de Cypress. Para instrumentar tests de Cypress, sigue los steps (UI) / pasos (generic) de instrumentación manual descritos a continuación.
+
-[1]: /es/continuous_integration/pipelines/jenkins/#enable-with-the-jenkins-configuration-ui-1
{{% /tab %}}
-
-{{% tab "Otro proveedor de CI en la nube" %}}
-El modo sin Agent está disponible en las versiones de la librería de Datadog JavaScript >= 2.5.0
+{{% tab "Otro proveedor de integración continua en la nube" %}}
+La modalidad agentless está disponible en las versiones de JavaScript de Datadog >= 2.5.0
{{% ci-agentless %}}
{{% /tab %}}
-{{% tab "Proveedor de CI on-premise" %}}
+{{% tab "Proveedor de integración continua on-premises" %}}
{{% ci-agent %}}
{{% /tab %}}
{{< /tabs >}}
## Instalación del rastreador de JavaScript
-Para instalar el [rastreador de JavaScript][3], ejecuta:
+Para instalar el [JavaScript Tracer][3], ejecuta:
```bash
yarn add --dev dd-trace
```
-Para obtener más información, consulta la [documentación del rastreador de JavaScript][4].
+Para obtener más información, consulta la [Documentación sobre la instalación de JavaScript Tracer][4].
## Instrumenta tus tests
{{< tabs >}}
{{% tab "Jest/Mocha" %}}
-Establece la variable de entorno `NODE_OPTIONS` en `-r dd-trace/ci/init`. Run your tests as you normally would, specifying the environment where the tests are run in the `DD_ENV` environment variable. For example, set `DD_ENV` to `local` when running tests on a developer workstation, or `ci` cuando se ejecuta en un proveedor de CI:
+Configura la variable de entorno `NODE_OPTIONS` en `-r dd-trace/ci/init`. Ejecuta tus tests como lo harías normalmente, opcionalmente especificando un nombre para tu sesión de tests con `DD_TEST_SESSION_NAME`:
```bash
-NODE_OPTIONS="-r dd-trace/ci/init" DD_ENV=ci DD_SERVICE=my-javascript-app yarn test
+NODE_OPTIONS="-r dd-trace/ci/init" DD_TEST_SESSION_NAME=unit-tests yarn test
```
-**Nota**: Si estableces un valor para `NODE_OPTIONS`, asegúrate que no sobrescriba la cláusula `-r dd-trace/ci/init`. This can be done using the `${NODE_OPTIONS:-}`:
+**Nota**: Si configuras un valor para `NODE_OPTIONS`, asegúrate de que no sobrescriba `-r dd-trace/ci/init`. Esto se puede hacer mediante la cláusula `${NODE_OPTIONS:-}`:
{{< code-block lang="json" filename="package.json" >}}
{
@@ -97,49 +91,55 @@ NODE_OPTIONS="-r dd-trace/ci/init" DD_ENV=ci DD_SERVICE=my-javascript-app yarn t
}
{{< /code-block >}}
-### Añade etiquetas personalizadas a tests
+### Añadir tags (etiquetas) personalizadas a los tests
-Puedes añadir etiquetas personalizadas a tus tests mediante el tramo activo en ese momento:
+Puedes añadir tags (etiquetas) personalizadas a tus tests mediante el span (tramo) activo actual:
```javascript
it('sum function can sum', () => {
const testSpan = require('dd-trace').scope().active()
testSpan.setTag('team_owner', 'my_team')
- // test continúa normalmente
+ // test continues normally
// ...
})
```
-Para crear filtros o campos `group by` para estas etiquetas, primero debes crear facetas. Para obtener más información sobre añadir etiquetas, consulta la sección [Añadir etiquetas][1] de la documentación de la instrumentación personalizada de Node.js.
+Para crear filtros o campos `group by` para estas tags (etiquetas), primero debes crear facetas. Para obtener más información sobre el agregado de tags (etiquetas), consulta la sección [Añadir tags (etiquetas)][1] de la documentación sobre la instrumentación personalizada de Node.js.
### Añadir medidas personalizadas a tests
-Como con las etiquetas, puedes añadir medidas personalizadas a tus tests mediante el tramo activo en ese momento:
+Al igual que las tags (etiquetas), puedes añadir medidas personalizadas a tus tests mediante el span activo actual:
```javascript
it('sum function can sum', () => {
const testSpan = require('dd-trace').scope().active()
testSpan.setTag('memory_allocations', 16)
- // test continúa normalmente
+ // test continues normally
// ...
})
```
-Para más información sobre las medidas personalizadas, consulta la [guía Añadir medidas personalizadas][2].
+Para obtener más información acerca de las medidas personalizadas, consulta la [Guía para añadir medidas personalizadas][2].
+
+### Módulos de ECMAScript de Mocha (ESM)
+[Mocha >=9.0.0][3] utiliza un primer enfoque de ESM para cargar archivos de tests. Configura `NODE_OPTIONS` en `-r dd-trace/ci/init --import dd-trace/register.js` para obtener una visibilidad completa de tus tests. Consulta [Compatibilidad de`dd-trace-js` y ESM][4] para obtener más información.
+
[1]: /es/tracing/trace_collection/custom_instrumentation/nodejs?tab=locally#adding-tags
[2]: /es/tests/guides/add_custom_measures/?tab=javascripttypescript
+[3]: https://github.com/mochajs/mocha/releases/tag/v9.0.0
+[4]: https://github.com/datadog/dd-trace-js?tab=readme-ov-file#ecmascript-modules-esm-support
{{% /tab %}}
{{% tab "Playwright" %}}
-Establece la variable de entorno `NODE_OPTIONS` en `-r dd-trace/ci/init`. Run your tests as you normally would, specifying the environment where the tests are run in the `DD_ENV` environment variable. For example, set `DD_ENV` to `local` when running tests on a developer workstation, or `ci` cuando lo ejecutas en un proveedor de CI:
+Configura la variable de entorno `NODE_OPTIONS` en `-r dd-trace/ci/init`. Ejecuta tus tests como lo harías normalmente, opcionalmente especificando un nombre para tu sesión de tests con `DD_TEST_SESSION_NAME`:
```bash
-NODE_OPTIONS="-r dd-trace/ci/init" DD_ENV=ci DD_SERVICE=my-javascript-app yarn test
+NODE_OPTIONS="-r dd-trace/ci/init" DD_TEST_SESSION_NAME=e2e-tests yarn test:e2e
```
-**Nota**: Si estableces un valor de `NODE_OPTIONS`, asegúrate que no sobrescriba la cláusula `-r dd-trace/ci/init`. This can be done using the `${NODE_OPTIONS:-}`:
+**Nota**: Si configuras un valor para `NODE_OPTIONS`, asegúrate de que no sobrescriba `-r dd-trace/ci/init`. Esto se puede hacer mediante la cláusula `${NODE_OPTIONS:-}`:
{{< code-block lang="json" filename="package.json" >}}
{
@@ -149,14 +149,14 @@ NODE_OPTIONS="-r dd-trace/ci/init" DD_ENV=ci DD_SERVICE=my-javascript-app yarn t
}
{{< /code-block >}}
-### Añadir etiquetas personalizadas a tests
+### Añadir tags (etiquetas) personalizadas a tests
-Puedes añadir etiquetas personalizadas a tus tests mediante la [API de anotaciones personalizadas de Playwright][1]:
+Puedes añadir tags (etiquetas) personalizadas a tus tests mediante la [API de anotaciones personalizadas desde Playwright][1]:
```javascript
test('user profile', async ({ page }) => {
test.info().annotations.push({
- type: 'DD_TAGS[test.memory.usage]', // DD_TAGS es obligatorio y distingue entre mayúscula y minúscula
+ type: 'DD_TAGS[test.memory.usage]', // DD_TAGS is mandatory and case sensitive
description: 'low',
});
test.info().annotations.push({
@@ -175,7 +175,7 @@ test('landing page', async ({ page }) => {
});
```
-El formato de las anotaciones es el siguiente, donde `$TAG_NAME` y `$TAG_VALUE` son *cadenas* que representan el nombre de etiqueta y el valor, respectivamente:
+El formato de las anotaciones es el siguiente, donde `$TAG_NAME` y `$TAG_VALUE` son *cadenas* que representan el nombre y el valor de la tag (etiqueta), respectivamente:
```json
{
@@ -186,18 +186,18 @@ El formato de las anotaciones es el siguiente, donde `$TAG_NAME` y `$TAG_VALUE`
### Añadir medidas personalizadas a tests
-Las medidas personalizadas también usan anotaciones personalizadas:
+Las medidas personalizadas también utilizan anotaciones personalizadas:
```javascript
test('user profile', async ({ page }) => {
test.info().annotations.push({
- type: 'DD_TAGS[test.memory.allocations]', // DD_TAGS es obligatorio y distingue entre mayúscula y minúscula
- description: 16, // este es un número
+ type: 'DD_TAGS[test.memory.allocations]', // DD_TAGS is mandatory and case sensitive
+ description: 16, // this is a number
});
});
```
-El formato de las anotaciones es el siguiente, donde `$TAG_NAME` es una *cadena* que representa el nombre de etiqueta y `$TAG_VALUE` es un *número* que representa el valor de etiqueta:
+El formato de las anotaciones es el siguiente, donde `$TAG_NAME` es una *cadena* que representa el nombre de la tag (etiqueta) y `$TAG_VALUE` es un *número* que representa el valor de la tag (etiqueta):
```json
{
@@ -205,21 +205,26 @@ El formato de las anotaciones es el siguiente, donde `$TAG_NAME` es una *cadena*
"description": $TAG_VALUE
}
```
-**Nota*: Los valores `description` en anotaciones se [escriben como cadenas][2]. Los números también funcionan, pero debes desactivar el error de escritura con `// @ts-expect-error`.
+**Nota**: Los valores `description` en las anotaciones se [escriben como cadenas][2]. Los números también funcionan, pero puede ser necesario desactivar el error de escritura con `// @ts-expect-error`.
- Importante: El prefijo DD_TAGS es obligatorio y distingue entre mayúscula y minúscula.
+ Importante: El prefijo DD_TAGS es obligatorio y distingue mayúsculas de minúsculas.
+### Integración de Playwright y RUM
+
+Si la aplicación de navegador que se está comprobando se instrumenta mediante [Monitorización del navegador][3], los resultados del test de Playwright y sus sesiones de navegador y repeticiones de sesión generadas con RUM se vinculan automáticamente. Para obtener más información, consulta la [Guía de instrumentación de tests del navegador con RUM][4].
+
[1]: https://playwright.dev/docs/test-annotations#custom-annotations
[2]: https://playwright.dev/docs/api/class-testinfo#test-info-annotations
+[3]: /es/real_user_monitoring/application_monitoring/browser/setup/
+[4]: /es/continuous_integration/guides/rum_integration/
{{% /tab %}}
{{% tab "Cucumber" %}}
-Establece la variable de entorno `NODE_OPTIONS` en `-r dd-trace/ci/init`. Run your tests as you normally would, specifying the environment where the tests are run in the `DD_ENV` environment variable. For example, set `DD_ENV` to `local` when running tests on a developer workstation, or `ci` cuando lo ejecute en un proveedor de CI:
-
+Configura la variable de entorno `NODE_OPTIONS` en `-r dd-trace/ci/init`. Ejecuta tus tests como lo harías normalmente, opcionalmente especificando un nombre para tu sesión de test con `DD_TEST_SESSION_NAME`:
```bash
-NODE_OPTIONS="-r dd-trace/ci/init" DD_ENV=ci DD_SERVICE=my-javascript-app yarn test
+NODE_OPTIONS="-r dd-trace/ci/init" DD_TEST_SESSION_NAME=integration-tests yarn test:integration
```
**Nota**: Si estableces un valor para `NODE_OPTIONS`, asegúrate de que no sobrescriba la cláusula `-r dd-trace/ci/init`. This can be done using the `${NODE_OPTIONS:-}`:
@@ -232,7 +237,7 @@ NODE_OPTIONS="-r dd-trace/ci/init" DD_ENV=ci DD_SERVICE=my-javascript-app yarn t
}
{{< /code-block >}}
-### Añadir etiquetas personalizadas a los tests
+### Añadir tags (etiquetas) personalizadas a los tests
Puedes añadir etiquetas personalizadas a tus tests con el tramo activo en ese momento:
@@ -256,7 +261,7 @@ También puedes añadir medidas personalizadas a tu test con el tramo que esté
When('the function is called', function () {
const stepSpan = require('dd-trace').scope().active()
testSpan.setTag('memory_allocations', 16)
- // test continúa normalmente
+ // test continues normally
// ...
})
```
@@ -306,8 +311,8 @@ const { defineConfig } = require('cypress')
module.exports = defineConfig({
e2e: {
setupNodeEvents(on, config) {
- // tu código previo va antes de esta línea
- require('dd-trace/ci/cypress/plugin')(on, config)
+ // tu código anterior está antes de esta línea
+ return require('dd-trace/ci/cypress/plugin')(on, config)
}
}
})
@@ -370,8 +375,8 @@ Estas son las instrucciones si estás utilizando una versión anterior a `cypres
Si ya has definido un `pluginsFile`, inicializa la instrumentación con:
{{< code-block lang="javascript" filename="cypress/plugins/index.js" >}}
module.exports = (on, config) => {
- // tu código previo va antes de esta línea
- require('dd-trace/ci/cypress/plugin')(on, config)
+ // tu código anterior está antes de esta línea
+ return require('dd-trace (traza)/ci/cypress/plugin')(on, config)
}
{{< /code-block >}}
@@ -416,14 +421,14 @@ module.exports = (on, config) => {
{{< /code-block >}}
-Ejecuta tus tests como lo haces normalmente, especificando el entorno donde se están ejecutando (por ejemplo, `local` cuando se ejecutan los tests en una estación de trabajo de desarrollador, o `ci` cuando se ejecutan en un proveedor de CI) en la variable de entorno `DD_ENV`. Por ejemplo:
+Ejecuta tus tests como lo harías normalmente, especificando opcionalmente un nombre para tu sesión de test con `DD_TEST_SESSION_NAME`:
{{< code-block lang="shell" >}}
-DD_ENV=ci DD_SERVICE=my-ui-app npm test
+DD_TEST_SESSION_NAME=ui-tests yarn test:ui
{{< /code-block >}}
-### Añadir etiquetas personalizadas a los tests
+### Añadir etiquetas (tags) personalizadas a los tests
Para añadir información adicional a tus tests, como el propietario del equipo, utiliza `cy.task('dd:addTags', { yourTags: 'here' })` en tu testo hooks.
@@ -478,21 +483,21 @@ Si la aplicación de navegador que se está probando se instrumenta con la [Moni
[7]: https://docs.cypress.io/guides/core-concepts/writing-and-organizing-tests#Support-file
[8]: /es/tracing/trace_collection/custom_instrumentation/nodejs?tab=locally#adding-tags
[9]: /es/tests/guides/add_custom_measures/?tab=javascripttypescript
-[10]: /es/real_user_monitoring/browser/setup
+[10]: /es/real_user_monitoring/application_monitoring/browser/setup/
[11]: /es/continuous_integration/guides/rum_integration/
{{% /tab %}}
{{% tab "Vitest" %}}
`vitest` y `dd-trace` requieren Node.js>=18.19 o Node.js>=20.6 para funcionar.
-Establece la variable de entorno `NODE_OPTIONS` en `--import dd-trace/register.js -r dd-trace/ci/init`. Run your tests as you normally would, specifying the environment where the tests are run in the `DD_ENV` environment variable. For example, set `DD_ENV` to `local` when running tests on a developer workstation, or `ci` cuando se ejecute en un proveedor de CI:
+Configura la variable de entorno `NODE_OPTIONS` en `--import dd-trace/register.js -r dd-trace/ci/init`. Ejecuta tus tests como lo harías normalmente, opcionalmente especificando un nombre para tu sesión de test con `DD_TEST_SESSION_NAME`:
```bash
-NODE_OPTIONS="--import dd-trace/register.js -r dd-trace/ci/init" DD_ENV=ci DD_SERVICE=my-javascript-app yarn test
+NODE_OPTIONS="--import dd-trace/register.js -r dd-trace/ci/init" DD_TEST_SESSION_NAME=smoke-tests yarn test:smoke
```
**Nota**: Si estableces un valor para `NODE_OPTIONS`, asegúrate de que no sobrescriba la cláusula `--import dd-trace/register.js -r dd-trace/ci/init`. This can be done using the `${NODE_OPTIONS:-}`:
@@ -529,6 +534,7 @@ jobs:
my-job:
name: Run tests
runs-on: ubuntu-latest
+ # Invalid NODE_OPTIONS
env:
NODE_OPTIONS: -r dd-trace/ci/init
steps:
@@ -595,10 +601,16 @@ Para más información, consulta [Cobertura del código][6].
A continuación, se muestra una lista de los ajustes más importantes de configuración que se pueden utilizar con el rastreador.
+`test_session.name`
+: Se utiliza para identificar un grupo de tests, como `integration-tests`, `unit-tests` o `smoke-tests`.
+**Variable de entorno**: `DD_TEST_SESSION_NAME`
+**Predeterminado**: (nombre del job (generic) de integración continua + comando de test)
+**Ejemplo**: `unit-tests`, `integration-tests`, `smoke-tests`
+
`service`
: nombre del servicio o biblioteca en proceso de test.
**Variable de entorno **: `DD_SERVICE`
-**Por defecto**: (nombre del marco de test)
+**Por defecto**: (nombre del framework de test)
**Ejemplo**: `my-ui`
`env`
@@ -621,16 +633,12 @@ Para más información sobre etiquetas `service` y `env` reservadas, consulta [E
## API para tests manuales
- Nota: Para utilizar la API de tests manuales, debes pasar DD_CIVISIBILITY_MANUAL_API_ENABLED=1 como variable de entorno.
+ Nota: La API de tests manuales está disponible a partir de las versiones 5.23.0 y 4.47.0 de dd-trace.
-
- Nota: La API de tests manuales está en fase beta, por lo que podría sufrir modificaciones. Está disponible a partir de las versiones 4.4.0, 3.25.0 y 2.38.0 de dd-trace.
-
+Si utilizas Jest, Mocha, Cypress, Playwright, Cucumber o Vitest, **no utilices la API de tests manuales**, ya que Test Optimization (optimización de tests) los instrumenta automáticamente y envía los resultados de los tests a Datadog. La API de test manual es **incompatible** con los frameworks de tests ya admitidos.
-Si utilizas Jest, Mocha, Cypress, Playwright, Cucumber o Vitest, **no utilices la API de tests manuales**, ya que CI Visibility los instrumenta automáticamente y envía los resultados a Datadog. La API de tests manuales es **incompatible** con los marcos de test que ya son compatibles.
-
-Utiliza la API de tests manuales solo si utilizas un marco de test no compatible o tienes un mecanismo de test diferente.
+Utiliza la API de tests manuales solo si utilizas un framework de test no compatible o tienes un mecanismo de test diferente.
La API de tests manuales aprovecha el módulo `node:diagnostics_channel` de Node.js y se basa en canales en los que se puede publicar:
@@ -664,7 +672,7 @@ Toma este canal por su ID `dd-trace:ci:manual:test:start` para publicar que se e
const { channel } = require('node:diagnostics_channel')
const testStartCh = channel('dd-trace:ci:manual:test:start')
-// ... el código para tu marco de test va aquí
+// ... el código para tu framework de test va aquí
beforeEach(() => {
const testDefinition = {
testName: 'a-string-that-identifies-this-test',
@@ -672,7 +680,7 @@ const testStartCh = channel('dd-trace:ci:manual:test:start')
}
testStartCh.publish(testDefinition)
})
-// el código para tu marco de test continúa aquí ...
+// el código para tu framework de test continúa aquí ...
```
La carga útil que se va a publicar tiene los atributos `testName` y `testSuite`, ambos cadenas, que identifican el test que está a punto de comenzar.
@@ -685,7 +693,7 @@ Toma este canal por su ID `dd-trace:ci:manual:test:finish` para publicar que se
const { channel } = require('node:diagnostics_channel')
const testFinishCh = channel('dd-trace:ci:manual:test:finish')
-// ... el código para tu marco de test va aquí
+// ... el código para tu framework de test va aquí
afterEach(() => {
const testStatusPayload = {
status: 'fail',
@@ -693,7 +701,7 @@ const testFinishCh = channel('dd-trace:ci:manual:test:finish')
}
testStartCh.publish(testStatusPayload)
})
-// el código para tu marco de test continúa aquí ...
+// el código para tu framework de test continúa aquí ...
```
La carga útil que se va a publicar tiene los atributos `status` y `error`:
@@ -713,13 +721,13 @@ Toma este canal por su ID `dd-trace:ci:manual:test:addTags` para publicar que un
const { channel } = require('node:diagnostics_channel')
const testAddTagsCh = channel('dd-trace:ci:manual:test:addTags')
-// ... el código para tu marco de test va aquí
+// ... el código para tu framework de test va aquí
test('can sum', () => {
testAddTagsCh.publish({ 'test.owner': 'my-team', 'number.assertions': 3 })
const result = sum(2, 1)
assert.equal(result, 3)
})
-// el código para tu marco de test continúa aquí ...
+// el código para tu framework de test continúa aquí ...
```
La carga útil que se publica es un diccionario `` de etiquetas o medidas que se añaden al test.
@@ -727,44 +735,47 @@ La carga útil que se publica es un diccionario `` de eti
### Ejecutar los tests
-Cuando los canales de inicio y fin del test estén en tu código, ejecuta tu marco de test como lo haces normalmente, incluyendo las siguientes variables de entorno:
+Cuando los canales de inicio y fin del test estén en tu código, ejecuta tu framework de test como lo haces normalmente, incluyendo las siguientes variables de entorno:
```shell
-NODE_OPTIONS="-r dd-trace/ci/init" DD_CIVISIBILITY_MANUAL_API_ENABLED=1 DD_ENV=ci DD_SERVICE=my-custom-framework-tests yarn run-my-test-framework
+NODE_OPTIONS="-r dd-trace/ci/init" DD_TEST_SESSION_NAME=custom-tests yarn run-my-test-framework
```
## Limitaciones conocidas
-### Módulos ES
-[Mocha >=9.0.0][9] utiliza un enfoque primero ESM para cargar archivos de test. Esto significa que si se utilizan [módulos ES][10] (por ejemplo, al definir archivos de test con la extensión `.mjs`), _la instrumentación está limitada_. Los tests se detectan, pero no hay visibilidad de tu test. Para más información sobre los módulos ES, consulta la [documentación de Node.js][10].
-
### Tests de navegador
Los tests de navegador ejecutados con `mocha`, `jest`, `cucumber`, `cypress`, `playwright` y `vitest` son instrumentados por `dd-trace-js`, pero la visibilidad de la sesión del navegador en sí no se proporciona por defecto (por ejemplo, llamadas de red, acciones del usuario, cargas de páginas, etc.).
-Si quieres visibilidad del proceso de navegador, considera el uso de [RUM y Session Replay][11]. Cuando se utiliza Cypress, los resultados de los tests y sus sesiones de navegador RUM generadas y las repeticiones de sesión se vinculan automáticamente. Para más información, consulta la [guía para Instrumentar tus tests de navegador con RUM][12].
+Si deseas tener visibilidad del proceso del navegador, considera el uso de [RUM y repetición de sesión][9]. Cuando se utiliza Cypress o Playwright, los resultados de test y sus sesiones de navegador de RUM generadas y las repeticiones de sesión se vinculan automáticamente. Para obtener más información, consulta la [Guía para Instrumentar tus tests del navegador con RUM][10].
### Modo interactivo de Cypress
-El modo interactivo de Cypress (al que puedes entrar ejecutando `cypress open`) no es compatible con CI Visibility porque algunos eventos de Cypress, como [`before:run`][13], no se activan. Si quieres probarlo de todas formas, pasa `experimentalInteractiveRunEvents: true` al [archivo de configuración de Cypress][14].
+El modo interactivo de Cypress (al que puedes entrar ejecutando `cypress open`) no es compatible con Test Optimization (optimización de tests) porque algunos eventos de cypress, como [`before:run`][11], no se disparan. Si deseas probarlo de todas formas, pasa `experimentalInteractiveRunEvents: true` al [archivo de configuración de cypress][12].
+
+### `--workerThreads` de Jest
+La opción [workerThreads][13] de Jest no es compatible.
### `test.concurrent` de Jest
-No se admite [test.concurrent][15] de Jest.
+[test.concurrent][14] de Jest no es compatible.
### `--forceExit` de Jest
-La opción [--forceExit][16] de Jest puede causar pérdida de datos. Datadog intenta enviar datos inmediatamente después de que tus tests terminen, pero cerrar el proceso abruptamente puede causar que algunas solicitudes fallen. Usa `--forceExit` con precaución.
+La opción [--forceExit][15] de Jest puede provocar la pérdida de datos. Datadog intenta enviar datos inmediatamente después de que finalicen tus tests, pero el cierre abrupto del proceso puede hacer que fallen algunas solicitudes. Utiliza `--forceExit` con precaución.
### `--exit` de Mocha
-La opción [--exit][17] de Mocha puede causar pérdida de datos. Datadog intenta enviar datos inmediatamente después de que tus tests terminen, pero cerrar el proceso abruptamente puede causar que algunas solicitudes fallen. Usa `--exit` con precaución.
+La opción [--exit][16] de Mocha puede provocar la pérdida de datos. Datadog intenta enviar los datos inmediatamente después de que finalicen tus tests, pero el cierre abrupto del proceso puede hacer que fallen algunas solicitudes. Utiliza `--exit` con precaución.
+
+### Modo navegador de Vitest
+El [modo navegador][17] de Vitest no es compatible.
## Prácticas recomendadas
-Sigue estas prácticas para aprovechar al máximo el marco de test y CI Visibility.
+Siga estas prácticas para aprovechar al máximo el framework testing y la optimización de test (optimización de tests).
### Tests parametrizados
-Siempre que sea posible, aprovecha las herramientas que ofrecen los marcos de test para realizar tests parametrizados. Por ejemplo, para `jest`:
+Siempre que sea posible, aprovecha las herramientas que ofrecen los frameworks de test para realizar tests parametrizados. Por ejemplo, para `jest`:
Evita esto:
{{< code-block lang="javascript" >}}
@@ -796,7 +807,34 @@ forEach([
});
{{< /code-block >}}
-Cuando se utiliza este enfoque, tanto el marco de test como CI Visibility pueden distinguir tus tests.
+Cuando se utiliza este enfoque, tanto el framework de testing como test Optimization (optimización de tests) pueden distinguir sus tests.
+
+### Nombre de la sesión de test `DD_TEST_SESSION_NAME`
+
+Utiliza `DD_TEST_SESSION_NAME` para definir el nombre de la sesión de test y del grupo de tests relacionado. Algunos ejemplos de valores para esta etiqueta serían:
+
+- `unit-tests`
+- `integration-tests`
+- `smoke-tests`
+- `flaky-tests`
+- `ui-tests`
+- `backend-tests`
+
+Si no se especifica `DD_TEST_SESSION_NAME`, el valor predeterminado utilizado es una combinación de:
+
+- Nombre del job (generic) de CI
+- Comando utilizado para ejecutar los tests (como `yarn test`)
+
+El nombre de la sesión de tests debe ser único dentro de un repositorio para ayudarte a distinguir diferentes grupos de tests.
+
+#### Cuándo utilizar `DD_TEST_SESSION_NAME`
+
+Hay un conjunto de parámetros que Datadog comprueba para establecer la correspondencia entre las sesiones de test. El comando de test utilizado para ejecutar los tests es uno de ellos. Si el comando de test contiene una cadena que cambia en cada ejecución, como una carpeta temporal, Datadog considera que las sesiones no están relacionadas entre sí. Por ejemplo:
+
+- `yarn test --temp-dir=/var/folders/t1/rs2htfh55mz9px2j4prmpg_c0000gq/T`
+- `pnpm vitest --temp-dir=/var/folders/t1/rs2htfh55mz9px2j4prmpg_c0000gq/T`
+
+Datadog recomienda utilizar `DD_TEST_SESSION_NAME` si tus comandos de test varían entre diferentes ejecuciones.
## Referencias adicionales
@@ -810,14 +848,14 @@ Cuando se utiliza este enfoque, tanto el marco de test como CI Visibility pueden
[6]: /es/tests/code_coverage/?tab=javascripttypescript
[7]: /es/getting_started/tagging/unified_service_tagging
[8]: /es/tracing/trace_collection/library_config/nodejs/?tab=containers#configuration
-[9]: https://github.com/mochajs/mocha/releases/tag/v9.0.0
-[10]: https://nodejs.org/api/packages.html#packages_determining_module_system
-[11]: /es/real_user_monitoring/browser/
-[12]: /es/continuous_integration/guides/rum_integration/
-[13]: https://docs.cypress.io/api/plugins/before-run-api
-[14]: https://docs.cypress.io/guides/references/configuration#Configuration-File
-[15]: https://jestjs.io/docs/api#testconcurrentname-fn-timeout
-[16]: https://jestjs.io/docs/cli#--forceexit
-[17]: https://mochajs.org/#-exit
+[9]: /es/real_user_monitoring/application_monitoring/browser/
+[10]: /es/continuous_integration/guides/rum_integration/
+[11]: https://docs.cypress.io/api/plugins/before-run-api
+[12]: https://docs.cypress.io/guides/references/configuration#Configuration-File
+[13]: https://jestjs.io/docs/configuration#workerthreads
+[14]: https://jestjs.io/docs/api#testconcurrentname-fn-timeout
+[15]: https://jestjs.io/docs/cli#--forceexit
+[16]: https://mochajs.org/running/cli/#--exit
+[17]: https://vitest.dev/guide/browser/
[18]: https://jestjs.io/docs/api#testeachtablename-fn-timeout
-[19]: https://www.npmjs.com/package/mocha-each
+[19]: https://www.npmjs.com/package/mocha-each
\ No newline at end of file
diff --git a/content/es/tracing/other_telemetry/connect_logs_and_traces/java.md b/content/es/tracing/other_telemetry/connect_logs_and_traces/java.md
index 11c068a9743..4317d0534d0 100644
--- a/content/es/tracing/other_telemetry/connect_logs_and_traces/java.md
+++ b/content/es/tracing/other_telemetry/connect_logs_and_traces/java.md
@@ -28,15 +28,111 @@ Asegúrate de que la recopilación de log está configurada. Consulta [Recopilac
A partir de la versión 0.74.0, el rastreador de Java inyecta automáticamente identificadores de correlación de traza en logs con formato JSON. Para versiones anteriores, activa la inyección automática en el rastreador de Java añadiendo `dd.logs.injection=true` como propiedad del sistema, o a través de la variable de entorno `DD_LOGS_INJECTION=true`. Los detalles completos de configuración pueden encontrarse en la página de [configuración del rastreador de Java][2].
+Para un enfoque más universal, basado en la configuración, también puedes utilizar appenders de logs de OpenTelemetry'. Consulta [Correlación de traces (trazas) y logs de OpenTelemetry][6] para obtener instrucciones de configuración.
+
**Notas**:
-- La inyección automática de la correlación de traza está disponible para Log4j2, Log4j o SLF4J y Logback.
-- Si la `attribute.path` de tu ID de traza *no* es `dd.trace_id`, asegúrate de que la configuración de atributos reservados de tu ID de traza tiene en cuenta la `attribute.path`. Para obtener más información, consulta [Los logs correlacionados no aparecen en el panel de ID de traza][3].
+- La inserción automática de la correlación de traces (trazas) está disponible para Log4j2, Log4j o SLF4J y Logback.
+- Si la `attribute.path` de tu ID de traza *no* es `dd.trace_id`, asegúrate de que la configuración de atributos reservados de tu ID de trace (traza) tenga en cuenta la `attribute.path`. Para obtener más información, consulta [Los logs correlacionados no aparecen en el panel de ID de traces (trazas)][3].
+
+
+
+## Inserción manual
+
+Si prefieres añadir manualmente identificadores de correlación a tus logs, puedes utilizar una API de rastreo. Datadog recomienda utilizar la API estándar de OpenTelemetry para la neutralidad del proveedor y una mayor compatibilidad. También puedes utilizar la API específica de Datadog.
+
+### API de OpenTelemetry (recomendada)
+
+Para correlacionar logs y traces (trazas) con la API de OpenTelemetry, añade primero la dependencia `OpenTelemetry-api` a tu project (proyecto).
+
+{{< tabs >}}
+{{% tab "Maven" %}}
+
+```xml
+
+ io.opentelemetry
+ opentelemetry-api
+ 1.40.0 provided
+
+```
+
+{{% /tab %}}
+{{% tab "Gradle" %}}
+
+```groovy
+compileOnly 'io.opentelemetry:opentelemetry-api:1.40.0'
+```
+{{% /tab %}}
+{{% tab "Gradle (Kotlin DSL)" %}}
+
+```kotlin
+compileOnly("io.opentelemetry:opentelemetry-api:1.40.0")
+```
+
+{{% /tab %}}
+{{< /tabs >}}
+
+Después de añadir la dependencia, utiliza la clase `Span` de OpenTelemetry para acceder a los ID actuales de trace (traza) y span (tramo) y añadirlos a tu contexto de logging.
+
+Por ejemplo:
+
+```java
+import io.opentelemetry.api.trace.Span;
+import io.opentelemetry.api.trace.SpanContext;
+import org.slf4j.MDC;
+
+// ...
+
+SpanContext spanContext = Span.current().getSpanContext();
+if (spanContext.isValid()) {
+ try {
+ MDC.put("dd.trace_id", spanContext.getTraceId());
+ MDC.put("dd.span_id", spanContext.getSpanId());
+ // Log something
+ } finally {
+ MDC.remove("dd.trace_id");
+ MDC.remove("dd.span_id");
+ }
+}
+```
+
+**Nota**: Si no hay ningún span (tramo) activo, `spanContext.isValid()` devuelve `false` y no se añade ningún ID a los logs.
+
+### API de Datadog
+
+Para correlacionar manualmente logs y traces (trazas) con la API de Datadog, añade la dependencia `dd-trace-api` a tu project (proyecto).
+
+{{< tabs >}}
+{{% tab "Maven" %}}
+
+```xml
+
+ com.datadoghq
+ dd-trace-api
+ LATEST_VERSION
+
+```
-
+{{% /tab %}}
+{{% tab "Gradle" %}}
-## Inyección manual
+```groovy
+implementation 'com.datadoghq:dd-trace-api:LATEST_VERSION'
+```
+{{% /tab %}}
+{{% tab "Gradle (Kotlin DSL)" %}}
-Si prefieres correlacionar manualmente tus trazas con tus logs, utiliza la API del rastreador de Java para recuperar los identificadores de correlación. Utiliza los métodos `CorrelationIdentifier.getTraceId` y `CorrelationIdentifier.getSpanId` para inyectar identificadores al principio del tramo que se está registrando, y elimina los identificadores cuando el tramo haya finalizado.
+```kotlin
+implementation("com.datadoghq:dd-trace-api:LATEST_VERSION")
+```
+
+{{% /tab %}}
+{{< /tabs >}}
+
+Sustituye `LATEST_VERSION` por la misma versión que tu rastreador de Java de Datadog (`dd-java-agent`).
+
+Después de añadir la dependencia, utiliza `CorrelationIdentifier.getTraceId()` y `CorrelationIdentifier.getSpanId()` para recuperar e insertar los ID en tu contexto de logging, como se muestra en los siguientes ejemplos.
+
+Si no hay ningún span (tramo) activo, CorrelationIdentifier.getTraceId() y getSpanId() devuelven "0". Asegúrate de que los spans (tramos) se inicien antes de ejecutar este código.
{{< tabs >}}
{{% tab "Log4j 2" %}}
@@ -45,32 +141,31 @@ Si prefieres correlacionar manualmente tus trazas con tus logs, utiliza la API d
import org.apache.logging.log4j.ThreadContext;
import datadog.trace.api.CorrelationIdentifier;
-// Deben haber tramos iniciados y activos antes de este bloque.
+// There must be spans started and active before this block.
try {
ThreadContext.put("dd.trace_id", CorrelationIdentifier.getTraceId());
ThreadContext.put("dd.span_id", CorrelationIdentifier.getSpanId());
-// Loguear algo.
+// Log something
} finally {
ThreadContext.remove("dd.trace_id");
ThreadContext.remove("dd.span_id");
}
```
-
{{% /tab %}}
-{{% tab "SLF4J and Logback" %}}
+{{% tab "SLF4J y Logback" %}}
```java
import org.slf4j.MDC;
import datadog.trace.api.CorrelationIdentifier;
-// Deben haber tramos iniciados y activos antes de este bloque.
+// There must be spans started and active before this block.
try {
MDC.put("dd.trace_id", CorrelationIdentifier.getTraceId());
MDC.put("dd.span_id", CorrelationIdentifier.getSpanId());
-// Loguear algo.
+// Log something
} finally {
MDC.remove("dd.trace_id");
@@ -84,12 +179,12 @@ try {
import org.tinylog.ThreadContext;
import datadog.trace.api.CorrelationIdentifier;
-// Deben haber tramos iniciados y activos antes de este bloque.
+// There must be spans started and active before this block.
try {
ThreadContext.put("dd.trace_id", CorrelationIdentifier.getTraceId());
ThreadContext.put("dd.span_id", CorrelationIdentifier.getSpanId());
-// Loguear algo.
+// Log something
} finally {
ThreadContext.remove("dd.trace_id");
@@ -99,11 +194,11 @@ try {
{{% /tab %}}
{{< /tabs >}}
-**Nota:** Si no utilizas [la integración de log de Datadog][4] para analizar tus logs, las reglas personalizadas de parseo de log deben asegurar que `dd.trace_id` y `dd.span_id` se analicen como cadenas. Para obtener más información, consulta [Los logs correlacionados no aparecen en el panel de ID de traza][5].
+**Nota:** Si no utilizas [la integración de log de Datadog][4] para analizar tus logs, las reglas personalizadas de parseo de log deben asegurar que `dd.trace_id` y `dd.span_id` se analicen como cadenas. Para obtener más información, consulta [Los logs correlacionados no aparecen en el panel de ID de trace (traza)][5].
[Consulta la documentación de la recopilación de log de Java][1] para obtener más detalles sobre el despliegue específico del registrador e instrucciones para el registro en formato JSON.
-## Leer más
+## Referencias adicionales
{{< partial name="whats-next/whats-next.html" >}}
@@ -111,4 +206,5 @@ try {
[2]: /es/tracing/trace_collection/dd_libraries/java/
[3]: /es/tracing/troubleshooting/correlated-logs-not-showing-up-in-the-trace-id-panel/?
[4]: /es/logs/log_collection/java/#raw-format
-[5]: /es/tracing/troubleshooting/correlated-logs-not-showing-up-in-the-trace-id-panel/?tab=custom
\ No newline at end of file
+[5]: /es/tracing/troubleshooting/correlated-logs-not-showing-up-in-the-trace-id-panel/?tab=custom
+[6]: /es/tracing/connect_logs_and_traces/opentelemetry
\ No newline at end of file
diff --git a/content/es/tracing/services/inferred_entity_remapping_rules.md b/content/es/tracing/services/inferred_entity_remapping_rules.md
new file mode 100644
index 00000000000..a2dd5377a7f
--- /dev/null
+++ b/content/es/tracing/services/inferred_entity_remapping_rules.md
@@ -0,0 +1,68 @@
+---
+aliases:
+- /es/tracing/services/renaming_rules/
+description: Crea nombres personalizados para entidades inferidas como bases de datos
+ y colas utilizando etiquetas (tags) y expresiones regulares.
+further_reading:
+- link: tracing/services/inferred_services
+ tag: Documentación
+ text: Servicios inferidos
+site_support_id: reglas_reasignación_entidades_inferidas
+title: Reglas de reasignación para entidades inferidas
+---
+
+## Información general
+
+En Datadog, puedes reasignar entidades inferidas, que incluyen los almacenes de datos y las colas, para que sean más fáciles de identificar y gestionar. Las reglas de reasignación permiten sustituir la etiqueta `peer.service` en tramos (spans) con nombres personalizados o generar nombres dinámicamente utilizando etiquetas y expresiones regulares. Esta funcionalidad se aplica en todo APM, no solo en el [Software Catalog][3]. Una vez creada una regla, los nombres actualizados aparecen de forma coherente en mapas de servicio, Trace Explorer, monitores, dashboards y cualquier otra vista de APM.
+
+La reasignación es útil cuando:
+- El nombre por defecto no coincide con tus preferencias o convenciones.
+- Los servicios que esperas que aparezcan como uno solo se dividen en varias entidades inferidas.
+- Varios componentes están agrupados bajo un mismo nombre, pero quieres representarlos por separado.
+
+**Nota**: Esta página describe solo la reasignación de entidades inferidas. Para reasignar tus servicios instrumentados (rastreados), está disponible la versión preliminar de [Service Remapping Rules][4].
+
+## Requisitos previos
+
+Debes tener el permiso `apm_service_renaming_write` para crear reglas de reasignación. Consulta [Permisos][2] para obtener más información sobre el control de acceso basado en roles de Datadog.
+
+## Crear una regla de reasignación
+
+### Paso 1: Seleccionar la acción y las entidades de reasignación objetivo
+
+1. En Datadog, ve a **APM > Software Catalog > Manage > Manage Remapping Rules** (APM > Software Catalog > Gestionar > Gestionar reglas de reasignación) y haz clic en **+ Add Rule** (+ Añadir regla).
+
+ Alternativamente, ve a **APM > Software Catalog** y haz clic en un servicio para abrir el panel lateral de servicios. Desde allí, haz clic en **Service Page > Service Remapping** (Página de servicio > Reasignación de servicios).
+
+ {{< img src="tracing/services/renaming_rules/service-side-panel.png" alt="Panel lateral de un servicio concreto que muestra el menú desplegable de la página de servicio con una opción de reasignación de servicios" style="width:100%;" >}}
+
+1. Elige una acción de reasignación que quieras realizar para tu nueva regla de reasignación.
+
+ Puedes optar por dividir una única entidad, renombrar una entidad, fusionar varias entidades o reasignar varias entidades.
+
+1. Utiliza la barra de búsqueda para seleccionar las entidades que quieres reasignar.
+ - Puedes seleccionar una o varias entidades, pero todas deben ser del mismo tipo (servicio, almacén de datos o cola).
+ - A medida que seleccionas entidades, se crea una consulta de tramo en segundo plano. Para editar la consulta, selecciona **Build Advanced Query** (Crear consulta avanzada).
+
+
+### Paso 2: Especificar el nombre de la nueva entidad
+
+1. En el cuadro de texto, introduce un nombre único para la entidad (o entidades) seleccionada. Alternativamente, utiliza valores de etiqueta con la sintaxis `{{tagName}}` para reasignar en función de las etiquetas de una entidad.
+1. Si los valores de las etiquetas siguen un patrón, aplica una expresión regular para extraer solo la parte que quieras del nombre.
+
+
+### Paso 3: Colocarle un nombre a tu regla y revisarla
+
+1. Puedes introducir un nombre descriptivo para la regla de reasignación a fin de poder identificarla posteriormente.
+1. Revisa y guarda tu regla de reasignación.
+
+- Las reglas se procesan en la ingesta y se aplican a los datos a medida que se reciben.
- Los cambios solo afectan a los tramos en los que la regla está activa y los datos anteriores no se actualizan de forma retroactiva.
- La eliminación o modificación de una regla impide que se aplique a los nuevos datos, pero no revierte los nombres de los datos ingeridos anteriormente.
+
+## Referencias adicionales
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /es/tracing/services/inferred_services
+[2]: /es/account_management/rbac/permissions
+[3]: /es/internal_developer_portal/software_catalog/
+[4]: /es/tracing/services/service_remapping_rules/
\ No newline at end of file
diff --git a/content/es/tracing/trace_collection/library_config/java.md b/content/es/tracing/trace_collection/library_config/java.md
index 8fbae91ce3f..1479316cb1d 100644
--- a/content/es/tracing/trace_collection/library_config/java.md
+++ b/content/es/tracing/trace_collection/library_config/java.md
@@ -7,24 +7,26 @@ further_reading:
text: Código fuente APM de Java para Datadog
- link: tracing/glossary/
tag: Documentación
- text: Explorar tus servicios, recursos y trazas (traces)
-- link: /tracing/trace_collection/trace_context_propagation/java/
+ text: Explorar tus servicios, recursos y traces (trazas)
+- link: /tracing/trace_collection/trace_context_propagation/
tag: Documentación
text: Propagación del contexto de rastreo utilizando cabeceras
- link: /opentelemetry/interoperability/environment_variable_support
tag: Documentación
text: Configuraciones de variables de entorno de OpenTelemetry
-title: Configuración de la librería de rastreo de Java
-type: lenguaje de código múltiple
+title: Configuración de la biblioteca de rastreo de Java
+type: multi-code-lang
---
-Después de configurar la librería de rastreo con tu código y de configurar el Agent para recopilar datos de APM, también puedes configurar la librería de rastreo como prefieras e incluir la configuración del [Etiquetado unificado de servicios][1].
+Después de configurar la biblioteca de rastreo con tu código y de configurar el Agent para recopilar datos de APM, también puedes configurar la biblioteca de rastreo como prefieras e incluir la configuración del [Etiquetado unificado de servicios][1].
+
+{{% apm-config-visibility %}}
Todas las opciones de configuración anteriores tienen propiedades del sistema y variables de entorno equivalentes.
Si se define el mismo tipo de clave para ambas, la configuración de propiedades del sistema tiene prioridad.
Las propiedades del sistema se pueden establecer como marcas de máquinas virtuales Java.
-### Conversión entre propiedades del sistema y variables de entorno
+### Conversión entre propiedades del sistema y variables de entorno
A menos que se indique lo contrario, puedes convertir entre propiedades del sistema y variables de entorno utilizando las siguientes transformaciones:
- Para definir una propiedad del sistema como variable de entorno, escribe el nombre de la propiedad en mayúsculas y sustitúyelo por `.` o `-` por `_`.
@@ -36,17 +38,13 @@ A menos que se indique lo contrario, puedes convertir entre propiedades del sist
## Opciones de configuración
+### Etiquetado de servicios unificados
+
`dd.service`
: **Variable de entorno**: `DD_SERVICE`
**Por defecto**: `unnamed-java-app`
El nombre de un conjunto de procesos que realizan la misma tarea. Se utiliza para agrupar estadísticas para tu aplicación. Disponible para las versiones 0.50.0 o posteriores.
-`dd.tags`
-: **Variable de entorno**: `DD_TAGS`
-**Por defecto**: `null`
-**Ejemplo**: `layer:api,team:intake,key:value`
-Una lista de etiquetas (tags) predeterminadas que se añadirá a cada tramo (span), perfil y métrica JMX. Si se utiliza DD_ENV o DD_VERSION, se anula cualquier etiqueta de entorno o versión definida en DD_TAGS. Disponible para las versiones 0.50.0 o posteriores.
-
`dd.env`
: **Variable de entorno**: `DD_ENV`
**Por defecto**: `none`
@@ -57,16 +55,19 @@ El entorno de tu aplicación (por ejemplo, producción, staging). Disponible par
**Por defecto**: `null`
La versión de tu aplicación (por ejemplo, 2.5, 202003181415, 1.3-alpha). Disponible para las versiones 0.48 o posteriores.
-`dd.logs.injection`
-: **Variable de entorno**: `DD_LOGS_INJECTION`
-**Por defecto**: `true`
-Inyección automática de claves MDC habilitada para los ID de rastreo y de tramos de Datadog. Para obtener más detalles, consulta [Uso avanzado][2].
-**Beta**: A partir de la versión 1.18.3, si la [configuración remota del Agent][3] está habilitada donde se ejecuta este servicio, puedes configurar `DD_LOGS_INJECTION` en la interfaz de usuario del [Catálogo de servicios][4].
+### Traces (trazas)
+
+`dd.trace.enabled`
+: **Variable de entorno**: `DD_TRACE_ENABLED`
+**Predeterminada**: `true`
+Cuando es `false` el agente de rastreo está desactivado.
+Consulta también [DD_APM_TRACING_ENABLED][21].
`dd.trace.config`
: **Variable de entorno**: `DD_TRACE_CONFIG`
-**Por defecto**: `null`
-Ruta opcional a un archivo donde se proporcionan las propiedades de configuración, una por cada línea. Por ejemplo, la ruta del archivo puede proporcionarse a través de propiedades `-Ddd.trace.config=`, configurando el nombre del servicio en el archivo con `dd.service=`
+**Predeterminada**: `null`
+Ruta opcional a un archivo donde se proporcionan las propiedades de configuración, una por cada línea. Por ejemplo, la ruta al archivo se puede proporcionar a través de `-Ddd.trace.config=.properties`, configurando el nombre del servicio en el archivo con `dd.service=`
+**Nota**: No confíes en `dd.trace.config` como el único mecanismo para para activar o desactivar productos dependientes del kit de desarrollo de software (SDK) (por ejemplo, Profiler y Dynamic Instrumentation). En su lugar, utiliza las propiedades del sistema o las variables de entorno correspondientes (o `application_monitoring.yaml` para la instrumentación de un solo step (UI) / paso (generic)).
`dd.service.mapping`
: **Variable de entorno**: `DD_SERVICE_MAPPING`
@@ -79,11 +80,6 @@ Cambia dinámicamente el nombre del servicio mediante la configuración. Esto es
**Por defecto**: `DDAgentWriter`
El valor por defecto envía trazas al Agent. Si se configura con `LoggingWriter`, escribe trazas a la consola.
-`dd.agent.host`
-: **Variable de entorno**: `DD_AGENT_HOST`
-**Por defecto**: `localhost`
-Nombre de host al que enviar trazas. Si utilizas un entorno contenedorizado, configúralo como IP del host. Para obtener más detalles, consulta [Rastreo de aplicaciones Docker][5].
-
`dd.trace.agent.port`
: **Variable de entorno**: `DD_TRACE_AGENT_PORT`
**Por defecto**: `8126`
@@ -104,24 +100,23 @@ La URL a la que enviar trazas. Si la [configuración del Agent][6] define `recei
**Por defecto**: `10`
Tiempo de espera en segundos de las interacciones de red con el Datadog Agent.
+`dd.trace.client-ip.enabled`
+: **Predeterminada**: `false`
+Activa la recopilación de IP del cliente a partir de encabezados de IP pertinentes en spans (tramos) de solicitudes HTTP. Activado automáticamente cuando `dd.appsec.enabled=true`.
+
`dd.trace.header.tags`
: **Variable de entorno**: `DD_TRACE_HEADER_TAGS`
-**Por defecto**: `null`
+**Predeterminada**: `null`
**Ejemplo**: `CASE-insensitive-Header:my-tag-name,User-ID:userId,My-Header-And-Tag-Name`
-Acepta un mapa de claves de cabeceras que no distinguen entre mayúsculas/minúsculas para nombres de etiquetas y aplica automáticamente valores de cabeceras coincidentes como etiquetas en las trazas. También acepta entradas sin un nombre de etiqueta especificado, que se asignan automáticamente a etiquetas con los formatos `http.request.headers.` y `http.response.headers.`, respectivamente.
-Antes de la versión 0.96.0, esta configuración sólo se aplicaba a etiquetas de cabeceras de solicitudes. Para volver al comportamiento anterior, añade el parámetro `-Ddd.trace.header.tags.legacy.parsing.enabled=true` o la variable de entorno `DD_TRACE_HEADER_TAGS_LEGACY_PARSING_ENABLED=true`.
-**Beta**: A partir de la versión 1.18.3, si la [configuración remota del Agent][3] está habilitada donde se ejecuta este servicio, puedes configurar `DD_TRACE_HEADER_TAGS` en la interfaz de usuario del [Catálogo de servicios][4].
-
-`dd.trace.rate.limit`
-: **Variable de entorno**: `DD_TRACE_RATE_LIMIT`
-**Por defecto**: `100`
-Número máximo de tramos para muestrear por segundo, por cada proceso, cuando se configuran`DD_TRACE_SAMPLING_RULES` o `DD_TRACE_SAMPLE_RATE`. De lo contrario, el Datadog Agent controla la limitación de la frecuencia.
+Acepta un mapa de claves de encabezado que no distinguen entre mayúsculas/minúsculas para nombres de tags (etiquetas) y aplica automáticamente los valores de encabezado coincidentes como tags (etiquetas) en las traces (trazas). También acepta entradas sin un nombre de tag (etiqueta) especificado que se asignan automáticamente a tags (etiquetas) de la forma `http.request.headers.` y `http.response.headers.`, respectivamente.
+Antes de la versión 0.96.0 esta configuración solo se aplicaba a las tags (etiquetas) de encabezados de solicitudes. Para volver al comportamiento anterior, añade la configuración `-Ddd.trace.header.tags.legacy.parsing.enabled=true` o la variable de entorno `DD_TRACE_HEADER_TAGS_LEGACY_PARSING_ENABLED=true`.
+A partir de la versión 1.18.3, si la [Configuración remota del Agent][3] está activada donde se ejecuta el servicio, puedes configurar `DD_TRACE_HEADER_TAGS` en la interfaz de usuario de [Software Catalog][4] UI.
`dd.trace.request_header.tags`
: **Variable de entorno**: `DD_TRACE_REQUEST_HEADER_TAGS`
-**Por defecto**: `null`
+**Predeterminada**: `null`
**Ejemplo**: `CASE-insensitive-Header:my-tag-name,User-ID:userId,My-Header-And-Tag-Name`
-Acepta un mapa de claves de cabeceras que no distinguen entre mayúsculas/minúsculas para nombres de etiquetas y aplica automáticamente valores de cabeceras coincidentes como etiquetas en las trazas. También acepta entradas sin un nombre de etiqueta especificado, que se asignan automáticamente a etiquetas con el formato `http.request.headers.`.
+Acepta un mapa de claves de encabezados que no distinguen entre mayúsculas/minúsculas para nombres de tags (etiquetas) y aplica automáticamente valores de encabezados coincidentes como tags (etiquetas) en las traces (trazas). También acepta entradas sin un nombre de tag (etiqueta) especificado, que se asignan automáticamente a tags (etiquetas) con el formato `http.request.headers.`.
Disponible a partir de la versión 0.96.0.
`dd.trace.response_header.tags`
@@ -146,8 +141,10 @@ Una lista de anotaciones de métodos para tratar como `@Trace`.
`dd.trace.methods`
: **Variable de entorno**: `DD_TRACE_METHODS`
-**Por defecto**: `null`
-**Ejemplo**: `package.ClassName[method1,method2,...];AnonymousClass$1[call];package.ClassName[*]`
Lista de clases/interfaces y métodos para rastrear. Es similar a añadir `@Trace`, pero sin cambiar de código. **Nota:** La compatibilidad de los métodos de comodín (`[*]`) no se adapta a constructores, getters, setters, Synthetic, toString, equivalentes, código hash o llamadas a métodos finalizadores.
+**Predeterminada**: `null`
+**Ejemplo**: `package.ClassName[method1,method2,...];AnonymousClass$1[call];package.ClassName[*]`
+Lista de clase/interfaz y métodos para rastrear. Similar a añadir `@Trace`, pero sin cambiar el código. **Nota:** La compatibilidad de métodos comodín (`[*]`) no acomoda constructores, getters, setters, sintéticos, toString, equals, hashcode ni llamadas a métodos finalizadores.
+`dd.trace.methods` no está diseñado para rastrear un gran número de métodos y clases. Para buscar cuellos de botella de CPU, memoria e IO, desglosados por nombre del método, nombre de la clase y número de línea, considera en su lugar el producto [Continuous Profiler][22].
`dd.trace.classes.exclude`
: **Variable de entorno**: `DD_TRACE_CLASSES_EXCLUDE`
@@ -166,26 +163,6 @@ Define un número de tramos parciales para la descarga. Es útil para reducir so
**Ejemplo**: `aws.service`
Se utiliza para renombrar el nombre de servicio asociado a tramos, para que se identifique con la etiqueta del tramo correspondiente.
-`dd.trace.db.client.split-by-instance`
-: **Variable de entorno**: `DD_TRACE_DB_CLIENT_SPLIT_BY_INSTANCE`
-**Por defecto**: `false`
-Cuando se configura como `true`, a los tramos de bases de datos se les asigna el nombre de la instancia como nombre de servicio.
-
-`dd.trace.db.client.split-by-host`
-: **Variable de entorno**: `DD_TRACE_DB_CLIENT_SPLIT_BY_HOST`
-**Por defecto**: `false`
-Cuando se configura como `true`, a los tramos de bases de datos se les asigna el nombre del host de la base de datos remota como nombre de servicio.
-
-`dd.trace.elasticsearch.body.enabled`
-: **Variable de entorno**: `DD_TRACE_ELASTICSEARCH_BODY_ENABLED`
-**Por defecto**: `false`
-Cuando se configura como `true`, el cuerpo se añade a tramos de Elasticsearch y OpenSearch.
-
-`dd.trace.elasticsearch.params.enabled`
-: **Variable de entorno**: `DD_TRACE_ELASTICSEARCH_PARAMS_ENABLED`
-**Por defecto**: `true`
-Cuando se configura como `true`, los parámetros de cadenas de consulta se añaden a tramos de Elasticsearch y OpenSearch.
-
`dd.trace.health.metrics.enabled`
: **Variable de entorno**: `DD_TRACE_HEALTH_METRICS_ENABLED`
**Por defecto: `true`
@@ -201,35 +178,254 @@ Host de Statsd al que enviar métricas de estado.
**Por defecto**: Igual que `dd.jmxfetch.statsd.port`
Puerto de Statsd al que enviar métricas de estado.
-`dd.http.client.tag.query-string`
-: **Variable de entorno**: `DD_HTTP_CLIENT_TAG_QUERY_STRING`
+`dd.trace.obfuscation.query.string.regexp`
+: **Variable de entorno**: `DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP`
+**Por defecto**: `null`
+Una expresión regular (regex) para ocultar datos sensibles de la cadena de consulta de solicitudes entrantes informadas en la etiqueta `http.url` (las coincidencias se sustituyen por ).
+
+`dd.trace.servlet.async-timeout.error`
+: **Variable de entorno**: `DD_TRACE_SERVLET_ASYNC_TIMEOUT_ERROR`
+**Por defecto**: `true`
+Por defecto, las solicitudes asíncronas de ejecución prolongada se marcan como errores. Definir este valor como falso permite marcar todos los tiempos de inactividad como solicitudes exitosas.
+
+`dd.trace.span.tags`
+: **Variable de entorno**: `DD_TRACE_SPAN_TAGS`
+**Predeterminada**: `none`
+**Ejemplo**: `tag1:value1,tag2:value2`
+Una lista de las tags (etiquetas) predeterminadas que se añadirán a cada span (tramo).
+
+`dd.trace.jmx.tags`
+: **Variable de entorno**: `DD_TRACE_JMX_TAGS`
+**Predeterminada**: `none`
+**Ejemplo**: `tag1:value1,tag2:value2`
+Una lista de las tags (etiquetas) de span (tramo) que se añadirán a cada métrica jmx.
+
+`dd.trace.startup.logs`
+: **Variable de entorno**: `DD_TRACE_STARTUP_LOGS`
+**Por defecto**: `true`
+Cuando es `false`, se deshabilita el registro informativo de inicio. Disponible para las versiones 0.64 o posteriores.
+
+
+`dd.trace.debug`
+: **Variable de entorno**: `DD_TRACE_DEBUG`
+**Predeterminada**: `false`
+Cuando `true`, el modo de depuración para el Java de Datadog está activado.
+
+`datadog.slf4j.simpleLogger.jsonEnabled`
+: **Variable de entorno**: No disponible
+**Predeterminada**: `false`
+Cuando `true`, los logs del rastreador de Java de Datadog se escriben en JSON. Disponible para las versiones 1.48.0+.
+**Nota**: Esta configuración es específica del registrador simple SLF4J insertado y no admite variables de entorno. `dd.log.format.json` es la opción de configuración preferida.
+
+`dd.trace.servlet.principal.enabled`
+: **Variable de entorno**: `DD_TRACE_SERVLET_PRINCIPAL_ENABLED`
**Por defecto**: `false`
-Cuando se configura como `true`, los parámetros y el fragmento de la cadena de consulta se añaden a tramos de clientes web.
+Cuando es `true`, se recopila el usuario principal. Disponible para las versiones 0.61 o posteriores.
-`dd.http.client.error.statuses`
-: **Variable de entorno**: `DD_HTTP_CLIENT_ERROR_STATUSES`
-**Por defecto**: `400-499`
-Se puede aceptar un rango de errores. Por defecto, los errores 4xx se informan como errores de clientes http. Esta configuración lo anula. Ej. `dd.http.client.error.statuses=400-403,405,410-499`.
-`dd.http.server.error.statuses`
-: **Variable de entorno**: `DD_HTTP_SERVER_ERROR_STATUSES`
-**Por defecto**: `500-599`
-Se puede aceptar un rango de errores. Por defecto, los códigos de estado 5xx se informan como errores de servidores http. Esta configuración lo anula. Ej. `dd.http.server.error.statuses=500,502-599`.
+`dd.trace.rate.limit`
+: **Variable de entorno**: `DD_TRACE_RATE_LIMIT`
+**Por defecto**: `100`
+Número máximo de tramos para muestrear por segundo, por cada proceso, cuando se configuran`DD_TRACE_SAMPLING_RULES` o `DD_TRACE_SAMPLE_RATE`. De lo contrario, el Datadog Agent controla la limitación de la frecuencia.
`dd.http.server.tag.query-string`
-: **Variable de entorno**: `DD_HTTP_CLIENT_TAG_QUERY_STRING`
+: **Variable de entorno**: `DD_HTTP_SERVER_TAG_QUERY_STRING`
**Por defecto**: `true`
Cuando se configura como `true`, los parámetros y el fragmento de la cadena de consulta se añaden a tramos de servidores web.
`dd.http.server.route-based-naming`
: **Variable de entorno**: `DD_HTTP_SERVER_ROUTE_BASED_NAMING`
**Por defecto**: `true`
-Cuando se configura como `false`, las rutas de marcos http no se utilizan para los nombres de recursos. Si se cambia, esto puede cambiar los nombres de recursos y las métricas derivadas.
+Cuando se configura como `false`, las rutas de frameworks http no se utilizan para los nombres de recursos. Si se cambia, esto puede cambiar los nombres de recursos y las métricas derivadas.
+
+`dd.trace.http.server.path-resource-name-mapping`
+: **Variable de entorno**: `DD_TRACE_HTTP_SERVER_PATH_RESOURCE_NAME_MAPPING`
+**Predeterminado**: `{}` (vacío)
+Asigna rutas de solicitudes HTTP a nombres de recursos personalizados. Proporciona una lista separada por comas de pares `pattern:resource_name`:
+ – `pattern`: Un [patrón de ruta de Ant‐style][20] que debe coincidir con el valor de la tag (etiqueta) de span (tramo) `http.path_group`.
+ – `resource_name`: El nombre del recurso personalizado que se asignará si el patrón coincide.
+Si se utiliza `*` como el `resource_name` para un patrón coincidente, la ruta original, no normalizada, combinada con el método HTTP, se utilizará como el nombre del recurso. Por ejemplo, dada la regla `/test/**:*`, una solicitud `GET` para `/test/some/path` da lugar al nombre del recurso `GET /test/some/path`.
+Las asignaciones se evalúan por orden de prioridad y se aplica la primera regla coincidente. Las rutas de solicitudes no coincidentes utilizan el comportamiento de normalización predeterminado.
+**Ejemplo**: La utilización de `-Ddd.trace.http.server.path-resource-name-mapping=/admin/*.jsp:/admin-page,/admin/user/**:/admin/user` da:
+Ruta de la solicitud | Ruta del recurso
+------------ | -------------
+`/admin/index.jsp` | `/admin-page`
+`/admin/user/12345/delete` | `/admin/user`
+`/user/12345` | `/user/?`
+
+`dd.trace.http.client.path-resource-name-mapping`
+: **Variable de entorno**: `DD_TRACE_HTTP_CLIENT_PATH_RESOURCE_NAME_MAPPING`
+**Predeterminado**: `{}` (vacío)
+Asigna rutas de solicitudes del cliente HTTP a nombres de recursos personalizados. Utiliza el mismo formato que `dd.trace.http.server.path-resource-name-mapping`, pero se aplica a spans (tramos) de cliente HTTP de spans (tramos) del servidor.
+
+`dd.trace.status404rule.enabled`
+: **Variable de entorno**: `DD_TRACE_STATUS404RULE_ENABLED`
+**Predeterminado**: `true`
+En forma predeterminada, las respuestas HTTP 404 utilizan "404" como el nombre del recurso del span (tramo). Cuando es `false`, las respuestas HTTP 404 mantienen la ruta URL original como el nombre del recurso.
-`dd.trace.enabled`
-: **Variable de entorno**: `DD_TRACE_ENABLED`
+`dd.trace.128.bit.traceid.generation.enabled`
+: **Variable de entorno**: `DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED`
+**Por defecto**: `true`
+Cuando es `true`, el rastreador genera los ID de rastreo de 128 bits y codifica los ID de rastreo como 32 caracteres hexadecimales en minúsculas con cero relleno.
+
+`dd.trace.128.bit.traceid.logging.enabled`
+: **Variable de entorno**: `DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED`
+**Por defecto**: `false`
+Cuando es `true`, el rastreador inyecta los ID de rastreo de 128 bits como 32 caracteres hexadecimales en minúsculas con cero relleno y los ID de rastreo de 64 bits como números decimales. De lo contrario, el rastreador siempre inyecta los ID de rastreo como números decimales.
+
+`dd.trace.otel.enabled`
+: **Variable de entorno**: `DD_TRACE_OTEL_ENABLED`
+**Por defecto**: `false`
+Cuando es `true`, el rastreo basado en OpenTelemetry para instrumentaciones [personalizadas][16] está habilitado.
+
+`dd.trace.cloud.payload.tagging.services`
+: **Variable de entorno**: `DD_TRACE_CLOUD_PAYLOAD_TAGGING_SERVICES`
+**Predeterminado**: `ApiGateway,ApiGatewayV2,EventBridge,Sqs,Sns,S3,Kinesis`
+**Ejemplo**: `S3,Sso`
+Para activar el [etiquetado de la carga útil de AWS][18] para servicios adicionales, utiliza esta configuración.
+
+`dd.trace.cloud.request.payload.tagging`
+: **Variable de entorno**: `DD_TRACE_CLOUD_REQUEST_PAYLOAD_TAGGING`
+**Predeterminado**: N/A (desactivado)
+**Ejemplo**: `$.Metadata.UserId,$.phoneNumber`
+Una cadena separada por comas de entradas de JSONPath que se eliminarán de las solicitudes del kit de desarrollo de software (SDK) de AWS. Al configurarla, se activa el [etiquetado de la carga útil de AWS][18] para las solicitudes.
+
+`dd.trace.cloud.response.payload.tagging`
+: **Variable de entorno**: `DD_TRACE_CLOUD_RESPONSE_PAYLOAD_TAGGING`
+**Predeterminada**: N/A (desactivada)
+**Ejemplo**: `$.Metadata.Credentials.*`
+Una cadena separada por comas de las entradas JSONPath que se eliminarán de las respuestas del kit de desarrollo de software (SDK) de AWS. Esta configuración activa el [etiquetado de la carga útil de AWS][18] para las respuestas.
+
+`dd.trace.cloud.payload.tagging.max-depth`
+: **Variable de entorno**: `DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_DEPTH`
+**Predeterminada**: `10`
+Un número entero que representa la profundidad máxima de una carga útil de la solicitud/respuesta del kit de desarrollo de software (SDK) de AWS que se utilizará para el [etiquetado de la carga útil de AWS][18].
+
+`dd.trace.cloud.payload.tagging.max-tags`
+: **Variable de entorno**: `DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_TAGS`
+**Predeterminado**: `758`
+Un número entero que representa el número máximo de tags (etiquetas) que se extraerán por cada span (tramo) que se utilizará para el [etiquetado de la carga útil de AWS][18].
+
+### Agent
+
+`dd.tags`
+: **Variable de entorno**: `DD_TAGS`
+**Por defecto**: `null`
+**Ejemplo**: `layer:api,team:intake,key:value`
+Una lista de etiquetas (tags) predeterminadas que se añadirá a cada tramo (span), perfil y métrica JMX. Si se utiliza DD_ENV o DD_VERSION, se anula cualquier etiqueta de entorno o versión definida en DD_TAGS. Disponible para las versiones 0.50.0 o posteriores.
+
+`dd.agent.host`
+: **Variable de entorno**: `DD_AGENT_HOST`
+**Por defecto**: `localhost`
+Nombre de host al que enviar trazas. Si utilizas un entorno contenedorizado, configúralo como IP del host. Para obtener más detalles, consulta [Rastreo de aplicaciones Docker][5].
+
+`dd.instrumentation.telemetry.enabled`
+: **Variable de entorno**: `DD_INSTRUMENTATION_TELEMETRY_ENABLED`
**Por defecto**: `true`
-Cuando es `false`, el Agent de rastreo está deshabilitado.
+Cuando es `true`, el rastreador recopila [datos de telemetría][8]. Disponible para las versiones 0.104 o posteriores. Por defecto es `true` para las versiones 0.115 o posteriores.
+
+### Bases de datos
+
+`dd.trace.db.client.split-by-instance`
+: **Variable de entorno**: `DD_TRACE_DB_CLIENT_SPLIT_BY_INSTANCE`
+**Por defecto**: `false`
+Cuando se configura como `true`, a los tramos de bases de datos se les asigna el nombre de la instancia como nombre de servicio.
+
+`dd.trace.db.client.split-by-host`
+: **Variable de entorno**: `DD_TRACE_DB_CLIENT_SPLIT_BY_HOST`
+**Por defecto**: `false`
+Cuando se configura como `true`, a los tramos de bases de datos se les asigna el nombre del host de la base de datos remota como nombre de servicio.
+
+`dd.dbm.propagation.mode`
+: **Variable de entorno**: `DD_DBM_PROPAGATION_MODE`
+**Predeterminada**: `null`
+Cuando se establece en `service` o `full`, activa la correlación de Database Monitoring y APM. Para obtener más información, consulta [Correlacionar Database Monitoring y traces (trazas][23].
+
+### AAP
+
+`dd.appsec.enabled`
+: **Variable de entorno**: `DD_APPSEC_ENABLED`
+**Predeterminada**: `false`
+Cuando es `true`, activa App and API Protection Monitoring de Datadog. Además, esto activa automáticamente la recopilación de IP del cliente (`dd.trace.client-ip.enabled`).
+Para obtener más información, consulta [Activar AAP para Java][19].
+
+### Errores
+
+`dd.trace.http.client.tag.query-string`
+: **Propiedad del sistema (obsoleta)**: `dd.http.client.tag.query-string`
+**Variable de entorno**: `DD_TRACE_HTTP_CLIENT_TAG_QUERY_STRING`
+**Variable de entorno (obsoleta)**: `DD_HTTP_CLIENT_TAG_QUERY_STRING`
+**Predeterminada**: `true`
+En forma predeterminada, los parámetros y fragmentos de cadenas de consulta se añaden a la tag (etiqueta) `http.url` en los spans (tramos) de clientes web. Configúralo en `false` para impedir la recopilación de estos datos.
+
+`dd.trace.http.client.error.statuses`
+: **Variable de entorno**: `DD_TRACE_HTTP_CLIENT_ERROR_STATUSES`
+**Predeterminada**: `400-499`
+Se puede aceptar un rango de errores. En forma predeterminada, 4xx errores se informan como errores para clientes HTTP. Esta configuración lo sustituye. Por ejemplo, `dd.trace.http.client.error.statuses=400-403,405,410-499`
+
+`dd.trace.http.server.error.statuses`
+: **Variable de entorno**: `DD_TRACE_HTTP_SERVER_ERROR_STATUSES`
+**Predeterminado**: `500-599`
+Se puede aceptar un rango de errores. En forma predeterminada 5xx códigos de estado se informan como errores para servidores HTTP. Esta configuración lo sustituye. Por ejemplo, `dd.trace.http.server.error.statuses=500,502-599`
+
+`dd.grpc.client.error.statuses`
+: **Variable de entorno**: `DD_GRPC_CLIENT_ERROR_STATUSES`
+**Predeterminado**: `1-16`
+Se puede aceptar un rango de errores. En forma predeterminada, los códigos de estado gRPC 1 a 16 se informan como errores para los clientes gRPC. Esta configuración lo sustituye. Por ejemplo, `dd.grpc.client.error.statuses=1-4,7-10`
+
+`dd.grpc.server.error.statuses`
+: **Variable de entorno**: `DD_GRPC_SERVER_ERROR_STATUSES`
+**Predeterminado**: `2-16`
+Se puede aceptar un rango de errores. En forma predeterminada, los códigos de estado gRPC 2 a 16 se informan como errores para los servidores gRPC. Esta configuración lo sustituye. Por ejemplo, `dd.grpc.server.error.statuses=2-4,7-10`
+
+### Logs
+
+`dd.log.level`
+: **Variable de entorno**: `DD_LOG_LEVEL`
+**Predeterminado**: `INFO`
+Establece el nivel interno de log para Datadog Java Tracer. Valores válidos: `DEBUG`, `INFO`, `WARN`, `ERROR`.
+Disponible a partir de la versión 1.36.0
+
+`dd.log.format.json`
+: **Variable de entorno**: `DD_LOG_FORMAT_JSON`
+**Predeterminado**: `false`
+Cuando es `true`, genera logs de Datadog Java Tracer en un formato JSON compatible con la interfaz de usuario de logs de Datadog.
+Disponible a partir de la versión 1.58.0
+
+`dd.logs.injection`
+: **Variable de entorno**: `DD_LOGS_INJECTION`
+**Predeterminado**: `true`
+Activada la inserción automática de claves MDC para ID de traces (trazas) y spans (tramos) de Datadog. Consulta [Utilización avanzada][2] para obtener más información.
+A partir de la versión 1.18.3, si la [Configuración remota del Agent][3] está activada donde se ejecuta este servicio, puedes configurar `DD_LOGS_INJECTION` en la interfaz de usuario de [Software Catalog][4].
+
+### Propagación del contexto de rastreo
+
+Para obtener información sobre los valores válidos y el uso de las siguientes opciones de configuración, consulta [Propagación del contexto de rastreo Java][15].
+
+`dd.trace.propagation.style.inject`
+: **Variable de entorno**: `DD_TRACE_PROPAGATION_STYLE_INJECT`
+**Por defecto**: `datadog,tracecontext`
+Una lista separada por comas de formatos de cabeceras para incluir, para propagar trazas distribuidas entre servicios.
+Disponible a partir de la versión 1.9.0
+
+`dd.trace.propagation.style.extract`
+: **Variable de entorno**: `DD_TRACE_PROPAGATION_STYLE_EXTRACT`
+**Por defecto**: `datadog,tracecontext`
+Una lista separada por comas de formatos de cabeceras de los que se intentará extraer datos de propagación del rastreo distribuido. El primer formato encontrado con cabeceras completas y válidas se utiliza para definir la traza y continuar.
+Disponible a partir de la versión 1.9.0
+
+`dd.trace.propagation.style`
+: **Variable de entorno**: `DD_TRACE_PROPAGATION_STYLE`
+**Por defecto**: `datadog,tracecontext`
+Una lista separada por comas de formatos de cabeceras en los que se intentará inyectar y extraer datos de propagación del rastreo distribuido. El primer formato encontrado con cabeceras completas y válidas se utiliza para definir la traza y continuar. Los parámetros de configuración más específicos `dd.trace.propagation.style.inject` y `dd.trace.propagation.style.extract` tienen prioridad cuando están presentes.
+Disponible a partir de la versión 1.9.0
+
+`trace.propagation.extract.first`
+: **Variable de entorno**: `DD_TRACE_PROPAGATION_EXTRACT_FIRST`
+**Por defecto**: `false`
+Cuando se configura como `true`, deja de extraer contextos de rastreo cuando encuentra uno válido.
+
+### Métricas de JMX
`dd.jmxfetch.enabled`
: **Variable de entorno**: `DD_JMXFETCH_ENABLED`
@@ -250,8 +446,8 @@ Directorio de configuración adicional para la recopilación de métricas JMX. E
`dd.jmxfetch.check-period`
: **Variable de entorno**: `DD_JMXFETCH_CHECK_PERIOD`
-**Por defecto**: `1500`
-Frecuencia de envío de métricas JMX (en milisegundos).
+**Predeterminado**: `15000`
+Frecuencia de envío de métricas de JMX (en ms).
`dd.jmxfetch.refresh-beans-period`
: **Variable de entorno**: `DD_JMXFETCH_REFRESH_BEANS_PERIOD`
@@ -275,10 +471,9 @@ Puerto de StatsD al que enviar métricas JMX. Si utilizas sockets de dominio Uni
**Por defecto**: `false`
I
Integración JMX para habilitar (por ejemplo, Kafka o ActiveMQ).
-`dd.trace.obfuscation.query.string.regexp`
-: **Variable de entorno**: `DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP`
-**Por defecto**: `null`
-Una expresión regular (regex) para ocultar datos sensibles de la cadena de consulta de solicitudes entrantes informadas en la etiqueta `http.url` (las coincidencias se sustituyen por ).
+### integraciones
+
+Consulta cómo deshabilitar integraciones en la sección de compatibilidad de las [integraciones][13].
`dd.integration.opentracing.enabled`
: **Variable de entorno**: `DD_INTEGRATION_OPENTRACING_ENABLED`
@@ -290,43 +485,41 @@ Por defecto, el cliente de rastreo detecta si se está cargando un GlobalTracer
**Por defecto**: `false`
Por defecto, el grupo Hystrix, el comando y las etiquetas de estado del circuito no están habilitados. Esta propiedad los habilita.
-`dd.trace.servlet.async-timeout.error`
-: **Variable de entorno**: `DD_TRACE_SERVLET_ASYNC_TIMEOUT_ERROR`
-**Por defecto**: `true`
-Por defecto, las solicitudes asíncronas de ejecución prolongada se marcan como errores. Definir este valor como falso permite marcar todos los tiempos de inactividad como solicitudes exitosas.
+`dd.trace.elasticsearch.body.enabled`
+: **Variable de entorno**: `DD_TRACE_ELASTICSEARCH_BODY_ENABLED`
+**Por defecto**: `false`
+Cuando se configura como `true`, el cuerpo se añade a tramos de Elasticsearch y OpenSearch.
-`dd.trace.startup.logs`
-: **Variable de entorno**: `DD_TRACE_STARTUP_LOGS`
+`dd.trace.elasticsearch.params.enabled`
+: **Variable de entorno**: `DD_TRACE_ELASTICSEARCH_PARAMS_ENABLED`
**Por defecto**: `true`
-Cuando es `false`, se deshabilita el registro informativo de inicio. Disponible para las versiones 0.64 o posteriores.
-
-
-`dd.trace.servlet.principal.enabled`
-: **Variable de entorno**: `DD_TRACE_SERVLET_PRINCIPAL_ENABLED`
-**Por defecto**: `false`
-Cuando es `true`, se recopila el usuario principal. Disponible para las versiones 0.61 o posteriores.
+Cuando se configura como `true`, los parámetros de cadenas de consulta se añaden a tramos de Elasticsearch y OpenSearch.
+`dd.trace.cassandra.keyspace.statement.extraction.enabled`
+: **Variable de entorno**: `DD_TRACE_CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION_ENABLED`
+**Predeterminado**: `false`
+En forma predeterminada, el espacio de claves se extrae solo si se configura durante la creación de la sesión. Cuando se configura en `true`, el espacio de claves también se puede extraer examinando los metadatos en los resultados de la consulta.
-`dd.instrumentation.telemetry.enabled`
-: **Variable de entorno**: `DD_INSTRUMENTATION_TELEMETRY_ENABLED`
-**Por defecto**: `true`
-Cuando es `true`, el rastreador recopila [datos de telemetría][8]. Disponible para las versiones 0.104 o posteriores. Por defecto es `true` para las versiones 0.115 o posteriores.
+`dd.trace.websocket.messages.enabled`
+: **Variable de entorno**: `DD_TRACE_WEBSOCKET_MESSAGES_ENABLED`
+**Predeterminado**: `false`
+Activa el rastreo de mensajes de websocket enviados y recibidos (de texto y binarios) y eventos de cierre de connection (conexión).
-`dd.trace.128.bit.traceid.generation.enabled`
-: **Variable de entorno**: `DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED`
-**Por defecto**: `true`
-Cuando es `true`, el rastreador genera los ID de rastreo de 128 bits y codifica los ID de rastreo como 32 caracteres hexadecimales en minúsculas con cero relleno.
+`dd.trace.websocket.messages.inherit.sampling`
+: **Variable de entorno**: `DD_TRACE_WEBSOCKET_MESSAGES_INHERIT_SAMPLING`
+**Predeterminado**: `true`
+En forma predeterminada, los mensajes de websocket conservan el mismo muestreo que el span (tramo) capturado durante el protocolo de enlace. Esto asegura que, si se ha muestreado un span (tramo) de protocolo de enlace, también se muestrearán todos los mensajes de la sesión. Para desactivar ese comportamiento y muestrear cada mensaje de websocket de forma independiente, establece esta configuración en `false`.
-`dd.trace.128.bit.traceid.logging.enabled`
-: **Variable de entorno**: `DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED`
-**Por defecto**: `false`
-Cuando es `true`, el rastreador inyecta los ID de rastreo de 128 bits como 32 caracteres hexadecimales en minúsculas con cero relleno y los ID de rastreo de 64 bits como números decimales. De lo contrario, el rastreador siempre inyecta los ID de rastreo como números decimales.
+`dd.trace.websocket.messages.separate.traces`
+: **Variable de entorno**: `DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES`
+**Predeterminado**: `true`
+En forma predeterminada, cada mensaje recibido genera una nueva trace (traza). El protocolo de enlace se vincula a ella como un enlace de span (tramo). La configuración de este parámetro en `false` hace que todos los spans (tramos) capturados durante la sesión estén en la misma trace (traza).
+`dd.trace.websocket.tag.session.id`
+: **Variable de entorno**: `DD_TRACE_WEBSOCKET_TAG_SESSION_ID`
+**Predeterminado**: `false`
+Cuando se configura en `true`, los spans (tramos) de websocket tienen la tag (etiqueta) `websocket.session.id` que contiene el ID de sesión cuando está disponible.
-`dd.trace.otel.enabled`
-: **Variable de entorno**: `DD_TRACE_OTEL_ENABLED`
-**Por defecto**: `false`
-Cuando es `true`, el rastreo basado en OpenTelemetry para instrumentaciones [personalizadas][16] está habilitado.
**Nota**:
@@ -337,15 +530,18 @@ Cuando es `true`, el rastreo basado en OpenTelemetry para instrumentaciones [per
- Si estás ejecutando el Agent como contenedor, asegúrate de que `DD_DOGSTATSD_NON_LOCAL_TRAFFIC` [está configurado como `true`][10] y que el puerto `8125` está abierto en el contenedor Agent.
- En Kubernetes, [vincula el puerto de DogStatsD con un puerto de host][11]. En ECS, [configura las marcas apropiadas en la definición de tu tarea][12].
-### Integraciones
+### UDS
-Consulta cómo deshabilitar integraciones en la sección de compatibilidad de las [integraciones][13].
+`dd.jdk.socket.enabled`
+: **Variable de entorno**: `DD_JDK_SOCKET_ENABLED`
+**Predeterminado**: `true`
+Activa la compatibilidad nativa de JDK para sockets de dominio de Unix.
### Ejemplos
#### `dd.service.mapping`
-**Ejemplo con propiedad del sistema**:
+Ejemplo con la propiedad del sistema:
```shell
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.service.mapping=postgresql:web-app-pg -jar path/to/application.jar
@@ -354,18 +550,17 @@ java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.service.map
{{< img src="tracing/setup/java/service_mapping.png" alt="Asignación de servicios" >}}
#### `dd.tags`
-
-**Configuración de un entorno global para tramos y métricas JMX**:
+Configuración de una variable de entorno global para spans (tramos) y métricas de JMX:
```shell
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -jar path/to/application.jar
```
-{{< img src="tracing/setup/java/trace_global_tags.png" alt="Etiquetas globales de trazas" >}}
+{{< img src="tracing/setup/java/trace_global_tags.png" alt="Tags (etiquetas) globales de traces (trazas)" >}}
#### `dd.trace.span.tags`
-**Ejemplo con la adición de project:test a cada tramo**:
+Ejemplo con la adición de project:test a cada span (tramo):
```shell
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -jar path/to/application.jar
@@ -375,7 +570,7 @@ java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Dd
#### `dd.trace.jmx.tags`
-**Configuración de custom.type:2 en una métrica JMX**:
+Configuración de custom.type:2 en una métrica de JMX:
```shell
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -Ddd.trace.jmx.tags=custom.type:2 -jar path/to/application.jar
@@ -385,7 +580,7 @@ java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Dd
#### `dd.trace.methods`
-**Ejemplo con propiedad del sistema**:
+Ejemplo con la propiedad del sistema:
```shell
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.methods="hello.GreetingController[doSomeStuff,doSomeOtherStuff];hello.Randomizer[randomize]" -jar path/to/application.jar
@@ -423,19 +618,19 @@ java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Dd
#### `dd.trace.enabled`
-**Ejemplo con la propiedad del sistema y el modo de la aplicación de depuración**:
+Ejemplo con propiedad del sistema y modo de depuración de aplicación:
```shell
-java -javaagent:/path/to/dd-java-agent.jar -Ddd.trace.enabled=false -Ddatadog.slf4j.simpleLogger.defaultLogLevel=debug -jar path/to/application.jar
+java -javaagent:/path/to/dd-java-agent.jar -Ddd.trace.enabled=false -Ddd.trace.debug=true -jar path/to/application.jar
```
-Los logs de la aplicación de depuración muestran que `el rastreo está deshabilitado y no está instalando instrumentaciones.`
+Los logs de la aplicación de la aplicación muestran que `Tracing is disabled, not installing instrumentations.`
#### `dd.jmxfetch.config.dir` y `dd.jmxfetch.config`
Ejemplo de configuración:
-- Ya sea, la combinación de: `DD_JMXFETCH_CONFIG_DIR=` + `DD_JMXFETCH_CONFIG=conf.yaml`
+- Ya sea la combinación de: `DD_JMXFETCH_CONFIG_DIR=` + `DD_JMXFETCH_CONFIG=conf.yaml`
- O directamente: `DD_JMXFETCH_CONFIG=/conf.yaml`
Con el siguiente contenido para `conf.yaml`:
@@ -460,32 +655,6 @@ Se produciría el siguiente resultado:
{{< img src="tracing/setup/java/jmxfetch_example.png" alt="Ejemplo de búsqueda JMX" >}}
Para obtener más información sobre la recopilación de métricas Java con la búsqueda JMX, consulta la [documentación de la integración Java][14].
-### Extracción e inyección de cabeceras
-
-Para obtener información sobre los valores válidos y el uso de las siguientes opciones de configuración, consulta [Propagación del contexto de rastreo Java][15].
-
-`dd.trace.propagation.style.inject`
-: **Variable de entorno**: `DD_TRACE_PROPAGATION_STYLE_INJECT`
-**Por defecto**: `datadog,tracecontext`
-Una lista separada por comas de formatos de cabeceras para incluir, para propagar trazas distribuidas entre servicios.
-Disponible a partir de la versión 1.9.0
-
-`dd.trace.propagation.style.extract`
-: **Variable de entorno**: `DD_TRACE_PROPAGATION_STYLE_EXTRACT`
-**Por defecto**: `datadog,tracecontext`
-Una lista separada por comas de formatos de cabeceras de los que se intentará extraer datos de propagación del rastreo distribuido. El primer formato encontrado con cabeceras completas y válidas se utiliza para definir la traza y continuar.
-Disponible a partir de la versión 1.9.0
-
-`dd.trace.propagation.style`
-: **Variable de entorno**: `DD_TRACE_PROPAGATION_STYLE`
-**Por defecto**: `datadog,tracecontext`
-Una lista separada por comas de formatos de cabeceras en los que se intentará inyectar y extraer datos de propagación del rastreo distribuido. El primer formato encontrado con cabeceras completas y válidas se utiliza para definir la traza y continuar. Los parámetros de configuración más específicos `dd.trace.propagation.style.inject` y `dd.trace.propagation.style.extract` tienen prioridad cuando están presentes.
-Disponible a partir de la versión 1.9.0
-
-`trace.propagation.extract.first`
-: **Variable de entorno**: `DD_TRACE_PROPAGATION_EXTRACT_FIRST`
-**Por defecto**: `false`
-Cuando se configura como `true`, deja de extraer contextos de rastreo cuando encuentra uno válido.
#### Parámetros de extracción e inyección obsoletos
@@ -503,24 +672,30 @@ Obsoleto a partir de la versión 1.9.0
Una lista separada por comas de formatos de cabecera de los que se intentará extraer datos de propagación del rastreo distribuido. El primer formato encontrado con cabeceras completas y válidas se utiliza para definir la traza y continuar.
Disponible a partir de la versión 1.9.0
-## Leer más
+## Referencias adicionales
{{< partial name="whats-next/whats-next.html" >}}
[1]: /es/getting_started/tagging/unified_service_tagging/
[2]: /es/agent/logs/advanced_log_collection
-[3]: /es/agent/remote_config/
+[3]: /es/tracing/guide/remote_config
[4]: https://app.datadoghq.com/services
[5]: /es/tracing/setup/docker/
[6]: /es/agent/configuration/network/#configure-ports
[7]: https://github.com/DataDog/dd-trace-java/blob/master/dd-java-agent/instrumentation/trace-annotation/src/main/java/datadog/trace/instrumentation/trace_annotation/TraceAnnotationsInstrumentation.java#L37
[8]: /es/tracing/configure_data_security/#telemetry-collection
-[9]: /es/developers/dogstatsd/#setup
+[9]: /es/extend/dogstatsd/#setup
[10]: /es/agent/docker/#dogstatsd-custom-metrics
-[11]: /es/developers/dogstatsd/
+[11]: /es/extend/dogstatsd/
[12]: /es/agent/amazon_ecs/#create-an-ecs-task
[13]: /es/tracing/compatibility_requirements/java#disabling-integrations
[14]: /es/integrations/java/?tab=host#metric-collection
-[15]: /es/tracing/trace_collection/trace_context_propagation/java/
+[15]: /es/tracing/trace_collection/trace_context_propagation/
[16]: /es/tracing/trace_collection/custom_instrumentation/java/otel/
[17]: /es/opentelemetry/interoperability/environment_variable_support
+[18]: /es/tracing/guide/aws_payload_tagging/?code-lang=java
+[19]: /es/security/application_security/setup/threat_detection/java/
+[20]: https://ant.apache.org/manual/dirtasks.html#patterns
+[21]: /es/tracing/trace_collection/library_config/#traces
+[22]: /es/profiler/
+[23]: /es/database_monitoring/connect_dbm_and_apm/?tab=java
\ No newline at end of file
diff --git a/content/ja/error_tracking/backend/capturing_handled_errors/ruby.md b/content/ja/error_tracking/backend/capturing_handled_errors/ruby.md
new file mode 100644
index 00000000000..d5667de68e5
--- /dev/null
+++ b/content/ja/error_tracking/backend/capturing_handled_errors/ruby.md
@@ -0,0 +1,54 @@
+---
+code_lang: ruby
+code_lang_weight: 10
+title: Ruby アプリケーションで処理済み例外を収集する
+type: multi-code-lang
+---
+
+## 互換性要件
+
+次の条件を満たしている必要があります:
+- Ruby `2.7+` 以降を使用していること。JRuby と TruffleRuby には対応していません。
+- Datadog Ruby gem (`datadog`) `v2.16.0+` 以降を使用していること。
+
+## はじめに
+
+始める前に、[Agent のインストールと設定][1] を済ませておいてください。また、アプリケーション自体をインスツルメンテーションできるように、[トレーシング ライブラリを追加][2] しておく必要があります。
+
+### 自動インスツルメンテーション
+
+処理済みエラーの自動報告を有効にするには、次の 2 つの環境変数のいずれかを設定します:
+
+`DD_ERROR_TRACKING_HANDLED_ERRORS`
+: ユーザー コード、サード パーティ gem、またはその両方で発生した処理済みエラーを報告します。指定できる値は `user`、`third_party`、`all` です。
+
+`DD_ERROR_TRACKING_HANDLED_ERRORS_INCLUDE`
+: 処理済みエラーを報告する対象として、カンマ区切りのパス、ファイル名、gem 名の一覧を指定します。指定できる値は、次のいずれかです:
+: - **ファイル名**: 例: `main` を指定すると、`main.rb` ファイルがインスツルメンテーション対象になります。
+: - **フォルダ名**: 例: `subdir` を指定すると、`subdir` という名前のフォルダにあるすべての Ruby ファイルがインスツルメンテーション対象になります。
+: - **gem 名**: 例: `rails` を指定すると、`rails` gem 内のすべての Ruby ファイルと、`rails` という名前のフォルダにあるすべての Ruby ファイルがインスツルメンテーション対象になります。
+: - **絶対パス** (`/` で始まるパス): 例: `/app/lib/mypackage/main.rb` を指定するとそのファイルが、`/app/lib/mypackage` を指定するとそのフォルダ内のすべての Ruby ファイルがインスツルメンテーション対象になります。
+: - **カレント ディレクトリからの相対パス** (`./` で始まるパス): 例: プログラムを `/app/` で実行している場合、`./lib/mypackage/main.rb` を指定すると `main.rb` ファイルが、`./lib/mypackage/` を指定するとそのフォルダ内のすべての Ruby ファイルがインスツルメンテーション対象になります。
+
+: Ruby `v3.3+` では、エラーを `rescue` した場所で一致判定が行われます。
+: それ以前の Ruby では、エラーが送出された場所で一致判定が行われます。
+
+環境変数の代わりに、コード内の `Datadog.configure` ブロックで次のいずれかを設定することもできます:
+
+- `c.error_tracking.handled_errors`
+: ユーザー コード、サード パーティ gem、またはその両方で発生した処理済みエラーを報告します。指定できる値は `user`、`third_party`、`all` です。
+- `c.error_tracking.handled_errors_include`
+: 処理済みエラーを報告する対象として、カンマ区切りのパス、ファイル名、gem 名の一覧を指定します。指定できる値は、前述の `DD_ERROR_TRACKING_HANDLED_ERRORS_INCLUDE` と同じです。Ruby `v3.3+` では、エラーを `rescue` した場所で一致判定が行われます。それ以前の Ruby では、エラーが送出された場所で一致判定が行われます。
+
+```Ruby
+Datadog.configure do |c|
+ # ユーザー コードで発生した処理済みエラーを報告する
+ c.error_tracking.handled_errors = 'user'
+
+ # または、処理済みエラーを報告する対象としてカンマ区切りのパス、ファイル名、gem 名を指定する
+ c.error_tracking.handled_errors_include = ['sinatra', 'subdir']
+end
+```
+
+[1]: /ja/error_tracking/backend/getting_started/#getting-started-with-backend-error-tracking
+[2]: /ja/tracing/trace_collection/automatic_instrumentation/dd_libraries/ruby
\ No newline at end of file
diff --git a/content/ja/integrations/amazon-bedrock.md b/content/ja/integrations/amazon-bedrock.md
new file mode 100644
index 00000000000..b8a579aeeae
--- /dev/null
+++ b/content/ja/integrations/amazon-bedrock.md
@@ -0,0 +1,259 @@
+---
+aliases:
+- /ja/integrations/amazon_bedrock
+app_id: amazon-bedrock
+categories:
+- aws
+- metrics
+- cloud
+- ai/ml
+custom_kind: integration
+description: Amazon Bedrock を使うと、AI の基盤モデルを API 経由で利用できます。
+further_reading:
+- link: https://www.datadoghq.com/blog/monitor-amazon-bedrock-with-datadog/
+ tag: blog
+ text: Datadog で Amazon Bedrock を監視する
+media: []
+title: Amazon Bedrock
+---
+## 概要
+
+Amazon Bedrock を使うと、チャット ボットやデータ抽出ツールなど、LLM を活用したアプリケーションを監視し、トラブルシューティングし、評価できます。
+
+LLM アプリケーションを構築している場合は、LLM Observability を使って問題の根本原因を調査し、運用パフォーマンスを監視し、LLM アプリケーションの品質、プライバシー、安全性を評価できます。
+
+トレースをどのように調査できるかの例については、[LLM Observability のトレーシング画面の動画](https://imgix.datadoghq.com/video/products/llm-observability/expedite-troubleshooting.mp4?fm=webm&fit=max) を参照してください。
+
+Amazon Bedrock は、Amazon や主要な AI スタートアップの [基盤モデル](https://aws.amazon.com/what-is/foundation-models/) (FM) を API 経由で利用できるようにするフル マネージド サービスです。さまざまな FM から、ユース ケースに最適なモデルを選べます。
+
+このインテグレーションを有効にすると、Bedrock のすべてのメトリクスを Datadog で確認できます。
+
+## セットアップ
+
+### LLM Observability: Amazon Bedrock を使って LLM アプリケーションをエンド ツー エンドで可視化する
+
+LLM Observability はさまざまな環境で有効化できます。利用シナリオに応じて、該当するセットアップ手順に従ってください:
+
+#### Python 向けインストール
+
+##### Datadog Agent がない場合:
+
+1. `ddtrace` パッケージをインストールします:
+
+```shell
+ pip install ddtrace
+```
+
+2. 次のコマンドで Agentless mode を有効にしてアプリケーションを起動します:
+
+```shell
+ DD_SITE= DD_API_KEY= DD_LLMOBS_ENABLED=1 DD_LLMOBS_AGENTLESS_ENABLED=1 DD_LLMOBS_ML_APP= ddtrace-run python .py
+```
+
+##### すでに Datadog Agent をインストールしている場合:
+
+1. Agent が起動しており、APM と StatsD が有効になっていることを確認します。たとえば、Docker では次のコマンドを使用します:
+
+```shell
+docker run -d \
+ --cgroupns host \
+ --pid host \
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
+ -v /proc/:/host/proc/:ro \
+ -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
+ -e DD_API_KEY= \
+ -p 127.0.0.1:8126:8126/tcp \
+ -p 127.0.0.1:8125:8125/udp \
+ -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
+ -e DD_APM_ENABLED=true \
+ gcr.io/datadoghq/agent:latest
+```
+
+2. まだであれば、`ddtrace` パッケージをインストールします:
+
+```shell
+ pip install ddtrace
+```
+
+3. `ddtrace-run` コマンドでアプリケーションを起動すると、トレーシングが自動的に有効になります:
+
+```shell
+ DD_SITE= DD_API_KEY= DD_LLMOBS_ENABLED=1 DD_LLMOBS_ML_APP= ddtrace-run python .py
+```
+
+**注**: Agent がカスタム ホストまたはポートで動作している場合は、`DD_AGENT_HOST` と `DD_TRACE_AGENT_PORT` を適切に設定します。
+
+##### サーバーレス環境 (AWS Lambda) で LLM Observability を実行する場合:
+
+1. AWS Lambda のセットアップの一環として、**Datadog-Python** と **Datadog-Extension** の Lambda レイヤーをインストールします。
+1. 次の環境変数を設定して LLM Observability を有効にします:
+
+```shell
+ DD_SITE= DD_API_KEY= DD_LLMOBS_ENABLED=1 DD_LLMOBS_ML_APP=
+```
+
+**注**: サーバーレス環境では、Lambda 関数の実行完了時に Datadog が span を自動的に flush します。
+
+##### Amazon Bedrock の自動トレーシング
+
+LLM Observability を設定すると、Amazon Bedrock インテグレーションは自動的に有効になります。これにより、Amazon Bedrock 呼び出しのレイテンシー、エラー、入力/出力メッセージ、トークン使用量が取得されます。
+
+同期処理とストリーミング処理の両方で、次の Amazon Bedrock 操作がトレース対象になります:
+
+- `InvokeModel()`
+- `InvokeModelWithResponseStream()`
+
+これらのメソッドでは追加設定は不要です。
+
+##### 検証
+
+LLM Observability が span を正しく取得していることは、アプリケーション ログで span の生成成功を確認することで検証できます。`ddtrace` インテグレーションの状態は、次のコマンドでも確認できます:
+
+```shell
+ddtrace-run --info
+```
+
+セットアップ確認のため、次のメッセージが表示されることを確認します:
+
+```shell
+Agent error: None
+```
+
+##### デバッグ
+
+セットアップ中に問題が発生した場合は、`--debug` フラグを付けて debug logging を有効にします:
+
+```shell
+ddtrace-run --debug
+```
+
+これにより、Amazon Bedrock のトレースに関する問題を含め、データ送信や instrumentation に関するエラーを確認できます。
+
+#### Node.js 向けインストール
+
+##### Datadog Agent がない場合:
+
+1. `dd-trace` パッケージをインストールします:
+
+ ```shell
+ npm install dd-trace
+ ```
+
+1. 次のコマンドで agentless mode を有効にしてアプリケーションを起動します:
+
+ ```shell
+ DD_SITE= DD_API_KEY= DD_LLMOBS_ENABLED=1 DD_LLMOBS_AGENTLESS_ENABLED=1 DD_LLMOBS_ML_APP= node -r 'dd-trace/init' .js
+ ```
+
+##### すでに Datadog Agent をインストールしている場合:
+
+1. Agent が起動しており、APM が有効になっていることを確認します。たとえば、Docker では次のコマンドを使用します:
+
+ ```shell
+ docker run -d \
+ --cgroupns host \
+ --pid host \
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
+ -v /proc/:/host/proc/:ro \
+ -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
+ -e DD_API_KEY= \
+ -p 127.0.0.1:8126:8126/tcp \
+ -p 127.0.0.1:8125:8125/udp \
+ -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
+ -e DD_APM_ENABLED=true \
+ gcr.io/datadoghq/agent:latest
+ ```
+
+1. Datadog APM Node.js ライブラリをインストールします。
+
+ ```shell
+ npm install dd-trace
+ ```
+
+1. `-r dd-trace/init` または `NODE_OPTIONS='--require dd-trace/init'` を使ってアプリケーションを起動すると、トレーシングが自動的に有効になります:
+
+ ```shell
+ DD_SITE= DD_API_KEY= DD_LLMOBS_ENABLED=1 DD_LLMOBS_ML_APP= node -r 'dd-trace/init' .js
+ ```
+
+**注**: Agent がカスタム ホストまたはポートで動作している場合は、`DD_AGENT_HOST` と `DD_TRACE_AGENT_PORT` を適切に設定します。
+
+##### サーバーレス環境 (AWS Lambda) で LLM Observability を実行する場合:
+
+1. 次の環境変数を設定して LLM Observability を有効にします:
+
+ ```shell
+ DD_SITE= DD_API_KEY= DD_LLMOBS_ENABLED=1 DD_LLMOBS_ML_APP=
+ ```
+
+1. Lambda の実行が終了する前に、`llmobs.flush()` を呼び出します:
+
+ ```js
+ const llmobs = require('dd-trace').llmobs;
+ // or, if dd-trace was not initialized via NODE_OPTIONS
+ const llmobs = require('dd-trace').init({
+ llmobs: {
+ mlApp: ,
+ }
+ }).llmobs; // with DD_API_KEY and DD_SITE being set at the environment level
+
+ async function handler (event, context) {
+ ...
+ llmobs.flush()
+ return ...
+ }
+ ```
+
+### APM: Python アプリケーションの使用状況メトリクスを取得する
+
+まだ設定していない場合は、先に [Amazon Web Services インテグレーション](https://docs.datadoghq.com/integrations/amazon_web_services/) を設定してください。
+
+### メトリクス収集
+
+1. [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services) の `Metric Collection` タブで、`Bedrock` が有効になっていることを確認します。
+1. [Datadog - Amazon Bedrock インテグレーション](https://app.datadoghq.com/integrations/amazon-bedrock) をインストールします。
+
+## 収集データ
+
+### メトリクス
+
+| | |
+| --- | --- |
+| **aws.bedrock.content_filtered_count**
(count) | テキスト出力コンテンツがフィルタリングされた総回数
_単位は time_ |
+| **aws.bedrock.input_token_count**
(gauge) | モデルに対して実行されたプロンプトで使用された入力トークン数の平均
_単位は token_ |
+| **aws.bedrock.input_token_count.minimum**
(gauge) | モデルに対して実行されたプロンプトで使用された入力トークン数の最小値
_単位は token_ |
+| **aws.bedrock.input_token_count.maximum**
(gauge) | モデルに対して実行されたプロンプトで使用された入力トークン数の最大値
_単位は token_ |
+| **aws.bedrock.input_token_count.sum**
(count) | モデルに対して実行されたプロンプトで使用された入力トークン総数
_単位は token_ |
+| **aws.bedrock.invocation_client_errors**
(count) | 呼び出し時に発生したクライアント エラー数
_単位は error_ |
+| **aws.bedrock.invocation_latency**
(gauge) | 呼び出しレイテンシーの平均 (ミリ秒)
_単位は millisecond_ |
+| **aws.bedrock.invocation_latency.minimum**
(gauge) | 1 分間における呼び出しレイテンシーの最小値
_単位は millisecond_ |
+| **aws.bedrock.invocation_latency.maximum**
(gauge) | 1 分間における呼び出しレイテンシーの最大値
_単位は millisecond_ |
+| **aws.bedrock.invocation_latency.p99**
(gauge) | 1 分間における呼び出しレイテンシーの 99 パーセンタイル値
_単位は millisecond_ |
+| **aws.bedrock.invocation_latency.p95**
(gauge) | 1 分間における呼び出しレイテンシーの 95 パーセンタイル値
_単位は millisecond_ |
+| **aws.bedrock.invocation_latency.p90**
(gauge) | 1 分間における呼び出しレイテンシーの 90 パーセンタイル値
_単位は millisecond_ |
+| **aws.bedrock.invocation_server_errors**
(count) | 呼び出し時に発生したサーバー エラー数
_単位は error_ |
+| **aws.bedrock.invocation_throttles**
(count) | 呼び出しのスロットリング発生回数
_単位は throttle_ |
+| **aws.bedrock.invocations**
(count) | モデル エンドポイントに送信された呼び出し回数
_単位は invocation_ |
+| **aws.bedrock.output_image_count**
(gauge) | 1 分間において、モデル呼び出しで返された出力画像数の平均
_単位は item_ |
+| **aws.bedrock.output_token_count**
(gauge) | 1 分間において、モデル呼び出しで返された出力トークン数の平均
_単位は token_ |
+| **aws.bedrock.output_token_count.minimum**
(gauge) | 1 分間において、モデル呼び出しで返された出力トークン数の最小値
_単位は token_ |
+| **aws.bedrock.output_token_count.maximum**
(gauge) | 1 分間において、モデル呼び出しで返された出力トークン数の最大値
_単位は token_ |
+| **aws.bedrock.output_token_count.sum**
(count) | すべてのモデル呼び出しで返された出力トークン総数
_単位は token_ |
+
+### イベント
+
+Amazon Bedrock インテグレーションにはイベントは含まれません。
+
+### サービス チェック
+
+Amazon Bedrock インテグレーションにはサービス チェックは含まれません。
+
+## トラブルシューティング
+
+サポートが必要な場合は、[Datadog サポート](https://docs.datadoghq.com/help/) にお問い合わせください。
+
+## 参考資料
+
+役立つドキュメント、リンク、記事:
+
+- [Datadog で Amazon Bedrock を監視する](https://www.datadoghq.com/blog/monitor-amazon-bedrock-with-datadog/)
\ No newline at end of file
diff --git a/content/ja/integrations/amazon-cloudhsm.md b/content/ja/integrations/amazon-cloudhsm.md
new file mode 100644
index 00000000000..0f73512c6d8
--- /dev/null
+++ b/content/ja/integrations/amazon-cloudhsm.md
@@ -0,0 +1,98 @@
+---
+aliases:
+- /ja/integrations/amazon_cloudhsm
+app_id: amazon-cloudhsm
+categories:
+- cloud
+- provisioning
+- aws
+- log collection
+custom_kind: integration
+description: AWS CloudHSM は、AWS Cloud で利用するためのハードウェア セキュリティ モジュールを提供するサービスです。
+media: []
+title: AWS CloudHSM
+---
+## 概要
+
+AWS CloudHSM は、AWS Cloud で利用するためのハードウェア セキュリティ モジュールを提供するサービスです。
+
+このインテグレーションを有効にすると、CloudHSM のすべてのメトリクスを Datadog で確認できます。
+
+## セットアップ
+
+### インストール
+
+まだ設定していない場合は、先に [Amazon Web Services インテグレーション](https://docs.datadoghq.com/integrations/amazon_web_services/) を設定してください。
+
+### メトリクス収集
+
+1. [AWS インテグレーション ページ](https://app.datadoghq.com/integrations/amazon-web-services) の `Metric Collection` タブで、`CloudHSM` が有効になっていることを確認します。
+1. [Datadog - AWS CloudHSM インテグレーション](https://app.datadoghq.com/integrations/amazon-cloudhsm) をインストールします。
+
+### ログ収集
+
+#### ログを有効にする
+
+AWS CloudHSM がログを S3 バケットまたは CloudWatch に送信するよう設定します。
+
+**注**: S3 バケットにログを出力する場合は、_Target prefix_ に `amazon_cloudhsm` が設定されていることを確認してください。
+
+#### ログを Datadog に送信する
+
+1. まだ設定していない場合は、[Datadog Forwarder Lambda 関数](https://docs.datadoghq.com/logs/guide/forwarder/) を設定してください。
+
+1. Lambda 関数をインストールしたら、AWS コンソールで AWS CloudHSM のログが保存されている S3 バケットまたは CloudWatch log group に、手動でトリガーを追加します:
+
+ - [S3 バケットに手動でトリガーを追加する](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-s3-buckets)
+ - [CloudWatch Log Group に手動でトリガーを追加する](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-cloudwatch-log-group)
+
+## 収集データ
+
+### メトリクス
+
+| | |
+| --- | --- |
+| **aws.cloudhsm.hsm_keys_session_occupied**
(gauge) | バッファリング済みメモリ量
_単位は key_ |
+| **aws.cloudhsm.hsm_keys_session_occupied.sum**
(count) | バッファリング済みメモリ量の合計
_単位は key_ |
+| **aws.cloudhsm.hsm_keys_token_occupied**
(gauge) | 使用中のキー数
_単位は key_ |
+| **aws.cloudhsm.hsm_keys_token_occupied.sum**
(count) | 使用中のキー数の合計
_単位は key_ |
+| **aws.cloudhsm.hsm_session_count**
(count) | オープン接続数の合計
_単位は session_ |
+| **aws.cloudhsm.hsm_session_count.average**
(gauge) | オープン接続数
_単位は session_ |
+| **aws.cloudhsm.hsm_session_count.maximum**
(gauge) | オープン接続数の最大値
_単位は session_ |
+| **aws.cloudhsm.hsm_ssl_ctxs_occupied**
(gauge) | 確立済みの暗号化チャネル数
_単位は process_ |
+| **aws.cloudhsm.hsm_ssl_ctxs_occupied.sum**
(count) | 確立済みの暗号化チャネル数の合計
_単位は process_ |
+| **aws.cloudhsm.hsm_temperature**
(gauge) | ハードウェア プロセッサのジャンクション温度
_単位は degree celsius_ |
+| **aws.cloudhsm.hsm_temperature.maximum**
(gauge) | ハードウェア プロセッサのジャンクション温度の最大値
_単位は degree celsius_ |
+| **aws.cloudhsm.hsm_unhealthy**
(count) | 異常な HSM インスタンス数の合計
_単位は event_ |
+| **aws.cloudhsm.hsm_unhealthy.average**
(gauge) | 異常な HSM インスタンス数の平均
_単位は event_ |
+| **aws.cloudhsm.hsm_unhealthy.maximum**
(gauge) | 異常な HSM インスタンス数の最大値
_単位は event_ |
+| **aws.cloudhsm.hsm_users_available**
(gauge) | 利用可能な HSM ユーザー数
_単位は user_ |
+| **aws.cloudhsm.hsm_users_max**
(gauge) | HSM ユーザー数の上限
_単位は user_ |
+| **aws.cloudhsm.interface_eth_2dropped_input**
(gauge) | |
+| **aws.cloudhsm.interface_eth_2dropped_input.sum**
(count) | |
+| **aws.cloudhsm.interface_eth_2dropped_output**
(gauge) | |
+| **aws.cloudhsm.interface_eth_2dropped_output.sum**
(count) | |
+| **aws.cloudhsm.interface_eth_2errors_input**
(gauge) |
_単位は error_ |
+| **aws.cloudhsm.interface_eth_2errors_input.sum**
(count) |
_単位は error_ |
+| **aws.cloudhsm.interface_eth_2errors_output**
(gauge) |
_単位は error_ |
+| **aws.cloudhsm.interface_eth_2errors_output.sum**
(count) |
_単位は error_ |
+| **aws.cloudhsm.interface_eth_2octets_input**
(gauge) | HSM への総受信トラフィック量|
+| **aws.cloudhsm.interface_eth_2octets_input.sum**
(count) | HSM への総受信トラフィック量の合計|
+| **aws.cloudhsm.interface_eth_2octets_output**
(gauge) | HSM からの総送信トラフィック量|
+| **aws.cloudhsm.interface_eth_2octets_output.sum**
(count) | HSM からの総送信トラフィック量の合計|
+| **aws.cloudhsm.interface_eth_2packets_input**
(gauge) |
_単位は packet_ |
+| **aws.cloudhsm.interface_eth_2packets_input.sum**
(count) |
_単位は packet_ |
+| **aws.cloudhsm.interface_eth_2packets_output**
(gauge) |
_単位は packet_ |
+| **aws.cloudhsm.interface_eth_2packets_output.sum**
(count) |
_単位は packet_ |
+
+### イベント
+
+AWS CloudHSM インテグレーションにはイベントは含まれません。
+
+### サービス チェック
+
+AWS CloudHSM インテグレーションにはサービス チェックは含まれません。
+
+## トラブルシューティング
+
+サポートが必要な場合は、[Datadog サポート](https://docs.datadoghq.com/help/) にお問い合わせください。
\ No newline at end of file
diff --git a/content/ja/integrations/gatling_enterprise.md b/content/ja/integrations/gatling_enterprise.md
new file mode 100644
index 00000000000..7a6e049dfaf
--- /dev/null
+++ b/content/ja/integrations/gatling_enterprise.md
@@ -0,0 +1,144 @@
+---
+app_id: gatling-enterprise
+app_uuid: 019662ce-ced4-7e23-9738-bd4c09f38b64
+assets:
+ dashboards:
+ Gatling Enterprise Overview: assets/dashboards/gatling_enterprise_overview.json
+ integration:
+ auto_install: true
+ configuration: {}
+ events:
+ creates_events: false
+ metrics:
+ check:
+ - gatling_enterprise.user.start_count
+ metadata_path: metadata.csv
+ prefix: gatling_enterprise
+ process_signatures: []
+ service_checks:
+ metadata_path: assets/service_checks.json
+ source_type_id: 45953787
+ source_type_name: gatling-enterprise
+ supports_ddr_coordinated_failover: false
+author:
+ homepage: https://gatling.io
+ name: Gatling Corp
+ sales_email: contact@gatling.io
+ support_email: contact@gatling.io
+ vendor_id: gatling-corp
+categories:
+- developer tools
+- testing
+custom_kind: integration
+dependencies:
+- https://github.com/DataDog/integrations-extras/blob/master/gatling_enterprise/README.md
+display_on_public_website: true
+draft: false
+git_integration_title: gatling_enterprise
+integration_id: gatling-enterprise
+integration_title: Gatling Enterprise
+integration_version: ''
+is_public: true
+manifest_version: 2.0.0
+name: gatling_enterprise
+public_title: Gatling Enterprise
+short_description: Gatling Enterprise から負荷テストのメトリクスを収集
+supported_os:
+- linux
+tile:
+ changelog: CHANGELOG.md
+ classifier_tags:
+ - Category::Developer Tools
+ - Category::Testing
+ - Offering::Integration
+ - Supported OS::Linux
+ - Submitted Data Type::Metrics
+ configuration: README.md#Setup
+ description: Gatling Enterprise から負荷テストのメトリクスを収集
+ media:
+ - caption: Gatling Enterprise の概要ダッシュボード - 応答とリクエスト
+ image_url: images/app.datadoghq.com_dashboard_n9p-inx-6jn_gatling-enterprise-overview_fromUser=false&refresh_mode=sliding&from_ts=1747402829806&to_ts=1747403729806&live=true
+ (2) 1.png
+ media_type: image
+ - caption: Gatling Enterprise の概要ダッシュボード - 応答時間
+ image_url: images/app.datadoghq.com_dashboard_n9p-inx-6jn_gatling-enterprise-overview_fromUser=false&refresh_mode=sliding&from_ts=1747402829806&to_ts=1747403729806&live=true
+ (2) 1-1.png
+ media_type: image
+ - caption: Gatling Enterprise の概要ダッシュボード - ユーザー
+ image_url: images/app.datadoghq.com_dashboard_n9p-inx-6jn_gatling-enterprise-overview_fromUser=false&refresh_mode=sliding&from_ts=1747402829806&to_ts=1747403729806&live=true
+ (2) 1-2.png
+ media_type: image
+ overview: README.md#Overview
+ support: README.md#Support
+ title: Gatling Enterprise
+ uninstallation: README.md#Uninstallation
+---
+
+
+
+
+## 概要
+
+Gatling Enterprise は、実際のトラフィックに近い条件でアプリケーションのスケーラビリティとパフォーマンスを検証できるように設計された負荷テスト プラットフォームです。
+
+Datadog とのインテグレーションにより、チームは応答時間、スループット、エラーなどの負荷テストのメトリクスを Datadog で追跡しているインフラ データと突き合わせ、パフォーマンス上の問題を詳しく調べられます。
+
+Gatling Enterprise は Datadog にメトリクスを送信するため、エンジニアリング チームや SRE チームはパフォーマンスに関する知見を 1 か所に集約し、スケーラビリティと信頼性に関する意思決定の質を高められます。
+
+
+## セットアップ
+
+> **注**: このインテグレーションは Gatling Enterprise をご利用のお客様向けです。Gatling Enterprise の詳細や無料で始める方法については、[gatling.io/products][1] を参照してください。
+
+1. Datadog で **Integrations** に移動し、Gatling Enterprise タイルを選択して **Install Integration** をクリックします。
+
+2. Gatling のコントロール プレーン環境で、[設定ファイル][2] を編集します。`system-properties` セクションに、次のようにパラメータを追加します。YOUR_API_KEY は [Datadog API キー][3] に置き換え、組織に対応した正しい [Datadog サイト][4] を指定してください:
+
+```bash
+control-plane {
+ locations = [
+ {
+ id = "prl_example"
+ # ... このロケーション向けのその他の設定
+ system-properties {
+ "gatling.enterprise.dd.api.key" = "YOUR_API_KEY" # ここに API キーを入力
+ "gatling.enterprise.dd.site" = "datadoghq.com" # ご利用の Datadog サイトに置き換え
+ }
+ }
+ ]
+}
+```
+
+3. コントロール プレーンをデプロイし、再起動します。
+
+
+## 収集データ
+
+Gatling Enterprise インテグレーションは、データ ベース、ノード、シャードに関するすべてのメトリクスを収集します。
+
+
+### メトリクス
+
+このインテグレーションで提供されるメトリクスの一覧は [metadata.csv][5] を参照してください。
+
+## アンインストール
+
+1. Datadog で **Integrations** に移動し、Gatling Enterprise タイルを選択して **Uninstall Integration** をクリックします。
+
+2. Gatling のコントロール プレーン環境で、[設定ファイル][6] を編集します。`system-properties` セクションから `gatling.enterprise.dd` を含む行を削除します。
+
+3. コントロール プレーンをデプロイし、再起動します。
+
+## サポート
+
+サポートが必要な場合は、[Gatling Enterprise サポート][7] にお問い合わせください。
+
+
+
+[1]: https://gatling.io/products
+[2]: https://docs.gatling.io/reference/install/cloud/private-locations/introduction/
+[3]: https://docs.datadoghq.com/ja/account_management/api-app-keys/
+[4]: https://docs.datadoghq.com/ja/getting_started/site/
+[5]: https://github.com/DataDog/integrations-extras/blob/master/gatling_enterprise/metadata.csv
+[6]: https://docs.gatling.io/reference/install/cloud/private-locations/introduction
+[7]: https://gatlingcorp.atlassian.net/servicedesk/customer/portal/8
\ No newline at end of file
diff --git a/content/ja/integrations/oci_goldengate.md b/content/ja/integrations/oci_goldengate.md
new file mode 100644
index 00000000000..5fdb1a9b609
--- /dev/null
+++ b/content/ja/integrations/oci_goldengate.md
@@ -0,0 +1,116 @@
+---
+app_id: oci-goldengate
+app_uuid: 6abb75a2-400b-4334-8224-2f381fca27fa
+assets:
+ integration:
+ auto_install: true
+ events:
+ creates_events: false
+ metrics:
+ check:
+ - oci.goldengate.cpu_utilization
+ - oci.goldengate.deployment_health
+ - oci.goldengate.deployment_inbound_lag
+ - oci.goldengate.deployment_outbound_lag
+ - oci.goldengate.distribution_path_lag
+ - oci.goldengate.distribution_path_status
+ - oci.goldengate.extract_lag
+ - oci.goldengate.extract_status
+ - oci.goldengate.file_system_usage
+ - oci.goldengate.heartbeat_lag
+ - oci.goldengate.memory_utilization
+ - oci.goldengate.ocpu_consumption
+ - oci.goldengate.pipeline_health
+ - oci.goldengate.pipeline_memory_usage
+ - oci.goldengate.pipeline_processing_rate
+ - oci.goldengate.pipeline_scheduling_delay
+ - oci.goldengate.pipeline_total_delay
+ - oci.goldengate.receiver_path_lag
+ - oci.goldengate.receiver_path_status
+ - oci.goldengate.replicat_lag
+ - oci.goldengate.replicat_status
+ - oci.goldengate.swap_space_usage
+ - oci.goldengate.temp_space_usage
+ metadata_path: metadata.csv
+ prefix: oci.
+ service_checks:
+ metadata_path: assets/service_checks.json
+ source_type_id: 48906972
+ source_type_name: OCI GoldenGate
+author:
+ homepage: https://www.datadoghq.com
+ name: Datadog
+ sales_email: info@datadoghq.com
+ support_email: help@datadoghq.com
+categories:
+- data stores
+- cloud
+- oracle
+- metrics
+custom_kind: integration
+dependencies: []
+display_on_public_website: true
+draft: false
+git_integration_title: oci_goldengate
+integration_id: oci-goldengate
+integration_title: OCI GoldenGate
+integration_version: ''
+is_public: true
+manifest_version: 2.0.0
+name: oci_goldengate
+public_title: OCI GoldenGate
+short_description: OCI GoldenGate は、データ ベース間でのデータ レプリケーション、変換、ストリーミングを提供
+supported_os: []
+tile:
+ changelog: CHANGELOG.md
+ classifier_tags:
+ - Category::Data Stores
+ - Category::Cloud
+ - Category::Oracle
+ - Category::Metrics
+ - Offering::Integration
+ configuration: README.md#Setup
+ description: OCI GoldenGate は、データ ベース間でのデータ レプリケーション、変換、ストリーミングを提供
+ media: []
+ overview: README.md#Overview
+ support: README.md#Support
+ title: OCI GoldenGate
+---
+
+
+
+
+## 概要
+
+Oracle Cloud Infrastructure (OCI) GoldenGate は、異種のデータ ソース間でリアルタイムのデータ レプリケーション、変換、ストリーミングを実行できる、フル マネージドでスケーラブルなサービスです。オンプレミス環境とクラウド環境の間で継続的なデータ可用性とシームレスな連携を実現し、データ ベースの移行、ディザスター リカバリー、リアルタイム分析など、幅広いユース ケースに対応します。
+
+このインテグレーションでは、[oci_goldengate][1] ネームスペースからメトリクスとタグを収集することで、GoldenGate インスタンスの健全性、容量、パフォーマンスを監視し、必要に応じてアラートを設定できます。
+
+## セットアップ
+
+### インストール
+
+[Oracle Cloud Infrastructure][2] インテグレーションを設定したら、上記のネームスペースが [Connector Hub][3] に含まれていることを確認してください。
+
+## 収集データ
+
+### メトリクス
+{{< get-metrics-from-git "oci_goldengate" >}}
+
+
+### サービス チェック
+
+OCI GoldenGate にはサービス チェックは含まれていません。
+
+### イベント
+
+OCI GoldenGate にはイベントは含まれていません。
+
+## トラブルシューティング
+
+サポートが必要な場合は、[Datadog サポート][5] にお問い合わせください。
+[1]: https://docs.oracle.com/en-us/iaas/goldengate/doc/metrics.html
+[2]: https://docs.datadoghq.com/ja/integrations/oracle_cloud_infrastructure/
+[3]: https://cloud.oracle.com/connector-hub/service-connectors
+[4]: https://github.com/DataDog/integrations-internal-core/blob/main/oci_goldengate/metadata.csv
+[5]: https://docs.datadoghq.com/ja/help/
\ No newline at end of file
diff --git a/content/ja/opentelemetry/guide/combining_otel_and_datadog_metrics.md b/content/ja/opentelemetry/guide/combining_otel_and_datadog_metrics.md
new file mode 100644
index 00000000000..08f6c3cbe3d
--- /dev/null
+++ b/content/ja/opentelemetry/guide/combining_otel_and_datadog_metrics.md
@@ -0,0 +1,75 @@
+---
+further_reading:
+- link: /metrics/
+ tag: ドキュメント
+ text: メトリクスのドキュメント
+private: true
+title: OpenTelemetry と Datadog のメトリクスを組み合わせる
+---
+
+## 概要
+
+{{< callout url="#" btn_hidden="true" header="Preview に参加する">}}
+equiv_otel() 関数は Preview 提供中です。この機能に関するフィードバックがあれば、担当のアカウント チームまでお寄せください。
+{{< /callout >}}
+
+Datadog と OpenTelemetry (OTel) では、インテグレーション メトリクスの命名規則が異なります。このガイドでは、Datadog の `equiv_otel` 関数を使って、両方のシステムのメトリクスを 1 つのクエリにまとめる方法を説明します。
+
+
+
+## メトリクスを組み合わせる際の課題
+
+Datadog と OTel のメトリクスを併用すると、主に 2 つの課題があります。ここでは、NGINX の接続監視を例に見ていきます:
+
+### 命名規則の違い
+
+Datadog と OTel では、同じ計測値でも表し方が異なります:
+- Datadog: `nginx.net.connections` (アクティブ接続専用のメトリクス)
+- OTel: `nginx.connections_current` (すべての接続状態を 1 つのメトリクスにまとめたもの)
+ - Datadog のアクティブ接続メトリクスと一致させるには、`state:active` でフィルタする必要があります。
+
+### 集計上の制約
+
+別々のメトリクス クエリをそのまま組み合わせると、正しくない結果になることがあります。たとえば、次のクエリを組み合わせるとします:
+```
+avg:nginx.net.connections
+avg:nginx.connections_current{state:active}
+```
+得られるのは、すべての時系列を通した真の平均ではなく、平均の平均です。これは、従来の [メトリクス関数][1] がデータを 1 つのメトリクスとして扱うのではなく、別々のクエリの結果を結合するためです。
+
+## equiv_otel 関数でメトリクスを組み合わせる
+
+`equiv_otel` 関数を使うと、対応する Datadog と OTel のメトリクスを 1 つのクエリ内で自動的に組み合わせられます。主な動作は次のとおりです。
+
+- メトリクス名の変換を自動で処理
+- すべての時系列を 1 つのメトリクスとして適切に集計
+- 双方向に利用可能 (Datadog から OTel、または OTel から Datadog)
+- クエリ本来の集計の意味を維持
+
+### Datadog から OTel への変換
+
+対応する OTel メトリクスもクエリに含めるには、Datadog のクエリを `equiv_otel` で包みます:
+
+```
+equiv_otel(avg:nginx.net.connections)
+```
+このクエリでは、次の処理が行われます。
+1. 対応する OTel メトリクス (`nginx.connections_current{state:active}`) を特定
+2. 両方のメトリクスの時系列を統合
+3. すべてのデータ ポイントに対して集計 (`avg`) を適用
+
+### OTel から Datadog への変換
+
+OTel のクエリに Datadog のメトリクスを含める場合も、同じように使えます:
+
+```
+equiv_otel(avg:nginx.connections_current{state:active})
+```
+逆方向でも動作は同じで、対応する Datadog のメトリクス (`nginx.net.connections`) が自動的に含まれます。
+
+## 参考資料
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+
+[1]: /ja/dashboards/functions
\ No newline at end of file
From 6887109d4a5d0238ef5e7df7690ab2f9ebe9bf49 Mon Sep 17 00:00:00 2001
From: Joe Peeples
Date: Tue, 17 Mar 2026 14:17:19 -0400
Subject: [PATCH 2/3] fix erroneously translated frontmatter value
---
content/es/tracing/services/inferred_entity_remapping_rules.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/content/es/tracing/services/inferred_entity_remapping_rules.md b/content/es/tracing/services/inferred_entity_remapping_rules.md
index a2dd5377a7f..3bf465c888c 100644
--- a/content/es/tracing/services/inferred_entity_remapping_rules.md
+++ b/content/es/tracing/services/inferred_entity_remapping_rules.md
@@ -7,7 +7,7 @@ further_reading:
- link: tracing/services/inferred_services
tag: Documentación
text: Servicios inferidos
-site_support_id: reglas_reasignación_entidades_inferidas
+site_support_id: inferred_entity_remapping_rules
title: Reglas de reasignación para entidades inferidas
---
From 3605ec9c38bbef56251b22c0a1f3e12b145e5304 Mon Sep 17 00:00:00 2001
From: Joe Peeples
Date: Tue, 17 Mar 2026 14:23:33 -0400
Subject: [PATCH 3/3] fix malformed link syntax
---
content/es/integrations/hudi.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/content/es/integrations/hudi.md b/content/es/integrations/hudi.md
index 52772814b19..47629d203c1 100644
--- a/content/es/integrations/hudi.md
+++ b/content/es/integrations/hudi.md
@@ -15,7 +15,7 @@ title: Hudi
## Información general
Este check monitoriza [Hudi](https://hudi.apache.org/).
-Es compatible con las [versiones] de Hudi (https://github.com/apache/hudi/releases) `0.10.0` y posteriores.
+Es compatible con las [versiones](https://github.com/apache/hudi/releases) de Hudi `0.10.0` y posteriores.
## Configuración