diff --git a/content/es/account_management/_index.md b/content/es/account_management/_index.md
index 80e46b756d0..1124522480e 100644
--- a/content/es/account_management/_index.md
+++ b/content/es/account_management/_index.md
@@ -5,136 +5,141 @@ aliases:
cascade:
algolia:
rank: 70
-description: Gestiona tu cuenta de Datadog y tu organización
+description: Administra tu cuenta de Datadog y organización
further_reading:
- link: https://www.datadoghq.com/blog/volkswagen-organizations/
tag: Blog
- text: Prácticas recomendadas para gestionar organizaciones de Datadog a escala
-title: Gestión de cuentas
+ text: Mejores prácticas para gestionar organizaciones de Datadog a gran escala
+title: Gestión de Cuentas
---
-{{< site-region region="gov" >}}
-
La plataforma Datadog for Government solo admite SAML o la autenticación básica mediante nombre de usuario/correo electrónico y contraseña. Antes de configurar la autenticación SAML, asegúrate de que se ha establecido al menos una cuenta con nombre de usuario/email y contraseña para mantener el acceso durante el proceso de configuración. Datadog recomienda habilitar la autenticación multifactor (MFA) para las cuentas basadas en contraseña.
+{{< site-region region="gov,gov2" >}}
+
La plataforma Datadog para Gobierno solo admite autenticación SAML o básica utilizando un nombre de usuario/correo electrónico y contraseña. Antes de configurar la autenticación SAML, asegúrate de que al menos una cuenta de nombre de usuario/correo electrónico y contraseña esté establecida para mantener el acceso durante el proceso de configuración. Datadog recomienda habilitar la autenticación de múltiples factores (MFA) para cuentas basadas en contraseña.
-Si necesitas habilitar SAML para una cuenta de prueba, ponte en contacto con el el servicio de asistencia de Datadog.
+Si necesitas habilitar SAML para una cuenta de prueba, contacta a Soporte de Datadog.
{{< /site-region >}}
-## Parámetros personales
+## Configuración personal {#personal-settings}
-Las páginas de parámetros personales de Datadog permiten controlar cómo te ven otras personas en tu organización, cambiar o salir de organizaciones, y gestionar tus preferencias de notificación.
+Las páginas de configuración personal en Datadog te permiten controlar cómo apareces ante otros en tu organización, cambiar o dejar organizaciones, y gestionar tus preferencias de notificación.
-### Perfil
+### Perfil {#profile}
-Tu perfil es la forma en que los demás miembros de tu organización te reconocen en Datadog. Define o actualiza tu nombre, dirección de correo electrónico y cargo desde la pestaña [Perfil][11], en la página **Parámetros personales**.
+Tu perfil es cómo te reconocen los demás en tu organización dentro de Datadog. Establece o actualiza tu nombre, dirección de correo electrónico y título desde la pestaña [Perfil][11] dentro de la página {{< ui >}}Personal Settings{{< /ui >}}.
-Para actualizar tu imagen, crea una cuenta en [Gravatar][1] y asóciala a tu dirección de correo electrónico.
+Para actualizar tu foto, crea una cuenta en [Gravatar][1] y asóciala con tu dirección de correo electrónico.
-Si inicias sesión en Datadog mediante la autenticación de Google, tu cuenta de Google proporcionará tu dirección de correo electrónico y **no** podrás editarla en Datadog. Para cambiar tu dirección de correo electrónico, consulta la [documentación de Google][2].
+Si inicias sesión en Datadog utilizando la autenticación de Google, tu dirección de correo electrónico es proporcionada por tu cuenta de Google y es **no** editable dentro de Datadog. Para cambiar tu dirección de correo electrónico en Google, consulta la [documentación de Google][2].
-### Preferencias
+### Preferencias {#preferences}
{{% site-region region="us,us3,us5,eu,ap1,ap2" %}}
-Puedes gestionar tu zona horaria, preferencia de accesibilidad visual y suscripciones de correo electrónico desde la [pestaña Preferencias][3] en la página **Configuración personal**.
+Puedes gestionar tu zona horaria, formato de hora, preferencia de accesibilidad visual y suscripciones de correo electrónico desde la pestaña [Preferencias][3] dentro de la página {{< ui >}}Personal Settings{{< /ui >}}.
-#### Suscripciones por correo electrónico
+#### Suscripciones por correo electrónico {#email-subscriptions}
-En las suscripciones por correo electrónico, tienes acceso a los siguientes informes:
-{{< site-region region="us3,us5,gov,ap1,ap2" >}}
+Bajo suscripciones por correo electrónico, tienes acceso a los siguientes informes:
+{{< site-region region="us3,us5,gov,gov2,ap1,ap2" >}}
Los resúmenes de correo electrónico no están disponibles en el sitio seleccionado ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}}
-* Daily Digest (Resumen diario)
-* Weekly Digest (Resumen semanal)
+* Resumen diario
+* Resumen semanal
-Si tienes dudas sobre si un resumen por correo electrónico es relevante para ti, puedes ver un ejemplo haciendo clic en el enlace **Example** (Ejemplo) que aparece junto a cada suscripción. También puedes usar el botón **Unsubscribe From All** (Darse de baja de todo) para anular todas sus suscripciones por correo electrónico.
+Si no estás seguro de si un resumen de correo electrónico es relevante para ti, puedes ver un ejemplo haciendo clic en el {{< ui >}}Example{{< /ui >}} enlace junto a cada suscripción por correo electrónico. También puedes usar el {{< ui >}}Unsubscribe From All{{< /ui >}} botón para darte de baja de todas las suscripciones por correo electrónico.
{{% /site-region %}}
-{{% site-region region="gov" %}}
-Puedes gestionar tu zona horaria y preferencias de accesibilidad visual desde la pestaña [**Preferencias**][3] (Preferences) en la página **Personal Settings** (Configuración personal).
+{{% site-region region="gov,gov2" %}}
+Puedes gestionar tu zona horaria, formato de hora y preferencia de accesibilidad visual desde la pestaña [**Preferencias**][3] dentro de la página {{< ui >}}Personal Settings{{< /ui >}}.
{{% /site-region %}}
-#### Accesibilidad visual
+#### Formato de hora {#time-format}
-La preferencia de accesibilidad visual ofrece cinco ajustes diferentes para abordar las necesidades por deficiencia de visión cromática, baja agudeza visual y sensibilidad a los colores brillantes. Si optas por una configuración de colores accesible, Datadog convertirá todos los gráficos que utilizan la paleta de colores clásica en un conjunto de colores adaptados a tus necesidades visuales.
+Elige si las horas se muestran en formato de 12 horas o 24 horas en Datadog (por ejemplo, "2:30 pm" o "14:30"). Las cuentas nuevas tienen como formato predeterminado el de 12 horas. Los gráficos y ciertos datos tabulares se muestran en formato de 24 horas en todo momento.
-**Nota**: Tus preferencias de accesibilidad visual se guardan localmente en tu navegador. Si usas otro navegador o borras la memoria caché, las preferencias volverán a la configuración predeterminada.
+#### Accesibilidad visual {#visual-accessibility}
-### Organizaciones
+La preferencia de accesibilidad visual tiene cinco configuraciones diferentes para abordar la deficiencia de visión de color, baja agudeza visual y sensibilidad a colores brillantes. Si optas por una configuración de color accesible, Datadog traduce todos los gráficos que utilizan la paleta de colores clásica a un conjunto accesible de colores adaptados a tus necesidades visuales.
-En la pestaña [Organizations][12] (Organizaciones) de **Personal Settings** (Configuración personal) se incluyen todas las organizaciones a las que estás asociado. Cambia de organización desde esta página o pasando el cursor por encima del menú de la cuenta en la barra de navegación de la izquierda.
+**Nota**: Tu preferencia de accesibilidad visual se guarda localmente en tu navegador. Si usas un navegador diferente o borras tu caché, la preferencia se establece en la configuración predeterminada.
-**Nota**: Si abandonas una organización, no podrás volver a unirte, a no ser que te invite un administrador de esa organización.
+### Organizaciones {#organizations}
-Para unirte a una organización existente, debes recibir la invitación de un administrador. Después de recibirla, se te enviará un correo electrónico con el asunto "Recibiste una invitación para unirte \". Haz clic en el botón **Unirse a la cuenta** del correo electrónico.
+La [pestaña de Organizaciones][12] en {{< ui >}}Personal Settings{{< /ui >}} lista todas las organizaciones con las que estás asociado. Cambia entre estas organizaciones desde esta página o pasando el cursor sobre el menú de cuenta en la navegación del lado izquierdo.
-Si eres administrador de una organización, consulta la documentación de referencia adicional para:
+**Nota**: Si dejas una organización, no puedes volver a unirte a menos que seas invitado por un administrador de esa organización.
+
+Para unirte a una organización existente, debes ser invitado por un administrador. Después de que seas invitado, se te enviará un correo electrónico con el asunto "Has sido invitado a unirte a \". Haz clic en el botón {{< ui >}}Join Account{{< /ui >}} en el correo electrónico.
+
+Si eres un administrador de la organización, consulta la documentación adicional para:
* [Gestionar usuarios en tu organización][4]
-* [Configurar el inicio de sesión único con SAML][5]
-* [Cambiar el nombre de tu organización][6]
-* [Gestionar cuentas de varias organizaciones][7]
-* [Cambiar tu plan de Datadog, y ver el historial de uso y facturación][8]
+* [Configurar inicio de sesión único con SAML][5]
+* [Renombrar tu organización][6]
+* [Gestionar cuentas de múltiples organizaciones][7]
+* [Cambiar tu plan de Datadog y ver el historial de uso y facturación][8]
+* [Elegir la topología de tu organización (una organización vs. múltiples organizaciones)][15]
-### Seguridad
+### Seguridad {#security}
-#### Claves de aplicación
+#### Claves de aplicación {#application-keys}
-La pestaña [Application Keys][13] (Claves de aplicación) de **Personal Settings** (Configuración personal) te permite gestionar las claves de tu aplicación. Para copiar una clave, pasa el cursor sobre ella hasta que aparezca el icono **Copy Key** (Copiar clave) a la derecha y haz clic en él. También puedes hacer clic en una clave concreta para editar su nombre, ver cuándo se creó, consultar el perfil del propietario, copiarla o revocarla.
+La [pestaña de claves de aplicación][13] en {{< ui >}}Personal Settings{{< /ui >}} te permite gestionar tus claves de aplicación. Para copiar una clave, pasa el cursor sobre ella hasta que aparezca el ícono {{< ui >}}Copy Key{{< /ui >}} a la derecha, y haz clic en él. También puedes hacer clic en una clave específica para editar su nombre, ver cuándo fue creada, ver el perfil del propietario de la clave, copiarla o revocarla.
-#### Aplicaciones
+#### Aplicaciones {#apps}
-La pestaña [Apps][14] (Aplicaciones) de **Personal Settings** (Configuración personal) te permite gestionar las aplicaciones que han sido instaladas o creadas por miembros de tu organización. Puedes filtrarlas con una cadena de búsqueda o elegir ver solo las aplicaciones activadas o desactivadas mediante casillas de verificación.
+La [pestaña de aplicaciones][14] en {{< ui >}}Personal Settings{{< /ui >}} te permite gestionar las aplicaciones que han sido instaladas o creadas por miembros de tu organización. Puedes filtrar aplicaciones con una cadena de búsqueda, o elegir ver solo aplicaciones habilitadas o deshabilitadas usando casillas de verificación.
-Al pasar el cursor por encima de una aplicación, la opción de activarla o desactivarla aparecerá a la derecha de la lista.
+Cuando pasas el cursor sobre una aplicación, la opción para habilitar o deshabilitar aparece a la derecha de la lista de aplicaciones.
-#### Verificación del correo electrónico
-Verifica tu dirección de correo electrónico para mejorar la seguridad de tu cuenta y acceder a funciones de gestión adicionales. Los usuarios verificados tienen un mayor control sobre la seguridad de sus cuentas y pueden ver todas las organizaciones a las que pertenecen.
+#### Verificación de correo electrónico {#email-verification}
+Verifica tu dirección de correo electrónico para mejorar la seguridad de la cuenta y acceder a funciones adicionales de gestión. Los usuarios verificados tienen un mayor control sobre la seguridad de su cuenta y pueden ver todas las organizaciones a las que pertenecen.
-- Los **usuarios que inician sesión en Google** se verifican automáticamente durante su primer inicio de sesión.
-- Los **usuarios con contraseña** verifican su correo electrónico al establecer su contraseña por primera vez.
-- **Los usuarios SAML** deben verificar manualmente su correo electrónico a través de Datadog.
+- **Los usuarios de inicio de sesión de Google** son verificados automáticamente durante su primer inicio de sesión.
+- **Los usuarios basados en contraseña** verifican su correo electrónico al establecer su contraseña por primera vez.
+- **Los usuarios de SAML** deben verificar manualmente su correo electrónico a través de Datadog.
-Una vez que apruebes la verificación, tendrás:
-- La posibilidad de **cerrar sesión en todas las sesiones web activas** en todos los dispositivos, garantizando la seguridad en caso de compromiso de credenciales.
-- La posibilidad de **ver y cambiar entre organizaciones** fuera de tu jerarquía orgánica actual.
+Después de ser verificado, obtienes acceso a:
+- La capacidad de **cerrar sesión en todas las sesiones web activas** en todos los dispositivos, asegurando la seguridad en caso de compromiso de credenciales.
+- La capacidad de **ver y cambiar entre organizaciones** fuera de la jerarquía actual de tu organización.
-Los usuarios no verificados pueden seguir accediendo a Datadog, pero solo pueden ver las organizaciones dentro de su jerarquía y no pueden revocar las sesiones activas.
+Los usuarios no verificados aún pueden acceder a Datadog, pero están limitados a ver organizaciones dentro de su jerarquía y no pueden revocar sesiones activas.
-#### Verificar tu correo electrónico
+#### Verifica tu correo electrónico {#verify-your-email}
Para verificar tu correo electrónico:
-1. Ve a tus **Parámetros de perfil**.
-2. Haz clic en **Verify Account** (Verificar cuenta).
-3. Introduce el **código de verificación** enviado a tu correo electrónico registrado.
-4. Haz clic en **Submit** (Enviar) para finalizar el proceso de verificación.
+1. Navega a tu {{< ui >}}Profile Settings{{< /ui >}}.
+2. Haz clic en {{< ui >}}Verify Account{{< /ui >}}.
+3. Ingresa el **código de verificación** enviado a tu correo electrónico registrado.
+4. Haz clic en {{< ui >}}Submit{{< /ui >}} para completar el proceso de verificación.
-#### Cerrar sesión en todas las sesiones web activas
+#### Cierra sesión en todas las sesiones web activas {#log-out-of-all-active-web-sessions}.
Para cerrar sesión en todas las sesiones web activas:
-Al cerrar sesión en todas las sesiones web activas, cierras sesión en todas las sesiones actuales en todos los dispositivos, incluido el que estás utilizando.
+Cerrar sesión en todas las sesiones web activas te desconecta de todas las sesiones actuales en todos los dispositivos, incluido el que estás usando.
Para cerrar sesión en todas las sesiones activas:
-1. Ve a **Personal Settings** (Configuración personal).
-2. Haz clic en **Log Out of All Web Sessions** (Cerrar sesión en todas las sesiones web).
+1. Ve a {{< ui >}}Personal Settings{{< /ui >}}.
+2. Haz clic en {{< ui >}}Log Out of All Web Sessions{{< /ui >}}.
3. Confirma la acción.
-Después de confirmar, se cierran tus sesiones en todos los dispositivos y debes iniciarlas nuevamente.
+Después de confirmar, se cierra sesión en todos los dispositivos y debes volver a iniciar sesión.
-## Aspecto
+## Apariencia {#appearance}
-Puedes utilizar Datadog en modo oscuro. Para hacerlo, pasa el cursor sobre tu avatar en la barra lateral o pulsa: `Ctrl+Opt+D` / `Ctrl+Alt+D`.
+Visualiza Datadog en modo oscuro al pasar el cursor sobre tu avatar en la barra lateral, o presionando `Ctrl+Opt+D` / `Ctrl+Alt+D`.
-Para adaptar el aspecto al aspecto de tu ordenador, selecciona la opción *System* (Sistema). De esta manera, el aspecto de Datadog se adaptará automáticamente al tema que hayas definido en el sistema operativo.
+Para adaptar la apariencia de tu computadora, selecciona la opción {{< ui >}}System{{< /ui >}}. Esto adapta automáticamente la apariencia de Datadog al tema que has configurado a nivel del sistema operativo.
-## Conectarse a GitHub
+## Conectando a GitHub {#connecting-to-github}
-Si has instalado la [integración con GitHub][9] para crear eventos en Datadog, vincula tu cuenta personal de GitHub a tu cuenta de usuario de Datadog. Una vez que las cuentas estén vinculadas, cualquier comentario que publiques en los eventos de GitHub a través de Datadog se publicarán de forma automática en el tema o solicitud pull correspondiente en GitHub.
+Si has instalado la [integración de GitHub][9] para crear eventos en Datadog, vincula tu cuenta personal de GitHub a tu cuenta de usuario de Datadog. Al vincular tus cuentas, cualquier comentario que publiques en eventos de GitHub en Datadog se publica automáticamente en el problema o solicitud de extracción correspondiente en GitHub.
-## Deshabilitar la cuenta de tu organización
+## Deshabilitando la cuenta de tu organización {#disabling-your-organizations-account}.
-Para deshabilitar la cuenta de tu organización de Datadog, ponte en contacto con el [equipo de asistencia de Datadog][10].
+Para deshabilitar la cuenta de tu organización de Datadog, contacta a [soporte de Datadog][10].
[1]: https://gravatar.com
[2]: https://support.google.com/accounts/answer/19870?hl=en
@@ -149,4 +154,5 @@ Para deshabilitar la cuenta de tu organización de Datadog, ponte en contacto co
[11]: https://app.datadoghq.com/personal-settings/profile
[12]: https://app.datadoghq.com/personal-settings/organizations
[13]: https://app.datadoghq.com/personal-settings/application-keys
-[14]: https://app.datadoghq.com/personal-settings/apps
\ No newline at end of file
+[14]: https://app.datadoghq.com/personal-settings/apps
+[15]: /es/getting_started/organization_topology/
\ No newline at end of file
diff --git a/content/es/account_management/api-app-keys.md b/content/es/account_management/api-app-keys.md
index 3c1c4597125..73b3bb2d0b3 100644
--- a/content/es/account_management/api-app-keys.md
+++ b/content/es/account_management/api-app-keys.md
@@ -1,180 +1,180 @@
---
algolia:
tags:
- - clave de API
+ - api key
aliases:
- /es/account_management/faq/how-do-i-reset-my-application-keys/
- /es/agent/faq/how-do-i-reset-my-datadog-api-keys/
- /es/account_management/faq/api-app-key-management/
-description: Gestiona claves de API, claves de aplicación y tokens de cliente para
- aplicaciones de navegador con funciones de seguridad.
-title: Claves de API y aplicación
+description: Administra las claves de API, las claves de aplicación y los tokens de
+ cliente para aplicaciones de navegador con características de seguridad.
+title: Claves de API y de Aplicación
---
+## Claves de API {#api-keys}
-## Claves de API
+Las claves de API son únicas para su organización. Se requiere una [clave de API][1] por parte del Agente de Datadog para enviar métricas y eventos a Datadog.
-Las claves de API son exclusivas de tu organización. El Datadog Agent requiere una [clave de API][1] para enviar métricas y eventos a Datadog.
+## Claves de Aplicación {#application-keys}
-## Claves de aplicación
+Las [claves de aplicación][2], junto con la clave de API de su organización, otorgan a los usuarios acceso a la API programática de Datadog. Las claves de aplicación están asociadas con la cuenta de usuario que las creó y, por defecto, tienen los permisos del usuario que las creó.
-Las [claves de aplicación][2], junto con la clave de API de tu organización, permiten a los usuarios acceder a la API programática de Datadog. Las claves de aplicación están asociadas a la cuenta de usuario que las creó y, por defecto, tienen los permisos del usuario que las creó.
+### Modo de Lectura Única {#one-time-read-mode}
-### Modo de lectura única
+El modo de Lectura Única (OTR) es una característica de seguridad que limita la visibilidad de los secretos de la clave de aplicación solo al momento de creación. Cuando el modo OTR está habilitado, los secretos de la clave de aplicación solo se muestran una vez durante la creación y no se pueden recuperar más tarde por razones de seguridad.
-El modo de lectura única (OTR) es una función de seguridad que limita la visibilidad de los secretos de las claves de aplicación únicamente al momento de la creación. Cuando el modo OTR está activado, los secretos de las claves de aplicación solo se muestran una vez durante la creación y no se pueden recuperar posteriormente por motivos de seguridad.
+#### Para nuevas organizaciones {#for-new-organizations}
-#### Para las nuevas organizaciones
+Todas las claves de aplicación para nuevas organizaciones principales (y sus organizaciones hijas) creadas después del 20 de agosto de 2025 tienen el modo OTR habilitado por defecto. Esta configuración es permanente y no se puede cambiar.
-Todas las claves de aplicación para nuevas organizaciones matrices (y sus organizaciones secundarias) creadas después del 20 de agosto de 2025 tienen el modo de OTR activado en forma predeterminada. Esta configuración es permanente y no puede modificarse.
+#### Para organizaciones existentes {#for-existing-organizations}
-#### Para las organizaciones existentes
+Los administradores de la organización pueden habilitar o deshabilitar el modo OTR desde [**Configuración de la Organización** > **Claves de Aplicación**][2]. Después de habilitar el modo OTR:
-Los administradores de la organización pueden activar o desactivar el modo de OTR desde [**Organization Settings** > **Application Keys** (Configuración de la organización > Claves de aplicación)][2]. Después de activar el modo de OTR:
+- Los secretos de la clave de aplicación son visibles solo una vez, en el momento de la creación
+- Ya no se pueden recuperar a través de la interfaz de usuario o la API
+- La configuración puede ser activada o desactivada por los administradores de la organización durante 3 meses después de habilitarla
+- Después de 3 meses de estar habilitado continuamente, el modo OTR se vuelve permanente y se elimina el interruptor
-- Los secretos de las claves de aplicación solo son visibles una vez, en el momento de su creación
-- Ya no se pueden recuperar a través de la interfaz de usuario ni la API.
-- Los administradores de la organización pueden activar o desactivar la configuración durante 3 meses después de activarla.
-- Transcurridos 3 meses de activación continua, el modo de OTR se convierte en permanente y se suprime la alternancia.
+**Permisos**: Los usuarios deben tener tanto el `org_app_keys_write` como el `org_management` permisos para habilitar o deshabilitar el modo OTR para su organización.
-**Permisos**: Los usuarios deben tener los permisos `org_app_keys_write` y `org_management` para activar o desactivar el modo de OTR para su organización.
+### Contextos {#scopes}
-### Contextos
+Para proteger y asegurar mejor sus aplicaciones, puede especificar los contextos de autorización para sus claves de aplicación para definir permisos más granulares y minimizar el acceso que las aplicaciones tienen a sus datos de Datadog. Esto le brinda un control de acceso detallado sobre sus aplicaciones y minimiza las vulnerabilidades de seguridad al limitar el acceso innecesario. Por ejemplo, una aplicación que solo lee tableros no necesita derechos de administrador para gestionar usuarios o eliminar cualquiera de los datos de su organización.
-
-Para proteger mejor tus aplicaciones, puedes indicar contextos de autorización para tus claves de aplicación. De este modo, podrás definir permisos más específicos y minimizar el acceso que las aplicaciones tienen a tus datos de Datadog. Esto te da un control pormenorizado sobre tus aplicaciones y minimiza las vulnerabilidades de seguridad al limitar el acceso externo. Por ejemplo, una aplicación que solo lee dashboards no necesita derechos de administrador para gestionar usuarios ni eliminar los datos de tu organización.
-
-La forma recomendada de determinar el contexto de las claves de aplicación es otorgar los mínimos privilegios y permisos necesarios para que una aplicación funcione según lo previsto. A las claves de aplicación con contexto solo se les conceden los contextos indicados por el usuario y ningún otro permiso. Aunque puedes modificar los contextos de autorización de tus claves de aplicación en cualquier momento, deberás valorar cómo esos cambios podrían afectar a la funcionalidad o al acceso de tu aplicación.
+La mejor práctica recomendada para definir los contextos de las claves de aplicación es otorgar a sus claves los privilegios y permisos mínimos necesarios para que una aplicación funcione como se espera. Las claves de aplicación con contexto se asignan únicamente a los contextos especificados por el usuario, sin permisos adicionales. Si bien puede modificar los contextos de autorización de sus claves de aplicación en cualquier momento, considere cómo esos cambios pueden afectar la funcionalidad o el acceso existente de su aplicación.
**Notas:**
-- Los usuarios o cuentas de servicio con [permisos][3] para crear o editar claves de aplicación pueden abarcar claves de aplicación. Un usuario debe tener el permiso `user_app_keys` para abarcar sus propias claves de aplicación o el permiso `org_app_keys_write` para abarcar claves de aplicación propiedad de cualquier usuario de su organización. Un usuario debe tener el permiso `service_account_write` para abarcar claves de aplicación para cuentas de servicio.
-- Los propietarios de aplicaciones no pueden autorizar una aplicación si les faltan los permisos necesarios, ni siquiera si definen el contexto de una clave de aplicación con contextos de autorización de otra persona.
-- Los errores debidos a la falta de permisos al escribir claves de aplicación o autorizar aplicaciones muestran un error `403 Forbidden`. Encontrará más información sobre las distintas respuestas de error en la documentación de [API de Datadog][4].
-- Si el rol o los permisos de algún usuario cambian, los contextos de autorización indicados para sus claves de aplicación seguirán iguales.
+-Los usuarios o cuentas de servicio que tienen [permisos][3] para crear o editar claves de aplicación pueden establecer los contextos de autorización de dichas claves. Un usuario debe tener el `user_app_keys` permiso para definir los contextos de sus propias claves de aplicación, o el `org_app_keys_write` permiso para definir los contextos de las claves de aplicación de cualquier usuario en su organización. Un usuario debe tener el `service_account_write` permiso para definir los contextos de las claves de aplicación para cuentas de servicio.
+- Los propietarios de la aplicación no pueden autorizar una aplicación si les falta algún permiso requerido, incluso si asignan a la clave de aplicación unos contextos de autorización que no poseen.
+- Los errores debido a permisos faltantes al escribir claves de aplicación o autorizar aplicaciones muestran un error `403 Forbidden`. Más información sobre varias respuestas de error se puede encontrar en la documentación de la [API de Datadog][4].
+- Si el rol o los permisos de un usuario cambian, los contextos de autorización especificados para sus claves de aplicación permanecen sin cambios.
-### Acceso a API de acciones
+### Acceso a la API de Acciones {#actions-api-access}
-Las API de acciones incluyen:
+Las API de Acciones incluyen:
- [App Builder][5]
-- [Conexiones de acciones][6]
-- [Workflow Automation (automatización de procesos)][7]
+- [Actions Connections][6]
+- [Workflow Automation][7]
+
+Para usar claves de aplicación con estas API, debe habilitar el acceso a la API de Acciones en la clave de aplicación. Esto se puede hacer [a través de la interfaz de usuario][2] o [API][21]. Por defecto, las claves de aplicación no se pueden usar con estas API.
-Para utilizar claves de aplicación con estas API, debes activar el acceso a API de acciones en la clave de aplicación. Esto puede hacerse [a través de la interfaz de usuario][2] o [API][21]. En forma predeterminada, las claves de aplicación no se pueden utilizar con estas API.
+{{< img src="account_management/click-enable-actions-api-access.png" alt="Haga clic en Habilitar para el Acceso a la API de Acciones" style="width:80%;" >}}
-{{< img src="account_management/click-enable-actions-api-access.png" alt="Activar con un clic el acceso a la API de acciones" style="width:80%;" >}}
+**Nota**: La sección {{< ui >}}Last used{{< /ui >}} solo se muestra si [Audit Trail está habilitado][22] en la cuenta y usted tiene [`Audit Trail Read`][23] permiso.
-## Tokens de cliente
+## Tokens de cliente {#client-tokens}
-Por razones de seguridad, las claves de API no pueden utilizarse para enviar datos desde un navegador, un móvil o una aplicación de TV, ya que quedarían expuestas al cliente. En su lugar, las aplicaciones destinadas al usuario final utilizan tokens de cliente para enviar datos a Datadog.
+Por razones de seguridad, las claves de API no se pueden usar para enviar datos desde un navegador, móvil o aplicación de TV, ya que estarían expuestas del lado del cliente. En su lugar, las aplicaciones orientadas al usuario final utilizan tokens de cliente para enviar datos a Datadog.
- Varios tipos de clientes envían datos que requieren un token de cliente, como los siguientes ejemplos:
-- Los recopiladores de logs para [navegador web][8], [Android][9], [iOS][10], [React Native][11], [Flutter][12] y [Roku][13] envían logs.
-- Las aplicaciones [Real User Monitoring][14] envían eventos y logs.
+ Varios tipos de clientes envían datos que requieren un token de cliente, incluidos los siguientes ejemplos:
+- Los recolectores de registros para [navegador web][8], [Android][9], [iOS][10], [React Native][11], [Flutter][12] y [Roku][13] envían registros.
+- Las aplicaciones de [Real User Monitoring][14] envían eventos y registros.
-Los tokens de cliente son exclusivos de tu organización. Para gestionarlos, accede a **Organization Settings** (Parámetros de organización) y haz clic en la pestaña **Client Tokens** (Tokens de cliente).
+Los tokens de cliente son únicos para su organización. Para gestionar sus tokens de cliente, vaya a {{< ui >}}Organization Settings{{< /ui >}}, luego haga clic en la pestaña {{< ui >}}Client Tokens{{< /ui >}}.
-**Nota**: Cuando se desactiva un usuario que ha creado un token de cliente, ese token de cliente permanece activo.
+**Nota**: Cuando un usuario que creó un token de cliente es desactivado, el token de cliente permanece activo.
-## Añadir una clave de API o token de cliente
+## Agregue una clave API o un token de cliente {#add-an-api-key-or-client-token}.
-Para añadir una clave de API o token de cliente de Datadog:
+Para agregar una clave API de Datadog o un token de cliente:
-1. Va a Configuración de la organización y, a continuación, haz clic en la pestaña [**API keys** (Claves de API)][1] o [**Client Tokens** (Tokens de cliente)][15].
-2. Haz clic en el botón **New Key** (Nueva clave) o **New Client Token** (Nuevo token de cliente), según lo que vayas a crear.
-3. Indica un nombre para tu clave o token.
-4. Haz clic en **Create API key** (Crear clave de API) o **Create Client Token** (Crear token de cliente).
+1. Navegue a la configuración de la organización, luego haga clic en la pestaña [**Claves API**][1] o [**Tokens de Cliente**][15].
+2. Haga clic en el botón {{< ui >}}New Key{{< /ui >}} o {{< ui >}}New Client Token{{< /ui >}}, dependiendo de cuál esté creando.
+3. Ingrese un nombre para su clave o token.
+4. Haga clic en {{< ui >}}Create API key{{< /ui >}} o {{< ui >}}Create Client Token{{< /ui >}}.
-{{< img src="account_management/api-key.png" alt="Navega a la página de claves de API para tu organización en Datadog" style="width:80%;" >}}
+{{< img src="account_management/api-key.png" alt="Navegue a la página de Claves API para su organización en Datadog." style="width:80%;" >}}
**Notas:**
-- Tu organización debe tener al menos una clave de API y un máximo de 50.
-- Los nombres de las claves deben ser únicos en toda tu organización.
+- Su organización debe tener al menos una clave API y como máximo 50 claves API.
+- Los nombres de las claves deben ser únicos en su organización.
-## Eliminar claves de API o tokens de cliente
+## Elimina las claves API o los tokens de cliente {#remove-api-keys-or-client-tokens}
-Para eliminar una clave de API o un token de cliente de Datadog, ve a la lista de claves o tokens y haz clic en el icono **Delete** (Eliminar) {{< img src="icons/delete.png" inline="true" style="width:14px;">}} situado junto a la clave o token que desees eliminar.
+Para eliminar una clave API de Datadog o un token de cliente, navegue a la lista de claves o tokens y haga clic en {{< ui >}}Delete{{< /ui >}} {{< img src="icons/delete.png" inline="true" style="width:14px;">}} el ícono junto a la clave o token que desea eliminar.
-## Añadir claves de aplicación
+## Agregue claves de aplicación {#add-application-keys}
-Para añadir una clave de aplicación de Datadog, ve a [**Organization Settings** > **Application Keys** (Configuración de la organización > Claves de aplicación)][2]. Si tienes el [permiso][3] para crear claves de aplicación, haz clic en **New Key** (Nueva clave).
+Para agregar una clave de aplicación de Datadog, navegue a [**Configuración de la Organización** > **Claves de Aplicación**][2]. Si tiene el [permiso][3] para crear claves de aplicación, haga clic en {{< ui >}}New Key{{< /ui >}}.
-{{< img src="account_management/app-key.png" alt="Navega a la página de Claves de aplicación para tu organización en Datadog" style="width:80%;" >}}
+{{< img src="account_management/app-key.png" alt="Navegue a la página de Claves de Aplicación para su organización en Datadog" style="width:80%;" >}}
-{{< site-region region="ap2,gov" >}}
-
Asegúrate de almacenar de forma segura tu clave de aplicación inmediatamente después de la creación, ya que el secreto de la clave no se puede recuperar más tarde.
+{{< site-region region="ap2,gov,gov2" >}}
+
Asegúrese de almacenar de manera segura su clave de aplicación inmediatamente después de su creación, ya que el secreto de la clave no se puede recuperar más tarde.
{{< /site-region >}}
-
Si tu organización tiene activado el modo de lectura única (OTR), asegúrate de almacenar de forma segura tu clave de aplicación inmediatamente después de la creación, ya que el secreto de la clave no se puede recuperar más tarde.
+
Si su organización tiene habilitado el modo de Lectura Única (OTR), asegúrese de almacenar de manera segura su clave de aplicación inmediatamente después de su creación, ya que el secreto de la clave no se puede recuperar más tarde.
**Notas:**
-- Los nombres de las claves de aplicación no pueden quedar en blanco.
+- Los nombres de las claves de aplicación no pueden estar en blanco.
-## Eliminar claves de aplicación
+## Elimine claves de aplicación {#remove-application-keys}
-Para eliminar una clave de aplicación de Datadog, ve a [**Organization Settings** > **Application Keys** (Configuración de la organización > Claves de aplicación)][2]. Si tienes el [permiso][3] para crear y gestionar claves de aplicación, puedes ver tus propias claves y hacer clic en **Revoke** (Revocar) junto a la clave que deseas revocar. Si tienes el permiso para gestionar todas las claves de aplicación de la organización, puedes buscar la clave que deseas revocar y hacer clic en **Revoke** (Revocar) junto a ella.
+Para eliminar una clave de aplicación de Datadog, navegue a [**Configuración de la Organización** > **Claves de Aplicación**][2]. Si tiene el [permiso][3] para crear y gestionar claves de aplicación, puede ver sus propias claves y hacer clic en {{< ui >}}Revoke{{< /ui >}} junto a la clave que desea revocar. Si tiene el permiso para gestionar todas las claves de aplicación de la organización, puede buscar la clave que desea revocar y hacer clic en {{< ui >}}Revoke{{< /ui >}} junto a ella.
-## Retraso en la propagación de claves y coherencia final
+## Retraso en la propagación de claves y consistencia eventual {#key-propagation-delay-and-eventual-consistency}
-Las claves de API y de aplicación de Datadog siguen un modelo de coherencia eventual. Debido a la naturaleza distribuida de los sistemas de Datadog, las actualizaciones de las claves, como la creación y la revocación, pueden tardar unos segundos en propagarse por completo.
+Las claves API y de aplicación de Datadog siguen un modelo de consistencia eventual. Debido a la naturaleza distribuida de los sistemas de Datadog, las actualizaciones a las claves, como la creación y revocación, pueden tardar unos segundos en propagarse completamente.
Como resultado:
-- No utilices nuevas claves de API o de aplicación inmediatamente en flujos de trabajo críticos. Deja un breve tiempo (unos segundos) para la propagación. Puedes implementar una estrategia de reintento con un backoff exponencial corto para manejar errores transitorios durante el intervalo de propagación.
-- Para validar si una clave de API está activa y utilizable, llama al endpoint [/api/v1/validate][16].
-- Para verificar que una clave de aplicación está activa, utiliza el endpoint `/api/v2/validate_keys` con el par de claves adecuado.
+- No utilice nuevas claves de API o de aplicación de inmediato en flujos de trabajo críticos. Permita un breve período (unos segundos) para la propagación. Puede implementar una estrategia de reintento con un retroceso exponencial corto para manejar errores transitorios durante la ventana de propagación.
+- Para validar si una clave de API está activa y utilizable, llame al punto de conexión [/api/v1/validate][16].
+- Para verificar que una clave de aplicación esté activa, utilice el punto de conexión `/api/v2/validate_keys` con el par de claves apropiado.
-Intentar utilizar una clave recién creada antes de que se haya propagado completamente puede provocar errores de autenticación temporales como 403 Forbidden o 401 Unauthorized.
+Intentar usar una clave recién creada antes de que esté completamente propagada puede resultar en errores de autenticación temporales como 403 Prohibido o 401 No autorizado.
-## Definir el contexto de claves de aplicación
+## Claves de aplicación con ámbitos {#scope-application-keys}
-Para especificar ámbitos de autorización para claves de aplicación, [realiza una solicitud a la API de Datadog ][4] o a la interfaz de usuario para crear o editar una clave de aplicación. Se pueden especificar ámbitos para claves de aplicación propiedad del [usuario actual][17] o una [cuenta de servicio][18]. Si no se especifica este campo, las claves de aplicación tendrán en forma predeterminada los mismos ámbitos y permisos que el usuario que las creó.
+Para especificar los ámbitos de autorización para las claves de aplicación, [haga una solicitud a la API de Datadog][4] o a la interfaz de usuario para crear o editar una clave de aplicación. Los ámbitos pueden especificarse para las claves de aplicación propiedad de [el usuario actual][17] o de [una cuenta de servicio][18]. Si este campo no se especifica, las claves de aplicación por defecto tienen todos los mismos ámbitos y permisos que el usuario que las creó.
**Notas:**
-- Los nombres de los contextos distinguen entre mayúsculas y minúsculas.
+- Los nombres de los ámbitos son sensibles a mayúsculas y minúsculas.
-## Usar varias claves de API
+## Uso de múltiples claves de API {#using-multiple-api-keys}
-Valora la posibilidad de configurar varias claves de API para tu organización. Por ejemplo, usa distintas claves de API para cada uno de tus métodos de implementación: una para implementar un Agent en Kubernetes, en AWS; otra para hacerlo localmente con Chef; otra para scripts de Terraform que automaticen tus dashboards o monitores, y otra para desarrolladores que hagan implementaciones en local.
+Considere configurar múltiples claves de API para su organización. Por ejemplo, use diferentes claves de API para cada uno de sus métodos de implementación: una para implementar un Agente en Kubernetes en AWS, otra para implementarlo en sus instalaciones con Chef, otra para los scripts de Terraform que automatizan sus tableros o seguimientos, y otra para desarrolladores que implementan localmente.
-El uso de varias claves de API te permite rotar las claves como parte de tus protocolos de seguridad, o revocar una clave en concreto si se expone inadvertidamente o si quieres dejar de usar el servicio al que está asociada.
+El uso de múltiples claves de API le permite rotar claves como parte de su práctica de seguridad, o revocar una clave específica si se expone inadvertidamente o si desea dejar de usar el servicio con el que está asociada.
-Si tu organización necesita más del límite incorporado de 50 claves de API, ponte en contacto con [Asistencia técnica][19] para solicitar información sobre cómo aumentar tu límite.
+Si su organización necesita más de 50 claves de API integradas, comuníquese con [Soporte][19] para preguntar sobre el aumento de su límite.
-## Desactivar una cuenta de usuario
+## Deshabilitando una cuenta de usuario {#disabling-a-user-account}
-Cuando la cuenta de un usuario está desactivada, se revocan todas las claves de aplicación que haya creado ese usuario. No obstante, las claves de API creadas por la cuenta desactivada no se eliminarán y seguirán siendo válidas.
+Si la cuenta de un usuario está deshabilitada, se revocan las claves de aplicación que el usuario creó. Cualquier clave de API que fue creada por la cuenta deshabilitada no se elimina y sigue siendo válida.
-## Transferir claves
+## Transferencia de claves {#transferring-keys}
-Por motivos de seguridad, Datadog no transfiere claves de aplicaciones de un usuario a otro. Si necesitas compartir una clave de aplicación, utiliza una [cuenta de servicio][20].
+Por razones de seguridad, Datadog no transfiere claves de aplicación de un usuario a otro. Si necesita compartir una clave de aplicación, utilice una [cuenta de servicio][20].
-## Qué hacer si una clave de API o aplicación se ve expuesta
+## Qué hacer si una clave de API o de aplicación fue expuesta {#what-to-do-if-an-api-or-application-key-was-exposed}
-Si alguna clave privada está en riesgo o se ha filtrado públicamente, se deben tomar medidas lo antes posible para garantizar la seguridad de la cuenta. Eliminar el archivo que contiene la clave de un sitio público como GitHub **no** garantiza que otras personas no hayan accedido ya a él.
+Si una clave privada ha sido comprometida o expuesta públicamente, se deben tomar medidas lo más rápido posible para garantizar la seguridad de su cuenta. Eliminar el archivo que contiene la clave de un sitio público como GitHub **no** garantiza que no haya sido accedido por otra parte.
-Sigue estos pasos para proteger tu cuenta:
+Siga estos pasos para ayudar a proteger su cuenta:
-**Nota:** Revocar una clave activa puede afectar a tus servicios. Si el contexto de uso es amplio o indeterminado, plantéate seguir los pasos del 2 al 5 **antes** de revocar la clave afectada.
+**Nota:** Revocar una clave activa puede causar un impacto en sus servicios. Si el alcance de uso es amplio o indeterminado, considere los pasos 2-5 **antes de** revocar la clave afectada.
-1. Revoca la clave afectada.
-2. Elimina el código que contiene la clave privada de cualquier archivo con acceso público:
- - Publica el archivo saneado en tu repositorio público.
- - Elimina los datos confidenciales de tu historial de confirmaciones.
-3. Crea una clave nueva.
-4. Actualiza los servicios afectados con la nueva clave.
-5. Revisa la cuenta para comprobar si ha habido algún acceso no autorizado:
- - Usuarios añadidos recientemente
+1. Revocar la clave afectada.
+2. Eliminar el código que contiene la clave privada de cualquier archivo accesible públicamente:
+ - Publique el archivo sanitizado en su repositorio público.
+ - Elimine los datos sensibles de su historial de commits.
+3. Cree una nueva clave.
+4. Actualice los servicios afectados con la nueva clave.
+5. Revise su cuenta en busca de accesos no aprobados:
+ - Usuarios que han sido añadidos recientemente
- Nuevos recursos
- - Cambios en permisos o roles
+ - Cambios en roles o permisos
-Si detectas alguna actividad inusual o necesitas más ayuda para proteger tu cuenta, ponte en contacto con [Asistencia técnica de Datadog][19].
+Si se identifica alguna actividad inusual, o necesita ayuda adicional para asegurar su cuenta, comuníquese con [Soporte][19].
-## Solucionar problemas
+## Resolución de problemas {#troubleshooting}
-¿Necesitas ayuda? Ponte en contacto con el [servicio de asistencia de Datadog][19].
+¿Necesita ayuda? Contacte a [Soporte][19].
[1]: https://app.datadoghq.com/organization-settings/api-keys
[2]: https://app.datadoghq.com/organization-settings/application-keys
@@ -196,4 +196,6 @@ Si detectas alguna actividad inusual o necesitas más ayuda para proteger tu cue
[18]: /es/api/latest/service-accounts/
[19]: /es/help/
[20]: /es/account_management/org_settings/service_accounts/
-[21]: /es/api/latest/action-connection/#register-a-new-app-key
\ No newline at end of file
+[21]: /es/api/latest/action-connection/#register-a-new-app-key
+[22]: /es/account_management/audit_trail/#setup
+[23]: /es/account_management/rbac/permissions/#compliance
\ No newline at end of file
diff --git a/content/es/account_management/rbac/permissions.md b/content/es/account_management/rbac/permissions.md
index a216baf107d..ebfe0791db3 100644
--- a/content/es/account_management/rbac/permissions.md
+++ b/content/es/account_management/rbac/permissions.md
@@ -1,79 +1,86 @@
---
algolia:
- category: Documentación
+ category: Documentation
rank: 80
- subcategory: Permisos de Rol en Datadog
+ subcategory: Datadog Role Permissions
aliases:
- /es/account_management/faq/managing-global-role-permissions
-description: Referencia completa de los permisos de Datadog, incluidas los roles gestionados,
- los roles personalizados, los permisos confidenciales y la lista de permisos.
+description: Referencia completa de los permisos de Datadog, incluyendo roles gestionados,
+ roles personalizados, permisos sensibles y la lista de permisos.
disable_toc: true
further_reading:
- link: /account_management/rbac/
tag: Documentación
- text: Aprende cómo crear, actualizar y borrar un rol.
+ text: Aprenda cómo crear, actualizar y eliminar un Rol
- link: /api/v2/roles/#list-permissions
tag: Documentación
- text: Gestiona tus permisos con la API de permisos.
-title: Permisos de rol en Datadog
+ text: Administre sus permisos con la API de Permisos
+title: Permisos de Rol de Datadog
---
+## Permisos {#permissions}
-## Permisos
+Los permisos definen el tipo de acceso que un usuario tiene a un recurso determinado. Típicamente, los permisos otorgan a un usuario el derecho a leer, editar o eliminar un objeto. Los permisos subyacen a los derechos de acceso de todos los roles, incluyendo los tres roles gestionados y los roles personalizados.
-Los permisos definen el tipo de acceso que tiene un usuario a un recurso determinado. Por lo general, los permisos otorgan a un usuario el derecho a leer, editar o eliminar un objeto. Los permisos son la base de los derechos de acceso de todos los roles, incluidos los tres roles gestionados y los roles personalizados.
+### Permisos sensibles {#sensitive-permissions}
-### Permisos sensibles
+Algunos permisos de Datadog proporcionan acceso a funcionalidades más privilegiadas que es importante conocer, tales como:
-Algunos permisos de Datadog proporcionan acceso a funcionalidades más privilegiadas, que es importante conocer, como por ejemplo:
-
-- Acceso para cambiar parámetros de la organización
-- Acceso para leer datos potencialmente confidenciales
+- Acceso para cambiar la configuración de la organización
+- Acceso para leer datos potencialmente sensibles
- Acceso para realizar operaciones privilegiadas
-Los permisos sensibles se marcan en las interfaces de Roles y Permisos para identificar que pueden necesitar un mayor análisis. Como práctica recomendada, los administradores que configuran las funciones deben prestar especial atención a estos permisos y confirmar cuáles de ellos están asignados a sus funciones y usuarios.
+Los permisos sensibles están marcados en las interfaces de Roles y Permisos para identificar que pueden necesitar un mayor escrutinio. Como mejor práctica, los administradores que configuran roles deben prestar especial atención a estos permisos y confirmar cuáles de estos permisos están asignados a sus roles y usuarios.
+
+### Permisos en modo de vista previa {#preview-mode-permissions}
+
+Algunos permisos aparecen en "modo de vista previa" antes de ser completamente aplicados. Durante este período:
+
+- Los permisos de vista previa se marcan en la aplicación con una insignia de "Vista previa"
+- No restringen el acceso hasta que finaliza el período de vista previa
+- La vista previa generalmente dura de 2 a 4 semanas antes de que comience la aplicación
+- Los administradores deben configurar los roles adecuadamente durante este período
-### Permisos del modo de vista previa
+El modo de vista previa le da a los administradores de su organización la capacidad de optar por ciertos nuevos permisos, para que puedan evitar perder acceso a recursos que anteriormente no estaban restringidos. Las notas de la versión asociadas con cada permiso de modo de vista previa indican cuándo se crea el permiso y cuándo se aplicará. Si bien estos permisos no restringen el acceso durante la vista previa, Datadog recomienda actualizar las configuraciones de roles antes de que se apliquen para evitar interrupciones.
-Algunos permisos aparecen en "modo de vista previa" antes de aplicarse plenamente. Durante este periodo:
+## Roles {#roles}
-- Los permisos de vista previa se marcan en la aplicación con un distintivo de "Vista previa".
-- No restringen el acceso hasta que finaliza el periodo de vista previa
-- La vista previa suele durar de 2 a 4 semanas antes de que comience la ejecución.
-- Los administradores deben configurar roles apropiados durante este período
+### Roles gestionados {#managed-roles}
-El modo de vista previa ofrece a los administradores de tu organización la posibilidad de optar por determinados permisos nuevos, de modo que puedan evitar perder el acceso a recursos que antes no tenían restricciones. Las notas de la versión asociadas a cada permiso del modo de vista previa indican cuándo se crea el permiso y cuándo se aplicará. Aunque estos permisos no restringen el acceso durante la vista previa, Datadog recomienda actualizar las configuraciones de roles antes de que entren en vigor para evitar interrupciones.
+Por defecto, los usuarios existentes están asociados con uno de los tres roles gestionados:
-## Roles
+- Rol de Administrador de Datadog
+- Rol Estándar de Datadog
+- Rol de Datadog Read Only
-### Roles gestionados
+Todos los usuarios con uno de estos roles pueden leer datos, excepto por los recursos [individualmente restringidos para lectura][1]. Los usuarios de Datadog Admin y de Datadog Standard tienen permisos de escritura sobre los activos. Los usuarios de Datadog Admin tienen permisos adicionales de lectura y escritura para activos sensibles relacionados con la gestión de usuarios, la gestión de organizaciones, la facturación y el uso.
-Por defecto, los usuarios existentes están asociados a uno de los tres roles gestionados:
+Los roles gestionados son creados y mantenidos por Datadog. Sus permisos pueden ser actualizados automáticamente por Datadog a medida que se agregan nuevas funciones o cambian los permisos. Los usuarios no pueden modificar roles administrados directamente, pero pueden clonarlos para crear [roles personalizados](#custom-roles) con permisos específicos. Si es necesario, los usuarios pueden eliminar roles administrados de su cuenta.
-- Rol de administrador de Datadog
-- Rol estándar de Datadog
-- Rol de sólo lectura de Datadog
+### Roles personalizados {#custom-roles}
-Todos los usuarios con uno de estos roles pueden leer datos, excepto los recursos [con restricción de lectura individual][1]. Los usuarios Admin y Standard tienen permisos de escritura sobre los recursos. Los usuarios Admin tienen permisos adicionales de lectura y escritura para activos confidenciales relacionados con la gestión de usuarios, la gestión de la organización, la facturación y el uso.
+Crea un rol personalizado para combinar permisos en nuevos roles. Un rol personalizado te da la capacidad de definir una persona, por ejemplo, un administrador de facturación, y luego asignar los permisos apropiados para ese rol. Después de crear un rol, asigna o elimina permisos a este rol directamente [actualizando el rol en Datadog][2], o a través de la [API de Permisos de Datadog][3]. También puedes agregar un permiso a múltiples roles personalizados a la vez seleccionando esos roles desde la página de Roles y presionando {{< ui >}}Add Permission{{< /ui >}}.
-Los roles gestionados son creados y mantenidos por Datadog. Sus permisos pueden ser actualizados automáticamente por Datadog a medida que se añaden nuevas funciones o cambian los permisos. Los usuarios no pueden modificar los roles gestionados directamente, pero pueden clonarlos para crear [roles personalizados](#custom-roles) con permisos específicos. Si es necesario, los usuarios pueden eliminar roles gestionados de sus cuentas.
+A diferencia de los roles gestionados, los roles personalizados no reciben nuevos permisos cuando Datadog lanza nuevos productos y características, a menos que estén configurados para recibir Actualizaciones Automáticas. Si las Actualizaciones Automáticas están desactivadas, los roles personalizados solo reciben nuevos permisos para mantener la compatibilidad cuando Datadog lanza un nuevo permiso que limita la funcionalidad existente.
-### Roles personalizados
+Para configurar Actualizaciones Automáticas para roles personalizados:
-Crea un rol personalizado para combinar permisos en nuevos roles. Un rol personalizado te permite definir una persona, por ejemplo, un administrador de facturación, y luego asignar los permisos apropiados para ese rol. Después de crear un rol, asigna permisos a este rol o elimínalos directamente [updating the role in Datadog (actualizando el rol en Datadog)][2], o a través de la [Datadog Permission API (API de permiso de Datadog)][3].
+1. Ve a la página de Configuración de la Organización y haz clic en la {{< ui >}}Roles{{< /ui >}} pestaña.
+2. Haz clic en el rol que deseas actualizar y haz clic en {{< ui >}}Edit Role{{< /ui >}}.
+3. Bajo {{< ui >}}Automatically Receives Permissions{{< /ui >}}, elige una opción del menú desplegable: Ninguno, Rol de Datadog Read Only, Rol Estándar de Datadog o Rol de Administrador de Datadog.
-A diferencia de los roles gestionados, los roles personalizados no reciben nuevos permisos cuando Datadog lanza nuevos productos y funciones. Los roles personalizados solo reciben nuevos permisos para mantener la compatibilidad cuando Datadog lanza un nuevo permiso que bloquea una funcionalidad existente.
+Si el rol personalizado está configurado para recibir actualizaciones automáticas, tu rol personalizado recibe cualquier nuevo permiso cada vez que se lanzan a la plantilla de rol seleccionada. No se añaden permisos ya lanzados. Puedes agregar o eliminar cualquier permiso de este rol y continuar recibiendo actualizaciones automáticas.
-**Nota**: Al añadir un nuevo rol personalizado a un usuario, asegúrate de eliminar el rol de Datadog gestionado, asociado a ese usuario, para aplicar los permisos del nuevo rol.
+**Nota**: Al agregar un nuevo rol personalizado a un usuario, asegúrate de eliminar el rol gestionado de Datadog asociado con ese usuario para hacer cumplir estrictamente los nuevos permisos del rol.
-## Lista de permisos
+## Lista de permisos {#permissions-list}
-La siguiente tabla muestra el nombre, la descripción y el rol predeterminado de todos los permisos disponibles en Datadog. Cada tipo de recurso tiene sus correspondientes permisos de lectura y escritura.
+La siguiente tabla enumera el nombre, la descripción y el rol predeterminado para todos los permisos disponibles en Datadog. Cada tipo de activo tiene permisos de lectura y escritura correspondientes.
-Cada rol gestionado hereda todos los permisos de los roles menos potentes. Por lo tanto, el rol Estándar de Datadog tiene todos los permisos que se indican en la tabla con Datadog Sólo Lectura como rol por defecto. Además, el rol Administrador de Datadog contiene todos los permisos del rol Estándar de Datadog y del rol de Sólo lectura de Datadog.
+Cada rol gestionado hereda todos los permisos de los roles menos poderosos. Por lo tanto, el Rol Estándar de Datadog tiene todos los permisos listados en la tabla con Datadog Read Only como rol predeterminado. Además, el Rol de Datadog Admin contiene todos los permisos tanto del Rol de Datadog Standard como del Rol de Datadog Read Only.
{{% permissions %}}
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/agent/_index.md b/content/es/agent/_index.md
index 6a4a9e73378..4f8a4943c32 100644
--- a/content/es/agent/_index.md
+++ b/content/es/agent/_index.md
@@ -21,88 +21,91 @@ cascade:
rank: 80
tags:
- agent
-description: Instala y configura el Agente para recopilar datos
+description: Instale y configure el Agente para recopilar datos
further_reading:
- link: /logs/
tag: Documentación
- text: Recopila tus registros
+ text: Recopile sus registros
- link: /infrastructure/process/
tag: Documentación
- text: Recopila tus procesos
+ text: Recopile sus procesos
- link: /tracing/
tag: Documentación
- text: Recopila tus trazas
+ text: Recopile sus trazas
- link: /agent/faq/why-should-i-install-the-agent-on-my-cloud-instances/
tag: Documentación
text: ¿Por qué instalar el Agente en instancias en la nube?
- link: https://www.datadoghq.com/blog/dont-fear-the-agent/
tag: Blog
- text: No temas al Agente
+ text: No tema al Agente
+- link: https://learn.datadoghq.com/courses/agent-on-host
+ tag: Centro de Aprendizaje
+ text: El Agente en un Servidor
title: Agente
---
## Resumen {#overview}
-El Agente de Datadog es un software que se ejecuta en tus hosts. Recopila eventos y métricas de los hosts y los envía a Datadog, donde puedes analizar tus datos de monitoreo y rendimiento. El Agente de Datadog es de código abierto y su código fuente está disponible en GitHub en [DataDog/datadog-agent][1].
+El Agente de Datadog es un software que se ejecuta en sus servidores. Recopila eventos y métricas de los servidores y los envía a Datadog, donde puede analizar sus datos de monitoreo y rendimiento. El Agente de Datadog es de código abierto y su código fuente está disponible en GitHub en [DataDog/datadog-agent][1].
{{< partial name="platforms/platforms.html" links="platforms" >}}
-Datadog recomienda que actualices el Agente de Datadog con cada lanzamiento menor y de parches, o, como mínimo, mensualmente.
+Datadog recomienda que actualice el Agente de Datadog con cada versión menor y de parche, o, como mínimo, mensualmente.
-Actualizar a una versión principal del Agente de Datadog y mantenerlo actualizado es la única forma soportada de obtener la última funcionalidad y correcciones del Agente.
-
Se recomienda instalar completamente el Agente. Sin embargo, un paquete independiente de DogStatsD está disponible para Amazon Linux, CentOS, Debian, Fedora, Red Hat, SUSE y Ubuntu. Este paquete se utiliza en entornos contenedorizados donde DogStatsD se ejecuta como un sidecar o en entornos que ejecutan un servidor DogStatsD sin la funcionalidad completa del Agente.
+Actualizar a una versión principal del Agente de Datadog y mantenerlo actualizado es la única forma soportada para obtener la última funcionalidad y correcciones del Agente.
+
Se recomienda instalar completamente el Agente. Sin embargo, hay un paquete independiente de DogStatsD disponible para Amazon Linux, CentOS, Debian, Fedora, Red Hat, SUSE y Ubuntu. Este paquete se utiliza en entornos contenedorizados donde DogStatsD se ejecuta como un sidecar o en entornos que ejecutan un servidor DogStatsD sin la funcionalidad completa del Agente.
## Gestión del Agente {#managing-the-agent}
### Gestión del Agente con Automatización de Flota (recomendado) {#managing-the-agent-with-fleet-automation-recommended}
-[Automatización de Flota][15] es el flujo de trabajo principal dentro de la aplicación para instalar, actualizar, configurar y solucionar problemas del Agente de Datadog a gran escala.
+[Fleet Automation][15] es el flujo de trabajo principal en la aplicación para instalar, actualizar, configurar y solucionar problemas del Agente de Datadog a gran escala.
-{{< img src="/agent/basic_agent_usage/basic_agent_2_july_25.png" alt="La vista de Automatización de Flota que permite gestionar centralmente sus Agentes de Datadog en un solo lugar." style="width:100%;">}}
+{{< img src="/agent/basic_agent_usage/basic_agent_2_july_25.png" alt="La vista de Fleet Automation que le permite gestionar centralmente sus Agentes de Datadog en un solo lugar." style="width:100%;">}}
-- **Ver configuración e historial**: Ver cada Agente en su flota, su versión, productos habilitados, archivos de configuración y cambios históricos desde una sola página.
-- **[Actualizar Agentes desactualizados][13]**: Activar actualizaciones remotas para sus Agentes y mantener su flota actualizada con unos pocos clics.
-- **[Enviar una señal para soporte][14]**: Desde la pestaña de Soporte de un host, generar una señal y adjuntarla a un caso de Soporte existente o nuevo sin tener que usar la línea de comandos.
-- **Auditar el uso de la clave API**: Identificar qué Agentes están utilizando una clave API específica y rotar claves de manera segura.
+- **{{< ui >}}View configuration & history{{< /ui >}}**: Vea cada Agente en su flota, su versión, productos habilitados, archivos de configuración y cambios históricos desde una sola página.
+- **[Upgrade outdated Agents][13]**: Inicie actualizaciones remotas para sus Agentes y mantenga actualizada su flota en unos pocos clics.
+- **[Send a flare for support][14]**: Desde la pestaña {{< ui >}}Support{{< /ui >}} de un servidor, genere un flare y adjúntelo a una incidencia de soporte existente o nueva sin tener que usar la línea de comandos.
+- **Auditar el uso de la clave de API**: Identifique cuáles agentes están utilizando una clave de API específica y rote las claves de manera segura.
-### Interfaz Gráfica del Administrador del Agente de Datadog {#datadog-agent-manager-gui}
+### Datadog Agent Manager GUI {#datadog-agent-manager-gui}
La interfaz gráfica del Agente no es compatible con plataformas Windows de 32 bits.
-Utilice la interfaz gráfica del Administrador del Agente de Datadog para:
-- Ver la información de estado de su Agente
-- Ver todas las verificaciones en ejecución
-- Ver el registro del Agente
-- Editar el archivo de configuración del Agente (`datadog.yaml`)
-- Agregar o editar verificaciones de Agente
-- Enviar bengalas
+Usa la interfaz gráfica del Administrador del Agente de Datadog para:
+- Vea la información de estado de su Agente
+- Vea todas las verificaciones en ejecución
+- Vea el registro del Agente
+- Edite el archivo de configuración del Agente (`datadog.yaml`)
+- Agregue o edite las verificaciones del Agente.
+- Envíe flares.
-La interfaz gráfica del administrador de Agente de Datadog está habilitada por defecto en Windows y macOS, y se ejecuta en el puerto `5002`. Utiliza el comando `datadog-agent launch-gui` para abrir la interfaz gráfica en tu navegador web predeterminado.
+La interfaz gráfica del administrador del Agente de Datadog está habilitada por defecto en Windows y macOS, y se ejecuta en el puerto `5002`. Utilice el comando `datadog-agent launch-gui` para abrir la interfaz gráfica en su navegador web predeterminado.
-Puedes cambiar el puerto predeterminado de la interfaz gráfica en tu archivo de configuración `datadog.yaml`. Para deshabilitar la interfaz gráfica, establece el valor del puerto en `-1`. En Linux, la interfaz gráfica está deshabilitada por defecto.
+Puede cambiar el puerto predeterminado de la interfaz gráfica en su archivo de configuración `datadog.yaml`. Para deshabilitar la interfaz gráfica, establezca el valor del puerto en `-1`. En Linux, la interfaz gráfica está deshabilitada por defecto.
Requisitos de la interfaz gráfica:
-- Las cookies deben estar habilitadas en tu navegador. La interfaz gráfica genera y guarda un token en tu navegador, que se utiliza para autenticar todas las comunicaciones con el servidor de la interfaz gráfica.
-- Para iniciar la interfaz gráfica, el usuario debe tener los permisos requeridos. Si puedes abrir `datadog.yaml`, puedes usar la interfaz gráfica.
-- Por razones de seguridad, la interfaz gráfica solo puede ser accedida desde la interfaz de red local (`localhost`/`127.0.0.1`), por lo tanto, debes estar en el host donde se está ejecutando el Agente. No puedes ejecutar el Agente en una máquina virtual o un contenedor y acceder a él desde la máquina host.
+- Las cookies deben estar habilitadas en su navegador. La interfaz gráfica genera y guarda un token en su navegador, que se utiliza para autenticar todas las comunicaciones con el servidor de la interfaz gráfica.
+- Para iniciar la interfaz gráfica, el usuario debe tener los permisos requeridos. Si puede abrir `datadog.yaml`, puede usar la interfaz gráfica.
+- Por razones de seguridad, la interfaz gráfica solo puede **ser accedida** desde la interfaz de red local (`localhost`/`127.0.0.1`), por lo tanto, debe estar en el servidor donde se está ejecutando el Agente. No puede ejecutar el Agente en una máquina virtual o un contenedor y acceder a él desde el servidor.
### Interfaz de línea de comandos {#command-line-interface}
-Desde el Agente 6 en adelante, la interfaz de línea de comandos del Agente se basa en subcomandos. Para una lista completa de subcomandos del Agente, consulta [Comandos del Agente][2].
+A partir del Agente 6 y versiones posteriores, la interfaz de línea de comandos del Agente se basa en subcomandos. Para una lista completa de los subcomandos del Agente, consulte [Comandos del Agente][2].
## Avanzando más con el Agente de Datadog {#getting-further-with-the-datadog-agent}
-### Actualizar el Agente {#update-the-agent}
+### Actualice el Agente {#update-the-agent}
-Para actualizar manualmente el núcleo del Agente de Datadog entre dos versiones menores en un host determinado, ejecute el [comando de instalación correspondiente para su plataforma][7].
+Para actualizar manualmente el núcleo del Agente de Datadog entre dos versiones menores en un servidor determinado, ejecute el [comando de instalación correspondiente para su plataforma][7].
**Nota**: Si desea actualizar manualmente una integración específica del Agente, consulte la [guía de Gestión de Integraciones][8].
@@ -120,17 +123,17 @@ site: {{< region-param key="dd_site" >}}
**Nota**: Consulte la [documentación de Introducción a los Sitios de Datadog][11] para más detalles sobre el parámetro `site`.
-### Ubicación de los registros {#log-location}
+### Ubicación de registros {#log-location}
Consulte la [documentación de archivos de registro del Agente][12].
## Sobrecarga del Agente {#agent-overhead}
-Un ejemplo del consumo de recursos del Agente de Datadog se muestra a continuación. Se realizaron pruebas en una instancia de máquina Amazon EC2 `c5.xlarge` (4 VCPU/ 8GB RAM) y se observó un rendimiento comparable en instancias basadas en ARM64 con recursos similares. El `datadog-agent` estándar se estaba ejecutando con un chequeo de proceso para monitorear el Agente en sí. Habilitar más integraciones puede aumentar el consumo de recursos del Agente.
-Habilitar las verificaciones de JMX obliga al Agente a usar más memoria dependiendo del número de beans expuestos por las JVMs monitoreadas. Habilitar los Agentes de traza y proceso también aumenta el consumo de recursos.
+Un ejemplo del consumo de recursos del Agente de Datadog se muestra a continuación. Se realizaron pruebas en una instancia de máquina Amazon EC2 `c5.xlarge` (4 VCPU/ 8GB RAM) y se observó un rendimiento comparable en instancias basadas en ARM64 con recursos similares. La versión vanilla `datadog-agent` estaba ejecutándose con una verificación de proceso para monitorear el propio Agente. Habilitar más integraciones puede aumentar el consumo de recursos del Agente.
+Habilitar las verificaciones JMX obliga al Agente a usar más memoria dependiendo del número de beans expuestos por las JVMs monitoreadas. Habilitar los Agentes de traza y de proceso también incrementa el consumo de recursos.
* Versión de prueba del Agente: 7.34.0
-* CPU: ~ 0.08% del CPU utilizado en promedio
+* CPU: ~ 0.08% de la CPU utilizada en promedio.
* Memoria: ~ 130MB de RAM utilizada (memoria RSS)
* Ancho de banda de red: ~ 140 B/s ▼ | 800 B/s ▲
* Disco:
@@ -145,7 +148,7 @@ Los resultados a continuación se obtienen de una colección de *110KB de regist
{{% tab "Nivel de compresión HTTP 6" %}}
* Versión de prueba del Agente: 6.15.0
-* CPU: ~ 1.5% del CPU utilizado en promedio
+* CPU: ~ 1.5% de la CPU utilizada en promedio.
* Memoria: ~ 95MB de RAM utilizada.
* Ancho de banda de red: ~ 14 KB/s ▲
@@ -153,7 +156,7 @@ Los resultados a continuación se obtienen de una colección de *110KB de regist
{{% tab "Nivel de compresión HTTP 1" %}}
* Versión de prueba del Agente: 6.15.0
-* CPU: ~ 1% del CPU utilizado en promedio
+* CPU: ~ 1% de la CPU utilizada en promedio.
* Memoria: ~ 95MB de RAM utilizada.
* Ancho de banda de red: ~ 20 KB/s ▲
@@ -161,7 +164,7 @@ Los resultados a continuación se obtienen de una colección de *110KB de regist
{{% tab "HTTP sin comprimir" %}}
* Versión de prueba del Agente: 6.15.0
-* CPU: ~ 0.7% de la CPU utilizada en promedio
+* CPU: ~ 0.7% de la CPU utilizada en promedio.
* Memoria: ~ 90MB de RAM utilizada (memoria RSS)
* Ancho de banda de red: ~ 200 KB/s ▲
@@ -172,17 +175,17 @@ Los resultados a continuación se obtienen de una colección de *110KB de regist
## Recursos adicionales {#additional-resources}
{{< whatsnext desc="Esta sección incluye los siguientes temas:">}}
{{< nextlink href="/agent/kubernetes">}}Kubernetes: Instalar y configurar el Agente de Datadog en Kubernetes.{{< /nextlink >}}
- {{< nextlink href="/agent/cluster_agent">}}Agente de Clúster: Instalar y configurar el Agente de Clúster para Kubernetes, una versión del Agente de Datadog diseñada para recopilar datos de monitoreo de manera eficiente desde un clúster orquestado.{{< /nextlink >}}
+ {{< nextlink href="/agent/cluster_agent">}}Agente de clúster: Instalar y configurar el Agente de clúster para Kubernetes, una versión del Agente de Datadog diseñada para recopilar datos de monitoreo de manera eficiente en un clúster orquestado.{{< /nextlink >}}
{{< nextlink href="/agent/amazon_ecs">}}Amazon ECS: Instalar y configurar el Agente de Datadog en Amazon ECS.{{< /nextlink >}}
{{< nextlink href="integrations/ecs_fargate/">}}AWS Fargate: Instalar y configurar el Agente de Datadog con Amazon ECS en AWS Fargate{{< /nextlink >}}
- {{< nextlink href="/agent/iot">}}IoT: Instalar y configurar el Agente de IoT de Datadog, una versión del Agente de Datadog optimizada para monitorear dispositivos IoT y aplicaciones embebidas.{{< /nextlink >}}
+ {{< nextlink href="/agent/iot">}}IoT: Instalar y configurar el Agente de IoT de Datadog, una versión del Agente de Datadog optimizada para el seguimiento de dispositivos IoT y aplicaciones embebidas.{{< /nextlink >}}
{{< nextlink href="/agent/logs">}}Recolección de Registros: Habilitar y configurar la recolección de registros en el Agente de Datadog.{{< /nextlink >}}
{{< nextlink href="/agent/configuration/proxy">}}Proxy: Si la configuración de su red restringe el tráfico saliente, use un proxy para el tráfico del Agente.{{< /nextlink >}}
{{< nextlink href="/agent/versions/">}}Versiones: El Agente 7 es la última versión principal del Agente de Datadog. Conozca los cambios entre las versiones principales del Agente y cómo actualizar.{{< /nextlink >}}
- {{< nextlink href="/agent/troubleshooting">}}Solución de Problemas: Encuentre información sobre la solución de problemas para el Agente de Datadog.{{< /nextlink >}}
+ {{< nextlink href="/agent/troubleshooting">}}Solución de Problemas: Encuentre información de solución de problemas para el Agente de Datadog.{{< /nextlink >}}
{{< nextlink href="/agent/guide">}}Guías: Estos son tutoriales detallados, paso a paso, para usar el Agente.{{< /nextlink >}}
{{< nextlink href="/agent/security">}}Seguridad: Información sobre las principales capacidades y características de seguridad disponibles para los clientes para garantizar que su entorno esté seguro.{{< /nextlink >}}
- {{< nextlink href="/getting_started/observability_pipelines">}}Configurar Pipelines de Observabilidad y Datadog: Desplegar el Trabajador de Pipelines de Observabilidad como un agregador para recopilar, transformar y enrutar todos sus registros y métricas a cualquier destino.{{< /nextlink >}}
+ {{< nextlink href="/getting_started/observability_pipelines">}}Configurar Pipelines de Observabilidad y Datadog: Despliegue el Observability Pipelines Worker como un agregador para recopilar, transformar y dirigir todos sus registros y métricas a cualquier destino.{{< /nextlink >}}
{{< /whatsnext >}}
## Lectura Adicional {#further-reading}
diff --git a/content/es/agent/configuration/agent-commands.md b/content/es/agent/configuration/agent-commands.md
index 3e674da7535..74bf5541175 100644
--- a/content/es/agent/configuration/agent-commands.md
+++ b/content/es/agent/configuration/agent-commands.md
@@ -1,89 +1,88 @@
---
algolia:
tags:
- - comando del estado del Agent
+ - agent status command
aliases:
- /es/agent/faq/agent-status-and-information
- /es/agent/faq/start-stop-restart-the-datadog-agent
- /es/agent/faq/agent-commands
- /es/agent/guide/agent-commands
-description: Referencia completa de los comandos del Datadog Agent para iniciar, detener,
- solucionar problemas y gestionar el Agent.
+description: Referencia completa de los comandos del Agente de Datadog para iniciar,
+ detener, solucionar problemas y gestionar el Agente.
further_reading:
- link: /agent/troubleshooting/
tag: Documentación
- text: Solucionar problemas del Agent
-title: Comandos del Agent
+ text: Solución de problemas del Agente
+title: Comandos del Agente
---
-
-## Iniciar, detener y reiniciar el Agent
+## Iniciar, detener y reiniciar el Agente {#start-stop-and-restart-the-agent}
-### Iniciar el Agent
+### Iniciar el Agente {#start-the-agent}
-Lista de comandos para iniciar el Datadog Agent:
+Lista de comandos para iniciar el Agente de Datadog:
| Plataforma | Comando |
|------------|--------------------------------------------------------------------|
| AIX | `startsrc -s datadog-agent` |
-| Linux | Consulta la [documentación sobre el Agent][1] correspondiente a tu sistema operativo. |
-| Docker | Utiliza el [comando de instalación][2]. |
+| Linux | Consulte la [documentación del Agente][1] para su sistema operativo. |
+| Docker | Use el [comando de instalación][2]. |
| Kubernetes | `kubectl create -f datadog-agent.yaml` |
-| macOS | `launchctl start com.datadoghq.agent` *o* a través de la aplicación systray |
+| macOS | `launchctl start com.datadoghq.agent` *o* a través de la aplicación de la bandeja del sistema |
| Fuente | `sudo service datadog-agent start` |
-| Windows | Consulta la [documentación sobre el Windows Agent][3]. |
+| Windows | Consulte la [documentación del Agente de Windows][3]. |
-### Detener el Agent
+### Detenga el Agente {#stop-the-agent}
-Lista de comandos para detener el Datadog Agent:
+Lista de comandos para detener el Agente de Datadog:
| Plataforma | Comando |
|------------|----------------------------------------------------------------------------------|
| AIX | `stopsrc -s datadog-agent` |
-| Linux | Consulta la [documentación sobre el Agent][1] correspondiente a tu sistema operativo. |
+| Linux | Consulte la [documentación del Agente][1] para su sistema operativo. |
| Docker | `docker exec -it agent stop` |
-| Kubernetes | `kubectl delete pod `. Nota: El pod se reprograma automáticamente. |
-| macOS | `launchctl stop com.datadoghq.agent` *o* a través de la aplicación systray |
+| Kubernetes | `kubectl delete pod `—nota: el pod se reprograma automáticamente |
+| macOS | `launchctl stop com.datadoghq.agent` *o* a través de la aplicación de la bandeja del sistema |
| Fuente | `sudo service datadog-agent stop` |
-| Windows | Consulta la [documentación sobre el Windows Agent][3]. |
+| Windows | Consulte la [documentación del Agente de Windows][3]. |
-### Reinicio del Agent
+### Reinicie el Agente {#restart-the-agent}
-Lista de comandos para reiniciar el Datadog Agent:
+Lista de comandos para reiniciar el Agente de Datadog:
| Plataforma | Comando |
|------------|----------------------------------------------------------------------------------|
-| Linux | Consulta la [documentación sobre el Agent][1] correspondiente a tu sistema operativo. |
-| Docker | Utiliza el [comando de instalación][2]. |
-| Kubernetes | `kubectl delete pod `. Nota: El pod se reprograma automáticamente. |
-| macOS | Detener y luego iniciar el Agent con: `launchctl stop com.datadoghq.agent` `launchctl start com.datadoghq.agent` o utilizar la aplicación systray |
-| Fuente | *Plataforma no compatible* |
-| Windows | Consulta la [documentación sobre el Windows Agent][3]. |
+| Linux | Consulte la [documentación del Agente][1] para su sistema operativo. |
+| Docker | Use el [comando de instalación][2]. |
+| Kubernetes | `kubectl delete pod `—nota: el pod se reprograma automáticamente |
+| macOS | Detenga y luego inicie el Agente con: `launchctl stop com.datadoghq.agent` `launchctl start com.datadoghq.agent` O use la aplicación de la bandeja del sistema |
+| Fuente | * Plataforma no soportada * |
+| Windows | Consulte la [documentación del Agente de Windows][3]. |
-## Estado e información del Agent
+## Estado e información del Agente de Datadog {#agent-status-and-information}
-### Estado del servicio
+### Estado del servicio {#service-status}
-Lista de comandos para mostrar el estado del Datadog Agent:
+Lista de comandos para mostrar el estado del Agente de Datadog:
| Plataforma | Comando |
|-----------------|-------------------------------------------------------------------------------|
| AIX | `lssrc -s datadog-agent` |
-| Linux | Consulta la [documentación sobre el Agent][1] correspondiente a tu sistema operativo. |
+| Linux | Consulte la [documentación del Agente][1] para su sistema operativo. |
| Docker (Debian) | `sudo docker exec -it s6-svstat /var/run/s6/services/agent/` |
| Kubernetes | `kubectl exec -it -- s6-svstat /var/run/s6/services/agent/` |
-| macOS | `launchctl list com.datadoghq.agent` *o* a través de la aplicación systray |
+| macOS | `launchctl list com.datadoghq.agent` *o* a través de la aplicación de la bandeja del sistema |
| Fuente | `sudo service datadog-agent status` |
-| Windows | Consulta la [documentación del Agent Windows][4]. |
-| [Cluster Agent (Kubernetes)][5] | `datadog-cluster-agent status` |
+| Windows | Consulte la [documentación del Agente de Windows][4]. |
+| [Agente de clúster (Kubernetes)][5] | `datadog-cluster-agent status` |
-### Información del Agent
+### Información del Agente {#agent-information}
-Lista de comandos para mostrar el estado del Datadog Agent y las integraciones habilitadas.
+Lista de comandos para mostrar el estado del Agente de Datadog y las integraciones habilitadas.
| Plataforma | Comando |
|------------|------------------------------------------------------|
@@ -91,12 +90,12 @@ Lista de comandos para mostrar el estado del Datadog Agent y las integraciones h
| Linux | `sudo datadog-agent status` |
| Docker | `sudo docker exec -it agent status` |
| Kubernetes | `kubectl exec -it -- agent status` |
-| macOS | `datadog-agent status` o a través de la [GUI web][6] |
+| macOS | `datadog-agent status` o a través de la [interfaz gráfica web][6] |
| Fuente | `sudo datadog-agent status` |
-| Windows | Consulta la [documentación del Agent Windows][4]. |
-| [Cluster Agent (Kubernetes)][5] | `datadog-cluster-agent status` |
+| Windows | Consulte la [documentación del Agente de Windows][4]. |
+| [Agente de clúster (Kubernetes)][5] | `datadog-cluster-agent status` |
-Se mostrará una integración debidamente configurada en **Running Checks** (Checks en ejecución) sin que figuren avisos ni errores, tal y como aparece a continuación:
+Una integración correctamente configurada se muestra bajo **Verificaciones en ejecución** sin advertencias ni errores, como se ve a continuación:
```text
Running Checks
@@ -110,43 +109,46 @@ Running Checks
Average Execution Time : 0ms
```
-## Otros comandos
+## Otros comandos {#other-commands}
+
+La interfaz de línea de comandos del Agente se basa en subcomandos. Para ver la lista de subcomandos disponibles, ejecute:
-La interfaz de línea de comandos del Agent se basa en subcomandos. Para consultar la lista de subcomandos disponibles, ejecuta:
```shell
--help
```
-Para ejecutar un subcomando, se debe invocar el archivo binario del Agent:
+Para ejecutar un subcomando, se debe invocar el binario del Agente:
+
```shell
```
-Algunas opciones tienen marcas y opciones detalladas en el subcomando `--help`. For example, use help with the `check`:
+Algunas opciones tienen banderas y opciones detalladas en `--help`. Por ejemplo, utilice el subcomando `check` para obtener ayuda:
+
```shell
check --help
```
| Subcomando | Notas |
|-------------------|-----------------------------------------------------------------------------|
-| `check` | Ejecuta el check especificado. |
-| `config` | [Gestión de la configuración del tiempo de ejecución][7]. |
-| `configcheck` | Muestra todas las configuraciones cargadas y resueltas de un Agent en ejecución. |
-| `diagnose` | Realiza un diagnóstico de conectividad en tu sistema. |
-| `flare` | [Recopila una bengala y envíala a Datadog][8]. |
-| `health` | Muestra el estado en que se encuentra el Agent en el momento de la ejecución del subcomando. |
-| `help` | Ofrece ayuda con cualquier comando. |
-| `hostname` | Muestra el nombre de host que utiliza el Agent. |
-| `import` | Importa y convierte archivos de configuración de versiones anteriores del Agent. |
-| `jmx` | Soluciona problemas de JMX. |
-| `launch-gui` | Inicia la GUI del Datadog Agent. |
-| `restart-service` | Reinicia el Agent en el administrador de control de servicios. Solo en Windows. |
-| `start-service` | Inicia el Agent en el administrador de control de servicios. Solo en Windows. |
-| `stream-logs` | Transmite los logs que procesa un Agent en ejecución. |
-| `stopservice` | Detiene el Agent en el administrador de control de servicios. Solo en Windows. |
-| `version` | Muestra información acerca de la versión. |
-
-## Referencias adicionales
+| `check` | Ejecute la verificación especificada. |
+| `config` | [Gestión de configuración en tiempo de ejecución][7]. |
+| `configcheck` | Imprima todas las configuraciones cargadas y resueltas de un Agente en ejecución. |
+| `diagnose` | Ejecute un diagnóstico de conectividad en su sistema. |
+| `flare` | [Recolecte un flare y envíelo a Datadog][8]. |
+| `health` | Imprima la salud actual del Agente. |
+| `help` | Ayuda sobre cualquier comando. |
+| `hostname` | Imprima el nombre de host utilizado por el Agente. |
+| `import` | Importar y convertir archivos de configuración de versiones anteriores del Agente de Datadog. |
+| `jmx` | Solución de problemas de JMX. |
+| `launch-gui` | Iniciar la interfaz gráfica del Agente de Datadog. |
+| `restart-service` | Reiniciar el Agente dentro del administrador de control de servicios. Solo en Windows. |
+| `start-service` | Iniciar el Agente dentro del administrador de control de servicios. Solo en Windows. |
+| `stream-logs` | Transmitir los registros que está procesando un Agente en ejecución. |
+| `stopservice` | Detener el Agente dentro del administrador de control de servicios. Solo en Windows. |
+| `version` | Imprimir información de versión. |
+
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/agent/configuration/network.md b/content/es/agent/configuration/network.md
index e3775baefeb..51a95618c9a 100644
--- a/content/es/agent/configuration/network.md
+++ b/content/es/agent/configuration/network.md
@@ -15,29 +15,29 @@ aliases:
further_reading:
- link: /getting_started/site
tag: Documentación
- text: Aprende sobre el sitio de Datadog
+ text: Conoce el sitio de Datadog
- link: /logs/
tag: Documentación
- text: Recopila tus registros
+ text: Recoja sus registros
- link: /infrastructure/process
tag: Documentación
- text: Recopila tus procesos
+ text: Recoja sus procesos
- link: tracing
tag: Documentación
- text: Recopila tus trazas
+ text: Recoja sus trazas
title: Tráfico de red
---
## Resumen {#overview}
-El tráfico siempre es iniciado por el Agente hacia Datadog. Nunca se inician sesiones desde Datadog de regreso al Agente.
+El Agente siempre inicia el tráfico hacia Datadog. Datadog nunca inicia sesiones de regreso al Agente.
-Todo el tráfico del Agente se envía a través de SSL. El destino depende del servicio y sitio de Datadog. Para ver destinos basados en tu [sitio de Datadog][11], haz clic en el selector `DATADOG SITE` a la derecha.
+Todo el tráfico del Agente se envía a través de SSL. El destino depende del servicio y sitio de Datadog. Para ver destinos basados en su [sitio de Datadog][11], haga clic en el selector {{< ui >}}DATADOG SITE{{< /ui >}} a la derecha.
## Instalación {#installation}
-Agrega los siguientes dominios a tu lista de inclusión para permitir la instalación del Agente:
+Agregue los siguientes dominios a su lista de inclusión para permitir la instalación del Agente:
- `install.datadoghq.com`
- `yum.datadoghq.com`
@@ -54,50 +54,51 @@ Este comportamiento se puede desactivar en la versión 7.72.0 y posteriores conf
[APM][1]
: `trace.agent.`{{< region-param key="dd_site" code="true" >}}
-`instrumentation-telemetry-intake.`{{< region-param key="dd_site" code="true" >}}
+`instrumentación-telemetría-intake.`{{< region-param key="dd_site" code="true" >}}
-[LLM Observabilidad][23]
+[Observabilidad LLM][23]
: `llmobs-intake.`{{< region-param key="dd_site" code="true" >}}
-[Imágenes de Contenedor][13]
+[Imágenes de contenedores][13]
: `contimage-intake.`{{< region-param key="dd_site" code="true" >}}
-[Contenedores en Vivo][3], [Proceso en Vivo][4], [Monitoreo de Red en la Nube][24], [Monitoreo de Servicio Universal][25]
+[Contenedores en Vivo][3], [Procesos en Vivo][4], [Cloud Network Monitoring][24], [Universal Service Monitoring][25]
: `process.`{{< region-param key="dd_site" code="true" >}}
-[Monitoreo de Dispositivos de Red][10]
+[Network Device Monitoring][10]
: `ndm-intake.`{{< region-param key="dd_site" code="true" >}}
`snmp-traps-intake.`{{< region-param key="dd_site" code="true" >}}
`ndmflow-intake.`{{< region-param key="dd_site" code="true" >}}
-[Ruta de Red][14]
-: `netpath-intake.`{{< region-param key="dd_site" code="true" >}}
+[Network Path][14]
+: `netpath-intake.`{{< region-param key="dd_site" code="true" >}}
+En la versión 7.75+ del Agente, Network Path contacta servicios externos a través de HTTPS para resolver la IP pública del servidor de origen. Esto es opcional y la Ruta de Red funciona sin ello, pero si su red restringe el tráfico saliente y desea la resolución de IP pública de origen, agregue lo siguiente a su lista de permitidos: `icanhazip.com`, `ipinfo.io`, `checkip.amazonaws.com`, `api.ipify.org`, `whatismyip.akamai.com`. Consulte [Network Path Setup][33] para más detalles.
[Orquestador][5]
: `orchestrator.`{{< region-param key="dd_site" code="true" >}}
`contlcycle-intake.`{{< region-param key="dd_site" code="true" >}}
-[Perfilado][7]
+[Profiling][7]
: `intake.profile.`{{< region-param key="dd_site" code="true" >}}
-[Monitoreo de Usuario Real (RUM)][6]
+[Real User Monitoring (RUM)][6]
: {{< region-param key="browser_sdk_endpoint_domain" code="true" >}}
-[Vulnerabilidades de Seguridad en la Nube][29]
+[Cloud Security Vulnerabilities][29]
: `sbom-intake.`{{< region-param key="dd_site" code="true" >}}
-[Monitoreo Sintético en Ubicaciones Privadas][8]
-: Trabajador Sintético v1.5.0 o posterior: `intake.synthetics.`{{< region-param key="dd_site" code="true" >}} es el único punto final que necesitas configurar.
-Resultados de pruebas de API para el Trabajador Sintético > v0.1.6: `intake.synthetics.`{{< region-param key="dd_site" code="true" >}}
-Resultados de pruebas de navegador para el Trabajador Sintético > v0.2.0: `intake-v2.synthetics.`{{< region-param key="dd_site" code="true" >}}
-Resultados de pruebas de API para el Trabajador Sintético < v0.1.5: `api.`{{< region-param key="dd_site" code="true" >}}
+[Synthetic Monitoring Private Locations][8]
+: Synthetics Worker v1.5.0 o posterior: `intake.synthetics.`{{< region-param key="dd_site" code="true" >}} es el único punto de conexión que necesitas configurar.
+Resultados de pruebas de API para el Synthetics Worker > v0.1.6: `intake.synthetics.`{{< region-param key="dd_site" code="true" >}}
+Resultados de pruebas de navegador para el Synthetics Worker > v0.2.0: `intake-v2.synthetics.`{{< region-param key="dd_site" code="true" >}}
+Resultados de pruebas de API para el Synthetics Worker < v0.1.5: `api.`{{< region-param key="dd_site" code="true" >}}
{{% site-region region="us,eu,us3,us5,ap1,ap2" %}}
-[Configuración Remota][101]
+[Remote Configuration][101]
: `config.`{{< region-param key="dd_site" code="true" >}}
-[Monitoreo de Base de Datos][102]
+[Database Monitoring][102]
: `dbm-metrics-intake.`{{< region-param key="dd_site" code="true" >}}
`dbquery-intake.`{{< region-param key="dd_site" code="true" >}}
@@ -108,24 +109,24 @@ Resultados de pruebas de API para el Trabajador Sintético < v0.1.5: `api.`{{< r
{{% logs-tcp-disclaimer %}}
-[Registros][30] & [registros HIPAA][31]
+[Logs][30] & [HIPAA logs][31]
: (Obsoleto) TCP: {{< region-param key=tcp_endpoint code="true" >}}
HTTP: {{< region-param key=agent_http_endpoint code="true" >}}
-Otro: Ver [puntos finales de registros][32]
+Otros: Ver [puntos de conexión de logs][32]
-[Registros HIPAA legado][31] (Obsoleto, TCP no soportado)
+[Registros de HIPAA legado][31] (Obsoleto, TCP no soportado)
: {{< region-param key=hipaa_logs_legacy code="true" >}}
[Métricas][26], [Verificaciones de Servicio][27], [Eventos][28], y otros metadatos del Agente
: `-app.agent.`{{< region-param key="dd_site" code="true" >}}
-Por ejemplo, el Agente v7.31.0 reporta a `7-31-0-app.agent.`{{< region-param key="dd_site" code="true" >}}. Debes agregar `*.agent.`{{< region-param key="dd_site" code="true" >}} a tu lista de inclusión en tu(s) firewall(s).
-Desde v6.1.0, el Agente también consulta la API de Datadog para proporcionar funcionalidad no crítica (Por ejemplo, mostrar la validez de la clave API configurada):
-Agente v7.18.0 o 6.18.0 y versiones posteriores: `api.`{{< region-param key="dd_site" code="true" >}}
+Por ejemplo, el Agente v7.31.0 reporta a `7-31-0-app.agent.`{{< region-param key="dd_site" code="true" >}}Debes agregar `*.agent.`{{< region-param key="dd_site" code="true" >}} a tu lista de inclusión en tu(s) firewall(s).
+Desde la versión 6.1.0, el Agente también consulta la API de Datadog para proporcionar funcionalidades no críticas (por ejemplo, mostrar la validez de la clave API configurada):
+Agente v7.18.0 o 6.18.0 y posteriores: `api.`{{< region-param key="dd_site" code="true" >}}
Agente < v7.18.0 o 6.18.0: `app.`{{< region-param key="dd_site" code="true" >}}
[Agente flare][12]
: `-flare.agent.`{{< region-param key="dd_site" code="true" >}}
-Por ejemplo, el Agente v7.31.0 envía datos de flare a `7-31-0-flare.agent.`{{< region-param key="dd_site" code="true" >}}. Debes agregar `*.agent.`{{< region-param key="dd_site" code="true" >}} a tu lista de inclusión en tu(s) firewall(s).
+Por ejemplo, el Agente v7.31.0 envía datos de flare a `7-31-0-flare.agent.`{{< region-param key="dd_site" code="true" >}}Debes agregar `*.agent.`{{< region-param key="dd_site" code="true" >}} a tu lista de inclusión en tu(s) firewall(s).
### Direcciones IP estáticas {#static-ip-addresses}
@@ -161,21 +162,21 @@ La información está estructurada como JSON siguiendo este esquema:
Cada sección tiene un endpoint dedicado, por ejemplo:
- `https://ip-ranges.{{< region-param key="dd_site" >}}/logs.json` para las IPs utilizadas para recibir datos de logs a través de TCP.
-- `https://ip-ranges.{{< region-param key="dd_site" >}}/apm.json` para las IPs utilizadas para recibir datos de APM.
+- `https://ip-ranges.{{< region-param key="dd_site" >}}/apm.json` para las direcciones IP utilizadas para recibir datos de APM.
### Inclusión {#inclusion}
-Agrega todos los `ip-ranges` a tu lista de inclusión. Aunque solo un subconjunto está activo en un momento dado, hay variaciones a lo largo del tiempo dentro de todo el conjunto debido a la operación y mantenimiento regular de la red.
+Agregue todos los `ip-ranges` a su lista de inclusión. Aunque solo un subconjunto está activo en un momento dado, el conjunto completo varía con el tiempo debido a la operación y mantenimiento regulares de la red.
## Puertos abiertos {#open-ports}
-Todo el tráfico saliente se envía a través de SSL por TCP o UDP.
+Todo el tráfico saliente se envía a través de SSL mediante TCP o UDP.
-Asegúrate de que el Agente sea accesible solo por tus aplicaciones o fuentes de red de confianza utilizando una regla de firewall o una restricción de red similar. El acceso no confiable puede permitir que actores maliciosos realicen varias acciones invasivas, incluyendo, pero no limitado a, escribir trazas y métricas en tu cuenta de Datadog, o obtener información sobre tu configuración y servicios.
+Asegúrese de que el Agente sea accesible solo por sus aplicaciones o fuentes de red de confianza utilizando una regla de firewall o una restricción de red similar. El acceso no confiable puede permitir que actores maliciosos realicen varias acciones invasivas, incluyendo, pero no limitándose a, escribir trazas y métricas en su cuenta de Datadog, o obtener información sobre su configuración y servicios.
-Abre los siguientes puertos para beneficiarte de todas las funcionalidades del **Agente**:
+Abra los siguientes puertos para beneficiarse de todas las funcionalidades del **Agent**:
#### Saliente {#outbound}
@@ -183,10 +184,10 @@ Abre los siguientes puertos para beneficiarte de todas las funcionalidades del *
| Producto/Funcionalidad | Puerto | Protocolo | Descripción |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Agente APM Contenedores Procesos en Vivo Métricas Monitoreo de Red en la Nube Monitoreo Universal de Servicios | 443 | TCP | La mayoría de los datos del Agente utilizan el puerto 443. |
+| Agente APM Contenedores Procesos en Vivo Métricas Monitoreo de Red en la Nube Monitoreo de Servicio Universal | 443 | TCP | La mayoría de los datos del Agente utilizan el puerto 443. |
| [Escalado Automático de Agentes Personalizados][22] | 8443 | TCP | |
-| Recolección de registros | {{< region-param key=web_integrations_port >}} | (Obsoleto) TCP | Registro a través de TCP. **Nota**: La recolección de registros TCP **no está soportada**. Datadog no proporciona **garantías de entrega o confiabilidad** al usar TCP, y los datos de registro pueden perderse sin previo aviso. Para una ingestión confiable, utiliza el punto de entrada HTTP, un Agente oficial de Datadog o una integración de reenvío en su lugar. Para otros tipos de conexión, consulta [puntos finales de registros][21]. |
-| NTP | 123 | UDP | Protocolo de Tiempo de Red (NTP). Consulta [objetivos NTP predeterminados][20]. Para información sobre la solución de problemas de NTP, consulta [problemas de NTP][19]. |
+| Recolección de registros | {{< region-param key=web_integrations_port >}} | (Obsoleto) TCP | Registro por TCP. **Nota**: La recolección de registros por TCP **no está soportada**. Datadog proporciona **ninguna garantía de entrega o fiabilidad** al usar TCP, y los datos de registro pueden perderse sin previo aviso. Para una ingestión confiable, utilice el punto de entrada HTTP, un Agente oficial de Datadog o una integración de reenvío en su lugar. Para otros tipos de conexión, consulte [logs endpoints][21]. |
+| NTP | 123 | UDP | Network Time Protocol (NTP). Consulte [default NTP targets][20]. Para información sobre la solución de problemas de NTP, consulte [NTP issues][19]. |
[19]: /es/agent/faq/network-time-protocol-ntp-offset-issues/
[20]: /es/integrations/ntp/#overview
@@ -195,12 +196,12 @@ Abre los siguientes puertos para beneficiarte de todas las funcionalidades del *
{{% /site-region %}}
-{{% site-region region="us3,us5,gov,ap1,ap2" %}}
+{{% site-region region="us3,us5,gov,gov2,ap1,ap2" %}}
| Producto/Funcionalidad | Puerto | Protocolo | Descripción |
| ------------------------------------------------------------------------------------------------------------------- | ---- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| Agente APM Contenedores Procesos en Vivo Métricas Monitoreo de Red en la Nube Monitoreo de Servicio Universal | 443 | TCP | La mayoría de los datos del Agente utiliza el puerto 443. |
-| NTP | 123 | UDP | Protocolo de Tiempo de Red (NTP). Vea [objetivos NTP predeterminados][20]. Para información sobre la solución de problemas de NTP, vea [problemas de NTP][19]. |
+| Agent APM Containers Live Processes Metrics Cloud Network Monitoring Universal Service Monitoring | 443 | TCP | La mayoría de los datos del Agente utilizan el puerto 443. |
+| NTP | 123 | UDP | Network Time Protocol (NTP). Consulte [destinos NTP predeterminados][20]. Para obtener información sobre la solución de problemas de NTP, consulte [problemas de NTP][19]. |
[19]: /es/agent/faq/network-time-protocol-ntp-offset-issues/
[20]: /es/integrations/ntp/#overview
@@ -209,17 +210,17 @@ Abre los siguientes puertos para beneficiarte de todas las funcionalidades del *
#### Entrante {#inbound}
-Utilizado para servicios de Agente que se comunican entre sí localmente dentro del host solamente.
+Se utiliza para los servicios del agente que se comunican entre sí localmente dentro del servidor únicamente.
| Producto/Funcionalidad | Puerto | Protocolo | Descripción |
| ---------------------------- | ---- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| [Interfaz Gráfica del Navegador del Agente][16] | 5002 | TCP | |
+| [Interfaz gráfica del navegador del Agente][16] | 5002 | TCP | |
| Receptor APM | 8126 | TCP | Incluye Trazado y el Profiler. |
-| [DogStatsD][18] | 8125 | UDP | Puerto para DogStatsD a menos que `dogstatsd_non_local_traffic` esté configurado como verdadero. Este puerto está disponible en localhost IPv4: `127.0.0.1`. |
-| servidor go_expvar (APM) | 5012 | TCP | Para más información, vea [la documentación de integración de go_expar][15]. |
-| servidor de integración go_expvar | 5000 | TCP | Para más información, vea [la documentación de integración de go_expar][15]. |
-| API IPC | 5001 | TCP | Puerto utilizado para Comunicación entre Procesos (IPC). |
-| Depurador del Agente de Proceso | 6062 | TCP | Puntos finales de depuración para el Agente de Proceso. |
+| [DogStatsD][18] | 8125 | UDP | Puerto para DogStatsD a menos que `dogstatsd_non_local_traffic` esté configurado como true. Este puerto está disponible en localhost IPv4: `127.0.0.1`. |
+| servidor go_expvar (APM) | 5012 | TCP | Para más información, consulte [la documentación de integración de go_expvar][15]. |
+| servidor de integración go_expvar | 5000 | TCP | Para más información, consulte [la documentación de integración de go_expvar][15]. |
+| API IPC | 5001 | TCP | Puerto utilizado para la Comunicación entre Procesos (IPC). |
+| Depuración del Agente de Proceso | 6062 | TCP | Puntos finales de depuración para el Agente de Proceso. |
| Tiempo de ejecución del Agente de Proceso | 6162 | TCP | Configuraciones de tiempo de ejecución para el Agente de Proceso. |
## Configurar puertos {#configure-ports}
@@ -227,52 +228,52 @@ Utilizado para servicios de Agente que se comunican entre sí localmente dentro
Si necesita cambiar un puerto de entrada porque el puerto predeterminado ya está en uso por un servicio existente en su red, edite el archivo de configuración `datadog.yaml`. Puede encontrar la mayoría de los puertos en la sección **Configuración Avanzada** del archivo:
{{< code-block lang="yaml" filename="datadog.yaml" disable_copy="true" collapsible="true" >}}
-## @param expvar_port - integer - optional - default: 5000 {#param-expvar-port-integer-optional-default-5000}
-## @env DD_EXPVAR_PORT - integer - optional - default: 5000 {#env-dd-expvar-port-integer-optional-default-5000}
-## The port for the go_expvar server. {#the-port-for-the-go-expvar-server}
+## @param expvar_port - integer - optional - default: 5000 HEADANCHOR:param-expvar-port-integer-optional-default-5000:ENDANCHOR
+## @env DD_EXPVAR_PORT - integer - optional - default: 5000 HEADANCHOR:env-dd-expvar-port-integer-optional-default-5000:ENDANCHOR
+## The port for the go_expvar server. HEADANCHOR:the-port-for-the-go-expvar-server:ENDANCHOR
#
-# expvar_port: 5000 {#expvar-port-5000}
+# expvar_port: 5000 HEADANCHOR:expvar-port-5000:ENDANCHOR
-## @param cmd_port - integer - optional - default: 5001 {#param-cmd-port-integer-optional-default-5001}
-## @env DD_CMD_PORT - integer - optional - default: 5001 {#env-dd-cmd-port-integer-optional-default-5001}
-## The port on which the IPC api listens. {#the-port-on-which-the-ipc-api-listens}
+## @param cmd_port - integer - optional - default: 5001 HEADANCHOR:param-cmd-port-integer-optional-default-5001:ENDANCHOR
+## @env DD_CMD_PORT - integer - optional - default: 5001 HEADANCHOR:env-dd-cmd-port-integer-optional-default-5001:ENDANCHOR
+## The port on which the IPC api listens. HEADANCHOR:the-port-on-which-the-ipc-api-listens:ENDANCHOR
#
-# cmd_port: 5001 {#cmd-port-5001}
-
-## @param GUI_port - integer - optional {#param-gui-port-integer-optional}
-## @env DD_GUI_PORT - integer - optional {#env-dd-gui-port-integer-optional}
-## The port for the browser GUI to be served. {#the-port-for-the-browser-gui-to-be-served}
-## Setting 'GUI_port: -1' turns off the GUI completely {#setting-gui-port-1-turns-off-the-gui-completely}
-## Default is: {#default-is}
-## * Windows & macOS : `5002` {#windows-macos-5002}
-## * Linux: `-1` {#linux-1}
+# cmd_port: 5001 HEADANCHOR:cmd-port-5001:ENDANCHOR
+
+## @param GUI_port - integer - optional HEADANCHOR:param-gui-port-integer-optional:ENDANCHOR
+## @env DD_GUI_PORT - integer - optional HEADANCHOR:env-dd-gui-port-integer-optional:ENDANCHOR
+## The port for the browser GUI to be served. HEADANCHOR:the-port-for-the-browser-gui-to-be-served:ENDANCHOR
+## Setting 'GUI_port: -1' turns off the GUI completely HEADANCHOR:setting-gui-port-1-turns-off-the-gui-completely:ENDANCHOR
+## Default is: HEADANCHOR:default-is:ENDANCHOR
+## * Windows & macOS : `5002` HEADANCHOR:windows-macos-5002:ENDANCHOR
+## * Linux: `-1` HEADANCHOR:linux-1:ENDANCHOR
##
#
-# GUI_port: {#gui-port}
+# GUI_port: HEADANCHOR:gui-port:ENDANCHOR
{{< /code-block >}}
-El receptor APM y los puertos de DogStatsD se encuentran en las secciones **Configuración de Recolección de Trazas** y **Configuración de DogStatsD** del archivo de configuración `datadog.yaml`, respectivamente:
+Los puertos del receptor APM y DogStatsD se encuentran en las secciones **Configuración de Recolección de Trazas** y **Configuración de DogStatsD** del archivo de configuración `datadog.yaml`, respectivamente:
{{< code-block lang="yaml" filename="datadog.yaml" disable_copy="true" collapsible="true" >}}
-## @param dogstatsd_port - integer - optional - default: 8125 {#param-dogstatsd-port-integer-optional-default-8125}
-## @env DD_DOGSTATSD_PORT - integer - optional - default: 8125 {#env-dd-dogstatsd-port-integer-optional-default-8125}
-## Override the Agent DogStatsD port. {#override-the-agent-dogstatsd-port}
-## Note: Make sure your client is sending to the same UDP port. {#note-make-sure-your-client-is-sending-to-the-same-udp-port}
+## @param dogstatsd_port - integer - optional - default: 8125 HEADANCHOR:param-dogstatsd-port-integer-optional-default-8125:ENDANCHOR
+## @env DD_DOGSTATSD_PORT - integer - optional - default: 8125 HEADANCHOR:env-dd-dogstatsd-port-integer-optional-default-8125:ENDANCHOR
+## Override the Agent DogStatsD port. HEADANCHOR:override-the-agent-dogstatsd-port:ENDANCHOR
+## Note: Make sure your client is sending to the same UDP port. HEADANCHOR:note-make-sure-your-client-is-sending-to-the-same-udp-port:ENDANCHOR
#
-# dogstatsd_port: 8125 {#dogstatsd-port-8125}
+# dogstatsd_port: 8125 HEADANCHOR:dogstatsd-port-8125:ENDANCHOR
[...]
-## @param receiver_port - integer - optional - default: 8126 {#param-receiver-port-integer-optional-default-8126}
-## @env DD_APM_RECEIVER_PORT - integer - optional - default: 8126 {#env-dd-apm-receiver-port-integer-optional-default-8126}
-## The port that the trace receiver should listen on. {#the-port-that-the-trace-receiver-should-listen-on}
-## Set to 0 to disable the HTTP receiver. {#set-to-0-to-disable-the-http-receiver}
+## @param receiver_port - integer - optional - default: 8126 HEADANCHOR:param-receiver-port-integer-optional-default-8126:ENDANCHOR
+## @env DD_APM_RECEIVER_PORT - integer - optional - default: 8126 HEADANCHOR:env-dd-apm-receiver-port-integer-optional-default-8126:ENDANCHOR
+## The port that the trace receiver should listen on. HEADANCHOR:the-port-that-the-trace-receiver-should-listen-on:ENDANCHOR
+## Set to 0 to disable the HTTP receiver. HEADANCHOR:set-to-0-to-disable-the-http-receiver:ENDANCHOR
#
-# receiver_port: 8126 {#receiver-port-8126}
+# receiver_port: 8126 HEADANCHOR:receiver-port-8126:ENDANCHOR
{{< /code-block >}}
-
Si cambia el valor del puerto de DogStatsD o del puerto del receptor APM aquí, también debe cambiar la configuración de la biblioteca de trazado APM para el puerto correspondiente. Consulte la información sobre la configuración de puertos en la documentación de Configuración de la Biblioteca para su lenguaje.
+
Si cambia el valor del puerto de DogStatsD o del puerto del receptor APM aquí, también debe cambiar la configuración del SDK de Datadog para el puerto correspondiente. Consulte la información sobre la configuración de puertos en la documentación de Configuración de Biblioteca para su lenguaje.
## Usando proxies {#using-proxies}
@@ -281,17 +282,17 @@ Para una guía de configuración detallada sobre la configuración de proxies, c
## Almacenamiento en búfer de datos {#data-buffering}
Si la red se vuelve inaccesible, el Agente almacena las métricas en memoria.
-El uso máximo de memoria para almacenar las métricas está definido por la configuración `forwarder_retry_queue_payloads_max_size`. Cuando se alcanza este límite, se descartan las métricas.
+El uso máximo de memoria para almacenar las métricas está definido por la configuración `forwarder_retry_queue_payloads_max_size`. Cuando se alcanza este límite, las métricas se descartan.
El Agente v7.27.0 o posterior almacena las métricas en disco cuando se alcanza el límite de memoria. Habilite esta capacidad configurando `forwarder_storage_max_size_in_bytes` a un valor positivo que indique la cantidad máxima de espacio de almacenamiento, en bytes, que el Agente puede usar para almacenar las métricas en disco.
Las métricas se almacenan en la carpeta definida por la configuración `forwarder_storage_path`, que por defecto es `/opt/datadog-agent/run/transactions_to_retry` en sistemas Unix, y `C:\ProgramData\Datadog\run\transactions_to_retry` en Windows.
-Para evitar quedarse sin espacio de almacenamiento, el Agente almacena las métricas en disco solo si el espacio total de almacenamiento utilizado es inferior al 80 por ciento. Este límite está definido por la configuración `forwarder_storage_max_disk_ratio`.
+Para evitar quedarse sin espacio de almacenamiento, el Agente almacena las métricas en disco solo si el espacio total de almacenamiento utilizado es menos del 80 por ciento. Este límite está definido por la configuración `forwarder_storage_max_disk_ratio`.
-## Instalando el Operador de Datadog {#installing-the-datadog-operator}
+## Instalando el Datadog Operator {#installing-the-datadog-operator}
-Si está instalando el Operador de Datadog en un entorno de Kubernetes con conectividad limitada, necesita permitir los siguientes puntos finales para el puerto TCP 443, según su registro:
+Si está instalando el Datadog Operator en un entorno de Kubernetes con conectividad limitada, necesita permitir los siguientes puntos de conexión para el puerto TCP 443, según su registro:
- `registry.datadoghq.com` (Registro de Contenedores de Datadog)
- `us-docker.pkg.dev/datadog-prod/public-images` (puede recibir redirecciones de `registry.datadoghq.com`)
@@ -303,7 +304,7 @@ Si está instalando el Operador de Datadog en un entorno de Kubernetes con conec
- `docker.io/datadog` (DockerHub)
-## Lectura Adicional {#further-reading}
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -338,4 +339,5 @@ Si está instalando el Operador de Datadog en un entorno de Kubernetes con conec
[29]: /es/security/cloud_security_management/vulnerabilities/
[30]: /es/logs/
[31]: /es/data_security/logs/#hipaa-enabled-customers
-[32]: /es/logs/log_collection/#logging-endpoints
\ No newline at end of file
+[32]: /es/logs/log_collection/#logging-endpoints
+[33]: /es/network_monitoring/network_path/setup/#source-public-ip-resolution
\ No newline at end of file
diff --git a/content/es/bits_ai/mcp_server/_index.md b/content/es/bits_ai/mcp_server/_index.md
new file mode 100644
index 00000000000..e392a17d840
--- /dev/null
+++ b/content/es/bits_ai/mcp_server/_index.md
@@ -0,0 +1,112 @@
+---
+algolia:
+ rank: 90
+ tags:
+ - mcp
+ - mcp server
+description: Conecte agentes de IA a los datos de observabilidad de Datadog utilizando
+ el Servidor MCP para consultar métricas, registros, trazas y otras perspectivas.
+further_reading:
+- link: ide_plugins/vscode/?tab=cursor
+ tag: Documentación
+ text: Extensión de Datadog para Cursor
+- link: bits_ai/mcp_server/setup
+ tag: Documentación
+ text: Configurar el Servidor MCP de Datadog
+- link: bits_ai/mcp_server/tools
+ tag: Documentación
+ text: Herramientas del Servidor MCP de Datadog
+- link: bits_ai/
+ tag: Documentación
+ text: Descripción general de Bits AI
+- link: https://www.datadoghq.com/blog/datadog-mcp-server-use-cases
+ tag: Blog
+ text: Cuatro formas en que los equipos de ingeniería utilizan el Servidor MCP de
+ Datadog para potenciar agentes de IA
+- link: https://www.datadoghq.com/blog/datadog-remote-mcp-server/
+ tag: Blog
+ text: Conecte sus agentes de IA a las herramientas y contextos de Datadog utilizando
+ el Servidor MCP de Datadog
+- link: https://www.datadoghq.com/blog/datadog-cursor-extension/
+ tag: Blog
+ text: Depure problemas de producción en vivo con la extensión de Datadog Cursor
+- link: https://www.datadoghq.com/blog/openai-datadog-ai-devops-agent/
+ tag: Blog
+ text: 'Datadog + OpenAI: integración de Codex CLI para DevOps asistido por IA'
+title: Servidor MCP de Datadog
+---
+El Servidor MCP de Datadog actúa como un puente entre sus datos de observabilidad en Datadog y cualquier agente de IA que soporte el [Model Context Protocol (MCP)][1]. Proporcionando acceso estructurado a contextos, características y herramientas relevantes de Datadog, el Servidor MCP le permite consultar y recuperar perspectivas de observabilidad directamente desde clientes impulsados por IA como Cursor, OpenAI Codex, Claude Code o su propio agente de IA.
+
+**¿Listo para comenzar?** Seleccione su agente a continuación o consulte [Configurar el Servidor MCP de Datadog][27] para obtener instrucciones de conexión.
+
+{{< partial name="mcp_server/mcp_server_agents.html" >}}
+
+Esta demostración muestra el Servidor MCP de Datadog siendo utilizado en Cursor y Claude Code (active el audio para escuchar):
+
+{{< img src="bits_ai/mcp_server/mcp_cursor_demo_3.mp4" alt="Demostración del Servidor MCP de Datadog en Cursor y Claude Code" video="true" >}}
+
+
+## Avisos {#disclaimers}
+
+- El Servidor MCP de Datadog es elegible para HIPAA. Usted es responsable de asegurar que las herramientas de IA que conecte al Servidor MCP de Datadog cumplan con sus requisitos de cumplimiento, como HIPAA.
+- El Servidor MCP de Datadog no es compatible con GovCloud.
+- Datadog recopila cierta información sobre su uso del Servidor MCP Remoto de Datadog, incluyendo cómo interactúa con él, si ocurrieron errores al usarlo, qué causó esos errores y los identificadores de usuario de acuerdo con la Política de Privacidad de Datadog y el EULA de Datadog. Estos datos se utilizan para ayudar a mejorar el rendimiento y las características del servidor, incluyendo las transiciones hacia y desde el servidor y la página de inicio de sesión de Datadog aplicable para acceder a los Servicios, y el contexto (por ejemplo, las solicitudes del usuario) que llevan al uso de las herramientas MCP. Los datos se almacenan durante 120 días.
+
+## Límites de tasa de uso justo {#fair-use-rate-limits}
+
+El Servidor MCP viene con los siguientes límites de uso justo:
+- 50 solicitudes/10 segundos, límites de ráfaga de llamadas a herramientas
+- 5000 llamadas a herramientas diarias
+- 50,000 llamadas a herramientas mensuales.
+
+Estos límites son **sujetos a cambios** y pueden ajustarse si su caso de uso requiere más. Por favor, contacte a [soporte de Datadog][37] para solicitudes o preguntas.
+
+## Monitoreo de las llamadas a herramientas del Servidor MCP de Datadog {#monitoring-the-datadog-mcp-server-tool-calls}
+
+Puede rastrear el uso del Servidor MCP de Datadog para su organización utilizando métricas de Datadog y el Registro de Auditoría.
+
+Todas las llamadas a herramientas se registran en el [Audit Trail][16] de Datadog con metadatos que las identifican como acciones MCP, incluyendo el nombre de la herramienta, argumentos, identidad del usuario y el cliente MCP utilizado. Vea [Rastrear llamadas a herramientas en el Audit Trail](#track-tool-calls-in-audit-trail) para más información.
+
+Datadog también emite dos métricas estándar que puede usar para monitorear la actividad del Servidor MCP:
+
+- `datadog.mcp.session.starts`: Emitido en cada inicialización de sesión.
+- `datadog.mcp.tool.usage`: Una métrica de distribución emitida en cada llamada a la herramienta.
+
+Ambas métricas están etiquetadas con atributos como `user_id`, `user_email`, `client` (el nombre del cliente MCP, como `claude` o `cursor`), y `tool_name`.
+
+Debido a que `datadog.mcp.tool.usage` es una métrica de distribución, utiliza `count` (no `sum`) con `.as_count()` para obtener el número de llamadas a la herramienta. Por ejemplo, para consultar el número total de llamadas a la herramienta agrupadas por correo electrónico de usuario:
+
+```
+count:datadog.mcp.tool.usage{*} by {user_email}.as_count()
+```
+
+## Herramientas disponibles {#available-tools}
+
+Consulta [Herramientas del Servidor MCP de Datadog][2] para una referencia completa de las herramientas disponibles organizadas por conjunto de herramientas, con ejemplos de solicitudes. Para habilitar conjuntos de herramientas específicos, consulta [Configurar el Servidor MCP de Datadog][28] para obtener instrucciones.
+
+## Eficiencia del contexto {#context-efficiency}
+
+El Servidor MCP de Datadog está optimizado para proporcionar respuestas de manera que los agentes de IA obtengan contexto relevante sin ser sobrecargados con información innecesaria. Por ejemplo:
+
+- Las respuestas se truncan según la longitud estimada de las respuestas que cada herramienta proporciona. Las herramientas responden a los agentes de IA con instrucciones sobre cómo solicitar más información si la respuesta fue truncada.
+- La mayoría de las herramientas tienen un parámetro `max_tokens` que permite a los agentes de IA solicitar menos o más información.
+
+## Rastrear llamadas a herramientas en el Audit Trail {#track-tool-calls-in-audit-trail}
+
+Puede ver información sobre las llamadas realizadas por las herramientas del Servidor MCP en el Audit Trail [16] de Datadog. Busque o filtre por el nombre del evento `MCP Server`.
+
+## Comentarios {#feedback}
+
+El Servidor MCP de Datadog se encuentra en pleno desarrollo. Utilice [este formulario de comentarios][19] para compartir cualquier comentario, caso de uso o problemas encontrados con sus solicitudes y consultas.
+
+## Lectura adicional {#further-reading}
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://modelcontextprotocol.io/
+[2]: /es/bits_ai/mcp_server/tools
+[16]: /es/account_management/audit_trail/
+[19]: https://docs.google.com/forms/d/e/1FAIpQLSeorvIrML3F4v74Zm5IIaQ_DyCMGqquIp7hXcycnCafx4htcg/viewform
+[27]: /es/bits_ai/mcp_server/setup
+[28]: /es/bits_ai/mcp_server/setup#toolsets
+[37]: https://help.datadoghq.com/hc/en-us/requests/new
\ No newline at end of file
diff --git a/content/es/bits_ai/mcp_server/setup.md b/content/es/bits_ai/mcp_server/setup.md
new file mode 100644
index 00000000000..01af0f15243
--- /dev/null
+++ b/content/es/bits_ai/mcp_server/setup.md
@@ -0,0 +1,743 @@
+---
+algolia:
+ rank: 75
+ tags:
+ - mcp
+ - mcp server
+ - setup
+description: Aprende a conectar tu agente de IA al servidor Datadog MCP.
+further_reading:
+- link: bits_ai/mcp_server
+ tag: Documentación
+ text: Servidor Datadog MCP
+- link: bits_ai/mcp_server/tools
+ tag: Documentación
+ text: Herramientas del Servidor Datadog MCP
+- link: ide_plugins/vscode/?tab=cursor
+ tag: Documentación
+ text: Extensión de Datadog para Cursor
+title: Configura el Servidor Datadog MCP
+---
+Aprende a poner en marcha y configurar el Servidor Datadog MCP, que te permite obtener información de telemetría y gestionar las características de la plataforma directamente desde clientes impulsados por IA. Selecciona tu cliente:
+
+{{< tabs >}}
+{{% tab "Claude" %}}
+
+Conecta a Claude (incluyendo Claude Cowork) al Servidor Datadog MCP añadiéndolo como un {{< ui >}}custom connector{{< /ui >}} con la URL remota de MCP.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+1. Sigue la guía del centro de ayuda de Claude sobre [conectores personalizados][1] para añadir un nuevo conector personalizado.
+
+1. Cuando se te pida una URL, ingresa el punto de conexión del Servidor Datadog MCP para tu [sitio de Datadog][2] ({{< region-param key="dd_site_name" >}}). Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
{{< region-param key="mcp_server_endpoint" >}}
+
+ Para habilitar [herramientas específicas de producto](#toolsets), incluye el parámetro de consulta `toolsets` al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de APM y LLM Observability (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
+
+
+
+1. Completa el flujo de inicio de sesión de OAuth cuando se te pida.
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+[1]: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp
+[2]: /es/getting_started/site/
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con el sitio de Datadog seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+{{% /tab %}}
+
+{{% tab "Claude Code" %}}
+
+Dirige tu agente de IA al punto de conexión del Servidor Datadog MCP para tu [sitio de Datadog][1] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto de conexión seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. Ejecuta en la terminal:
+
claude mcp add --transport http datadog-mcp {{< region-param key="mcp_server_endpoint" >}}
+
+ Alternativamente, agrega a `~/.claude.json`:
+
+
+1. Para habilitar [herramientas específicas de producto](#toolsets), incluye el parámetro de consulta `toolsets` al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de Observabilidad APM y LLM (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
+
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+
+{{< /site-region >}}
+
+[1]: /es/getting_started/site/
+{{% /tab %}}
+
+{{% tab "Codex" %}}
+
+Dirige tu agente de IA al punto de conexión del servidor MCP para tu [sitio de Datadog][1] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto final seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. Edita `~/.codex/config.toml` (o tu archivo de configuración de Codex CLI) para agregar el Servidor Datadog MCP con transporte HTTP y la URL del punto de conexión para tu sitio. Por ejemplo:
+
+
+
+ Para habilitar [herramientas específicas de producto](#toolsets), incluye el parámetro de consulta `toolsets` al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de Observabilidad APM y LLM (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
+
+
+
+1. Inicia sesión en el servidor MCP de Datadog:
+
+ ```shell
+ codex mcp login datadog
+ ```
+
+ Esto abre tu navegador para completar el flujo de OAuth. Codex almacena las credenciales resultantes para que no necesites iniciar sesión nuevamente hasta que el token expire.
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[1]: /es/getting_started/site/
+{{% /tab %}}
+
+{{% tab "Cursor" %}}
+
+Instala el [Plugin de Datadog][1] desde el Marketplace de Cursor; el plugin incluye el Servidor Datadog MCP y otros recursos. Si previamente instalaste el Servidor Datadog MCP manualmente, elimínalo de la configuración del IDE para evitar conflictos.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+1. Puedes instalar el plugin desde el Marketplace de Cursor o desde dentro de Cursor:
+ - Desde el Marketplace de Cursor, abre el [Plugin de Datadog][1] y haz clic en **Agregar a Cursor**.
+ - En Cursor, navega a **Configuración de Cursor** > **Plugins**, luego busca el plugin de Datadog y haz clic en **Agregar a Cursor**.
+
+1. Después de la instalación del plugin, escribe `/ddsetup` en el chat del agente para realizar la configuración inicial.
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+[1]: https://cursor.com/marketplace/datadog
+[2]: /es/ide_plugins/vscode/?tab=cursor#installation
+[3]: /es/bits_ai/mcp_server/tools
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[1]: https://cursor.com/marketplace/datadog
+{{% /tab %}}
+
+{{% tab "Devin" %}}
+
+Conecta a Devin al Servidor MCP de Datadog habilitándolo desde el Mercado MCP de Devin. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+1. En Devin, ve a {{< ui >}}Settings{{< /ui >}} > {{< ui >}}MCP Marketplace{{< /ui >}} y busca `Datadog`.
+1. Selecciona tu sitio de Datadog para el {{< ui >}}Server URL{{< /ui >}}; por ejemplo, tu sitio seleccionado es {{< region-param key="dd_site_name" code="true" >}}.
+1. Ingresa tus claves de API y de aplicación de Datadog.
+1. Instala y habilita el Servidor Datadog MCP, y completa el flujo de inicio de sesión de OAuth cuando se te solicite.
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+
Para usar conjuntos de herramientas específicos del producto, configura un servidor MCP personalizado en Devin e incluye la toolsets consulta al final de la URL del punto de conexión. Consulta Conjuntos de herramientas para más información.
+
El Servidor Datadog MCP no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+{{% /tab %}}
+
+{{% tab "Gemini CLI" %}}
+
+Dirige tu agente de IA al punto de conexión del Servidor Datadog MCP para tu [sitio de Datadog][1] regional. Para las instrucciones correctas, utiliza el selector de **Sitio de Datadog** en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto de conexión seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. Ejecuta en la terminal:
+
+
+1. Para habilitar [herramientas específicas de producto](#toolsets), incluye el `toolsets` parámetro de consulta al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de Observabilidad APM y LLM (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
+
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[1]: /es/getting_started/site/
+{{% /tab %}}
+
+{{% tab "Goose" %}}
+
+Dirige tu agente de IA al punto de conexión del Servidor MCP para tu [sitio de Datadog][3] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto de conexión seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. Agrega el Servidor MCP de Datadog a Goose utilizando uno de los siguientes métodos:
+ - **Instalación con un clic (recomendada):** Utiliza el Servidor MCP de Datadog {{< region-param key="goose_mcp_install_deeplink" link="true" text="install deeplink" >}}.
+ - **Configuración manual:** Sigue las instrucciones de Goose para [agregar un servidor MCP][2], utilizando el punto final listado en esta sección como la URL del servidor HTTP transmitible. Para editar la configuración directamente, modifica `~/.config/goose/config.yaml`.
+
+1. Para habilitar [herramientas específicas del producto][1], incluye el parámetro de consulta `toolsets` al final de la URL del punto final. Por ejemplo, esta URL habilita _solo_ herramientas de APM y LLM Observability (usa para habilitar todos los conjuntos de herramientas generalmente disponibles, ideal para clientes que soportan filtrado de herramientas):
+
+
+
+ To enable all generally available toolsets, use `toolsets=all`. This works best for clients that support tool filtering.
+
+1. Al iniciar la sesión por primera vez, elige tu cuenta de Datadog cuando se te pida autenticarte.
+
+1. Verifica que tienes los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+[1]: /es/bits_ai/mcp_server#toolsets
+[2]: https://goose-docs.ai/docs/getting-started/using-extensions#mcp-servers
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[3]: /es/getting_started/site/
+{{% /tab %}}
+
+{{% tab "IDEs de JetBrains" %}}
+
+JetBrains ofrece los plugins de [Junie][1] y [Asistente de IA][2] para su gama de IDEs. GitHub ofrece el plugin de [Copilot][4]. Alternativamente, muchos desarrolladores utilizan un CLI de Agent, como Claude Code, Codex o Gemini CLI, junto a su IDE.
+
+Dirige tu plugin al punto de conexión del Servidor MCP para tu [sitio de Datadog][3] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto de conexión seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+{{% collapse-content title="Junie" level="h4" expanded=false id="jetbrains-junie" %}}
+1. Ve a {{< ui >}}Tools{{< /ui >}} > {{< ui >}}Junie{{< /ui >}} > {{< ui >}}MCP Settings{{< /ui >}} y agrega el siguiente bloque:
+
+
+
+1. Para habilitar [herramientas específicas de producto](#toolsets), incluye el parámetro de consulta `toolsets` al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de Observabilidad APM y LLM (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
+
+
+
+1. Se te solicita iniciar sesión a través de OAuth. El indicador de estado en la configuración muestra una marca verde cuando la conexión se realiza correctamente.
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+{{% /collapse-content %}}
+
+{{% collapse-content title="JetBrains AI Assistant" level="h4" expanded=false id="jetbrains-ai-assistant" %}}
+1. Ve a {{< ui >}}Tools{{< /ui >}} > {{< ui >}}AI Assistant{{< /ui >}} > {{< ui >}}Model Context Protocol (MCP){{< /ui >}} y agrega el siguiente bloque:
+
+
+
+1. Para habilitar [herramientas específicas de producto](#toolsets), incluye el `toolsets` parámetro de consulta al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de APM y LLM Observability (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, ideal para clientes que soportan filtrado de herramientas):
+
+
+
+1. El indicador de estado en la configuración muestra una marca de verificación verde cuando la conexión se realiza correctamente.
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+{{% /collapse-content %}}
+
+{{% collapse-content title="GitHub Copilot" level="h4" expanded=false id="github-copilot" %}}
+1. Ve a {{< ui >}}Tools{{< /ui >}} > {{< ui >}}GitHub Copilot{{< /ui >}} > {{< ui >}}Model Context Protocol (MCP){{< /ui >}} y agrega el siguiente bloque:
+
+
+
+1. Para habilitar [herramientas específicas de producto](#toolsets), incluye el `toolsets` parámetro de consulta al final de la URL del endpoint. Por ejemplo, esta URL habilita _solo_ herramientas de Observabilidad APM y LLM (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
+
+
+
+1. Haz clic en el elemento `Start` que aparece en el editor para iniciar el servidor. Se te solicita iniciar sesión a través de OAuth.
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+{{% /collapse-content %}}
+
+{{% collapse-content title="CLIs de Agent" level="h4" expanded=false id="jetbrains-agent-clis" %}}
+Muchos desarrolladores utilizan una CLI de Agent, como Claude Code, Codex o Gemini CLI, junto con su IDE de JetBrains. Consulta la configuración para esas herramientas CLI:
+- [Claude Code][4]
+- [Codex][5]
+- [Gemini CLI][6]
+
+El [plugin de Datadog para IDEs de JetBrains][3] se integra con estas CLIs de Agent. Para una experiencia ininterrumpida, instala el plugin al mismo tiempo que configuras el Servidor MCP de Datadog.
+
+[3]: /es/ide_plugins/idea/
+[4]: /es/bits_ai/mcp_server/setup/?tab=claudecode
+[5]: /es/bits_ai/mcp_server/setup/?tab=codex
+[6]: /es/bits_ai/mcp_server/setup/?tab=geminicli
+{{% /collapse-content %}}
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[1]: https://plugins.jetbrains.com/plugin/26104-junie-the-ai-coding-agent-by-jetbrains
+[2]: https://plugins.jetbrains.com/plugin/22282-jetbrains-ai-assistant
+[3]: /es/getting_started/site/
+[4]: https://plugins.jetbrains.com/plugin/17718-github-copilot--your-ai-pair-programmer
+{{% /tab %}}
+
+{{% tab "Kiro" %}}
+
+Dirige tu agente de IA al punto de conexión del Servidor MCP para tu [sitio de Datadog][3] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto de conexión seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. Agrega lo siguiente a tu [archivo de configuración de Kiro MCP][2] (`~/.kiro/settings/mcp.json` para configuración a nivel de usuario):
+
+
+
+1. Para habilitar [herramientas específicas de producto](#toolsets), incluye el `toolsets` parámetro de consulta al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de APM y LLM Observability (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, ideal para clientes que soportan filtrado de herramientas):
+
+
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+[2]: https://kiro.dev/docs/mcp/configuration/
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[3]: /es/getting_started/site/
+{{% /tab %}}
+
+{{% tab "OpenCode" %}}
+
+Dirige tu agente de IA al punto de conexión del Servidor MCP para tu [sitio de Datadog][1] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto de conexión seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. Agrega lo siguiente a tu archivo de configuración `opencode.json`:
+
+
+1. Para habilitar [herramientas específicas de producto](#toolsets), incluye el `toolsets` parámetro de consulta al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ herramientas de APM y LLM Observability:
+
+
+
+ Para habilitar todos los conjuntos de herramientas generalmente disponibles, usa `toolsets=all`. Esto funciona mejor para clientes que soportan filtrado de herramientas.
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+[1]: /es/getting_started/site/
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[1]: /es/getting_started/site/
+{{% /tab %}}
+
+{{% tab "VS Code" %}}
+
+La [extensión de Cursor y VS Code de Datadog][1] incluye acceso integrado al Servidor MCP de Datadog gestionado. GitHub Copilot también puede acceder al Servidor MCP de Datadog en VS Code (requiere una suscripción activa a GitHub Copilot).
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+1. Instala la extensión (omite `--profile` y el nombre del perfil para instalar en el perfil predeterminado de VS Code):
+ ```shell
+ code --install-extension datadog.datadog-vscode --profile
+ ```
+ Alternativamente, instala la [extensión de Datadog][2]. Si ya tienes la extensión instalada, asegúrate de que sea la última versión.
+1. Inicia sesión en tu cuenta de Datadog.
+1. **Reinicia el IDE.**
+1. Confirma que el servidor MCP de Datadog esté disponible y que las [herramientas][3] estén listadas: Abre el panel de chat, selecciona el modo agente y haz clic en el botón {{< ui >}}Configure Tools{{< /ui >}}.
+ {{< img src="bits_ai/mcp_server/vscode_configure_tools_button.png" alt="Configura el botón de Herramientas en VS Code" style="width:70%;" >}}
+1. Si previamente instalaste el servidor MCP de Datadog manualmente, elimínalo de la configuración del IDE para evitar conflictos. Abre la paleta de comandos (`Shift` + `Cmd/Ctrl` + `P`) y ejecuta `MCP: Open User Configuration`.
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+[2]: /es/ide_plugins/vscode/?tab=vscode#installation
+[3]: /es/bits_ai/mcp_server/tools
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[1]: /es/ide_plugins/vscode/
+{{% /tab %}}
+
+{{% tab "Warp" %}}
+
+[Warp][1] es un terminal agente con soporte MCP integrado. Dirige el agente Warp al punto de conexión del servidor MCP para tu [sitio de Datadog][2] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto de conexión seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. En la aplicación Warp, ve a {{< ui >}}Settings{{< /ui >}} > {{< ui >}}MCP Servers{{< /ui >}} y haz clic en {{< ui >}}+ Add{{< /ui >}}.
+
+1. Pega la siguiente configuración:
+
+
+
+ To enable [product-specific tools](#toolsets), include the `toolsets` query parameter at the end of the endpoint URL. For example, this URL enables _only_ APM and LLM Observability tools (use `toolsets=all` to enable all generally available toolsets, best for clients that support tool filtering):
+
+
+
+1. Haz clic en {{< ui >}}Start{{< /ui >}} en el servidor de Datadog. Warp abre tu navegador para completar el flujo de inicio de sesión de OAuth. Las credenciales se almacenan de forma segura en tu dispositivo y se reutilizan para sesiones futuras.
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+{{< /site-region >}}
+
+[1]: https://www.warp.dev/
+[2]: /es/getting_started/site/
+{{% /tab %}}
+
+{{% tab "Otro" %}}
+
+Para la mayoría de los otros [clientes soportados](#supported-clients), utiliza estas instrucciones para la autenticación remota. Para Cline o cuando la autenticación remota no es confiable o no está disponible, utiliza [la autenticación binaria local](#local-binary-authentication).
+
+Dirige tu agente de IA al punto de conexión del servidor MCP para tu [sitio de Datadog][1] regional. Para las instrucciones correctas, utiliza el selector {{< ui >}}Datadog Site{{< /ui >}} en el lado derecho de esta página de documentación para seleccionar tu sitio.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Punto final seleccionado ({{< region-param key="dd_site_name" >}}): {{< region-param key="mcp_server_endpoint" >}}.
+
+1. Agrega el Servidor MCP de Datadog al archivo de configuración de tu cliente utilizando el transporte HTTP y la URL del punto de conexión de tu sitio. Por ejemplo:
+
+
+
+1.Para habilitar [herramientas específicas de producto](#toolsets), incluye el `toolsets` parámetro de consulta al final de la URL del punto de conexión. Por ejemplo, esta URL habilita _solo_ APM y LLM Observability (usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles, lo mejor para clientes que soportan filtrado de herramientas):
+
+
+
+1. Verifica que tengas los [permisos](#required-permissions) requeridos para los recursos de Datadog a los que deseas acceder.
+
+{{< /site-region >}}
+
+{{< site-region region="gov,gov2" >}}
+
El servidor MCP de Datadog no es compatible con tu sitio seleccionado ({{< region-param key="dd_site_name" >}}).
+
+{{< /site-region >}}
+
+[1]: /es/getting_started/site/
+{{% /tab %}}
+{{< /tabs >}}
+
+## Conjuntos de herramientas {#toolsets}
+
+El Servidor MCP de Datadog soporta _conjuntos de herramientas_, que te permiten usar solo las [herramientas MCP][49] que necesitas, ahorrando valioso espacio en la ventana de contexto. Para usar un conjunto de herramientas, incluye el `toolsets` parámetro de consulta en la URL del punto de conexión al conectarte al Servidor MCP ([autenticación remota](#authentication) solamente). Usa `toolsets=all` para habilitar todos los conjuntos de herramientas generalmente disponibles a la vez.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Por ejemplo, basado en el [sitio de Datadog][17] que seleccionaste ({{< region-param key="dd_site_name" >}}) :
+
+- Recupera solo las herramientas básicas (este es el valor predeterminado si no se especifica `toolsets`):
+
{{< region-param key="mcp_server_endpoint" >}}
+
+- Recupera solo las herramientas relacionadas con Synthetic Testing:
+
Habilitar todos los conjuntos de herramientas aumenta el número de definiciones de herramientas enviadas a tu cliente de IA, lo que consume espacio en la ventana de contexto. toolsets=all funciona mejor con clientes que soportan filtrado de herramientas, como Claude Code.
+
+[17]: /es/getting_started/site/#navigate-the-datadog-documentation-by-site
+{{< /site-region >}}
+
+### Conjuntos de herramientas disponibles {#available-toolsets}
+
+Estos conjuntos de herramientas están disponibles en general. Consulta [Herramientas del Servidor MCP de Datadog][49] para una referencia completa de herramientas disponibles organizadas por conjunto de herramientas, con ejemplos de prompts.
+
+- `core`: El conjunto de herramientas predeterminado para registros, métricas, trazas, tableros, monitores, incidentes, servidores, servicios, eventos y notebook.
+- `alerting`: Herramientas para validar y crear monitores, buscar grupos de monitores, recuperar plantillas de monitores, analizar la cobertura de monitores y buscar SLOs
+- `cases`: Herramientas para [Case Management][42], incluyendo la creación, búsqueda y actualización de casos; gestión de proyectos; y vinculación de Jira issues
+- `dashboards`: Herramientas para recuperar, crear, actualizar y eliminar [tableros][46], además de referencia y validación de esquemas de widgets
+- `dbm`: Herramientas para interactuar con [Database Monitoring][33]
+- `ddsql`: Herramientas para consultar datos de Datadog usando [DDSQL][44], un dialecto SQL con soporte para recursos de infraestructura, registros, métricas, RUM, tramos y otras fuentes de datos de Datadog
+- `error-tracking`: Herramientas para interactuar con Datadog [Error Tracking][32]
+- `feature-flags`: Herramientas para [feature flags][35], incluyendo la creación, listado y actualización de flags y sus entornos
+- `kubernetes`: Herramientas para buscar y describir recursos de [Kubernetes][51] y recuperar manifiestos en todos los clúster
+- `llmobs`: Herramientas para buscar y analizar tramos y experimentos de [LLM Observability][36]
+- `networks`: Herramientas para análisis de [Cloud Network Monitoring][37] y [Network Device Monitoring][38]
+- `onboarding`: Herramientas de incorporación agentic para la configuración guiada de Datadog
+- `product-analytics`: Herramientas para interactuar con consultas de [Product Analytics][41]
+- `reference-tables`: Herramientas para gestionar [Reference Tables][48], incluyendo el listado de tablas, lectura de filas, adición de filas y creación de tablas desde almacenamiento en la nube
+- `security`: Herramientas para escaneo de seguridad de código y búsqueda de [señales de seguridad][39] y [hallazgos de seguridad][40]
+- `software-delivery`: Herramientas para interactuar con la Entrega de Software ([CI Visibility][30] y [Test Optimization][31])
+- `synthetics`: Herramientas para interactuar con [Synthetic tests][29]
+- `workflows`: Herramientas para [Workflow Automation][43], incluyendo el listado, inspección, ejecución y configuración de flujos de trabajo para uso de agentes
+
+### Conjuntos de herramientas de vista previa {#preview-toolsets}
+
+Estos conjuntos de herramientas están en vista previa. Regístrate para un conjunto de herramientas completando el formulario de Product Preview o contacta a [Datadog support][47] para solicitar acceso.
+- `apm`: ([Regístrate][45]) Herramientas para un análisis de trazas [APM][34] en profundidad, búsqueda de tramos, información de Watchdog e investigación de rendimiento
+
+## Clientes soportados {#supported-clients}
+
+| Cliente | Desarrollador | Notas |
+|--------|------|------|
+| [Cursor][3] | Cursor | Datadog [Cursor y extensión de VS Code][15] recomendados. |
+| [Claude Code][4] | Anthropic | |
+| [Claude][19] | Anthropic | Utilice [ la configuración del conector personalizado ](?tab=claude#installation). Incluye Claude Cowork. |
+| [Codex CLI][6] | OpenAI | |
+| [Gemini CLI][50] | Google | |
+| [Warp][28] | Warp | |
+| [VS Code][7] | Microsoft | Datadog [Cursor y extensión de VS Code][16] recomendados. |
+| [JetBrains IDEs][18] | JetBrains | [plugin de Datadog][18] recomendado. |
+| [Kiro][9], [Kiro CLI][10] | Amazon Web Services | |
+| [Goose][8] | Agentic AI Foundation | |
+| [Cline][11] | Varios | Consulte la {{< ui >}}Other{{< /ui >}} pestaña arriba. Utilice la autenticación binaria local para Cline si la autenticación remota no es confiable. |
+
+
El servidor MCP de Datadog está en desarrollo activo, y podrían estar disponibles clientes compatibles adicionales.
+
+## Permisos requeridos {#required-permissions}
+
+Las herramientas del servidor MCP requieren los siguientes [permisos de rol de usuario de Datadog][22]:
+
+| Permiso | Requerido para |
+|------------|-------------|
+| mcp_read | Herramientas que leen datos de Datadog (por ejemplo, consultar monitores, buscar registros, recuperar tableros) |
+| mcp_write | Herramientas que crean o modifican recursos en Datadog (por ejemplo, crear monitores, silenciar servidores) |
+
+Además de `mcp_read` o `mcp_write`, los usuarios necesitan los permisos estándar de Datadog para el recurso subyacente. Por ejemplo, usar una herramienta MCP que lee monitores requiere tanto `mcp_read` como el permiso de [Lectura de Monitores][24]. Consulte [Permisos de Rol de Datadog][25] para la lista completa de permisos a nivel de recurso.
+
+Los usuarios con el **Rol Estándar de Datadog** tienen ambos permisos del servidor MCP por defecto. Si su organización utiliza [roles personalizados][23], agregue los permisos manualmente:
+1. Vaya a [**Configuración de la Organización > Roles**][26] como administrador, y haga clic en el rol que desea actualizar.
+1. Haga clic en {{< ui >}}Edit Role{{< /ui >}} (icono de lápiz).
+1. En la lista de permisos, seleccione las casillas de verificación {{< ui >}}MCP Read{{< /ui >}} y {{< ui >}}MCP Write{{< /ui >}}.
+1. Seleccione cualquier otro permiso a nivel de recurso que necesite para el rol.
+1. Haga clic en {{< ui >}}Save{{< /ui >}}.
+
+Los administradores de la organización pueden gestionar el acceso global de MCP y las capacidades de escritura desde [Configuración de la Organización][27].
+
+## Autenticación {#authentication}
+
+El servidor MCP utiliza OAuth 2.0 para [autenticación][14]. Si no puede pasar por el flujo de OAuth (por ejemplo, en un servidor), puede proporcionar una clave de API de Datadog y una clave de aplicación como `DD_API_KEY` y `DD_APPLICATION_KEY` en los encabezados HTTP.
+
+{{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+Por ejemplo, según el [sitio de Datadog][17] seleccionado ({{< region-param key="dd_site_name" >}}):
+
+
+
+[17]: /es/getting_started/site/#navigate-the-datadog-documentation-by-site
+{{< /site-region >}}
+
+Por seguridad, utilice una clave de API con alcance restringido y una clave de aplicación de una [cuenta de servicio][13] que tenga solo los permisos requeridos.
+
+### Autenticación binaria local {#local-binary-authentication}
+
+Se recomienda la autenticación local para Cline y cuando la autenticación remota no es confiable o no está disponible. Después de la instalación, normalmente no necesita actualizar el binario local para beneficiarse de las actualizaciones del servidor MCP, ya que las herramientas son remotas.
+
+{{% collapse-content title="Configure el binario local del servidor MCP de Datadog" level="h5" expanded=false id="mcp-local-binary" %}}
+
+1. Instale el binario del servidor MCP de Datadog (macOS y Linux):
+ ```bash
+ curl -sSL https://coterm.datadoghq.com/mcp-cli/install.sh | bash
+ ```
+ Esto instala el binario en `~/.local/bin/datadog_mcp_cli`.
+
+ Para Windows, descargue la [versión de Windows][20].
+
+2. Ejecute `datadog_mcp_cli login` manualmente para recorrer el flujo de inicio de sesión de OAuth y elegir un [sitio de Datadog][21].
+
+3. Configura tu cliente de IA para usar el transporte stdio con `datadog_mcp_cli` como el comando. Por ejemplo, en macOS (reemplaza `` con tu nombre de usuario del sistema operativo):
+ ```json
+ {
+ "mcpServers": {
+ "datadog": {
+ "type": "stdio",
+ "command": "/Users//.local/bin/datadog_mcp_cli",
+ "args": [],
+ "env": {}
+ }
+ }
+ }
+ ```
+
+ Para otros sistemas operativos, reemplaza la ruta `command` con la ubicación del binario descargado:
+ - Linux: `/home//.local/bin/datadog_mcp_cli`
+ - Windows: `\bin\datadog_mcp_cli.exe`
+
+
Para Claude Code, puedes ejecutar en su lugar:
+
claude mcp add datadog --scope user -- ~/.local/bin/datadog_mcp_cli
+
+4. Reinicia completamente tu cliente de IA para aplicar la configuración y cargar el servidor MCP.
+{{% /collapse-content %}}
+
+## Prueba el acceso al servidor MCP {#test-access-to-the-mcp-server}
+
+1. Instala el [inspector de MCP][2], una herramienta para desarrolladores para probar y depurar servidores MCP.
+
+ ```bash
+ npx @modelcontextprotocol/inspector
+ ```
+2. En la interfaz web del inspector, para {{< ui >}}Transport Type{{< /ui >}}, selecciona {{< ui >}}Streamable HTTP{{< /ui >}}.
+3. Para {{< ui >}}URL{{< /ui >}}, ingresa el punto de conexión del servidor MCP para tu sitio regional de Datadog.
+ {{< site-region region="us,us3,us5,eu,ap1,ap2" >}}
+ Por ejemplo, para {{< region-param key="dd_site_name" >}}: {{< region-param key="mcp_server_endpoint" >}}
+ {{< /site-region >}}
+4. Haz clic en {{< ui >}}Connect{{< /ui >}}, luego ve a {{< ui >}}Tools{{< /ui >}} > {{< ui >}}List Tools{{< /ui >}}.
+5. Verifica si las [herramientas disponibles][12] aparecen.
+
+## Lectura adicional {#further-reading}
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /es/account_management/api-app-keys/
+[2]: https://github.com/modelcontextprotocol/inspector
+[3]: https://cursor.com
+[4]: https://claude.com/product/claude-code
+[5]: https://claude.com/download
+[6]: https://chatgpt.com/codex
+[7]: https://code.visualstudio.com/
+[8]: https://github.com/block/goose
+[9]: https://kiro.dev/
+[10]: https://kiro.dev/cli/
+[11]: https://cline.bot/
+[12]: /es/bits_ai/mcp_server/tools
+[13]: /es/account_management/org_settings/service_accounts/
+[14]: https://modelcontextprotocol.io/specification/draft/basic/authorization
+[15]: /es/ide_plugins/vscode/?tab=cursor
+[16]: /es/ide_plugins/vscode/
+[17]: /es/getting_started/site/#navigate-the-datadog-documentation-by-site
+[18]: /es/ide_plugins/idea/
+[19]: https://claude.ai
+[20]: https://coterm.datadoghq.com/mcp-cli/datadog_mcp_cli.exe
+[21]: /es/getting_started/site/
+[22]: /es/account_management/rbac/permissions/#mcp
+[23]: /es/account_management/rbac/?tab=datadogapplication#custom-roles
+[24]: /es/account_management/rbac/permissions/#monitors
+[25]: /es/account_management/rbac/permissions/
+[26]: https://app.datadoghq.com/organization-settings/roles
+[27]: https://app.datadoghq.com/organization-settings/preferences
+[28]: https://www.warp.dev/
+[29]: /es/synthetics/
+[30]: /es/continuous_integration/
+[31]: /es/tests/
+[32]: /es/error_tracking/
+[33]: /es/database_monitoring/
+[34]: /es/tracing/
+[35]: /es/feature_flags/
+[36]: /es/llm_observability/mcp_server/
+[37]: /es/network_monitoring/cloud_network_monitoring/
+[38]: /es/network_monitoring/devices/
+[39]: /es/security/threats/security_signals/
+[40]: /es/security/misconfigurations/findings/
+[41]: /es/product_analytics
+[42]: /es/service_management/case_management/
+[43]: /es/actions/workflows/
+[44]: /es/ddsql_editor/
+[45]: https://www.datadoghq.com/product-preview/apm-mcp-toolset/
+[46]: /es/dashboards/
+[47]: /es/help/
+[48]: /es/reference_tables/
+[49]: /es/bits_ai/mcp_server/tools
+[50]: https://github.com/google-gemini/gemini-cli
+[51]: /es/containers/monitoring/kubernetes_explorer/
\ No newline at end of file
diff --git a/content/es/containers/kubernetes/prometheus.md b/content/es/containers/kubernetes/prometheus.md
index cdc2c018e49..2593200abc1 100644
--- a/content/es/containers/kubernetes/prometheus.md
+++ b/content/es/containers/kubernetes/prometheus.md
@@ -6,57 +6,56 @@ aliases:
- /es/agent/prometheus
- /es/agent/kubernetes/prometheus
description: Recopila Prometheus y OpenMetrics de las cargas de trabajo de Kubernetes
- utilizando el módulo Datadog Agent con Autodiscovery
+ utilizando el Datadog Agent con Autodiscovery
further_reading:
- link: https://www.datadoghq.com/blog/kubernetes-operator-performance
tag: Blog
- text: Monitorizar tus operadores de Kubernetes para que las aplicaciones funcionen
+ text: Monitorea tus operadores de Kubernetes para mantener las aplicaciones funcionando
sin problemas
- link: /agent/kubernetes/log/
tag: Documentación
- text: Recopilar logs de tus aplicaciones
+ text: Recopila los registros de tu aplicación
- link: /agent/kubernetes/apm/
tag: Documentación
- text: Recopilar tus trazas (traces) de aplicaciones
+ text: Recopila las trazas de tu aplicación
- link: /agent/kubernetes/integrations/
tag: Documentación
- text: Recopila automáticamente los datos de métricas y logs de tus aplicaciones
+ text: Recopila automáticamente las métricas y registros de tus aplicaciones
- link: /agent/guide/autodiscovery-management/
tag: Documentación
- text: Limitar la recopilación de datos a un subconjunto de contenedores
+ text: Limita la recopilación de datos a un subconjunto de contenedores solamente
- link: /agent/kubernetes/tag/
tag: Documentación
- text: Asignar etiquetas (tags) a todos los datos emitidos por un contenedor
+ text: Asigna etiquetas a todos los datos emitidos por un contenedor
- link: /integrations/guide/prometheus-metrics/
tag: Documentación
- text: Asignación de métricas de Prometheus a métricas de Datadog
-title: Recopilación de métricas de Kubernetes Prometheus y OpenMetrics
+ text: Mapeo de métricas de Prometheus a métricas de Datadog
+title: Recopilación de métricas de Prometheus y OpenMetrics en Kubernetes
---
+## Resumen {#overview}
-## Información general
+Recopila tus métricas expuestas de Prometheus y OpenMetrics de tu aplicación que se ejecuta dentro de Kubernetes utilizando el Datadog Agent y las integraciones de [OpenMetrics][1] o [Prometheus][2]. Por defecto, todas las métricas recuperadas por la verificación genérica de Prometheus se consideran métricas personalizadas.
-Recopila tus métricas de Prometheus y OpenMetrics expuestas desde tu aplicación que se ejecuta dentro de Kubernetes utilizando el Datadog Agent y las integraciones de [OpenMetrics][1] o [Prometheus][2]. Por defecto, todas las métricas recuperadas por el check genérico de Prometheus se consideran métricas personalizadas.
+A partir de la versión 6.5.0, el Datadog Agent incluye verificaciones de [OpenMetrics][3] y [Prometheus][4] capaces de extraer puntos de conexión de Prometheus. Para un uso más avanzado de la interfaz `OpenMetricsCheck`, incluyendo la escritura de una verificación personalizada, consulta la sección de [Herramientas para Desarrolladores][5].
-A partir de la versión 6.5.0, el Agent incluye checks de [OpenMetrics][3] y [Prometheus][4] capaces de rastrear los endpoints de Prometheus. Para un uso más avanzado de la interfaz `OpenMetricsCheck`, incluida la escritura de un check personalizado, consulta la sección [Herramientas para desarrolladores][5].
+Esta página explica el uso básico de estas verificaciones, que te permiten extraer métricas personalizadas de los puntos de conexión de Prometheus. Para una explicación de cómo las métricas de Prometheus y OpenMetrics se mapean a las métricas de Datadog, consulta la guía de [Mapeo de métricas de Prometheus a métricas de Datadog][6].
-En esta página se explica el uso básico de estos checks, que te permiten extraer métricas personalizadas desde los endpoints de Prometheus. Para obtener una explicación de cómo se asignan las métricas de Prometheus y OpenMetrics a las métricas de Datadog, consulta la guía [Asignación de métricas de Prometheus a métricas de Datadog][6].
+**Nota**: Datadog recomienda utilizar la verificación de OpenMetrics ya que es más eficiente y soporta completamente el formato de texto de Prometheus. Utiliza la verificación de Prometheus solo cuando el punto de conexión de métricas no soporte un formato de texto.
-**Nota**: Datadog recomienda utilizar el check de OpenMetrics, ya que es más eficiente y admite totalmente el formato de texto de Prometheus. Utiliza el check de Prometheus sólo cuando el endpoint de métricas no admita un formato de texto.
+## Configuración {#setup}
-## Instalación
+### Instalación {#installation}
-### Instalación
+[Despliega el Datadog Agent en tu clúster de Kubernetes][7]. Las verificaciones de OpenMetrics y Prometheus están incluidas en el paquete del [Datadog Agent][8], por lo que no necesitas instalar nada más en tus contenedores o servidores.
-[Despliega el Datadog Agent en tu clúster de Kubernetes][7]. Los checks de OpenMetrics y Prometheus están incluidos en el paquete de [Datadog Agent ][8], por lo que no necesitas instalar nada más en tus contenedores o hosts.
+### Configuración {#configuration}
-### Configuración
-
-Configura tu check de OpenMetrics o Prometheus con Autodiscovery, aplicando las siguientes `annotations` a tu **pod** exponiendo las métricas de OpenMetrics/Prometheus:
+Configura tu verificación de OpenMetrics o Prometheus utilizando Autodiscovery, aplicando lo siguiente `annotations` a tu **pod** que expone las métricas de OpenMetrics/Prometheus:
{{< tabs >}}
{{% tab "Kubernetes (AD v2)" %}}
-**Nota:** AD Annotations v2 se introdujo en Datadog Agent versión 7.36 para simplificar la configuración de la integración. Para versiones anteriores de Datadog Agent, utiliza AD Annotations v1.
+**Nota**: Las Anotaciones de AD v2 se introdujeron en la versión 7.36 del Datadog Agent para simplificar la configuración de la integración. Para versiones anteriores del Datadog Agent, utiliza las Anotaciones de AD v1.
```yaml
# (...)
@@ -110,36 +109,36 @@ spec:
{{% /tab %}}
{{< /tabs >}}
-Con los siguientes valores de parámetros de configuración:
+Con los siguientes valores de marcador de posición de configuración:
-| Parámetro | Descripción |
+| Marcador de posición | Descripción |
|------------------------------------------|----------------------------------------------------------------------------------------------------|
| `` | Coincide con el nombre del contenedor que expone las métricas. |
-| `` | La ruta de URL para las métricas que brinda el contenedor, en formato Prometheus. |
-| `` | Establece el espacio de nombres que se usará como prefijo para cada métrica cuando se visualiza en Datadog. |
-| `` | Clave de métricas de Prometheus a recuperar del endpoint de Prometheus. |
-| `` | Transforma la clave de métrica `` en `` en Datadog. |
+| `` | Ruta URL para las métricas servidas por el contenedor, en formato Prometheus. |
+| `` | Establece el espacio de nombres que se prefijará a cada métrica cuando se visualice en Datadog. |
+| `` | Clave de métricas de Prometheus que se debe obtener del punto de conexión de Prometheus. |
+| `` | Transforma la clave métrica `` a `` en Datadog. |
-La configuración `metrics` es una lista de métricas para recuperar como métricas personalizadas. Incluye cada métrica a recuperar y el nombre de métrica deseado en Datadog como pares de clave-valor, por ejemplo, `{"":""}`. Para evitar cargos por métricas personalizadas, Datadog recomienda limitar el contexto para incluir solo las métricas que necesites. Alternativamente, puedes proporcionar una lista de cadenas de nombres de métrica, interpretadas como expresiones regulares, para obtener las métricas deseadas con sus nombres actuales. Si deseas **todas** las métricas, utiliza `".*"` en lugar de `"*"`.
+La configuración `metrics` es una lista de métricas para recuperar como métricas personalizadas. Incluye cada métrica a obtener y el nombre de la métrica deseada en Datadog como pares clave-valor, por ejemplo, `{"":""}`. Para evitar cargos excesivos por métricas personalizadas, Datadog recomienda limitar el alcance a solo incluir las métricas que necesitas. Alternativamente, puedes proporcionar una lista de nombres de métricas como cadenas, interpretadas como expresiones regulares, para traer las métricas deseadas con sus nombres actuales. Si deseas **todas** las métricas, entonces usa `".*"` en lugar de `"*"`.
-**Nota:** Las expresiones regulares pueden potencialmente enviar un montón de métricas personalizadas.
+**Nota:** Las expresiones regulares pueden enviar potencialmente muchas métricas personalizadas.
-Para obtener una lista completa de los parámetros disponibles para las instancias, incluidos `namespace` y `metrics`, consulta la [configuración de ejemplo openmetrics.d/conf.yaml][9].
+Para una lista completa de parámetros disponibles para instancias, incluyendo `namespace` y `metrics`, consulta el [archivo de configuración de muestra openmetrics.d/conf.yaml][9].
-**Nota**: El check se limita a 2000 métricas en forma predeterminada. Especifica el parámetro opcional `max_returned_metrics` para modificar este límite.
+**Nota**: La verificación se limita a 2000 métricas por defecto. Especifica el parámetro opcional `max_returned_metrics` para modificar este límite.
-## Empezando
+## Primeros pasos {#getting-started}
-### Recopilación sencilla de métricas (OpenMetrics Check)
+### Recolección de métricas simple (Verificación de OpenMetrics) {#simple-metric-collection-openmetrics-check}
-1. [Inicia el Datadog Agent][10].
+1. [Lanza el Datadog Agent][10].
-2. Utiliza [Prometheus `prometheus.yaml`][11] para iniciar un ejemplo de despliegue de Prometheus con la configuración de Autodiscovery en el pod:
+2. Usa el [Prometheus `prometheus.yaml`][11] para lanzar un ejemplo de despliegue de Prometheus con la configuración de Autodiscovery en el pod:
{{< tabs >}}
{{% tab "Kubernetes (AD v2)" %}}
- **Nota:** AD Annotations v2 se introdujo en Datadog Agent versión 7.36 para simplificar la configuración de la integración. Para versiones anteriores de Datadog Agent, utiliza AD Annotations v1.
+ **Nota:** Las Anotaciones de AD v2 se introdujeron en la versión 7.36 del Datadog Agent para simplificar la configuración de la integración. Para versiones anteriores del Datadog Agent, utiliza las Anotaciones de AD v1.
```yaml
# (...)
@@ -202,32 +201,32 @@ Para obtener una lista completa de los parámetros disponibles para las instanci
{{% /tab %}}
{{< /tabs >}}
- Comando para crear el despliegue de Prometheus:
+ Command to create the Prometheus Deployment:
```shell
kubectl create -f prometheus.yaml
```
-3. Entra en tu page (página) [Fleet Automation][16] y filtra por la integración `openmetrics` para ver información detallada sobre el estado de tus checks.
+3. Accede a tu página de [Fleet Automation][16] y filtra por la `openmetrics` integración para ver información detallada sobre el estado de tus verificaciones.
-4. Ve a tu página [Resumen de métrica][12] para ver las métricas recopiladas de este pod de ejemplo. Esta configuración recopilará las métricas `promhttp_metric_handler_requests` , `promhttp_metric_handler_requests_in_flight` y todas las métricas expuestas empezando por `go_memory`.
+4. Accede a tu página de [Resumen de Métricas][12] para ver las métricas recopiladas de este pod de ejemplo. Esta configuración recopilará la métrica `promhttp_metric_handler_requests`, `promhttp_metric_handler_requests_in_flight` y todas las métricas expuestas que comiencen con `go_memory`.
- {{< img src="integrations/guide/prometheus_kubernetes/openmetrics_v2_collected_metric_kubernetes.png" alt="Métrica de Prometheus recopilada en Kubernetes">}}
+ {{< img src="integrations/guide/prometheus_kubernetes/openmetrics_v2_collected_metric_kubernetes.png" alt="Métrica de Prometheus recopilada de Kubernetes">}}
-## Recopilación de métricas con anotaciones de Prometheus (Prometheus Check)
+## Recopilación de métricas con anotaciones de Prometheus (Verificación de Prometheus) {#metric-collection-with-prometheus-annotations-prometheus-check}
-Con Prometheus Autodiscovery, el Datadog Agent es capaz de detectar anotaciones nativas de Prometheus (por ejemplo: `prometheus.io/scrape`, `prometheus.io/path`, `prometheus.io/port`) y programar checks de OpenMetrics automáticamente para recopilar métricas de Prometheus en Kubernetes.
+Con Prometheus Autodiscovery, el Datadog Agent puede detectar anotaciones nativas de Prometheus (por ejemplo: `prometheus.io/scrape`, `prometheus.io/path`, `prometheus.io/port`) y programar verificaciones de OpenMetrics automáticamente para recopilar métricas de Prometheus en Kubernetes.
-**Nota**: Datadog recomienda utilizar el check de OpenMetrics, ya que es más eficiente y admite totalmente el formato de texto de Prometheus. Utiliza el check de Prometheus sólo cuando el endpoint de métricas no admita un formato de texto.
+**Nota**: Datadog recomienda usar la verificación de OpenMetrics ya que es más eficiente y soporta completamente el formato de texto de Prometheus. Utiliza la verificación de Prometheus solo cuando el punto de conexión de métricas no soporte un formato de texto.
-### Requisitos
+### Requisitos {#requirements}
-- Datadog Agent v7.27+ o v6.27+ (para checks de pod)
-- Datadog Cluster Agent v1.11+ (para checks de servicio y endpoint)
+- Datadog Agent v7.27+ o v6.27+ (para verificaciones de pod)
+- Datadog Cluster Agent v1.11+ (para verificaciones de servicio y punto de conexión)
-### Configuración
+### Configuración {#configuration-1}
-Es recomendado primero comprobar qué pods y servicios tienen la anotación `prometheus.io/scrape=true` antes de activar esta función. Esto se puede hacer con los siguientes comandos:
+Se recomienda primero verificar qué pods y servicios tienen la anotación `prometheus.io/scrape=true` antes de habilitar esta función. Esto se puede hacer con los siguientes comandos:
```shell
kubectl get pods -o=jsonpath='{.items[?(@.metadata.annotations.prometheus\.io/scrape=="true")].metadata.name}' --all-namespaces
@@ -235,16 +234,16 @@ kubectl get pods -o=jsonpath='{.items[?(@.metadata.annotations.prometheus\.io/sc
kubectl get services -o=jsonpath='{.items[?(@.metadata.annotations.prometheus\.io/scrape=="true")].metadata.name}' --all-namespaces
```
-Una vez activada la función de extracción de Prometheus, Datadog Agent recopila métricas personalizadas de estos recursos. Si no deseas recopilar las métricas personalizadas de estos recursos, puedes eliminar esta anotación o actualizar las reglas de Autodiscovery tal y como se describe en la [sección de configuración avanzada](#advanced-configuration).
+Una vez que la función de raspado de Prometheus esté habilitada, el Agente de Datadog recopila métricas personalizadas de estos recursos. Si no deseas recopilar las métricas personalizadas de estos recursos, puedes eliminar esta anotación o actualizar las reglas de Autodiscovery como se describe en la [sección de configuración avanzada](#advanced-configuration).
-**Nota**: Activar esta función sin la configuración avanzada puede causar un aumento significativo de las métricas personalizadas, lo que puede afectar tu facturación. Consulta la sección [configuración avanzada](#advanced-configuration) para saber cómo recopilar métricas únicamente de un subconjunto de contenedores/pods/servicios.
+**Nota**: Habilitar esta función sin configuración avanzada puede causar un aumento significativo en las métricas personalizadas, lo que puede llevar a implicaciones de facturación. Consulta la [sección de configuración avanzada](#advanced-configuration) para aprender cómo recopilar métricas solo de un subconjunto de contenedores/pods/servicios.
-#### Configuración básica
+#### Configuración básica {#basic-configuration}
{{< tabs >}}
{{% tab "Datadog Operator" %}}
-Actualiza tu configuración del Datadog Operador para que contenga lo siguiente:
+Actualiza la configuración de tu Datadog Operator para que contenga lo siguiente:
{{< code-block lang="yaml" filename="datadog-agent.yaml" >}}
apiVersion: datadoghq.com/v2alpha1
@@ -283,14 +282,16 @@ datadog:
{{% /tab %}}
{{% tab "Manual (DaemonSet)" %}}
-En tu manifiesto de DaemonSet para el Agent `daemonset.yaml` , añade las siguientes variables de entorno para el contenedor del Agent:
+En tu manifiesto de DaemonSet para el Datadog Agent `daemonset.yaml`, agrega las siguientes variables de entorno para el contenedor del Datadog Agent:
+
```yaml
- name: DD_PROMETHEUS_SCRAPE_ENABLED
value: "true"
- name: DD_PROMETHEUS_SCRAPE_VERSION
value: "2"
```
-Si el Cluster Agent está habilitado, dentro de su manifiesto `cluster-agent-deployment.yaml`, añade las siguientes variables de entorno para el contenedor del Cluster Agent:
+Si el Datadog Cluster Agent está habilitado, dentro de su manifiesto `cluster-agent-deployment.yaml`, agrega las siguientes variables de entorno para el contenedor del Datadog Cluster Agent:
+
```yaml
- name: DD_PROMETHEUS_SCRAPE_ENABLED
value: "true"
@@ -301,33 +302,33 @@ Si el Cluster Agent está habilitado, dentro de su manifiesto `cluster-agent-dep
{{% /tab %}}
{{< /tabs >}}
-Esto indica a Datadog Agent que detecte los pods que tienen anotaciones nativas de Prometheus y genere los checks de OpenMetrics correspondientes.
+Esto instruye al Datadog Agent a detectar los pods que tienen anotaciones nativas de Prometheus y generar las verificaciones correspondientes de OpenMetrics.
-También indica a Datadog Cluster Agent (si está habilitado) que detecte los servicios que tienen anotaciones nativas de Prometheus y genere los checks correspondientes de OpenMetrics.
+También instruye al Agente de Clúster de Datadog (si está habilitado) a detectar los servicios que tienen anotaciones nativas de Prometheus y generar las verificaciones correspondientes de OpenMetrics.
-- `prometheus.io/scrape=true`: obligatorio.
-- `prometheus.io/path`: opcional, por defecto es `/metrics`.
-- `prometheus.io/port`: opcional, por defecto es `%%port%%`, una [variable de plantilla][13] que se sustituye por el puerto del contenedor/servicio.
+- `prometheus.io/scrape=true`: Requerido.
+- `prometheus.io/path`: Opcional, por defecto es `/metrics`.
+- `prometheus.io/port`: Opcional, el valor por defecto es `%%port%%`, una [variable de plantilla][13] que es reemplazada por el puerto del contenedor/servicio.
-Esta configuración genera un check que recopila todas las métricas expuestas utilizando la configuración por defecto de la [integración de OpenMetrics][1].
+Esta configuración genera una verificación que recopila todas las métricas expuestas utilizando la configuración predeterminada de la [integración de OpenMetrics][1].
-#### Configuración avanzada
+#### Configuración avanzada {#advanced-configuration}
Puedes configurar aún más la recopilación de métricas (más allá de las anotaciones nativas de Prometheus) con el campo `additionalConfigs`.
-##### Configuraciones adicionales del check de OpenMetrics
+##### Configuraciones adicionales de verificación de OpenMetrics {#additional-openmetrics-check-configurations}
-Utiliza `additionalConfigs.configurations` para definir configuraciones adicionales del check de OpenMetrics. Consulta la [lista de parámetros de OpenMetrics compatibles][15] que puedes pasar en `additionalConfigs`.
+Usa `additionalConfigs.configurations` para definir configuraciones adicionales de verificación de OpenMetrics. Consulta la [lista de parámetros de OpenMetrics soportados][15] que puedes pasar en `additionalConfigs`.
-##### Reglas personalizadas de Autodiscovery
+##### Reglas de Autodiscovery personalizadas {#custom-autodiscovery-rules}
-Utiliza `additionalConfigs.autodiscovery` para definir reglas personalizadas de Autodiscovery. Estas reglas pueden basarse en nombres de contenedores, anotaciones de Kubernetes o ambos.
+Utiliza `additionalConfigs.autodiscovery` para definir reglas personalizadas de Autodiscovery. Estas reglas pueden basarse en nombres de contenedores, anotaciones de Kubernetes o en ambos.
`additionalConfigs.autodiscovery.kubernetes_container_names`
-: una lista de nombres de contenedores a los que apuntar, en formato de expresión regular.
+: Una lista de nombres de contenedores a los que dirigirse, en formato de expresión regular.
`additionalConfigs.autodiscovery.kubernetes_annotations`
-: Dos mapas (`include` y `exclude`) de anotaciones para definir reglas de detección.
+: Dos mapas (`include` y `exclude`) de anotaciones para definir reglas de descubrimiento.
Por defecto:
```yaml
@@ -339,14 +340,14 @@ Utiliza `additionalConfigs.autodiscovery` para definir reglas personalizadas de
Si se definen tanto `kubernetes_container_names` como `kubernetes_annotations`, se utiliza la lógica **AND** (ambas reglas deben coincidir).
-##### Ejemplos
+##### Ejemplos {#examples}
-La siguiente configuración se dirige a un contenedor llamado `my-app` que se ejecuta en un pod con la anotación `app=my-app`. La configuración del check de OpenMetrics se personaliza para activar la opción `send_distribution_buckets` y definir un tiempo de espera personalizado de 5 segundos.
+La siguiente configuración apunta a un contenedor llamado `my-app` que se ejecuta en un pod con la anotación `app=my-app`. La configuración de verificación de OpenMetrics se personaliza para habilitar la opción `send_distribution_buckets` y definir un tiempo de espera personalizado de 5 segundos.
{{< tabs >}}
{{% tab "Datadog Operator" %}}
-Actualiza tu configuración del Datadog Operador para que contenga lo siguiente:
+Actualiza la configuración de tu Datadog Operator para que contenga lo siguiente:
{{< code-block lang="yaml" filename="datadog-agent.yaml" >}}
apiVersion: datadoghq.com/v2alpha1
@@ -398,7 +399,7 @@ datadog:
{{% /tab %}}
{{% tab "Manual (DaemonSet)" %}}
-Para el DaemonSet, la configuración avanzada se define en la variable de entorno`DD_PROMETHEUS_SCRAPE_CHECKS`, no en un campo `additionalConfigs`.
+Para DaemonSet, la configuración avanzada se define en la variable de entorno `DD_PROMETHEUS_SCRAPE_CHECKS`, no en un campo `additionalConfigs`.
```yaml
- name: DD_PROMETHEUS_SCRAPE_ENABLED
@@ -415,13 +416,13 @@ Para el DaemonSet, la configuración avanzada se define en la variable de entorn
{{% /tab %}}
{{< /tabs >}}
-## De la integración personalizada a la oficial
+## De la integración personalizada a la oficial {#from-custom-to-official-integration}
-Por defecto, todas las métricas recuperadas por el check genérico de Prometheus se consideran métricas personalizadas. Si estás monitorizando software comercial y crees que merece tener una integración oficial, no dudes en [contribuir][5].
+Por defecto, todas las métricas recuperadas por la verificación genérica de Prometheus se consideran métricas personalizadas. Si estás monitoreando software estándar y crees que merece una integración oficial, ¡no dudes en [contribuir][5]!
-Las integraciones oficiales tienen sus propios directorios específicos. Hay un mecanismo de instancia por defecto en el check genérico para codificar la configuración predeterminada y los metadatos de métricas. Por ejemplo, consulta la integración [kube-proxy][14].
+Las integraciones oficiales tienen sus propios directorios dedicados. Hay un mecanismo de instancia por defecto en la verificación genérica para codificar la configuración y los metadatos de métricas por defecto. Por ejemplo, referencia la integración de [kube-proxy][14].
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -429,13 +430,13 @@ Las integraciones oficiales tienen sus propios directorios específicos. Hay un
[2]: /es/integrations/prometheus/
[3]: https://github.com/DataDog/integrations-core/tree/master/openmetrics
[4]: https://github.com/DataDog/integrations-core/tree/master/prometheus
-[5]: /es/developers/custom_checks/prometheus/
+[5]: /es/extend/custom_checks/prometheus/
[6]: /es/integrations/guide/prometheus-metrics
[7]: /es/agent/kubernetes/#installation
[8]: /es/getting_started/tagging/
[9]: https://github.com/DataDog/integrations-core/blob/master/openmetrics/datadog_checks/openmetrics/data/conf.yaml.example
[10]: https://app.datadoghq.com/account/settings/agent/latest?platform=kubernetes
-[11]: /resources/yaml/prometheus.yaml
+[11]: /es/resources/yaml/prometheus.yaml
[12]: https://app.datadoghq.com/metric/summary
[13]: /es/agent/faq/template_variables/
[14]: https://github.com/DataDog/integrations-core/tree/master/kube_proxy
diff --git a/content/es/dashboards/_index.md b/content/es/dashboards/_index.md
index 7c4803fdd13..cca07bd2927 100644
--- a/content/es/dashboards/_index.md
+++ b/content/es/dashboards/_index.md
@@ -16,106 +16,107 @@ cascade:
tags:
- snapshot
- dashboards
-description: Visualiza tus datos para obtener más información
+description: Visualiza tus datos para obtener información
further_reading:
-- link: https://app.datadoghq.com/release-notes?category=Dashboards
- tag: Notas de versiones
- text: ¡Ëchales un vistazo a las últimas versiones de dashboards de Datadog! (Se
- requiere iniciar sesión en la aplicación).
- link: /dashboards/sharing/
tag: Documentación
- text: Compartir gráficos fuera de Datadog
+ text: Comparte tus gráficos fuera de Datadog
+- link: https://datadoghq.dev/integrations-core/guidelines/dashboards/#best-practices
+ tag: Mejores prácticas
+ text: Crea excelentes Dashboards de integración
+- link: https://dtdg.co/fe
+ tag: Habilitación de la fundación
+ text: Únete a una sesión interactiva sobre mejores visualizaciones con Dashboards
- link: https://www.datadoghq.com/blog/datadog-clipboard/
tag: Blog
- text: Añade widgets del dashboard a tu portapapeles
+ text: Agrega widgets de Dashboards a tu portapapeles
- link: https://www.datadoghq.com/blog/datadog-dashboards/
tag: Blog
- text: Una nueva experiencia con los dashboards de Datadog
-- link: https://datadoghq.dev/integrations-core/guidelines/dashboards/#best-practices
- tag: Prácticas recomendadas
- text: Crea unos dashboards de integración excelentes
-- link: https://dtdg.co/fe
- tag: Habilitación de los fundamentos
- text: Participa en una sesión interactiva sobre las mejores visualizaciones con
- dashboards
+ text: La nueva experiencia de Dashboards de Datadog
+- link: https://www.datadoghq.com/blog/datadog-executive-dashboards
+ tag: Blog
+ text: Diseña Dashboards ejecutivos efectivos con Datadog
+- link: https://app.datadoghq.com/release-notes?category=Dashboards
+ tag: Notas de la versión
+ text: ¡Consulta las últimas versiones de los Dashboards de Datadog! (Se requiere
+ inicio de sesión en la aplicación).
title: Dashboards
---
+## Resumen {#overview}
-## Información general
-
-Los dashboards proporcionan información en tiempo real sobre el rendimiento y el estado de los sistemas y las aplicaciones de una organización. Permiten a los usuarios analizar visualmente los datos, realizar un seguimiento de los indicadores clave de rendimiento (KPI) y monitorizar tendencias de forma eficaz. Con los dashboards, los equipos pueden identificar anomalías, priorizar problemas, detectar problemas de forma proactiva, diagnosticar sus causas raíz y garantizar el cumplimiento de los objetivos de confiabilidad. Permite a tus equipos tomar decisiones informadas, optimizar las operaciones del sistema e impulsar el éxito empresarial, proporcionando una interfaz centralizada y fácil de utilizar para monitorizar y analizar los indicadores críticos de métricas y de rendimiento.
+Los Dashboards proporcionan información en tiempo real sobre el rendimiento y la salud de los sistemas y aplicaciones dentro de una organización. Permiten a los usuarios analizar visualmente los datos, rastrear indicadores clave de rendimiento (KPI) y monitorear tendencias de manera eficiente. Con los Dashboards, los equipos pueden identificar anomalías, priorizar problemas, detectar proactivamente problemas, diagnosticar causas raíz y asegurar que se cumplan los objetivos de confiabilidad. Empodera a tus equipos para tomar decisiones informadas, optimizar las operaciones del sistema y impulsar el éxito empresarial al proporcionar una interfaz centralizada y fácil de usar para monitorear y analizar métricas críticas e indicadores de rendimiento.
-{{< whatsnext desc="Funciones del dashboard:">}}
- {{< nextlink href="/dashboards/configure" >}}Configuración: Información general sobre las opciones de configuración de dashboards{{< /nextlink >}}
- {{< nextlink href="/dashboards/list" >}}Lista de dashboards: Búsqueda, visualización o creación de dashboards y listas{{< /nextlink >}}
- {{< nextlink href="/dashboards/template_variables" >}}Variable de plantilla: Filtrado dinámico de widgets en un dashboard{{< /nextlink >}}
+{{< whatsnext desc="Características de Dashboards:">}}
+ {{< nextlink href="/dashboards/configure" >}}Configurar: Resumen de las opciones de configuración para los Dashboards{{< /nextlink >}}
+ {{< nextlink href="/dashboards/list" >}}Dashboard List: Buscar, ver o crear Dashboards y listas{{< /nextlink >}}
+ {{< nextlink href="/dashboards/template_variables" >}}Variable de plantilla: Filtra dinámicamente los widgets en un Dashboard{{< /nextlink >}}
{{< nextlink href="/dashboards/guide/datadog_clipboard/" >}}Portapapeles de Datadog{{< /nextlink >}}
- {{< nextlink href="/api/latest/dashboards" >}}API: Gestión de dashboards mediante programación{{< /nextlink >}}
+ {{< nextlink href="/api/latest/dashboards" >}}API: Administrar Dashboards programáticamente{{< /nextlink >}}
{{< /whatsnext >}}
-{{< whatsnext desc="Funciones gráficas:">}}
- {{< nextlink href="/dashboards/widgets" >}}Widgets: Obtén información sobre la configuración de diferentes visualizaciones{{< /nextlink >}}
- {{< nextlink href="/dashboards/querying" >}}Consultas: Visualiza las opciones de formatos para las consultas gráficas{{< /nextlink >}}
- {{< nextlink href="/dashboards/functions" >}}Funciones: Modifica consultas sobre métricas y los gráficos resultantes{{< /nextlink >}}
- {{< nextlink href="/dashboards/change_overlays" >}}Superposiciones: Superpone automáticamente eventos de cambios en gráficos{{< /nextlink >}}
+{{< whatsnext desc="Características de graficación:">}}
+ {{< nextlink href="/dashboards/widgets" >}}Widgets: Aprender la configuración para diferentes visualizaciones{{< /nextlink >}}
+ {{< nextlink href="/dashboards/querying" >}}Consultas: Ver las opciones de formato para consultas gráficas{{< /nextlink >}}
+ {{< nextlink href="/dashboards/functions" >}}Funciones: Modificar consultas de métricas y gráficos resultantes{{< /nextlink >}}
+ {{< nextlink href="/dashboards/change_overlays" >}}Superposiciones: Superponer automáticamente eventos de cambio en gráficos{{< /nextlink >}}
{{< /whatsnext >}}
-## Para empezar
+## Comenzar {#get-started}
-Para crear un dashboard:
-1. Haz clic en **+Nuevo dashboard** en la page (página) [Listas de dashboards][4] o en **Nuevo dashboard** en el menú de navegación.
-2. Introduce un nombre para el dashboard y elige una opción de diseño.
+Para crear un Dashboard:
+1. Haga clic en **+Nuevo Dashboard** en la página de [Dashboard List][4] o **Nuevo Dashboard** en el menú de navegación.
+2. Ingrese un nombre para el Dashboard y elija una opción de diseño.
-{{< img src="dashboards/create-dashboard.png" alt="Añadir un nuevo dashboard" style="width:70%;">}}
+{{< img src="dashboards/create-dashboard.png" alt="Agregando un nuevo Dashboard" style="width:70%;">}}
Dashboards
-: Tienen un diseño basado en cuadrículas, que puede incluir una variedad de objetos como imágenes, gráficos y logs. Suelen utilizarse como tableros de estado o vistas narrativas que se actualizan en tiempo real y pueden representar puntos específicos del pasado. Tienen una anchura máxima de 12 cuadrados de cuadrícula y también resultan útiles para tareas de depuración.
+: Un diseño basado en cuadrícula, que puede incluir una variedad de objetos como imágenes, gráficos y registros. Se utilizan comúnmente como Dashboards de estado o vistas narrativas que se actualizan en tiempo real, y pueden representar puntos fijos en el pasado. Tienen un ancho máximo de 12 cuadros de cuadrícula y también funcionan bien para depuración.
-Timeboards (Tableros temporales)
-: Tienen un diseño automático que representa un único punto en el tiempo, ya sea fijo o en tiempo real, en todo el dashboard. Suelen utilizarse para solucionar problemas, la correlación y la exploración general de datos.
+Timeboards
+: Diseños automáticos que representan un único punto en el tiempo—ya sea fijo o en tiempo real—en todo el Dashboard. Se utilizan comúnmente para la resolución de problemas, correlación y exploración general de datos.
-Screenboards (Pantallas)
-: Dashboards con un diseño de forma libre que puede incluir una variedad de objetos, como imágenes, gráficos y logs. Suelen utilizarse como tableros de estado o vistas narrativas que se actualizan en tiempo real o que representan puntos específicos del pasado.
+Paneles visuales
+: Paneles visuales con diseños de forma libre que pueden incluir una variedad de objetos como imágenes, gráficos y registros. Se utilizan comúnmente como paneles visuales de estado o vistas narrativas que se actualizan en tiempo real o representan puntos fijos en el pasado.
-{{< whatsnext desc="Consulta los siguientes recursos:" >}}
- {{< nextlink href="/getting_started/dashboards/" >}}Empezando con los dashboards{{< /nextlink >}}
- {{< nextlink href="https://learn.datadoghq.com/courses/intro-dashboards" >}}Curso de aprendizaje: Presentación de los dashboards{{< /nextlink >}}
- {{< nextlink href="https://learn.datadoghq.com/courses/building-better-dashboards" >}}Curso de aprendizaje: Crear mejores dashboards{{< /nextlink >}}
+{{< whatsnext desc="Vea los siguientes recursos:" >}}
+ {{< nextlink href="/getting_started/dashboards/" >}}Introducción a Dashboards{{< /nextlink >}}
+ {{< nextlink href="https://learn.datadoghq.com/courses/intro-dashboards" >}}Curso de Aprendizaje: Introducción a Dashboards{{< /nextlink >}}
+ {{< nextlink href="https://learn.datadoghq.com/courses/building-better-dashboards" >}}Curso de Aprendizaje: Creando Mejores Dashboards{{< /nextlink >}}
{{< /whatsnext >}}
-## Frecuencia de actualización
+## Tasa de actualización {#refresh-rate}
-La frecuencia de actualización de un dashboard privado depende del periodo de tiempo que se esté visualizando. Cuanto más corto sea el periodo, más a menudo se actualizarán los datos. Los dashboards compartidos públicamente se actualizan cada treinta segundos, independientemente del intervalo de tiempo que se haya seleccionado.
+La tasa de actualización de un Dashboard privado depende del marco de tiempo que esté visualizando. Cuanto más corto sea el marco de tiempo, más frecuentemente se actualizan los datos. Los Dashboards compartidos públicamente se actualizan cada treinta segundos, independientemente del marco de tiempo seleccionado.
-| Periodo de tiempo | Frecuencia de actualización |
+| Marco de tiempo | Tasa de actualización |
|--------------|--------------|
| 1 minuto | 10 segundos |
| 2 minutos | 10 segundos |
-| 5 minutos | 10 segundos |
-| 10 minutos | 10 segundos |
-| 30 minutos | 20 segundos |
-| 1 hora | 20 segundos |
-| 3 horas | 1 minuto |
-| 4 horas | 1 minuto |
-| 1 día | 3 minutos |
-| 2 días | 10 minutos |
-| 1 semana | 1 hora |
-| 1 mes | 1 hora |
-| 3 meses | 1 hora |
-| 6 meses | 1 hora |
-| 1 año | 1 hora |
+| 5 minutos | 10 segundos |
+| 10 minutos | 10 segundos |
+| 30 minutos | 20 segundos |
+| 1 hora | 20 segundos |
+| 3 horas | 1 minuto |
+| 4 horas | 1 minuto |
+| 1 día | 3 minutos |
+| 2 días | 10 minutos |
+| 1 semana | 1 hora |
+| 1 mes | 1 hora |
+| 3 meses | 1 hora |
+| 6 meses | 1 hora |
+| 1 año | 1 hora |
-## Ver dashboards en dispositivos móviles
+## Ver Dashboards en dispositivos móviles {#view-dashboards-on-mobile-devices}
-Consulta tus dashboards en formato móvil con la aplicación móvil de Datadog, disponible en [Apple App Store][2] y [Google Play Store][3]. La aplicación móvil viene equipada con widgets móviles en la pantalla de inicio que te permiten monitorizar servicios de salud y de infraestructura sin abrir la aplicación móvil.
+Vea sus Dashboards en un formato amigable para móviles con la aplicación móvil de Datadog, disponible en el [Apple App Store][2] y [Google Play Store][3]. La aplicación móvil de Datadog viene equipada con widgets para la pantalla de inicio que te permiten monitorear la salud del servicio y la infraestructura sin abrir la aplicación.
-**Nota**: Para configurar o editar un dashboard, debes iniciar sesión en la interfaz de usuario del navegador de Datadog. Para obtener más información sobre la instalación de la aplicación, consulta la documentación de la [aplicación móvil de Datadog][1].
+**Nota**: Para configurar o editar un Dashboard, debes iniciar sesión en la interfaz de usuario del navegador de Datadog. Para más información sobre la instalación de la aplicación, consulte la documentación de la [Aplicación Móvil de Datadog][1].
-## Referencias adicionales
+## Lectura adicional {#further-reading}
-{{< learning-center-callout header="Try Creating Graph Widgets in the Datadog Learning Center" btn_title="Enroll Now" btn_url="https://learn.datadoghq.com/courses/dashboard-graph-widgets">}} Explora los widgets de series temporales, valor de consulta, top list (lista principal), tabla, distribución y gráfico circular. Aprende a configurar los widgets y a comprender cuándo debe utilizarse cada tipo de widget. {{< /learning-center-callout >}}
+{{< learning-center-callout header="Intenta crear widgets de gráficos en el Datadog Learning Center" btn_title="Inscríbete ahora" btn_url="https://learn.datadoghq.com/courses/dashboard-graph-widgets">}} Explora widgets de series temporales, consulta de valores, lista principal, tabla, distribución y gráfico de pastel. Aprende a configurar los widgets y desarrolla una comprensión de cuándo se debe utilizar cada tipo de widget. {{< /learning-center-callout >}}
-{{< learning-center-callout header="Try Creating Table, List, SLO, and Architecture Widgets in the Datadog Learning Center" btn_title="Enroll Now" btn_url="https://learn.datadoghq.com/courses/discovering-table-list-widgets">}} Explora los widgets de tabla, lista, SLOs y arquitectura. Aprende a rastrear las métricas y el rendimiento de una aplicación web y descubre cómo presentar datos importantes. {{< /learning-center-callout >}}
+{{< learning-center-callout header="Intenta crear widgets de tabla, lista, SLO y arquitectura en el Datadog Learning Center" btn_title="Inscríbete ahora" btn_url="https://learn.datadoghq.com/courses/discovering-table-list-widgets">}} Explora widgets de tabla, lista, SLO y arquitectura. Aprende a rastrear las métricas y el rendimiento de una aplicación web y descubre cómo presentar datos importantes. {{< /learning-center-callout >}}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/extend/dogstatsd/_index.md b/content/es/extend/dogstatsd/_index.md
new file mode 100644
index 00000000000..afe01350b74
--- /dev/null
+++ b/content/es/extend/dogstatsd/_index.md
@@ -0,0 +1,637 @@
+---
+aliases:
+- /es/guides/dogstatsd/
+- /es/guides/DogStatsD/
+- /es/developers/faq/how-to-remove-the-host-tag-when-submitting-metrics-via-dogstatsd/
+- /es/integrations/faq/dogstatsd-and-docker
+- /es/agent/kubernetes/dogstatsd
+- /es/developers/dogstatsd/
+description: Descripción general de las características de DogStatsD, incluidos los
+ tipos de datos y el etiquetado.
+further_reading:
+- link: integrations/node
+ tag: Documentación
+ text: Habilitar DogStatsD para Node.js a través de la integración de Node.js
+- link: extend/dogstatsd
+ tag: Documentación
+ text: Introducción a DogStatsD
+- link: extend/libraries
+ tag: Documentación
+ text: Bibliotecas de cliente de API y DogStatsD creadas oficialmente y por la comunidad
+- link: https://www.datadoghq.com/blog/monitor-azure-app-service-linux/
+ tag: Blog
+ text: Monitorea tus aplicaciones web de Linux en Azure App Service con Datadog
+- link: https://www.datadoghq.com/blog/datadog-csi-driver/
+ tag: Blog
+ text: Aporta observabilidad de alto rendimiento a entornos de Kubernetes seguros
+ con el controlador CSI de Datadog
+- link: https://learn.datadoghq.com/courses/create-custom-metrics-dogstatsd
+ tag: Centro de Aprendizaje
+ text: Crea Custom Metrics con DogStatsD
+title: DogStatsD
+---
+La forma más fácil de enviar las métricas personalizadas de tu aplicación a Datadog es enviarlas a DogStatsD, un servicio de agregación de métricas incluido con el Datadog Agent. DogStatsD implementa el protocolo [StatsD][1] y añade algunas extensiones específicas de Datadog:
+
+- Tipo de métrica de histograma
+- Verificaciones de servicio
+- Eventos
+- Etiquetado
+
+Cualquier cliente StatsD compatible funciona con DogStatsD y el Datadog Agent, pero no incluye las [extensiones específicas de Datadog](#dive-into-dogstatsd).
+
+**Nota**: DogStatsD NO implementa temporizadores de StatsD como un tipo de métrica nativa (aunque sí los soporta a través de [histogramas][2]).
+
+DogStatsD está disponible en el Registro de Contenedores de Datadog, GAR, ECR, Azure ACR y Docker Hub:
+
+| Registro | Imagen |
+| -------------------------- | --------------------------------------- |
+| Registro de Contenedores de Datadog | [registry.datadoghq.com/dogstatsd][33] |
+| Registro de Artefactos de Google | [gcr.io/datadoghq/dogstatsd][4] |
+| Amazon ECR | [public.ecr.aws/datadog/dogstatsd][34] |
+| Azure ACR | datadoghq.azurecr.io/dogstatsd |
+| Docker Hub | [hub.docker.com/r/datadog/dogstatsd][3] |
+
+
Docker Hub está sujeto a límites de tasa de descarga de imágenes. Si no eres cliente de Docker Hub, Datadog recomienda que utilices el Registro de Contenedores de Datadog o un registro de proveedor de nube en su lugar. Para instrucciones, consulta Cómo cambiar tu registro de contenedores.
+
+## Cómo funciona {#how-it-works}
+
+DogStatsD acepta [métricas personalizadas][5], [eventos][6] y [verificaciones de servicio][7] a través de UDP y las agrega y reenvía periódicamente a Datadog.
+
+Debido a que utiliza UDP, tu aplicación puede enviar métricas a DogStatsD y continuar su trabajo sin esperar una respuesta. Si DogStatsD alguna vez deja de estar disponible, tu aplicación no experimenta una interrupción.
+
+{{< img src="metrics/custom_metrics/dogstatsd_metrics_submission/dogstatsd.png" alt="dogstatsd" >}}
+
+A medida que recibe datos, DogStatsD agrega múltiples puntos de datos para cada métrica única en un solo punto de datos durante un período de tiempo llamado _el intervalo de vaciado_. DogStatsD utiliza un intervalo de vaciado de 10 segundos.
+
+## Configuración {#setup}
+
+DogStatsD consiste en un servidor, que se incluye con el Datadog Agent, y una biblioteca cliente, que está disponible en múltiples lenguajes. El servidor DogStatsD está habilitado por defecto en el puerto UDP `8125` para el Datadog Agent v6+. Puedes establecer un puerto personalizado para el servidor si es necesario. Configura tu cliente para que coincida con la dirección y el puerto del servidor DogStatsD del Datadog Agent.
+
+### Servidor DogStatsD del Datadog Agent {#datadog-agent-dogstatsd-server}
+
+{{< tabs >}}
+{{% tab "Host Agent" %}}
+
+Si necesitas cambiar el puerto, configura la opción `dogstatsd_port` en el archivo principal de configuración del [Datadog Agent][1], y reinicia el Datadog Agent. También puedes configurar DogStatsD para usar un [socket de dominio UNIX][2].
+
+Para habilitar un puerto UDP personalizado para el servidor DogStatsD del Datadog Agent:
+
+1. Establece el parámetro `dogstatsd_port`:
+
+ ```yaml
+ ## @param dogstatsd_port - integer - optional - default: 8125
+ ## Override the Agent DogStatsD port.
+ ## Note: Make sure your client is sending to the same UDP port.
+ #
+ dogstatsd_port: 8125
+ ```
+
+2. [Reinicia tu Datadog Agent][3].
+
+[1]: /es/agent/configuration/agent-configuration-files/?tab=agentv6v7#agent-main-configuration-file
+[2]: /es/extend/dogstatsd/unix_socket/
+[3]: /es/agent/configuration/agent-commands/
+{{% /tab %}}
+{{% tab "Agente de Contenedor" %}}
+
+Por defecto, DogStatsD escucha en el puerto UDP **8125**, por lo que necesitas vincular este puerto a tu puerto de host al ejecutar el Agente en un contenedor. Si tus métricas de StatsD provienen de fuera de `localhost`, debes establecer `DD_DOGSTATSD_NON_LOCAL_TRAFFIC` en `true` para permitir la recolección de métricas. Para ejecutar el Agente con el servidor DogStatsD activo, ejecuta el siguiente comando:
+
+```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= \
+ -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC="true" \
+ -p 8125:8125/udp \
+ registry.datadoghq.com/agent:latest
+```
+
+Si necesitas cambiar el puerto utilizado para recolectar métricas de StatsD, utiliza la variable de entorno `DD_DOGSTATSD_PORT="`. También puedes configurar DogStatsD para usar un [socket de dominio UNIX][1].
+
+[1]: /es/extend/dogstatsd/unix_socket/
+{{% /tab %}}
+{{% tab "Datadog Operator" %}}
+
+La recolección de métricas de StatsD está habilitada por defecto en [socket de dominio UNIX][1]. Para comenzar a recolectar tus métricas de StatsD a través de UDP, necesitas activar la función DogStatsD en la configuración del Datadog Operator.
+
+1. Agrega `features.dogstatsd.hostPortConfig.enabled` a tu manifiesto de `datadog-agent.yaml`:
+
+ ```yaml
+ features:
+ dogstatsd:
+ hostPortConfig:
+ enabled: true
+ ```
+
+ This is an example `datadog-agent.yaml` manifest:
+ ```yaml
+ apiVersion: datadoghq.com/v2alpha1
+ kind: DatadogAgent
+ metadata:
+ name: datadog
+ spec:
+ global:
+ credentials:
+ apiSecret:
+ secretName: datadog-secret
+ keyName: api-key
+ features:
+ dogstatsd:
+ hostPortConfig:
+ enabled: true
+ ```
+
+ This enables the Agent to collect StatsD metrics over UDP on port `8125`.
+
+2. Aplica el cambio:
+
+ ```shell
+ kubectl apply -f datadog-agent.yaml
+ ```
+
+**Advertencia**: El parámetro `features.dogstatsd.hostPortConfig.hostPort` abre un puerto en tu host. Asegúrate de que tu firewall solo permita el acceso desde tus aplicaciones o fuentes de confianza. Si tu complemento de red no soporta `hostPorts`, agrega `hostNetwork: true` en las especificaciones de tu pod Agent. Esto comparte el espacio de nombres de red de tu host con el Datadog Agent. También significa que todos los puertos abiertos en el contenedor están abiertos en el host. Si un puerto se utiliza tanto en el host como en tu contenedor, hay un conflicto (ya que comparten el mismo espacio de nombres de red) y el pod no se inicia. Algunas instalaciones de Kubernetes no permiten esto.
+
+### Envía métricas de StatsD al Agent {#send-statsd-metrics-to-the-agent}
+
+Tu aplicación necesita una forma confiable de determinar la dirección IP de su host. Esto se simplifica en Kubernetes 1.7, que amplía el conjunto de atributos que puedes pasar a tus pods como variables de entorno. En versiones 1.7 y superiores, puedes pasar la IP del host a cualquier pod agregando una variable de entorno al PodSpec. Por ejemplo, tu manifiesto de aplicación podría verse así:
+
+```yaml
+env:
+ - name: DD_AGENT_HOST
+ valueFrom:
+ fieldRef:
+ fieldPath: status.hostIP
+```
+
+Con esto, cualquier pod que ejecute tu aplicación puede enviar métricas de DogStatsD con el puerto `8125` en `$DD_AGENT_HOST`.
+
+**Nota**: Como buena práctica, Datadog recomienda usar unified service tagging al asignar atributos. Unified service tagging vincula la telemetría de Datadog a través del uso de tres etiquetas estándar: `env`, `service` y `version`. Para aprender a unificar tu entorno, consulta [unified service tagging][4].
+
+[1]: /es/extend/dogstatsd/unix_socket/
+[2]: https://github.com/containernetworking/cni
+[3]: https://kubernetes.io/docs/setup/independent/troubleshooting-kubeadm/#hostport-services-do-not-work
+[4]: /es/getting_started/tagging/unified_service_tagging
+{{% /tab %}}
+{{% tab "Helm" %}}
+
+Para recopilar métricas personalizadas con [DogStatsD][1] usando Helm:
+
+1. Actualiza tu archivo [datadog-values.yaml][2] para habilitar DogStatsD:
+
+ ```yaml
+ dogstatsd:
+ port: 8125
+ useHostPort: true
+ nonLocalTraffic: true
+ ```
+
+ **Note**: `hostPort` functionality requires a networking provider that adheres to the [CNI specification][3], such as Calico, Canal, or Flannel. For more information, including a workaround for non-CNI network providers, see the Kubernetes documentation: [HostPort services do not work][4].
+
+ **Warning**: The `hostPort` parameter opens a port on your host. Make sure your firewall only allows access from your applications or trusted sources. If your network plugin doesn't support `hostPorts`, so add `hostNetwork: true` in your Agent pod specifications. This shares the network namespace of your host with the Datadog Agent. It also means that all ports opened on the container are opened on the host. If a port is used both on the host and in your container, they conflict (since they share the same network namespace) and the pod does not start. Some Kubernetes installations do not allow this.
+
+2. Actualiza la configuración de tu Datadog Agent:
+
+ ``` shell
+ helm upgrade -f datadog-values.yaml datadog/datadog
+ ```
+
+3. Actualiza tus pods de aplicación: Tu aplicación necesita una forma confiable de determinar la dirección IP de tu host. Esto se simplifica en Kubernetes 1.7, que amplía el conjunto de atributos que puedes pasar a tus pods como variables de entorno. En versiones 1.7 y superiores, puedes pasar la IP del host a cualquier pod agregando una variable de entorno al PodSpec. Por ejemplo, tu manifiesto de aplicación podría verse así:
+
+ ```yaml
+ env:
+ - name: DD_AGENT_HOST
+ valueFrom:
+ fieldRef:
+ fieldPath: status.hostIP
+ ```
+
+ With this, any pod running your application is able to send DogStatsD metrics through port `8125` on `$DD_AGENT_HOST`.
+
+[1]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/
+[2]: https://github.com/DataDog/helm-charts/blob/master/charts/datadog/values.yaml
+[3]: https://github.com/containernetworking/cni
+[4]: https://kubernetes.io/docs/setup/independent/troubleshooting-kubeadm/#hostport-services-do-not-work
+{{% /tab %}}
+{{< /tabs >}}
+
+### Detección de origen {#origin-detection}
+
+El Datadog Agent v6.10.0 soporta _detección de origen_, lo que permite a DogStatsD detectar de dónde provienen las métricas del contenedor y etiquetar automáticamente las métricas. Cuando la detección de origen está habilitada, todas las métricas recibidas a través de UDP son etiquetadas por el mismo pod
+etiquetas como métricas de Autodiscovery.
+
+#### En un cliente de DogStatsD {#in-a-dogstatsd-client}
+
+La detección de origen está habilitada por defecto en todos los clientes de DogStatsD.
+
+Para **deshabilitar** la detección de origen en un cliente, realice una de las siguientes acciones:
+- Establezca la variable de entorno `DD_ORIGIN_DETECTION_ENABLED=false`
+- Configure la biblioteca de DogStatsD para deshabilitar la detección de origen. Para instrucciones, consulte la [documentación de su biblioteca específica de DogStatsD][10].
+
+#### En el Agente de Datadog {#in-the-datadog-agent}
+La detección de origen no está habilitada por defecto en el Agente de Datadog. Para **habilitar** la detección de origen en el Agente de Datadog, establezca la variable de entorno `DD_DOGSTATSD_ORIGIN_DETECTION_CLIENT` en `true`.
+
+Establezca [`shareProcessNamespace:true` en la especificación del pod][12] para ayudar al Agente en la detección de origen en EKS Fargate.
+
+#### Cómo se detectan los orígenes {#how-origins-are-detected}
+
+La detección de origen se puede lograr de varias maneras. La detección de origen a través de cgroups está habilitada por defecto. La detección de origen sobre UDP o `DD_EXTERNAL_ENV` requiere configuración.
+
+{{< tabs >}}
+{{% tab "Cgroups" %}}
+En Linux, el ID del contenedor se puede extraer de las entradas `procfs` relacionadas con `cgroups`. El cliente lee de `/proc/self/cgroup` o `/proc/self/mountinfo` para intentar analizar el ID del contenedor.
+
+En cgroup v2, el ID del contenedor se puede inferir resolviendo la ruta del cgroup desde `/proc/self/cgroup`, combinándola con el punto de montaje del cgroup desde `/proc/self/mountinfo`. El inode del directorio resultante se envía al Agente de Datadog. Si el Agente de Datadog está en el mismo nodo que el cliente, esta información se puede utilizar para identificar el UID del pod.
+{{% /tab %}}
+
+{{% tab "UDP" %}}
+Para habilitar la detección de origen sobre UDP, agregue las siguientes líneas a su manifiesto de aplicación:
+
+```yaml
+env:
+- name: DD_ENTITY_ID
+ valueFrom:
+ fieldRef:
+ fieldPath: metadata.uid
+```
+
+El cliente de DogStatsD adjunta una etiqueta interna, `entity_id`. El valor de esta etiqueta es el contenido de la variable de entorno `DD_ENTITY_ID`, que es el UID del pod.
+
+
Para UDP, pod_name las etiquetas no se añaden por defecto para evitar crear demasiadas métricas personalizadas.
+{{% /tab %}}
+
+{{% tab "DD_EXTERNAL_ENV" %}}
+Agrega la siguiente etiqueta a tu pod:
+
+```
+admission.datadoghq.com/enabled: "true"
+```
+
+Si tu pod tiene esta etiqueta, el [Controlador de Admisiones][1] inyecta una variable de entorno, `DD_EXTERNAL_ENV`. El valor de esta variable se envía en un campo con la métrica, que puede ser utilizado por el Agente de Datadog para determinar el origen de la métrica.
+
+[1]: /es/containers/cluster_agent/admission_controller
+{{% /tab %}}
+{{< /tabs >}}
+
+#### Cardinalidad de etiqueta {#tag-cardinality}
+
+Consulte [Asignación de Etiquetas: Cardinalidad de Etiqueta][11] para más información sobre la cardinalidad de etiqueta.
+
+##### Globalmente {#globally}
+
+Puedes especificar la cardinalidad de etiqueta globalmente configurando la variable de entorno `DD_CARDINALITY`, o pasando un campo `'cardinality'` al constructor.
+
+##### Por métrica {#per-metric}
+
+Puedes especificar la cardinalidad de etiqueta por métrica pasando el valor en el parámetro `cardinality`. Los valores válidos para este parámetro son `"none"`, `"low"`, `"orchestrator"` o `"high"`.
+
+### Cliente DogStatsD {#dogstatsd-client}
+
+Instala la biblioteca del cliente DogStatsD para tu lenguaje preferido y configúrala para que coincida con la dirección y el puerto del servidor DogStatsD del Agente de Datadog.
+
+#### Instala el cliente DogStatsD {#install-the-dogstatsd-client}
+
+Las bibliotecas oficiales del cliente Datadog-DogStatsD están disponibles para los siguientes lenguajes. Cualquier cliente StatsD compatible funciona con DogStatsD y el Agente, pero no incluye las características específicas de Datadog mencionadas anteriormente:
+{{< programming-lang-wrapper langs="python,ruby,go,java,PHP,.NET" >}}
+
+{{< programming-lang lang="python" >}}
+
+```shell
+pip install datadog
+```
+
+{{< /programming-lang >}}
+
+{{< programming-lang lang="ruby" >}}
+
+```shell
+gem install dogstatsd-ruby
+```
+
+{{< /programming-lang >}}
+
+{{< programming-lang lang="go" >}}
+
+```shell
+go get github.com/DataDog/datadog-go/v5/statsd
+```
+
+{{< /programming-lang >}}
+
+{{< programming-lang lang="java" >}}
+
+El Cliente Java DataDog StatsD se distribuye con Maven Central y se puede [descargar desde Maven][1]. Comience agregando la siguiente configuración a su `pom.xml`:
+
+```xml
+
+ com.datadoghq
+ java-dogstatsd-client
+ 4.2.1
+
+```
+
+[1]: https://search.maven.org/search?q=g:com.datadoghq%20a:java-dogstatsd-client
+{{< /programming-lang >}}
+
+{{< programming-lang lang="PHP" >}}
+
+Agregue lo siguiente a su `composer.json`:
+
+```text
+"datadog/php-datadogstatsd": "1.6.*"
+```
+
+**Nota**: La primera versión lanzada en Composer es _0.0.3_
+
+O clone manualmente el repositorio en [github.com/DataDog/php-datadogstatsd][1] y configúrelo con `require './src/DogStatsd.php'`.
+
+
+
+[1]: https://github.com/DataDog/php-datadogstatsd#php-datadog-statsd-client
+{{< /programming-lang >}}
+
+{{< programming-lang lang=".NET" >}}
+
+Instale el paquete directamente usando el CLI de Nuget o obtenga [el PackageReference de NuGet][1]:
+
+```shell
+dotnet add package DogStatsD-CSharp-Client
+```
+
+[1]: https://www.nuget.org/packages/DogStatsD-CSharp-Client
+{{< /programming-lang >}}
+
+{{< /programming-lang-wrapper >}}
+
+
+#### Instancie el cliente DogStatsD {#instantiate-the-dogstatsd-client}
+
+Una vez que su cliente DogStatsD esté instalado, instáncielo en su código:
+{{< programming-lang-wrapper langs="python,ruby,go,java,PHP,.NET" >}}
+
+{{< programming-lang lang="python" >}}
+
+```python
+from datadog import initialize, statsd
+
+options = {
+ 'statsd_host':'127.0.0.1',
+ 'statsd_port':8125
+}
+
+initialize(**options)
+```
+
+
+ Por defecto, las instancias del cliente DogStatsD de Python (incluida la statsd instancia global) no pueden compartirse entre procesos, pero son seguras para hilos. Debido a esto, el proceso padre y cada proceso hijo deben crear sus propias instancias del cliente o el almacenamiento en búfer debe deshabilitarse explícitamente configurando disable_buffering a True. Consulte la documentación sobre datadog.dogstatsd para más detalles.
+
+ Si utiliza DogStatsD con el Agente de Contenedor o en Kubernetes, debe instanciar el host al que se envían las métricas de StatsD con la variable de entorno $DD_DOGSTATSD_SOCKET si utiliza un Socket de Dominio UNIX, o con la variable de entorno $DD_AGENT_HOST si está utilizando el método de enlace de puerto del host.
+
+
+{{< /programming-lang >}}
+
+{{< programming-lang lang="go" >}}
+
+```go
+dogstatsd_client, err := statsd.New("127.0.0.1:8125")
+if err != nil {
+ log.Fatal(err)
+}
+```
+
+Para más opciones, consulte [GoDoc de Datadog][1].
+
+
+
+[1]: https://pkg.go.dev/github.com/DataDog/datadog-go/v5/statsd
+{{< /programming-lang >}}
+
+{{< programming-lang lang="java" >}}
+
+```java
+import com.timgroup.statsd.NonBlockingStatsDClientBuilder;
+import com.timgroup.statsd.StatsDClient;
+
+public class DogStatsdClient {
+
+ public static void main(String[] args) throws Exception {
+
+ StatsDClient statsd = new NonBlockingStatsDClientBuilder()
+ .prefix("statsd")
+ .hostname("localhost")
+ .port(8125)
+ .build();
+
+
+ // alternatively
+ StatsDClient statsdAlt = new NonBlockingStatsDClient(
+ new NonBlockingStatsDClientBuilder(
+ .prefix("statsd")
+ .hostname("localhost")
+ .port(8125)
+ .resolve()));
+
+ }
+}
+```
+
+{{< /programming-lang >}}
+
+{{< programming-lang lang="PHP" >}}
+
+Instancie un nuevo objeto DogStatsd usando composer:
+
+```php
+ '127.0.0.1',
+ 'port' => 8125,
+ )
+ );
+```
+
+{{< /programming-lang >}}
+
+{{< programming-lang lang=".NET" >}}
+
+Configure la clase DogStatsd:
+
+```csharp
+// The code is located under the StatsdClient namespace
+using StatsdClient;
+
+// ...
+
+var dogstatsdConfig = new StatsdConfig
+{
+ StatsdServerName = "127.0.0.1",
+ StatsdPort = 8125,
+};
+
+using (var dogStatsdService = new DogStatsdService())
+{
+ if (!dogStatsdService.Configure(dogstatsdConfig))
+ throw new InvalidOperationException("Cannot initialize DogstatsD. Set optionalExceptionHandler argument in the `Configure` method for more information.");
+ // ...
+} // Flush metrics not yet sent
+```
+
+{{< /programming-lang >}}
+
+{{< /programming-lang-wrapper >}}
+
+### Parámetros de instanciación del cliente {#client-instantiation-parameters}
+
+**Nota**: Como mejor práctica, Datadog recomienda usar unified service tagging al asignar etiquetas. El unified service tagging vincula la telemetría de Datadog a través del uso de tres etiquetas estándar: `env`, `service` y `version`. Para aprender cómo unificar su entorno, consulte [unified service tagging][8].
+
+Además de la configuración requerida de DogStatsD (`url` y `port`), los siguientes parámetros opcionales están disponibles para su cliente DogStatsD:
+
+{{< programming-lang-wrapper langs="python,ruby,go,java,PHP,.NET" >}}
+{{< programming-lang lang="python" >}}
+| Parámetro | Tipo | Predeterminado | Descripción |
+| ---------------------- | --------------- | ----------- | -------------------------------------------------------------------------------------------------------------- |
+| `statsd_host` | Cadena | `localhost` | El host de su servidor DogStatsD. |
+| `statsd_port` | Entero | `8125` | El puerto de su servidor DogStatsD. |
+| `statsd_socket_path` | Cadena | `null` | La ruta al socket de dominio UNIX de DogStatsD (anula `host` y `port`, solo es compatible con el Agente v6+). |
+| `statsd_constant_tags` | Lista de cadenas | `null` | Etiquetas para aplicar a todas las métricas, eventos y verificaciones de servicio. |
+| `statsd_namespace` | Cadena | `null` | Espacio de nombres para prefijar todas las métricas, eventos y verificaciones de servicio. |
+
+Para la lista completa de parámetros opcionales disponibles para `datadog.initialize()` así como parámetros disponibles solo al instanciar explícitamente instancias de `datadog.dogstatsd.DogStatsd`, consulte la [biblioteca de Python de Datadog][1].
+
+
+[1]: https://datadogpy.readthedocs.io/en/latest
+{{< /programming-lang >}}
+{{< programming-lang lang="ruby" >}}
+
+| Parámetro | Tipo | Predeterminado | Descripción |
+| --------------- | --------------- | ----------- | -------------------------------------------------------------------------------------------------------------- |
+| `host` | Cadena | `localhost` | El host de su servidor DogStatsD. |
+| `port` | Entero | `8125` | El puerto de su servidor DogStatsD. |
+| `socket_path` | Cadena | `null` | La ruta al socket de dominio UNIX de DogStatsD (anula `host` y `port`, solo es compatible con el Agente v6+). |
+| `tags` | Lista de cadenas | `null` | Etiquetas para aplicar a todas las métricas, eventos y verificaciones de servicio. |
+| `namespace` | Cadena | `null` | Espacio de nombres para prefijar a todas las métricas, eventos y verificaciones de servicio. |
+| `single_thread` | Booleano | `false` | Hace que el cliente envíe las métricas en el hilo principal cuando está habilitado en lugar de en un hilo secundario. |
+
+Para la lista completa de parámetros opcionales, consulte el [repositorio de dogstatsd-ruby][1] en GitHub.
+
+
+[1]: https://github.com/DataDog/dogstatsd-ruby
+{{< /programming-lang >}}
+{{< programming-lang lang="go" >}}
+
+El cliente de Go tiene múltiples opciones para configurar el comportamiento del cliente.
+
+| Parámetro | Tipo | Descripción |
+| ----------------- | --------------- | --------------------------------------------------------------------------- |
+| `WithNamespace()` | Cadena | Configure un espacio de nombres para prefijar a todas las métricas, eventos y verificaciones de servicio. |
+| `WithTags()` | Lista de cadenas | Etiquetas globales aplicadas a cada métrica, evento y verificación. |
+
+Para todas las opciones disponibles, consulte [GoDoc de Datadog][1].
+
+
+[1]: https://pkg.go.dev/github.com/DataDog/datadog-go/v5/statsd#Option
+{{< /programming-lang >}}
+{{< programming-lang lang="java" >}}
+
+A partir de la versión 2.10.0, la forma recomendada de instanciar el cliente es con el NonBlockingStatsDClientBuilder. Usted
+puede utilizar los siguientes métodos de constructor para definir los parámetros del cliente.
+
+| Método de Constructor | Tipo | Predeterminado | Descripción |
+| -------------------------------------------- | -------------- | --------- | ---------------------------------------------------------------------------------- |
+| `prefix(String val)` | Cadena | null | El prefijo que se aplicará a todas las métricas, eventos y verificaciones. |
+| `hostname(String val)` | Cadena | localhost | El nombre del servidor StatsD objetivo. |
+| `port(int val)` | Entero | 8125 | El puerto del servidor StatsD objetivo. |
+| `constantTags(String... val)` | Cadena varargs | null | Etiquetas globales que se aplicarán a cada métrica, evento y verificación. |
+| `blocking(boolean val)` | Booleano | falso | El tipo de cliente a instanciar: bloqueante vs no bloqueante. |
+| `socketBufferSize(int val)` | Entero | -1 | El tamaño del búfer de socket subyacente. |
+| `enableTelemetry(boolean val)` | Booleano | falso | Reporte de telemetría del cliente. |
+| `entityID(String val)` | Cadena | null | ID de entidad para la detección de origen. |
+| `errorHandler(StatsDClientErrorHandler val)` | Entero | null | Manejador de errores en caso de un error interno del cliente. |
+| `maxPacketSizeBytes(int val)` | Entero | 8192/1432 | El tamaño máximo del paquete; 8192 sobre UDS, 1432 para UDP. |
+| `processorWorkers(int val)` | Entero | 1 | El número de hilos de trabajo del procesador que ensamblan los búferes para su envío. |
+| `senderWorkers(int val)` | Entero | 1 | El número de hilos de trabajo del remitente que envían los búferes al socket. |
+| `poolSize(int val)` | Entero | 512 | Tamaño del grupo de búferes de paquetes de red. |
+| `queueSize(int val)` | Entero | 4096 | Número máximo de mensajes no procesados en la cola. |
+| `timeout(int val)` | Entero | 100 | El tiempo de espera en milisegundos para operaciones bloqueantes. Aplica solo a sockets unix. |
+
+Para más información, busca el paquete Java DogStatsD [package][1] para la clase NonBlockingStatsDClient y la clase NonBlockingStatsDClientBuilder. Asegúrese de ver la versión que coincide con la versión de su cliente.
+
+
+[1]: https://javadoc.io/doc/com.datadoghq/java-dogstatsd-client/latest/index.html
+{{< /programming-lang >}}
+{{< programming-lang lang="PHP" >}}
+
+| Parámetro | Tipo | Predeterminado | Descripción |
+| ------------------ | --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `host` | El servidor de DogStatsD. | `localhost` | Si esto no está configurado, el Agente revisa la variable de entorno `DD_AGENT_HOST` o `DD_DOGSTATSD_URL`. |
+| `port` | El puerto de su servidor DogStatsD. | `8125` | Si esto no está configurado, el Agente revisa la variable de entorno `DD_DOGSTATSD_PORT` o `DD_DOGSTATSD_URL`. |
+| `socket_path` | Cadena | `null` | La ruta al socket de dominio UNIX de DogStatsD (anula `host` y `port`). Esto solo es compatible con el Agente v6+. Si esto no está configurado, el Agente revisa la variable de entorno `DD_DOGSTATSD_URL`. |
+| `global_tags` | Lista de Cadenas | `null` | Etiquetas que se aplicarán a todas las métricas, eventos y verificaciones de servicio. La etiqueta `@dd.internal.entity_id` se agrega a global_tags de la variable de entorno `DD_ENTITY_ID`. |
+| `origin_detection` | Booleano | Verdadero | ¿Se deben agregar campos de detección de origen a cada métrica? |
+| `container_id` | Cadena | `null` | Un id de contenedor para etiquetar todas las métricas para la detección de origen. |
+
+{{< /programming-lang >}}
+{{< programming-lang lang=".NET" >}}
+
+| Parámetro | Tipo | Predeterminado | Descripción |
+| ------------------ | --------------- | ----------- | -------------------------------------------------------------------- |
+| `StatsdServerName` | El nombre del servidor StatsD objetivo. | `localhost` | |
+| `StatsdPort` | Entero | `8125` | El puerto del servidor StatsD objetivo. |
+| `Prefix` | Cadena | `null` | Prefijo que se aplicará a cada métrica, evento y verificación de servicio. |
+| `ConstantTags` | Lista de cadenas | `null` | Etiquetas globales que se aplicarán a cada métrica, evento y verificación de servicio. |
+| `OriginDetection` | Bool | Verdadero | ¿Se deben agregar campos de detección de origen a cada métrica? |
+| `ContainerID` | Cadena | `null` | Un id de contenedor para etiquetar todas las métricas para la detección de origen. |
+
+{{< /programming-lang >}}
+{{< /programming-lang-wrapper >}}
+
+## Profundiza en DogStatsD {#dive-into-dogstatsd}
+
+DogStatsD y StatsD son ampliamente similares, sin embargo, DogStatsD contiene características avanzadas que son específicas de Datadog, incluyendo tipos de datos disponibles, eventos, verificaciones de servicio y etiquetas:
+
+{{< whatsnext desc="">}}
+{{< nextlink href="/metrics/custom_metrics/dogstatsd_metrics_submission/" >}}Envía métricas a Datadog con DogStatsD.{{< /nextlink >}}
+{{< nextlink href="/events/guides/dogstatsd/" >}}Envía eventos a Datadog con DogStatsD.{{< /nextlink >}}
+{{< nextlink href="/extend/service_checks/dogstatsd_service_checks_submission/" >}}Envía verificaciones de servicio a Datadog con DogStatsD.{{< /nextlink >}}
+{{< /whatsnext >}}
+
+Si está interesado en aprender más sobre el formato de datagrama utilizado por DogStatsD, o desea desarrollar su propia biblioteca de Datadog, consulte la sección de [datagrama y uso de shell][9], que también explica cómo enviar métricas y eventos directamente desde la línea de comandos.
+
+## Lectura adicional {#further-reading}
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://github.com/statsd/statsd
+[2]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/
+[3]: https://hub.docker.com/r/datadog/dogstatsd
+[4]: https://gcr.io/datadoghq/dogstatsd
+[5]: /es/metrics/custom_metrics/
+[6]: /es/events/guides/dogstatsd/
+[7]: /es/extend/service_checks/dogstatsd_service_checks_submission/
+[8]: /es/getting_started/tagging/unified_service_tagging
+[9]: /es/extend/dogstatsd/datagram_shell/
+[10]: /es/extend/community/libraries/
+[11]: /es/getting_started/tagging/assigning_tags/?tab=containerizedenvironments#tags-cardinality
+[12]: https://kubernetes.io/docs/tasks/configure-pod-container/share-process-namespace/
+[33]: https://registry.datadoghq.com/v2/dogstatsd/tags/list
+[34]: https://gallery.ecr.aws/datadog/dogstatsd
\ No newline at end of file
diff --git a/content/es/getting_started/_index.md b/content/es/getting_started/_index.md
index 0e1fb51bb72..3e5f315e338 100644
--- a/content/es/getting_started/_index.md
+++ b/content/es/getting_started/_index.md
@@ -4,30 +4,32 @@ aliases:
- /es/getting_started/faq/
cascade:
algolia:
- category: Empezando
+ category: Getting Started
rank: 50
description: Introducción a la plataforma de observabilidad de Datadog con guías para
- la instalación, la configuración y puesta en marcha de las principales funciones.
-disable_sidebar: verdadero
+ la instalación, configuración y comenzar con las características clave.
+disable_sidebar: true
further_reading:
- link: https://learn.datadoghq.com/
- tag: Centro de aprendizaje
- text: Haz un curso para empezar a utilizar Datadog
+ tag: Centro de Aprendizaje
+ text: Toma un curso para comenzar con Datadog
- link: https://datadoghq.com/blog/
tag: Blog
- text: Obtén información sobre los nuevos productos y funciones de Datadog, integraciones
- y mucho más
+ text: Conoce sobre nuevos productos y características de Datadog, integraciones
+ y más
- link: https://app.datadoghq.com/help/quick_start
tag: Aplicación
- text: Explorar la Guía de inicio rápido
-title: Empezando
+ text: Explora la Guía de Inicio Rápido
+- link: https://learn.datadoghq.com/courses/introduction-to-observability
+ tag: Centro de Aprendizaje
+ text: Introducción a la Observabilidad
+title: Comenzando
---
+## ¿Qué es Datadog? {#what-is-datadog}
-## ¿Qué es Datadog?
+Datadog es una plataforma de observabilidad que apoya cada fase del desarrollo de software en cualquier stack. La plataforma consiste en muchos productos que te ayudan a construir, probar, monitorear, depurar, optimizar y asegurar tu software. Estos productos pueden ser utilizados individualmente o combinados en una solución personalizada.
-Datadog es una plataforma de observabilidad que respalda cada fase del desarrollo de software en cualquier stack tecnológico. La plataforma consta de muchos productos que permiten crear, probar, monitorizar, depurar, optimizar y proteger tu software. Estos productos pueden utilizarse individualmente o combinados en una solución personalizada.
-
-En la tabla siguiente, se enumeran algunos ejemplos de productos de Datadog:
+La tabla a continuación lista algunos ejemplos de productos de Datadog:
@@ -38,35 +40,35 @@ En la tabla siguiente, se enumeran algunos ejemplos de productos de Datadog:
Desarrollo
-
Resalta las vulnerabilidades del código en tu editor de textos o en GitHub con Code Security.
-
Organiza una sesión remota de programación en parejas con CoScreen.
+
Destaca las vulnerabilidades de código en tu editor de texto o en GitHub con Code Security.
+
Facilita una sesión de programación en pareja remota con CoScreen.
-
Tests
+
Pruebas
Bloquea el código defectuoso para que no se despliegue en producción con PR Gates.
-
Incentiva a tus usuarios de todo el mundo a probar tu aplicación web, API o aplicación móvil con Synthetic Monitoring.
+
Simula usuarios alrededor del mundo para probar tu aplicación web, API o aplicación móvil con Synthetic Monitoring.
-Además, cientos de [integraciones][1] te permiten superponer funciones de Datadog a las tecnologías que ya utilizas. Por ejemplo, la [integración de AWS][2] recopila logs, eventos y métricas de más de 90 servicios de AWS.
+Además, cientos de [integraciones][1] te permiten integrar las características de Datadog con las tecnologías que ya utilizas. Por ejemplo, la [integración de AWS][2] recopila registros, eventos y métricas de más de 90 servicios de AWS.
-## Más información
+## Aprende más {#learn-more}
-{{< learning-center-callout header="Únete a una sesión de webinar de Enablement" hide_image="true" btn_title="Inscríbete" btn_url="https://www.datadoghq.com/technical-enablement/session/datadog-overview/">}}
- Esta sesión de capacitación básica ayuda a responder a la pregunta clave: "¿Qué es Datadog y qué puede hacer por mí?". Aprenderás cómo enviar datos a Datadog y qué páginas visitar para comprender mejor el estado de tus diversos entornos, aplicaciones e infraestructura.
+{{< learning-center-callout header="Únete a una sesión de seminario web de capacitación" hide_image="true" btn_title="Regístrate" btn_url="https://www.datadoghq.com/technical-enablement/session/datadog-overview/">}}
+ Esta sesión de habilitación de fundamentos ayuda a responder la pregunta clave: "¿Qué es Datadog y qué puede hacer por mí?" Aprenderás cómo enviar datos a Datadog y qué páginas visitar para comprender mejor el estado de tus diversos entornos, aplicaciones e infraestructura.
{{< /learning-center-callout >}}
-### Haz un curso
-El Centro de aprendizaje de Datadog ofrece experiencia práctica en la plataforma de Datadog. Los [cursos introductorios][3] abarcan prácticas de observabilidad, conceptos clave de Datadog y mucho más.
-
-Para comenzar rápidamente con la navegación por Datadog, prueba el [Curso de inicio rápido][4].
-
-### Conocer más sobre un área de producto
-{{< whatsnext desc="Empíeza con una de las siguientes guías:">}}
-{{< nextlink href="/getting_started/application" >}}Datadog: Descubre cómo utilizar la interfaz de usuario de Datadog: dashboards, lista de infraestructuras, mapas y mucho más.{{< /nextlink >}}
-{{< nextlink href="/getting_started/site" >}}Sitio Datadog: Selecciona el sitio Datadog adecuado para tu región y tus requisitos de seguridad.{{< /nextlink >}}
-{{< nextlink href="/getting_started/devsecops" >}}Paquetes DevSecOps: Empieza con los paquetes DevSecOps de infraestructura.{{< /nextlink >}}
-{{< nextlink href="/getting_started/agent" >}}Agent: Envía métricas y eventos de tus hosts a Datadog.{{< /nextlink >}}
-{{< nextlink href="/getting_started/api" >}}API: Empieza a utilizar la API HTTP de Datadog.{{< /nextlink >}}
-{{< nextlink href="/getting_started/integrations" >}}Integraciones: Aprende a recopilar métricas, trazas y logs con las integraciones de Datadog.{{< /nextlink >}}
-{{< nextlink href="/getting_started/search" >}}Búsqueda: Aprende los fundamentos de la búsqueda y el filtrado en productos de Datadog.{{< /nextlink >}}
-{{< nextlink href="/getting_started/tagging" >}}Etiquetas (Tags): Empieza a etiquetar tus métricas, trazas y logs.{{< /nextlink >}}
-{{< nextlink href="/getting_started/OpenTelemetry" >}}OpenTelemetry: Aprende a enviar métricas, trazas y logs de OpenTelemetry a Datadog. {{< /nextlink >}}
-{{< nextlink href="/getting_started/learning_center" >}}Centro de aprendizaje: Sigue un recorrido de aprendizaje, toma una clase o un laboratorio autoguiado y explora el programa de certificación de Datadog.{{< /nextlink >}}
+### Toma un curso {#take-a-course}
+El Centro de Aprendizaje de Datadog ofrece experiencia práctica con la plataforma de Datadog. Los [cursos de Introducción][3] cubren prácticas de observabilidad, conceptos clave de Datadog y más.
+
+Para la introducción más rápida a la navegación en Datadog, prueba el [curso de Inicio Rápido][4].
+
+### Profundiza en un área de producto {#dive-deeper-into-a-product-area}
+{{< whatsnext desc="Comienza con una de las guías a continuación:">}}
+{{< nextlink href="/getting_started/application" >}}Datadog: Descubre cómo usar la interfaz de usuario de Datadog: Tableros, lista de infraestructura, mapas y más.{{< /nextlink >}}
+{{< nextlink href="/getting_started/site" >}}Sitio de Datadog: Selecciona el sitio de Datadog apropiado para tu región y requisitos de seguridad.{{< /nextlink >}}
+{{< nextlink href="/getting_started/devsecops" >}}Paquetes de DevSecOps: Comienza con los paquetes de Infraestructura DevSecOps.{{< /nextlink >}}
+{{< nextlink href="/getting_started/agent" >}}Agente: Envía métricas y eventos desde tus servidores a Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/api" >}}API: Comienza con la API HTTP de Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/integrations" >}}Integraciones: Aprende cómo recopilar métricas, trazas y registros con las integraciones de Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/search" >}}Búsqueda: Aprende los fundamentos de la búsqueda y filtrado en los productos de Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/tagging" >}}Etiquetas: Comienza a etiquetar tus métricas, registros y trazas.{{< /nextlink >}}
+{{< nextlink href="/getting_started/opentelemetry" >}}OpenTelemetry: Aprende cómo enviar métricas, trazas y registros de OpenTelemetry a Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/learning_center" >}}Centro de Aprendizaje: Sigue un camino de aprendizaje, toma una clase o laboratorio autodirigido y explora el programa de certificación de Datadog.{{< /nextlink >}}
{{< /whatsnext >}}
-{{< whatsnext desc="Servicios de plataforma:">}}
-{{< nextlink href="/getting_started/dashboards" >}}Dashboards: Crea, comparte y realiza un mantenimiento de aquellos dashboards que responden a las preguntas relacionadas con el trabajo que más te importan.{{< /nextlink >}}
-{{< nextlink href="/getting_started/incident_management" >}}Gestión de incidencias: Comunica y realiza un seguimiento de los problemas en tus sistemas.{{< /nextlink >}}
-{{< nextlink href="/getting_started/monitors" >}}Monitores: Configura alertas y notificaciones para que tu equipo sepa cuándo ocurren cambios críticos.{{< /nextlink >}}
-{{< nextlink href="/getting_started/notebooks" >}}Notebooks: Combina gráficos, métricas, logs y monitores en directo para aislar los problemas y crear guías interactivas.{{< /nextlink >}}
-{{< nextlink href="/getting_started/workflow_automation" >}}Workflow Automation: Automatiza los procesos de extremo a extremo en respuesta a las alertas y señales de seguridad.{{< /nextlink >}}
+{{< whatsnext desc="Servicios de Plataforma:">}}
+{{< nextlink href="/getting_started/dashboards" >}}Tableros: Crea, comparte y mantén tableros que respondan a las preguntas clave de tu trabajo.{{< /nextlink >}}
+{{< nextlink href="/getting_started/incident_management" >}}Incident Management: Comunica y da seguimiento a los problemas en tus sistemas.{{< /nextlink >}}
+{{< nextlink href="/getting_started/monitors" >}}Monitors: Configura alertas y notificaciones para que tu equipo sepa cuándo ocurren cambios críticos.{{< /nextlink >}}
+{{< nextlink href="/getting_started/notebooks" >}}Notebooks: Combina gráficos en vivo, métricas, registros y monitores para aislar problemas y crear guías interactivas.{{< /nextlink >}}
+{{< nextlink href="/getting_started/organization_topology" >}}Topología de Organización: Elige entre implementaciones de Datadog de una sola organización y de múltiples organizaciones, y gestiona el aislamiento con controles de acceso.{{< /nextlink >}}
+{{< nextlink href="/getting_started/teams" >}}Teams: Construye un modelo de propiedad confiable sincronizando datos de Teams desde proveedores de identidad, GitHub y otras fuentes en Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/workflow_automation" >}}Workflow Automation: Automatiza procesos de extremo a extremo en respuesta a alertas y señales de seguridad.{{< /nextlink >}}
{{< /whatsnext >}}
{{< whatsnext desc="Producto:">}}
-{{< nextlink href="/getting_started/containers" >}}Contenedores: Aprende a utilizar Agent Autodiscovery y el Datadog Operator.{{< /nextlink >}}
-{{< nextlink href="/getting_started/serverless" >}}Serverless para AWS Lambda: Aprende a recopilar métricas, logs y trazas de tu infraestructura sin servidor.{{< /nextlink >}}
-{{< nextlink href="/getting_started/internal_developer_portal" >}}Portal interno para desarrolladores: Unifica telemetría, metadatos y flujos de trabajo para acelerar la entrega. {{< /nextlink >}}
-{{< nextlink href="/getting_started/tracing" >}}Rastreo: Configura el Agent para rastrear una aplicación pequeña.{{< /nextlink >}}
-{{< nextlink href="/getting_started/profiler" >}}Profiler: Utiliza el Continuous Profiler para encontrar y solucionar problemas de rendimiento en tu código.{{< /nextlink >}}
+{{< nextlink href="/getting_started/containers" >}}Containers: Aprende cómo usar Agent Autodiscovery y el operador de Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/serverless" >}}Serverless para AWS Lambda: Aprende cómo recopilar métricas, registros y trazas de tu infraestructura serverless.{{< /nextlink >}}
+{{< nextlink href="/getting_started/internal_developer_portal" >}}Internal Developer Portal: Unifica telemetría, metadatos y flujos de trabajo para acelerar la entrega. {{< /nextlink >}}
+{{< nextlink href="/getting_started/tracing" >}}Rastreo: Configura el Agente para rastrear una pequeña aplicación.{{< /nextlink >}}
+{{< nextlink href="/getting_started/profiler" >}}Profiler: Utiliza Continuous Profiler para encontrar y solucionar problemas de rendimiento en tu código.{{< /nextlink >}}
{{< nextlink href="/getting_started/database_monitoring" >}}Database Monitoring: Visualiza la salud y el rendimiento de las bases de datos, y soluciona rápidamente cualquier problema que surja.{{< /nextlink >}}
-{{< nextlink href="/getting_started/synthetics" >}}Synthetic Monitoring: Empieza a probar y monitorizar tus endpoints de API y tus experiencias empresariales clave con tests Synthetic.{{< /nextlink >}}
-{{< nextlink href="/getting_started/continuous_testing" >}}Continuous Testing: Ejecuta tests Synthetic de extremo a extremo en tus pipelines y tus IDE de CI.{{< /nextlink >}}
-{{< nextlink href="/getting_started/session_replay" >}}Session Replay: Observa en profundidad como interactúan tus usuarios con tu producto con Session Replays.{{< /nextlink >}}
-{{< nextlink href="/getting_started/application_security" >}}App and API Protection: Descubre las prácticas recomendadas para poner a tu equipo en marcha con AAP.{{< /nextlink >}}
-{{< nextlink href="/getting_started/cloud_security_management" >}}Cloud Security: Descubre las prácticas recomendadas para poner a tu equipo en marcha con Cloud Security.{{< /nextlink >}}
-{{< nextlink href="/getting_started/cloud_siem" >}}Cloud SIEM: Descubre las prácticas recomendadas para poner a tu equipo en marcha con Cloud SIEM.{{< /nextlink >}}
-{{< nextlink href="/getting_started/logs" >}}Logs: Envía tus primeros logs y utiliza el procesamiento de logs para enriquecerlos.{{< /nextlink >}}
-{{< nextlink href="/getting_started/ci_visibility" >}}CI Visibility: Recopila datos de pipelines CI configurando integraciones con tus proveedores CI.{{< /nextlink >}}
-{{< nextlink href="/getting_started/feature_flags" >}}Marcadores de funciones: Gestiona la entrega de funciones y personaliza la experiencia del usuario gracias a la observabilidad incorporada.{{< /nextlink >}}
-{{< nextlink href="/getting_started/test_optimization" >}}Test Optimization: Recopila datos de tests CI configurando servicios de test en Datadog.{{< /nextlink >}}
-{{< nextlink href="/getting_started/test_impact_analysis" >}}Test Impact Analysis: Optimiza tu paquete de tests y reduce los costes de CI ejecutando solo los tests pertinentes para tu cambio de código.{{< /nextlink >}}
-{{< nextlink href="/getting_started/code_security" >}}Code Security: Analiza tu código y tus bibliotecas de código abierto en tus aplicaciones, desde el desarrollo hasta la ejecución.{{< /nextlink >}}
+{{< nextlink href="/getting_started/synthetics" >}}Synthetic Monitoring: Comienza a probar y monitorear tus puntos de conexión de API y los viajes clave de negocio con pruebas Synthetic.{{< /nextlink >}}
+{{< nextlink href="/getting_started/continuous_testing" >}}Continuous Testing: Ejecuta pruebas Synthetic de extremo a extremo en tus canalizaciones de CI y IDEs.{{< /nextlink >}}
+{{< nextlink href="/getting_started/session_replay" >}}Session Replay: Obtén una visión detallada de cómo los usuarios interactúan con tu producto mediante reproducciones de sesión.{{< /nextlink >}}
+{{< nextlink href="/getting_started/application_security" >}}App and API Protection: Descubre las mejores prácticas para que tu equipo comience a trabajar con AAP.{{< /nextlink >}}
+{{< nextlink href="/getting_started/cloud_security_management" >}}Cloud Security: Descubre las mejores prácticas para que tu equipo comience a trabajar con Cloud Security.{{< /nextlink >}}
+{{< nextlink href="/getting_started/cloud_siem" >}}Cloud SIEM: Descubre las mejores prácticas para que tu equipo comience a trabajar con Cloud SIEM.{{< /nextlink >}}
+{{< nextlink href="/getting_started/logs" >}}Registros: Envía tus primeros registros y utiliza el procesamiento de registros para enriquecerlos.{{< /nextlink >}}
+{{< nextlink href="/getting_started/ci_visibility" >}}Visibilidad de CI: Recopila datos de pipelines de CI configurando integraciones con tus proveedores de CI.{{< /nextlink >}}
+{{< nextlink href="/getting_started/feature_flags" >}}Banderas de Características: Gestiona la entrega de características y personaliza las experiencias de los usuarios, con observabilidad incorporada.{{< /nextlink >}}
+{{< nextlink href="/getting_started/test_optimization" >}}Optimización de Pruebas: Recopila datos de pruebas de CI configurando servicios de pruebas en Datadog.{{< /nextlink >}}
+{{< nextlink href="/getting_started/test_impact_analysis" >}}Análisis de Impacto de Pruebas: Optimiza tu conjunto de pruebas y reduce los costos de CI ejecutando solo las pruebas que son relevantes para tus cambios de código.{{< /nextlink >}}
+{{< nextlink href="/getting_started/code_security" >}}Code Security: Analiza tu código propio y las bibliotecas de código abierto en tus aplicaciones, desde el desarrollo hasta el tiempo de ejecución.{{< /nextlink >}}
{{< /whatsnext >}}
-## Probar la versión preliminar de un producto o una función
+## Prueba un producto o característica en vista previa {#try-a-preview-product-or-feature}
-Los equipos de productos Datadog añaden con frecuencia nuevas funciones que pueden ayudarte. Puedes probar algunas de ellas antes de que estén disponibles, para ver si te sirven, y luego darnos tu opinión para mejorarlas. Para ver una lista completa de las versiones preliminares activas, obtener más información e inscribirte para participar, visita el [programa de versiones preliminares de productos Datadog][5].
+Los equipos de producto de Datadog están agregando frecuentemente nuevas características que podrían ayudarte. Puedes probar algunas de estas antes de que estén disponibles en general para ver si te ayudan y para darnos retroalimentación para mejorarlas. Para ver una lista completa de vistas previas activas, obtener más información y registrarte para participar, visita [Programa de Vista Previa de Productos de Datadog][5].
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/getting_started/agent/_index.md b/content/es/getting_started/agent/_index.md
index eac31811bc2..1706b4a67bd 100644
--- a/content/es/getting_started/agent/_index.md
+++ b/content/es/getting_started/agent/_index.md
@@ -1,187 +1,149 @@
---
+description: Guía para instalar y configurar el Agente de Datadog para recopilar métricas,
+ eventos y registros a nivel de sistema desde los hosts.
further_reading:
-- link: /agent/basic_agent_usage/
+- link: agent/
tag: Documentación
- text: Uso básico del Agent
+ text: El Agente de Datadog
- link: https://dtdg.co/fe
- tag: Habilitar los fundamentos
- text: Participa en una sesión interactiva para monitorizar mejor tu infraestructura
+ tag: Habilitación de la Fundación
+ text: Únete a una sesión interactiva para potenciar la supervisión de tu infraestructura
- link: /agent/faq/why-should-i-install-the-agent-on-my-cloud-instances/
- tag: FAQ
- text: ¿Por qué debería instalar el Datadog Agent en mis instancias de nube?
-title: Empezando con el Agent
+ tag: Preguntas frecuentes
+ text: ¿Por qué debería instalar el Agente de Datadog en mis instancias en la nube?
+- link: https://www.datadoghq.com/blog/lambda-managed-instances
+ tag: Blog
+ text: Monitorea instancias administradas de AWS Lambda con Datadog
+title: Introducción al Agente
---
+## Resumen {#overview}
-Esta guía sirve de introducción al Agent y te explica cómo usarlo para enviar métricas de nivel de sistema a la plataforma de Datadog. Se utilizará como ejemplo la instalación del Agent en Ubuntu. Estos son los puntos que trataremos:
+Esta guía presenta el Agente de Datadog y cubre:
- - Instalación del Agent
- - Verificar que el Agent se esté ejecutando
- - Configurar las funciones del Agent
- - Solucionar problemas en los recursos
+ - [Introducción al Agente](#what-is-the-datadog-agent)
+ - [Instalación](#installation)
+ - [Datos recopilados por el Agente](#data-collected-by-the-agent)
+ - [Configuraciones y características avanzadas](#advanced-configurations-and-features)
+ - [Solución de problemas](#troubleshooting)
-## Información general
-### Acerca del Agent
+## ¿Qué es el Agente de Datadog? {#what-is-the-datadog-agent}
-El Datadog Agent es un software que se ejecuta en tus hosts. Recopila eventos y métricas de los hosts y los envía a Datadog, donde puedes analizar tus datos de monitorización y rendimiento. Puede ejecutarse en tus hosts locales (Windows, MacOS), entornos contenedorizados (Docker, Kubernetes) y en los centros de datos on-premise. Para instalarlo y configurarlo, puedes utilizar herramientas de gestión de configuración (como Chef, Puppet o Ansible).
+El Agente de Datadog es un software que se ejecuta en tus hosts. Recopila eventos y métricas de los hosts y los envía a Datadog, donde puedes analizar tus datos de monitoreo y rendimiento.
-El Agent puede recopilar entre 75 y 100 métricas de nivel de sistema cada 15-20 segundos. Con configuración adicional, el Agent puede enviar datos, logs y trazas en tiempo real desde los procesos en ejecución a la plataforma de Datadog. El Datadog Agent es de código abierto, y su código fuente está disponible en GitHub: [DataDog/datadog-agent][1].
+El Agente puede ejecutarse en:
+- Hosts locales (Windows, Linux, macOS)
+- Entornos en contenedores (Docker, Kubernetes)
+- Centros de datos locales
-### Sobrecarga del Agent
+También puedes instalar y configurar el Agente utilizando herramientas de gestión de configuración como Chef, Puppet o Ansible.
-La cantidad de espacio y recursos que ocupa el Agent depende de la configuración y de los datos que el Agent esté configurado para enviar. Al principio, puedes esperar alrededor de un 0,08% de CPU utilizada de media con un espacio en disco de aproximadamente 880MB a 1,3GB.
+El Agente puede recopilar de 75 a 100 métricas a nivel de sistema cada 15 a 20 segundos. Con una configuración adicional, puede enviar datos en vivo, registros y trazas de procesos en ejecución a Datadog. El Agente de Datadog es de código abierto, y su código fuente está disponible en GitHub en [DataDog/datadog-agent][1].
-Para obtener más información sobre estos puntos de referencia, consulta [Sobrecarga del Agent][2].
+### El archivo de configuración del Agente {#the-agent-configuration-file}
-### Datos recopilados
+El archivo de configuración principal del Agente es `datadog.yaml`. Los parámetros requeridos son:
+- Tu [clave de API de Datadog][16], que se utiliza para asociar los datos del Agente con tu organización.
+- Tu [sitio de Datadog][41] ({{< region-param key="dd_site" code="true" >}}).
-#### Métricas del Agent
+Consulta el [archivo de muestra `config_template.yaml`][23] para todas las opciones de configuración disponibles. Puedes ajustar los archivos de configuración del Agente para aprovechar otras características de Datadog.
-Las métricas del Agent que presentamos a continuación son información que el Agent envía a Datadog sobre sí mismo. Su propósito es que dispongas de datos como en qué hosts y contenedores se están ejecutando Agents, cuándo se inicia un Agent y qué versión de Python se está utilizando.
-| Métrica | Descripción |
-| -------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `datadog.agent.python.version` | La métrica está etiquetada con `python_version`. |
-| `datadog.agent.running` | Muestra un valor de `1` si el Agent envía información a Datadog. |
-| `datadog.agent.started` | Envía un count con un valor de `1` cuando se inicia el Agent (disponible en v6.12+). |
-
-Para ver la lista completa de métricas del Agent, consulta la integración de [Métricas del Agent][3].
-
-#### Checks
-
-Dependiendo de la plataforma que utilices, el Agent puede tener varios checks básicos activados de forma predeterminada que recopilen métricas.
-
-| Check | Métricas | Platformas |
-| ----------- | ------------- | ------------------ |
-| CPU | [Sistema][4] | Todas |
-| Disco | [Disco][5] | Todas |
-| E/S | [Sistema][4] | Todas |
-| Memoria | [Sistema][4] | Todas |
-| Red | [Red][6] | Todas |
-| NTP | [NTP][7] | Todas |
-| Tiempo de actividad | [Sistema][4] | Todas |
-| Identificador de archivos | [Sistema][4] | Todas menos Mac |
-| Carga | [Sistema][4] | Todas menos Windows |
-| Docker | [Docker][8] | Docker |
-| Winproc | [Sistema][4] | Windows |
-
-Para recopilar métricas de otras tecnologías, consulta la página de [Integraciones][9].
-
-## Diferencias entre Agents para hosts y para contenedores
-
-En esta guía, te enseñaremos a instalar y configurar un Agent en un host. Si tu intención es instalar Agents en un entorno contenedorizado, deberías tener en cuenta que existen algunas diferencias.
-
-1. En un host, el Agent se configura mediante un archivo YAML (como podrás comprobar más adelante en esta guía). En cambio, las opciones de configuración del Agent en un contenedor se habilitan con [variables de entorno][10] como, por ejemplo:
- - `DD_API_KEY` para la clave de API de Datadog
- - `DD_SITE` para el sitio de Datadog
-
-2. De un modo similar, mientras que en un host las [integraciones][9] se identifican mediante el archivo de configuración del Agent, en un entorno de contenedor se identifican automáticamente mediante la función Autodiscovery de Datadog. Para más información, consulta [Autodiscovery básico del Agent][11].
-
-Consulta [Docker Agent][12] o [Kubernetes][13] para ver un tutorial sobre cómo ejecutar el Agent en un entorno contenedorizado.
-
-## ¿Por qué debería instalar el Agent?
-
-Para que el Agent envíe datos desde cualquiera de las numerosas integraciones basadas en Agent, tiene que estar instalado. No tiene necesidad de desviar los datos a la plataforma de Datadog; por ejemplo, puedes enviar logs y métricas a través de la API de Datadog. Sin embargo, el Agent es el método recomendado obstante para desviar tus datos hacia la plataforma de Datadog.
-
-El Agent recopila datos del host cada 15 segundos para ofrecer información precisa sobre lo que sucede en tus entornos. Como se ha mencionado anteriormente en la sección [Checks][14], el Agent tiene varios checks activados que recopilan más de 50 métricas predeterminadas para brindar más información sobre los datos de nivel de sistema.
-
-## Configuración
-
-### Requisitos previos
+## Instalación {#installation}
+### Requisitos previos {#prerequisites}
1. Crea una [cuenta de Datadog][15].
2. Ten a mano tu [clave de API de Datadog][16].
-3. Ten la IU de Datadog abierta.
+### Configura {#setup}
-**Nota**: Este tutorial utiliza el sistema operativo Ubuntu. Consulta la página [Uso básico del Agent][17] para obtener una lista completa de las plataformas compatibles.
+Utiliza [Fleet Automation][39], el flujo de trabajo dentro de la aplicación de Datadog, para instalar, actualizar, configurar y solucionar problemas del Agente de Datadog en un solo host o a gran escala.
-### Instalación
+Consulta la [documentación del Agente][40] para obtener configuración adicional del Agente para tu plataforma específica.
-En la interfaz de usuario de Datadog, ve a la página [Instalación del Agent][18] y haz clic en **Ubuntu**. Para instalar el Datadog Agent en un host, utiliza el comando de instalación de una línea de esa página (el ejemplo se muestra a continuación), actualizado con tu [clave de API de Datadog][16].
-Ejemplo para Ubuntu de un comando de instalación de una línea:
+## Datos recopilados por el Agente {#data-collected-by-the-agent}
-```shell
-DD_API_KEY= DD_SITE="{{< region-param key="dd_site" >}}" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
-```
+Para brindarte visibilidad completa de tu infraestructura, el Agente de Datadog informa métricas sobre su propia salud y configuración, así como métricas recopiladas de tus hosts y servicios a través de sus verificaciones predeterminadas.
-Utiliza la [página de instalación del Agent][18] para consultar las instrucciones de instalación más actualizadas para tu sistema operativo.
+### Métricas del Agente {#agent-metrics}
-### Validación
+El Agente informa las siguientes métricas a Datadog sobre sí mismo. Estas métricas proporcionan información sobre qué hosts o contenedores tienen Agentes en ejecución, cuándo se inició cada Agente y la versión de Python que está utilizando el Agente.
-#### Comando del terminal
+| Métrica | Descripción |
+| -------------------------------- |------------------------------------------------- |
+| `datadog.agent.running` | Muestra un valor de `1` si el Agente está informando a Datadog. |
+| `datadog.agent.started` | Un conteo enviado con un valor de `1` cuando el Agente se inicia (disponible en v6.12+). |
+| `datadog.agent.python.version` | La métrica está etiquetada con el `python_version`. |
-Ejecuta el [comando de estado][19] del Agent para verificar la instalación.
-```shell
-sudo datadog-agent status
-```
-Si la instalación se realiza correctamente, devolverá un informe de estado de Agent con la información del Agent al comienzo. Ejemplo:
-
-```text
-===============
-Agent (v7.36.1)
-===============
-
- Status date: 2022-06-15 15:54:48.364 EDT / 2022-06-15 19:54:48.364 UTC (1655322888364)
- Agent start: 2022-06-15 15:54:29.85 EDT / 2022-06-15 19:54:29.85 UTC (1655322869850)
- Pid: 9801
- Go Version: go1.17.6
- Python Version: 3.8.11
- Build arch: amd64
- Agent flavor: agent
- Check Runners: 6
- Log Level: info
-```
+Consulta la integración de [Métricas de Agente][3] para obtener una lista completa de métricas de Agente.
-#### Eventos
+### Verificaciones {#checks}
-En la interfaz de usuario de Datadog, ve a la [Página del Event Explorer][20]. Cuando se inicia o reinicia un Agent, envía eventos a Datadog. El siguiente mensaje aparece si tu Agent se instala correctamente:
+Dependiendo de tu plataforma, el Agente tiene varias verificaciones básicas habilitadas por defecto que recopilan métricas.
-```text
-Agent de Datadog (v. 7.XX.X) iniciado en
-```
+| Verificación | Métricas | Plataformas |
+| ----------- | ------------- | ------------------ |
+| CPU | [Sistema][4] | Todo |
+| Disco | [Disco][5] | Todo |
+| IO | [Sistema][4] | Todo |
+| Memoria | [Sistema][4] | Todo |
+| Network | [Network][6] | Todo |
+| NTP | [NTP][7] | Todo |
+| Tiempo de actividad | [Sistema][4] | Todo |
+| Manejador de archivos | [Sistema][4] | Todo excepto Mac |
+| Carga | [Sistema][4] | Todo excepto Windows |
+| Docker | [Docker][8] | Docker |
+| Winproc | [Sistema][4] | Windows |
+
+Para recopilar métricas de otras tecnologías, consulta la página de [Integraciones][9].
-#### Checks de servicio
-El Agent está configurado para ofrecer los siguientes checks de servicio:
- - `datadog.agent.up`: devuelve `OK` si el Agent se conecta a Datadog.
-
AIX Agents no informan el check de servicio datadog.agent.up. Puedes utilizar la métrica datadog.agent.running para monitorizar el tiempo de actividad de un AIX Agent. La métrica emite un valor de 1 si el Agent está informando a Datadog.
- - `datadog.agent.check_status`: devuelve `CRITICAL` si un Agent check no puede enviar métricas a Datadog, en caso contrario devuelve `OK`.
+### Verificaciones de servicio {#service-checks}
+El Agente está configurado para proporcionar las siguientes verificaciones de servicio:
-Estos checks pueden utilizarse en la plataforma de Datadog para visualizar el estado del Agent a través de monitores y dashboards de forma rápida. Consulta [Información general sobre el check de servicio][21] para obtener más información.
+ - `datadog.agent.up`: Devuelve **OK** si el Agente se conecta a Datadog.
+ - `datadog.agent.check_status`: Devuelve **CRÍTICO** si una verificación del Agente no puede enviar métricas a Datadog; de lo contrario, devuelve **OK**.
-#### Métricas
+Estas verificaciones se pueden utilizar en Datadog para visualizar el estado del Agente a través de monitores y tableros de un vistazo. Consulta [Descripción general de las verificaciones de servicio][21] para obtener más información.
-En la interfaz de usuario de Datadog, ve a la [página Resumen de métricas][22] y busca la métrica `datadog.agent.started` o la métrica `datadog.agent.running`. Si estas métricas no son visibles de inmediato, es posible que el Agent tarde unos minutos en enviar los datos a la plataforma de Datadog.
-Haz clic en cualquiera de las métricas para que se abra un panel de métrica. Aquí, podrás ver metadatos adicionales sobre el lugar desde el que se recopilaron las métricas, así como cualquier etiqueta asociada. Como no se ha configurado ninguna etiqueta en el host a estas alturas del tutorial, solo deberías ver las etiquetas predeterminadas que Datadog asigna a las métricas, como `version` y `host`. Para obtener más información sobre cómo añadir etiquetas, consulta la siguiente sección sobre los archivos de configuración del Agent.
+## Configuraciones y características avanzadas {#advanced-configurations-and-features}
-Explora otras métricas predeterminadas, como `ntp.offset` o `system.cpu.idle`.
+{{% collapse-content title="Diferencias entre el Agente para hosts y contenedores" level="h4" expanded=false id="id-for-anchoring" %}}
-## Archivos de configuración del Agent
+Existen diferencias clave entre la instalación de Agentes en un host y en un entorno de contenedores:
-El archivo de configuración principal del Agent es `datadog.yaml`. Estos son los parámetros obligatorios:
-- tu [clave de API de Datadog][16], que se utiliza para asociar los datos del Agent con tu organización, y
-- el sitio de Datadog ({{< region-param key="dd_site" code="true" >}}).
+- **Diferencias de configuración**:
+ - **Host**: El Agente se configura utilizando un archivo YAML.
+ - **Contenedor**: Las opciones de configuración se pasan utilizando [variables de entorno][10], por ejemplo:
+
+ ```sh
+ `DD_API_KEY` # Datadog API key
+ `DD_SITE` # Datadog site
+ ```
-Consulta el [ejemplo de archivo `config_template.yaml`][23] para ver todas las opciones disponibles de configuración.
+- **Detección de integraciones**:
+ - **Host**: [Integraciones][9] se identifican a través del archivo de configuración del Agente.
+ - **Contenedor**: Las integraciones se identifican automáticamente utilizando la función de Autodiscovery de Datadog. Consulta [Autodiscovery básico del Agente][11] para obtener más información.
-Puedes modificar los archivos de configuración del Agent para aprovechar otras funciones de Datadog, incluidas las etiquetas (tags).
+Además, consulta el [Agente de Docker][12] o [Kubernetes][13] para una guía sobre cómo ejecutar el Agente en un entorno de contenedores.
+{{% /collapse-content %}}
-#### Configurar etiquetas (tags) mediante el archivo de configuración del Agent
-Las etiquetas añaden una capa adicional de metadatos a tus métricas y eventos. Te permiten contexto y comparar los datos en visualizaciones de Datadog. Cuando los datos se envían a Datadog desde múltiples hosts, el etiquetado de esta información te permite limitar los datos que más te interesa visualizar.
+{{% collapse-content title="Configurando etiquetas a través del archivo de configuración del Agente" level="h4" expanded=false id="id-for-anchoring" %}}
-Por ejemplo, supongamos que tienes datos recopilados de diferentes equipos y sólo te interesa ver las métricas del equipo alfa, el etiquetado de esos hosts específicos con `team:alpha` o `team:bravo` te permite filtrar hasta las métricas que están etiquetadas con `team:alpha`. Consulta [Empezando con etiquetas][24] para obtener más información sobre el etiquetado de tus datos.
+Las etiquetas añaden una capa adicional de metadatos a tus métricas y eventos. Te permiten delimitar y comparar tus datos en las visualizaciones de Datadog. Cuando se envían datos a Datadog desde múltiples hosts, etiquetar esta información te permite reducir el enfoque a los datos que más te interesa visualizar.
-1. Localiza el [archivo principal de configuración][25] del Agent. Para Ubuntu, las localizaciones del archivos son `/etc/datadog-agent/datadog.yaml`.
+Por ejemplo, supongamos que tienes datos recopilados de diferentes equipos y solo te interesa ver las métricas del equipo alfa; etiquetar esos hosts específicos con la etiqueta `team:alpha` o `team:bravo` te da la capacidad de filtrar las métricas que están etiquetadas con `team:alpha`. Consulta [Introducción a las etiquetas][24] para aprender más sobre cómo etiquetar tus datos.
-2. En el archivo `datadog.yaml`, localiza el parámetro `tags`. Puedes definir las etiquetas de nivel de host en la configuración de `datadog.yaml` para aplicar las etiquetas en todas las métricas, trazas y logs que se desvíen desde este host.
+1. Localiza el [archivo de configuración principal][25] de tu Agente. Para Ubuntu, la ubicación del archivo es `/etc/datadog-agent/datadog.yaml`.
+
+2. En el archivo `datadog.yaml`, localiza el parámetro `tags`. Las etiquetas a nivel de host se pueden establecer en la configuración `datadog.yaml` para aplicar etiquetas a todas las métricas, trazas y registros enviados desde este host.
```yaml
## @param tags - list of key:value elements - optional
@@ -199,7 +161,7 @@ Por ejemplo, supongamos que tienes datos recopilados de diferentes equipos y só
# - :
```
-3. Quita la marca de comentario del parámetro de etiquetas y de la etiqueta `team:infra` del ejemplo. También puedes añadir tu propia etiqueta personalizada (por ejemplo, `test:agent_walkthrough`).
+3. Descomente el parámetro de etiquetas y el ejemplo de etiqueta proporcionado `team:infra`. También puede agregar su propia etiqueta personalizada, por ejemplo `test:agent_walkthrough`.
```yaml
## @param tags - list of key:value elements - optional
## @env DD_TAGS - space separated list of strings - optional
@@ -216,64 +178,86 @@ Por ejemplo, supongamos que tienes datos recopilados de diferentes equipos y só
- test:agent_walkthrough
```
-4. Reinicia el Agent ejecutando el [comando de reinicio] del Agent [26]. El comando de reinicio de Ubuntu:
+4. Reinicie el Agente ejecutando el [comando de reinicio][26] del Agente. El comando de reinicio de Ubuntu:
```shell
sudo service datadog-agent restart
```
-5. Unos minutos más tarde, ve de nuevo a la [página Resumen de métricas][22] y haz clic en la métrica `datadog.agent.started`. Además de las etiquetas `host` y `version` predeterminadas, verás la etiqueta `team` y las etiquetas personales que hayas añadido. También puedes filtrar las métricas con el campo `Tag` en la parte superior de la página.
+5. Después de unos minutos, vuelva a la [Metrics Summary page][22] y haga clic en la métrica `datadog.agent.started`. Además de las etiquetas predeterminadas `host` y `version`, también puede ver la etiqueta `team` y cualquier etiqueta personal que haya agregado. También puede filtrar métricas por el campo `Tag` en la parte superior de la página.
+
+6. Ve a la [Event Explorer page][20] y encuentra las etiquetas personalizadas mostradas con el último evento del Agente.
-6. Ve a la [página del Event Explorer][20] y busca las etiquetas personalizadas que aparecen con el último evento del Agent.
+{{% /collapse-content %}}
-#### Otras opciones de configuración
+{{% collapse-content title="Encontrando métricas en la interfaz de usuario de Datadog" level="h4" expanded=false id="id-for-anchoring" %}}
-La recopilación de datos de [logs][27], [trazas (traces)][28] y [procesos][29] puede habilitarse a través del archivo de configuración del Agent. No son funciones activadas por defecto. Por ejemplo, en el archivo de configuración, el parámetro `logs_enabled` está establecido en false.
+Puedes confirmar que el Agente está funcionando correctamente al verificar sus métricas predeterminadas en la interfaz de usuario de Datadog. Ve a la [Metrics Summary page][22] y busca la métrica `datadog.agent.started` o la métrica `datadog.agent.running`. Si estas métricas no son visibles de inmediato, puede tardar unos minutos para que el Agente envíe los datos a Datadog.
+
+Haz clic en cualquiera de las métricas y se abrirá un panel de Métricas. Este panel muestra metadatos adicionales sobre dónde se recopilan estas métricas y cualquier etiqueta asociada. Si no hay etiquetas configuradas en un servidor, deberías ver solo las etiquetas predeterminadas que Datadog asigna a las métricas, incluyendo `version` y `host`. Consulta la sección anterior sobre cómo configurar etiquetas a través de los archivos de configuración del Agente para aprender más sobre cómo agregar etiquetas.
+
+Explora otras métricas predeterminadas como `ntp.offset` o `system.cpu.idle`.
+{{% /collapse-content %}}
+
+
+{{% collapse-content title="Sobrecarga del Agente" level="h4" expanded=false id="id-for-anchoring" %}}
+
+La cantidad de espacio y recursos que ocupa el Agente depende de la configuración y de qué datos está enviando el Agente. Al principio, puedes esperar alrededor del 0.08% de CPU utilizada en promedio con un espacio en disco de aproximadamente 880MB a 1.3GB.
+
+Consulta [Agent Overhead][2] para aprender más sobre estos puntos de referencia.
+{{% /collapse-content %}}
+
+{{% collapse-content title="Opciones de configuración adicionales" level="h4" expanded=false id="id-for-anchoring" %}}
+
+La recopilación de datos de [registros][27], [trazas][28] y [procesos][29] se puede habilitar a través del archivo de configuración del Agente. Estas características no están habilitadas por defecto. Por ejemplo, en el archivo de configuración, el parámetro `logs_enabled` está configurado como falso.
```yaml
##################################
-## Configuración de la recopilación de logs ##
+## Log collection Configuration ##
##################################
## @param logs_enabled - boolean - optional - default: false
## @env DD_LOGS_ENABLED - boolean - optional - default: false
-## Para activar la recopilación de logs del Datadog Agent, establece logs_enabled como true.
+## Enable Datadog Agent log collection by setting logs_enabled to true.
#
# logs_enabled: false
```
-Para configurar otras funciones de Datadog mediante el archivo de configuración del Agent, es necesario:
-- Activar [la ingesta de trazas de OTLP][30]
-- [Personalizar la recopilación de logs][31] para filtrar o limpiar datos confidenciales
-- Configurar datos personalizados a través de [DogStatsD][32]
+Otras características de Datadog que se pueden configurar a través del archivo de configuración del Agente incluyen:
+- Habilitando [OTLP Trace Ingestion][30]
+- [Personalizando la recolección de registros][31] para filtrar o eliminar datos sensibles
+- Configurando datos personalizados a través de [DogStatsD][32]
+
+A lo largo de su configuración, cuando la documentación se refiere al archivo `datadog.yaml` o al archivo de configuración del Agente, este es el archivo que necesita configurar.
+
+{{% /collapse-content %}}
-Durante la configuración, cuando veas que la documentación hace referencia al archivo `datadog.yaml` o al archivo de configuración del Agent, ten en cuenta que se trata del archivo que tienes que configurar.
-## Comandos
+## Comandos {#commands}
-Consulta [Comandos del Agent][33] para [Iniciar][34], [Detener][35] o [Reiniciar][26] tu Agent.
+Consulte [Agent Commands][33] para [Start][34], [Stop][35] o [Restart][26] su Agente.
-## Solucionar problemas
+## Solucionando problemas {#troubleshooting}
-Si necesitas ayuda para solucionar problemas relacionados con el Agent:
+Para obtener ayuda con la solución de problemas del Agente:
-- Consulta [Solucionar problemas del Agent][36]
-- Ve los [archivos de log del Agent][37]
-- Contacta con el [soporte de Datadog][38]
+- Consulte [Agent Troubleshooting][36]
+- Vea los [Archivos de Registro del Agente][37]
+- Contacte a [Datadog support][38]
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
-## Siguientes pasos
+## Próximos pasos {#next-steps}
-{{< whatsnext desc="After the Agent is installed:">}}
-{{< nextlink href="/getting_started/integrations" >}}Obtén información sobre las integraciones{{< /nextlink >}}
-{{< nextlink href="/getting_started/application" >}}Obtén información sobre la IU de Datadog{{< /nextlink >}}
-{{< nextlink href="/getting_started/logs" >}}Obtén información sobre cómo recopilar logs a través del Agent{{< /nextlink >}}
-{{< nextlink href="/getting_started/tracing" >}}Obtén información sobre cómo recopilar trazas a través del Agent{{< /nextlink >}}
+{{< whatsnext desc="Después de que el Agente esté instalado:">}}
+{{< nextlink href="/getting_started/integrations" >}}Aprenda sobre Integrations{{< /nextlink >}}
+{{< nextlink href="/getting_started/application" >}}Aprenda sobre Datadog UI{{< /nextlink >}}
+{{< nextlink href="/getting_started/logs" >}}Aprenda cómo recolectar Registros a través del Agente{{< /nextlink >}}
+{{< nextlink href="/getting_started/tracing" >}}Aprenda cómo recolectar Trazas a través del Agente{{< /nextlink >}}
{{< /whatsnext >}}
[1]: https://github.com/DataDog/datadog-agent
@@ -292,11 +276,11 @@ Si necesitas ayuda para solucionar problemas relacionados con el Agent:
[14]: /es/getting_started/agent/#checks
[15]: https://www.datadoghq.com
[16]: https://app.datadoghq.com/organization-settings/api-keys
-[17]: /es/agent/basic_agent_usage/?tab=agentv6v7
+[17]: /es/agent/supported_platforms
[18]: https://app.datadoghq.com/account/settings/agent/latest
[19]: /es/agent/configuration/agent-commands/#agent-status-and-information
[20]: https://app.datadoghq.com/event/explorer
-[21]: /es/developers/service_checks/#visualize-your-service-check-in-datadog
+[21]: /es/extend/service_checks/#visualize-your-service-check-in-datadog
[22]: https://app.datadoghq.com/metric/summary
[23]: https://github.com/DataDog/datadog-agent/blob/master/pkg/config/config_template.yaml
[24]: /es/getting_started/tagging/
@@ -307,10 +291,13 @@ Si necesitas ayuda para solucionar problemas relacionados con el Agent:
[29]: /es/infrastructure/process/?tab=linuxwindows#introduction
[30]: /es/opentelemetry/otlp_ingest_in_the_agent/?tab=host
[31]: /es/agent/logs/advanced_log_collection/
-[32]: /es/developers/dogstatsd/?tab=hostagent
+[32]: /es/extend/dogstatsd/?tab=hostagent
[33]: /es/agent/configuration/agent-commands/
[34]: /es/agent/configuration/agent-commands/#start-the-agent
[35]: /es/agent/configuration/agent-commands/#stop-the-agent
[36]: /es/agent/troubleshooting/
[37]: /es/agent/configuration/agent-log-files/
-[38]: /es/help/
\ No newline at end of file
+[38]: /es/help/
+[39]: /es/agent/fleet_automation/
+[40]: /es/agent/?tab=Host-based
+[41]: /es/getting_started/site/
\ No newline at end of file
diff --git a/content/es/getting_started/tagging/_index.md b/content/es/getting_started/tagging/_index.md
index 04da88be4c3..7ae40bd737d 100644
--- a/content/es/getting_started/tagging/_index.md
+++ b/content/es/getting_started/tagging/_index.md
@@ -1,7 +1,7 @@
---
algolia:
tags:
- - etiquetado
+ - tagging
aliases:
- /es/getting_started/getting_started_with_tags
- /es/guides/getting_started/tagging/
@@ -9,103 +9,116 @@ aliases:
- /es/tagging
- /es/guides/tagging/
- /es/faq/when-i-query-can-i-use-wildcards-in-metric-names-and-events/
-description: Descubre cómo asignar y usar etiquetas en Datadog.
+description: Aprende a asignar y usar etiquetas en Datadog.
further_reading:
- link: /getting_started/tagging/assigning_tags/
tag: Documentación
- text: Descubre cómo asignar etiquetas
+ text: Aprende a asignar etiquetas
- link: /getting_started/tagging/unified_service_tagging/
tag: Documentación
- text: Descubre cómo configurar el etiquetado de servicios unificado
+ text: Aprende a configurar el etiquetado de servicio unificado
- link: /getting_started/tagging/using_tags/
tag: Documentación
- text: Descubre cómo usar las etiquetas
+ text: Aprende a usar etiquetas
- link: https://dtdg.co/fe
- tag: Habilitar los fundamentos
- text: Participa en una sesión interactiva sobre la eficacia del etiquetado con Datadog
-title: Empezando con las etiquetas (tags)
+ tag: Habilitación de Fundamentos
+ text: Únete a una sesión interactiva sobre etiquetado efectivo con Datadog
+- link: https://www.datadoghq.com/blog/datadog-executive-dashboards
+ tag: Blog
+ text: Diseña tableros ejecutivos efectivos con Datadog
+- link: https://learn.datadoghq.com/courses/tagging-best-practices
+ tag: Centro de Aprendizaje
+ text: Mejores Prácticas de Etiquetado
+title: Introducción a las Etiquetas
---
+## Resumen {#overview}
-## Información general
+Las etiquetas son una forma de agregar dimensiones a las telemetrías de Datadog para que puedan ser filtradas, agregadas y comparadas en las visualizaciones de Datadog. [Usar etiquetas][1] te permite observar el rendimiento agregado a través de varios hosts y (opcionalmente) reducir el conjunto aún más basado en elementos específicos. En resumen, el etiquetado es un método para observar puntos de datos agregados.
-Las etiquetas son una forma de añadir dimensiones a las telemetrías de Datadog para que puedan filtrarse, agregarse y compararse en las visualizaciones de Datadog. [Usar etiquetas][1] te permite observar el rendimiento conjunto en varios hosts y, de manera opcional, reducir ese conjunto en función de ciertos elementos. En resumen, el etiquetado es un método para observar puntos de datos de manera conjunta.
+Una etiqueta puede estar formateada como `:` o ``. Datadog recomienda usar el formato `:`, ya que a menudo es semánticamente más claro y permite capacidades de consulta más ricas (por ejemplo, agrupando por clave). Al usar un par `:`:
-Las etiquetas son pares `key:value` que contienen dos partes:
+- La etiqueta **clave** es el identificador. Las claves de etiqueta comúnmente utilizadas son `env`, `instance` y `name`.
+- La etiqueta **valor** es el dato o la información específica asociada con la clave. Los valores de etiqueta no son únicos por recurso y pueden ser utilizados en muchos recursos en un par `:`.
-- La clave de etiqueta es el identificador. La clave de etiqueta sólo puede existir una vez en cada recurso y distingue entre mayúsculas y minúsculas.
-- El valor de etiqueta son los datos específicos o la información asociada a la clave. Los valores de etiqueta no son únicos por recurso y pueden utilizarse en muchos recursos en un par `key-value`.
+El etiquetado vincula distintos tipos de datos en Datadog, permitiendo la correlación y la ejecución de acciones entre métricas, trazas y registros. Esto se logra con las claves de etiqueta **reservadas**:
+| Clave de etiqueta | Permite |
+|-----------|------------------------------------------------------------------------|
+| `host` | Correlación entre métricas, trazas, procesos y registros. |
+| `device` | Segregación de métricas, trazas, procesos y registros por dispositivo o disco. |
+| `source` | Filtrado de tramos y creación automatizada de canalizaciones para Log Management. |
+| `service` | Alcance de datos específicos de la aplicación a través de métricas, trazas y registros. |
+| `env` | Alcance de datos específicos de la aplicación a través de métricas, trazas y registros. |
+| `version` | Alcance de datos específicos de la aplicación a través de métricas, trazas y registros. |
+| `team` | Asignando la propiedad a cualquier recurso. |
-El etiquetado vincula distintos tipos de datos en Datadog, lo que permite la correlación y las llamadas a la acción entre métricas, trazas (traces) y logs. Esto se consigue con claves de etiqueta **reservadas**:
+Datadog recomienda observar contenedores, máquinas virtuales e infraestructura en la nube a nivel `service` en conjunto. Por ejemplo, observe el uso de CPU a través de una colección de hosts que representa un servicio, en lugar de observar el uso de CPU del servidor A o del servidor B por separado.
-| Clave de etiqueta | Qué permite |
-| --------- | --------------------------------------------------------------------- |
-| `host` | Correlación entre métricas, trazas, procesos y logs. |
-| `device` | Segregación de métricas, trazas, procesos y logs por dispositivo o disco. |
-| `source` | Filtrado por tramos y creación automatizada de pipelines para la gestión de logs. |
-| `service` | Control sobre datos específicos de la aplicación en métricas, trazas y logs. |
-| `env` | Control sobre datos específicos de la aplicación en métricas, trazas y logs. |
-| `version` | Control sobre datos específicos de la aplicación en métricas, trazas y logs. |
-| `team` | Asignar una propiedad a cualquier recurso |
+Debido a que los contenedores y los entornos en la nube cambian regularmente de servidores, es importante usar etiquetas para agregar tus métricas.
-Datadog recomienda analizar los contenedores, las máquinas virtuales y la infraestructura en la nube de forma conjunta a nivel de `service`. Por ejemplo, puedes observar el uso de la CPU en una serie de hosts que represente un servicio, en lugar del uso de la CPU para el servidor A o B por separado.
+## Defina etiquetas {#define-tags}
-Puesto que los contenedores y entornos en la nube se renuevan con frecuencia en los hosts, es importante usar etiquetas para agregar las métricas.
+Las cadenas de etiquetas (es decir, el contenido completo de `:` o ``) deben cumplir con los siguientes requisitos:
-## Definir etiquetas
+- Las cadenas de etiquetas deben **comenzar con una letra** (esto se aplica independientemente de si la etiqueta utiliza el formato `:` o ``). Después de la letra inicial, la cadena de etiquetas puede contener los caracteres que se enumeran a continuación:
-Estos son los requisitos de etiquetado de Datadog:
-
-1. Las etiquetas deben **empezar por una letra** y pueden incluir lo siguiente:
-
- - Caracteres alfanuméricos
- - Guiones bajos
- - Signos de resta
+ - Letras (se admiten todas las letras Unicode; por ejemplo, a, ó, 気, 녕, ك y ดี)
+ - Números
+ - Guiones bajos (los guiones bajos iniciales y finales se eliminan, y los guiones bajos contiguos se colapsan en uno solo)
+ - Guiones
- Dos puntos
- Puntos
- - Barras
-
- Los demás caracteres especiales se convertirán en guiones bajos.
-
-2. Las etiquetas pueden tener **hasta 200 caracteres** y admiten letras Unicode (que incluyen la mayoría de conjuntos de caracteres, incluidos idiomas como el japonés).
-3. Las etiquetas se cambiarán a minúsculas. Por tanto, no se recomiendan las etiquetas `CamelCase`. Las integraciones basadas en (un rastreador de) autenticación convierten ese tipo de ortografía en guiones bajos. Ejemplo: `TestTag` --> `test_tag`.
-4. Una etiqueta puede estar en formato `value` o `:`. Las claves de etiquetas más utilizadas son `env`, `instance` y `name`. La clave siempre precede a los primeros dos puntos de la definición de la etiqueta global. Ejemplo:
-
+ - Barras diagonales
+ - (Solo para etiquetas en registros [ingresados a través de HTTP][28]) signos de arroba (`@`)
+
+ Todos los demás caracteres (incluidos comas, emoji, barras invertidas y espacios) se convierten en guiones bajos.
+
+ **Notas**:
+ - Una etiqueta que comienza con un dígito puede ser aceptada en algunos contextos, como las etiquetas `env` establecidas a nivel de Agent. Sin embargo, las etiquetas que no siguen las reglas de nomenclatura estándar pueden no funcionar de manera consistente en todos los productos de Datadog y pueden aumentar la cardinalidad de las etiquetas. Comience las etiquetas con una letra a menos que un producto específico lo soporte explícitamente de otra manera.
+ - La variable de entorno `DD_TAGS` utiliza espacios en blanco como separador entre etiquetas. Los espacios en blanco en los valores de `DD_TAGS` **no** se convierten a guiones bajos. Por ejemplo, `DD_TAGS="test:this is a test"` produce cuatro etiquetas separadas: `test:this`, `is`, `a` y `test`. Para establecer un valor de etiqueta que contenga espacios, use un archivo de configuración YAML o anotaciones de integración, donde los espacios en blanco se convierten a guiones bajos.
+
+- Las etiquetas pueden tener hasta **200 caracteres** de longitud. Si la etiqueta tiene el formato `:`, la clave, `:`, y el valor cuentan para el límite de caracteres.
+- [Las etiquetas de span][26] y las etiquetas métricas se normalizan a minúsculas, por lo que se debe evitar el uso de camel case en las claves de las etiquetas. Los proveedores de la nube normalizan el camel case de manera inconsistente. Por ejemplo, AWS convierte `TestTag` a `testtag`, mientras que Alibaba Cloud convierte `TestTag` a `test_tag`.
+ - A diferencia de las etiquetas, [los atributos de span][27] y los atributos de log son sensibles a mayúsculas y minúsculas y no se normalizan.
+- Al usar el formato `:`, la clave siempre precede al primer dos puntos de la definición de etiqueta global. Por ejemplo:
+
| Etiqueta | Clave | Valor |
| ------------------ | ------------- | -------------- |
| `env:staging:east` | `env` | `staging:east` |
| `env_staging:east` | `env_staging` | `east` |
-5. Las etiquetas no deben originarse en fuentes sin enlazar, como marcas de tiempo epoch, ID de usuario o ID de solicitud. De ser así, [la cantidad de métricas podría aumentar][2] infinitamente en tu organización y afectar a tu facturación.
-6. Las limitaciones (como el cambio a minúsculas) solo se aplican a las etiquetas de métricas, no a los atributos de logs ni a las etiquetas de tramos.
+- Las etiquetas no deben originarse de fuentes sin límites, como marcas de tiempo de época, identificadores de usuario o identificadores de solicitud. Hacerlo puede causar un crecimiento sin límites en el número de [métricas][2].
+
-## Asignación de etiquetas
+## Asignar etiquetas {#assign-tags}
-### Métodos de etiquetado
+### Métodos de etiquetado {#tagging-methods}
-Las etiquetas se pueden asignar con cualquiera de los siguientes métodos o con todos ellos:
+Las etiquetas pueden ser asignadas utilizando cualquiera (o todos) de los siguientes métodos.
-| Método | Asignación de etiquetas |
+| Método | Asignar etiquetas |
| ------------------------ | --------------------------------------------------------------- |
-| [Archivos de configuración][3] | Manualmente en tu Agent principal o en los archivos de configuración de la integración. |
-| [IU][4] | En el sitio de Datadog. |
-| [API][5] | Al usar la API de Datadog. |
+| [Archivos de configuración][3] | Manualmente en sus archivos de configuración principales del Agent o integración. |
+| [Interfaz de Usuario][4] | En el sitio de Datadog. |
+| [API][5] | Al utilizar la API de Datadog. |
| [DogStatsD][6] | Al enviar métricas con DogStatsD. |
-Para más información, consulta la sección [Asignar etiquetas][7].
+Para más información, consulte [Asignación de Etiquetas][7].
+
+#### Etiquetado de servicio unificado {#unified-service-tagging}
-#### Etiquetado de servicios unificado
+Como mejor práctica, Datadog recomienda utilizar el etiquetado de servicio unificado al asignar etiquetas. El etiquetado de servicio unificado vincula la telemetría de Datadog a través del uso de tres etiquetas estándar: `env`, `service` y `version`. Para aprender a configurar su entorno con etiquetado unificado, consulte [Etiquetado de Servicio Unificado][8].
-Datadog recomienda utilizar el etiquetado de servicios unificado al asignar etiquetas. Este sistema asocia toda la telemetría de Datadog mediante el uso de tres etiquetas estándar: `env`, `service` y `version`. Para saber cómo configurar tu entorno con el etiquetado unificado, consulta la sección [Etiquetado de servicios unificado][8].
+### Herencia de etiquetas {#tag-inheritance}
-### Herencia de etiquetas
+Todas las métricas, registros, trazas e integraciones pasan por un proceso de herencia de `host-tag` a medida que los datos se ingieren en Datadog. Dado que los datos están asociados con un nombre de host determinado, esos componentes heredan todas las etiquetas `host-level` asociadas con ese host. Estas etiquetas son visibles en la [lista de infraestructura][12] para un host determinado, provenientes ya sea del proveedor de la nube o del Datadog Agent. Consulte [etiquetas `host-level` faltantes en nuevos hosts o nodos][25] para más información.
-Todas las métricas, logs, trazas e integraciones pasan por un proceso de herencia de `host-tag` a medida que los datos se introducen en Datadog. Dado que los datos están asociados a un nombre de host determinado, esos componentes heredan todas las etiquetas `host-level` asociadas a ese host. Estas etiquetas son visibles en la [lista de infraestructura][12] de un host determinado, y proceden del proveedor de la nube o del Datadog Agent. Consulta [las etiquetas `host-level` faltantes en nuevos hosts o nodos][25] para más información.
+Debido a que las etiquetas pueden ser heredadas de múltiples fuentes, elija nombres de clave únicos y específicos para evitar duplicarlas entre fuentes. Por ejemplo, si ha establecido una clave `service` en un host (`service:my-host`) y una clave `service` en un pod que se ejecuta en ese host (`service:my-service`), sus datos heredan ambas etiquetas. Opte por nombres de clave más diferenciados (como `infra_service`) para evitar claves de etiqueta duplicadas.
-### Precedencia de las etiquetas
+### Prioridad de etiquetas {#tag-precedence}
-El Datadog Agent **no** impone un orden de precedencia para las etiquetas establecidas a partir de diferentes fuentes. En su lugar, el Agent recopila todas las etiquetas de cada fuente disponible, almacena cada valor único para una clave de etiqueta determinada y los emite todos con la telemetría.
+El Agente de Datadog **no** impone un orden de prioridad para las etiquetas establecidas desde diferentes fuentes. En cambio, el Agente recopila todas las etiquetas de cada fuente disponible, almacena cada valor único para una clave de etiqueta dada y emite todas ellas con la telemetría.
-Esto significa que una misma clave de etiqueta puede tener varios valores si está configurada de forma diferente en las distintas fuentes. Por ejemplo, si la etiqueta `service` se establece como `payments` en una variable de entorno, `checkout` en el YAML Agent y `orders` en una configuración de cliente de rastreo, la telemetría para ese servicio podría incluir:
+Esto significa que una sola clave de etiqueta puede tener múltiples valores si se configura de manera diferente entre fuentes. Por ejemplo, si la etiqueta `service` se establece en `payments` en una variable de entorno, `checkout` en el YAML del Agente y `orders` en una configuración de cliente de trazado, la telemetría para ese servicio podría incluir:
```
service:payments
@@ -113,33 +126,33 @@ service:checkout
service:orders
```
-Los filtros o dashboards descendentes deben filtrar explícitamente el valor deseado si solo se espera uno.
+Los filtros o tableros descendentes deben filtrar explícitamente el valor deseado si espera solo uno.
-## Utilización
+## Uso {#usage}
-Después de haber [asignado etiquetas][7] a nivel de host e [integración][9], comienza a utilizarlas para filtrar y agrupar tus métricas, trazas y logs. Las etiquetas se utilizan en las siguientes áreas de tu plataforma Datadog.
+Después de haber [asignado etiquetas][7] a nivel de servidor y [de integración][9], comience a usarlas para filtrar y agrupar sus métricas, trazas y registros. Las etiquetas se utilizan en las siguientes áreas de su plataforma Datadog.
-| Área | Uso de las etiquetas para |
+| Área | Usar Etiquetas para |
| -------------------- | ------------------------------------------------------------------------------------------------ |
-| [Events (Eventos)][10] | Filtrar el flujo de eventos. |
+| [Eventos][10] | Filtrar el flujo de eventos. |
| [Dashboards][11] | Filtrar y agrupar métricas en gráficos. |
-| [Infrastructura][12] | Filtrar y agrupar en el mapa del host, la lista de infraestructuras, los Live Containers y las visualizaciones de Live Processes. |
-| [Monitores][13] | Crear y gestionar monitores, o controlar caídas del sistema. |
-| [Métricas][14] | Filtrar y agrupar en el navegador de métricas. |
-| [Integraciones][15] | Limitar opcionalmente las métricas de AWS, Google Cloud y Azure. |
-| [APM][16] | Filtrar servicios, trazas y perfiles, o navegar a otras áreas con el Mapa de servicios. |
-| [RUM y Session Replay][17] | Filtrar la búsqueda de eventos, análisis, patrones, reproducciones y problemas en el navegador RUM. |
-| [Monitorización Synthetic y tests continuos][18] | Filtra y agrupa los tests Synthetic o aquellos que se ejecutan en pipelines CI con el Explorador de monitorización Synthetic y de resultados de tests. |
-| [Notebooks][19] | Filtrar y agrupar métricas en gráficos. |
-| [Logs][20] | Filtrar la búsqueda de logs, análisis, patrones, Live Tail y pipelines. |
-| [SLOs][21] | Buscar SLOs, SLOs basados en métricas agrupadas y SLOs basados en monitores agrupados. |
-| [Desarrolladores][22] | Obtener información o configurar distintas áreas en la IU con la API. |
-| [Facturación][23] | Generar informes sobre el uso de Datadog eligiendo hasta tres etiquetas, por ejemplo: `env`, `team` y `account_id`. |
-| [CI Visibility][24] | Filtra y agrupa ejecuciones de pruebas o pipelines con el explorador de visibilidad CI. |
-
-Para obtener más información, consulta la sección [Uso de etiquetas][1].
-
-## Referencias adicionales
+| [Infrastructure][12] | Filtrar y agrupar en el mapa de servidores, lista de infraestructura, contenedores en vivo y vistas de procesos en vivo. |
+| [Monitors][13] | Administrar monitores, crear monitores o gestionar el tiempo de inactividad. |
+| [Metrics][14] | Filtrar y agrupar con el Metric Explorer. |
+| [Integrations][15] | Opcionalmente limitar métricas para AWS, Google Cloud y Azure. |
+| [APM][16] | Filtrar servicios, trazas y perfiles, o navegar a otras áreas con el Service Map. |
+| [RUM & Session Replay][17] | Filtrar búsqueda de eventos, análisis, patrones, repeticiones y problemas con el RUM Explorer. |
+| [Synthetic Monitoring & Continuous Testing][18] | Filtrar y agrupar pruebas Synthetic o pruebas que se ejecutan en pipelines de CI con el Synthetic Monitoring & Testing Results Explorer. |
+| [Notebooks][19] | Filtrar y agrupar métricas en gráficos. |
+| [Logs][20] | Filtrar búsqueda de registros, análisis, patrones, seguimiento de las últimas líneas y pipelines. |
+| [SLOs][21] | Buscar SLOs, SLOs agrupados por métricas y SLOs agrupados por monitors. |
+| [Developers][22] | Obtener información o configurar diferentes áreas en la interfaz de usuario con la API. |
+| [Billing][23] | Informar sobre el uso de Datadog eligiendo hasta tres etiquetas, por ejemplo: `env`, `team` y `account_id`. |
+| [CI Visibility][24] | Filtrar y agrupar ejecuciones de prueba o ejecuciones de canalización con el CI Visibility Explorer. |
+
+Para más información, consulte [Using Tags][1].
+
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -167,4 +180,7 @@ Para obtener más información, consulta la sección [Uso de etiquetas][1].
[22]: /es/getting_started/tagging/using_tags/#developers
[23]: /es/account_management/billing/usage_attribution/
[24]: /es/getting_started/tagging/using_tags/#ci-visibility
-[25]: /es/containers/kubernetes/log/?tab=datadogoperator#missing-host-level-tags-on-new-hosts-or-nodes
\ No newline at end of file
+[25]: /es/containers/troubleshooting/log-collection?tab=datadogoperator#missing-host-level-tags-on-new-hosts-or-nodes
+[26]: /es/tracing/trace_collection/tracing_naming_convention/#span-tags
+[27]: /es/tracing/trace_collection/tracing_naming_convention/#span-attributes
+[28]: /es/api/latest/logs/#send-logs
\ No newline at end of file
diff --git a/content/es/getting_started/tagging/unified_service_tagging.md b/content/es/getting_started/tagging/unified_service_tagging.md
index 339b2c9dbd6..82fad6a293c 100644
--- a/content/es/getting_started/tagging/unified_service_tagging.md
+++ b/content/es/getting_started/tagging/unified_service_tagging.md
@@ -1,95 +1,93 @@
---
algolia:
tags:
- - etiquetas (tags) de servicios unificadas
- - unificado
- - servicio unificado
- - etiquetas (tags) de servicios
-description: Conecta la telemetría a través de trazas, métricas y logs utilizando
- etiquetas estandarizadas de entorno, servicio y versión para una monitorización
- coherente.
+ - unified service tags
+ - unified
+ - unified service
+ - service tags
+description: Conecte la telemetría a través de trazas, métricas y registros utilizando
+ etiquetas estandarizadas de entorno, servicio y versión para un monitoreo consistente.
further_reading:
- link: /getting_started/tagging/using_tags
tag: Documentación
- text: Descubre cómo utilizar las etiquetas (tags) en la aplicación de Datadog
+ text: Aprenda cómo usar etiquetas en la aplicación de Datadog
- link: /tracing/version_tracking
tag: Documentación
- text: Uso de etiquetas (tags) de versión en APM de Datadog para monitorizar despliegues
+ text: Utilice etiquetas de versión dentro de Datadog APM para monitorear implementaciones
- link: https://www.datadoghq.com/blog/autodiscovery-docker-monitoring/
tag: Blog
- text: Más información sobre Autodiscovery
-title: Etiquetado de servicios unificado
+ text: Aprenda más sobre Autodiscovery
+title: Unified Service Tagging
---
+## Visión general {#overview}
-## Información general
+Unified Service Tagging integra la telemetría de Datadog utilizando tres [etiquetas reservadas][1]: `env`, `service` y `version`.
-El etiquetado de servicios unificado asocia la telemetría de Datadog utilizando tres [etiquetas (tags) reservadas][1]: `env`, `service` y `version`.
+Con estas tres etiquetas, usted puede:
-Estas tres etiquetas (tags) te permiten:
+- Identificar el impacto de la implementación con métricas de trazas y contenedores filtradas por versión
+- Navegar sin problemas a través de trazas, métricas y registros con etiquetas consistentes
+- Ver datos del servicio basados en el entorno o la versión de manera unificada
-- Identificar el impacto del despliegues con métricas de rastreo y de contenedor filtradas por versión
-- Navegar sin problemas a través de trazas (traces), métricas y logs con etiquetas (tags) coherentes
-- Ver datos de servicios basados en el entorno o la versión de manera unificada
-
-{{< img src="tagging/unified_service_tagging/overview.mp4" alt="Etiquetado de servicios unificado" video=true >}}
+{{< img src="tagging/unified_service_tagging/overview.mp4" alt="Unified Service Tagging" video=true >}}
**Notas**:
-- Se espera que la etiqueta (tag) de `version` cambie con cada nuevo despliegue de la aplicación. Dos versiones diferentes del código de tu aplicación deberían tener diferentes etiquetas de `version`.
-- El servicio oficial de un log es por defecto la imagen corta del contenedor, si no hay una configuración de logs de Autodiscovery presente. Para reemplazar el servicio oficial de un log, añade [etiquetas (labels) de Docker/anotaciones de pod][2] de Autodiscovery. Por ejemplo: `"com.datadoghq.ad.logs"='[{"service": "service-name"}]'`
-- La información del host se excluye para la base de datos y los tramos (spans) de caché porque el host asociado con el tramo no es el host de base de datos/caché.
+- Se espera que la etiqueta `version` cambie con cada nueva implementación de la aplicación. Dos versiones diferentes del código de su aplicación deben tener etiquetas `version` distintas.
+- El servicio oficial de un registro se establece por defecto en la imagen corta del contenedor si no hay una configuración de registros de Autodescubrimiento presente. Para anular el servicio oficial de un registro, agregue Autodiscovery [etiquetas de Docker/anotaciones de pod][2]. Por ejemplo: `"com.datadoghq.ad.logs"='[{"service": "service-name"}]'`
+- La información del host se excluye para los tramos de base de datos y caché porque el host asociado al tramo no es el host de la base de datos/caché.
-### Requisitos
+### Requisitos {#requirements}
-- El etiquetado de servicios unificado requiere la configuración de un [Datadog Agent ][3] de 6.19.x/7.19.x o posterior.
+- Unified Service Tagging requiere la configuración de un [Datadog Agent][3] que sea 6.19.x/7.19.x o superior.
-- El etiquetado de servicios unificado requiere una versión de rastreador que admita nuevas configuraciones de las [etiquetas reservadas][1]. Obtén más información por idioma en las [instrucciones de configuración][4].
+- Unified Service Tagging requiere una versión de SDK que soporte nuevas configuraciones de las [etiquetas reservadas][1]. Se puede encontrar más información por idioma en las [instrucciones de configuración][4].
-| Lenguaje | Versión mínima del rastreador |
+| Idioma | Versión mínima de SDK |
|--------------|------------|
| .NET | 1.17.0+ |
-| C++ | v0.1.0 o posterior |
-| Go | 1.24.0 o posterior |
-| Java | 0.50.0 o posterior |
-| Node | 0.20.3 o posterior |
-| PHP | 0.47.0 o posterior |
-| Python | 0.38.0 o posterior |
-| Ruby | 0.34.0 o posterior |
+| C++ | 0.1.0+ |
+| Go | 1.24.0+ |
+| Java | 0.50.0+ |
+| Node | 0.20.3+ |
+| PHP | 0.47.0+ |
+| Python | 0.38.0+ |
+| Ruby | 0.34.0+ |
-- Para llevar a cabo el etiquetado de servicios unificado, es necesario conocer la configuración de etiquetas (tags). Si no sabes muy bien cómo configurar etiquetas, lee antes la documentación [Empezando con el etiquetado][1] y [Asignación de etiquetas][5].
+- Unified service tagging requiere conocimiento sobre la configuración de etiquetas. Si no está seguro de cómo configurar etiquetas, lea la documentación de [Introducción a la Etiquetación][1] y [Asignación de Etiquetas][5] antes de proceder a la configuración.
-## Configuración
+## Configuración {#configuration}
-Para empezar a configurar el etiquetado de servicios unificado, elige tu entorno:
+Para comenzar a configurar unified service tagging, elija su entorno:
-- [contenedorizado](#containerized-environment)
-- [no contenedorizado](#non-containerized-environment)
-- [Serverless](#serverless-environment)
+- [Contenerizado](#containerized-environment)
+- [No contenerizado](#non-containerized-environment)
+- [Sin servidor](#serverless-environment)
- [OpenTelemetry](#opentelemetry)
-### Entorno contenedorizado
+### Entorno contenerizado {#containerized-environment}
-En entornos contenedorizados, `env`, `service` y `version` se configuran a través de variables de entorno o etiquetas (labels) del servicio; por ejemplo, etiquetas del despliegue de Kubernetes y del pod o etiquetas del contenedor de Docker. El Datadog Agent detecta esta configuración de etiquetado y la aplica a los datos que recopila de los contenedores.
+En entornos contenerizados, `env`, `service` y `version` se configuran a través de las variables de entorno o etiquetas del servicio (por ejemplo, etiquetas de implementación y pod de Kubernetes, etiquetas de contenedor de Docker). El Agente de Datadog detecta esta configuración de etiquetado y la aplica a los datos que recopila de los contenedores.
-Para configurar el etiquetado de servicios unificado en un entorno contenedorizado:
+Para configurar unified service tagging en un entorno contenerizado:
-1. Activa [Autodiscovery][6]. Esto permitirá al Datadog Agent identificar automáticamente los servicios que se ejecutan en un contenedor concreto y recopilar datos de esos servicios para asignar variables de entorno a las etiquetas (tags) `env`, `service,` y `version`.
+1. Habilitar [Autodiscovery][6]. Esto permite que el Agente de Datadog identifique automáticamente los servicios que se ejecutan en un contenedor específico y recopile datos de esos servicios para mapear las variables de entorno a las etiquetas `env`, `service,` y `version`.
-2. Si utilizas [Docker][2], asegúrate de que el Agent pueda acceder al [socket de Docker][7] de tu contenedor. Esto permitirá al Agent detectar las variables de entorno y asignarlas a etiquetas (tags) estándar.
+2. Si está utilizando [Docker][2], asegúrese de que el Datadog Agent pueda acceder al [socket de Docker][7] de su contenedor. Esto permite que el Datadog Agent detecte las variables de entorno y las mapee a las etiquetas estándar.
-3. Configura el entorno que corresponda a tu servicio de orquestación de contenedores, según la configuración completa o parcial, tal y como se indica a continuación.
+3. Configure su entorno que corresponde a su servicio de orquestación de contenedores basado en configuración completa o configuración parcial como se detalla a continuación.
-#### Configuración
+#### Configuración {#configuration-1}
{{< tabs >}}
{{% tab "Kubernetes" %}}
-Si has implementado el Agent de clúster de Datadog con el [controlador de admisión][1] activado, este último mutará los manifiestos del pod e introducirá todas las variables de entorno requeridas (en función de las condiciones de mutación establecidas). En ese caso, no será necesaria la configuración manual de las variables de entorno `DD_` en los manifiestos del pod. Para obtener más información, consulta la [documentación del controlador de admisión][1].
+Si implementó el Datadog Cluster Agent con el [Controlador de Admisión][1] habilitado, éste muta los manifiestos de los pods e inyecta todas las variables de entorno requeridas (según las condiciones de mutación configuradas). En ese caso, la configuración manual de `DD_` variables de entorno en los manifiestos de los pods es innecesaria. Para más información, consulte la [documentación del Controlador de Admisión][1].
-##### Configuración completa
+##### Configuración completa {#full-configuration}
-Para obtener todo el rango del etiquetado de servicios unificado al utilizar Kubernetes, añade variables de entorno tanto a nivel del objeto del despliegue como a nivel de las especificaciones de la plantilla del pod:
+Para obtener el rango completo de Unified Service Tagging al usar Kubernetes, agregue variables de entorno tanto al nivel del objeto de implementación como al de la especificación de la plantilla del pod:
```yaml
apiVersion: apps/v1
@@ -123,7 +121,7 @@ template:
fieldPath: metadata.labels['tags.datadoghq.com/version']
```
-También puedes utilizar las variables de atributos de recursos de OpenTelemetry para configurar las etiquetas (tags) `env`, `service` y `version`:
+También puede usar las variables de entorno de OpenTelemetry Resource Attributes para establecer las etiquetas `env`, `service` y `version`:
```yaml
containers:
@@ -134,13 +132,13 @@ También puedes utilizar las variables de atributos de recursos de OpenTelemetry
- name: OTEL_SERVICE_NAME
value: ""
```
-
La variable de entorno OTEL_SERVICE_NAME tiene prioridad sobre el atributo service.name de la variable de entorno OTEL_RESOURCE_ATTRIBUTES.
+
La variable de entorno OTEL_SERVICE_NAME tiene prioridad sobre el atributo service.name en la variable de entorno OTEL_RESOURCE_ATTRIBUTES.
-##### Configuración parcial
+##### Configuración parcial {#partial-configuration}
-###### Métricas a nivel del pod
+###### Métricas a nivel de pod {#pod-level-metrics}
-Para configurar métricas a nivel del pod, añade las siguientes etiquetas (labels) estándar (`tags.datadoghq.com`) a las especificaciones del pod de un despliegue, StatefulSet o tarea:
+Para configurar métricas a nivel de pod, agregue las siguientes etiquetas estándar (`tags.datadoghq.com`) a la especificación del pod de una Implementación, StatefulSet o Job:
```yaml
template:
@@ -150,9 +148,9 @@ template:
tags.datadoghq.com/service: ""
tags.datadoghq.com/version: ""
```
-Estas etiquetas (labels) abarcan la CPU, la memoria, la red y las métricas de disco de Kubernetes a nivel del pod, y pueden utilizarse para introducir `DD_ENV`, `DD_SERVICE` y `DD_VERSION` en el contenedor de tu servicio a través de la [API descendente de Kubernetes][2].
+Estas etiquetas abarcan las métricas a nivel de pod de CPU, memoria, red y disco en Kubernetes, y se pueden utilizar para inyectar `DD_ENV`, `DD_SERVICE` y `DD_VERSION` en el contenedor de su servicio a través de la [API descendente de Kubernetes][2].
-Si tienes varios contenedores en cada pod, podrás especificar etiquetas (labels) estándar según el contenedor:
+Si tiene múltiples contenedores por pod, puede especificar etiquetas estándar por contenedor:
```yaml
tags.datadoghq.com/.env
@@ -160,13 +158,13 @@ tags.datadoghq.com/.service
tags.datadoghq.com/.version
```
-###### Métricas de estado
+###### Métricas de estado {#state-metrics}
-Para configurar [métricas de estado de Kubernetes][3]:
+Para configurar [Métricas de Estado de Kubernetes][3]:
-1. Configura `join_standard_tags` como `true` en tu archivo de configuración. Para conocer la localización de los parámetros, consulta este [archivo de configuración de ejemplo][4].
+1. Establezca `join_standard_tags` en `true` en su archivo de configuración. Consulte este [archivo de configuración de ejemplo][4] para la ubicación de la configuración.
-2. Añade las mismas etiquetas (labels) estándar a la colección de etiquetas del recurso principal. Por ejemplo: `Deployment`.
+2. Agregue las mismas etiquetas estándar a la colección de etiquetas del recurso padre, por ejemplo: `Deployment`.
```yaml
apiVersion: apps/v1
@@ -185,9 +183,9 @@ Para configurar [métricas de estado de Kubernetes][3]:
tags.datadoghq.com/version: ""
```
-###### Rastreador de APM y cliente StatsD
+###### SDK de Datadog y cliente de StatsD {#datadog-sdk-and-statsd-client}
-Para configurar las variables de entorno del [rastreador de APM][5] y del [cliente StatsD][6], utiliza la [API descendente de Kubernetes][2] con el siguiente formato:
+Para configurar las variables de entorno del Datadog SDK y del StatsD client, utilice la [API descendente de Kubernetes][2] en el siguiente formato:
```yaml
containers:
@@ -207,24 +205,24 @@ containers:
fieldPath: metadata.labels['tags.datadoghq.com/version']
```
-##### Etiquetado automático de versiones para datos de APM en entornos contenedorizados
+##### Etiquetado automático de versiones para datos de APM en entornos en contenedores {#automatic-version-tagging-for-apm-data-in-containerized-environments}
-
-Puedes utilizar la etiqueta (tag) `version` en APM para [monitorizar despliegues][7] e identificar despliegues de código fallidos mediante la [detección automática de despliegues fallidos][8].
+Puede usar la etiqueta `version` en APM para [monitorear implementaciones][7] e identificar implementaciones de código defectuosas a través de la [Detección Automática de Implementaciones Defectuosas][8].
-Para datos de APM, Datadog configura la etiqueta (tag) `version` en el siguiente orden de prioridad. Si configuras `version` manualmente, Datadog no anula su valor `version`.
+Para los datos de APM, Datadog establece la etiqueta `version` para usted en el siguiente orden de prioridad. Si establece manualmente `version`, Datadog no sobrescribe su valor de `version`.
-| Prioridad | Valor de versión |
+| Prioridad | Valor de Versión |
|--------------|------------|
-| 1 | {tu valor de versión} |
+| 1 | {your version value} |
| 2 | {image_tag}_{first_7_digits_of_git_commit_sha} |
-| 3 | {image_tag} o {first_7_digits_of_git_commit_sha} si sólo uno está disponible |
+| 3 | {image_tag} or {first_7_digits_of_git_commit_sha} if only one is available |
Requisitos:
-- Datadog Agent versión 7.52.0 o posterior
-- Si tus servicios se ejecutan en un entorno contenedorizado y `image_tag` es suficiente para el seguimiento de los despliegues de nuevas versiones, no es necesaria ninguna configuración adicional.
-- Si tus servicios no se ejecutan en un entorno contenedorizado o si también te gustaría incluir el git SHA, [integra información de Git en tus artefactos de creación][9]
+- Versión del Agente de Datadog 7.52.0 o superior
+- Si sus servicios se ejecutan en un entorno en contenedores y `image_tag` es suficiente para rastrear nuevas implementaciones de versiones, no se necesita configuración adicional.
+- Si sus servicios no se están ejecutando en un entorno contenerizado, o si también desea incluir el Git SHA, [incorpore la información de Git en sus artefactos de compilación][9].
[1]: /es/agent/cluster_agent/admission_controller/
@@ -240,11 +238,11 @@ Requisitos:
{{% /tab %}}
{{% tab "Docker" %}}
-##### Configuración completa
+##### Configuración completa {#full-configuration-1}
-Configura las variables de entorno `DD_ENV`, `DD_SERVICE` y `DD_VERSION` y las etiquetas (labels) de Docker correspondientes a tu contenedor, para acceder a todo el rango del etiquetado de servicios unificado.
+Establezca las variables de entorno `DD_ENV`, `DD_SERVICE` y `DD_VERSION` y las etiquetas de Docker correspondientes para su contenedor para obtener el rango completo de unified service tagging.
-Los valores de `service` y `version` pueden proporcionarse en el archivo de Docker:
+Los valores para `service` y `version` se pueden proporcionar en el Dockerfile:
```yaml
ENV DD_SERVICE
@@ -254,13 +252,13 @@ LABEL com.datadoghq.tags.service=""
LABEL com.datadoghq.tags.version=""
```
-Puesto que `env` probablemente se determine en el momento del despliegue, puedes introducir la etiqueta (label) y la variable de entorno más adelante:
+Dado que `env` probablemente se determina en el momento de la implementación, puede inyectar la variable de entorno y la etiqueta más tarde:
```shell
docker run -e DD_ENV= -l com.datadoghq.tags.env= ...
```
-Si lo prefieres, también puedes configurar todo en el momento del despliegue:
+También puede preferir establecer todo en el momento de la implementación:
```shell
docker run -e DD_ENV="" \
@@ -272,9 +270,9 @@ docker run -e DD_ENV="" \
...
```
-##### Configuración parcial
+##### Configuración parcial {#partial-configuration-1}
-Si tu servicio no necesita las variables de entorno de Datadog (por ejemplo, si se trata de un software de terceros como Redis, PostgreSQL, NGINX y aplicaciones sin rastreo de APM), puedes utilizar simplemente las etiquetas (labels) de Docker:
+Si su servicio no necesita las variables de entorno de Datadog (por ejemplo, software de terceros como Redis, PostgreSQL, NGINX y aplicaciones que no son rastreadas por APM), puede usar las etiquetas de Docker:
```yaml
com.datadoghq.tags.env
@@ -282,27 +280,27 @@ com.datadoghq.tags.service
com.datadoghq.tags.version
```
-Como se explica en la configuración completa, estas etiquetas (labels) se pueden configurar en un archivo de Docker o como argumentos para iniciar el contenedor.
+Como se explicó en la configuración completa, estas etiquetas se pueden establecer en un Dockerfile o como argumentos para lanzar el contenedor.
-##### Etiquetado automático de versiones para datos de APM en entornos contenedorizados
+##### Etiquetado automático de versiones para datos de APM en entornos contenedorizados {#automatic-version-tagging-for-apm-data-in-containerized-environments-1}
-
-Puedes utilizar la etiqueta (tag) `version` en APM para [monitorizar despliegues][1] e identificar despliegues de código fallidos mediante la [detección automática de despliegues fallidos][2].
+Puede usar la etiqueta `version` en APM para [monitorear implementaciones][1] e identificar implementaciones de código defectuosas a través de [Detección Automática de Implementaciones Defectuosas][2].
-Para datos de APM, Datadog configura la etiqueta (tag) `version` en el siguiente orden de prioridad. Si configuras `version` manualmente, Datadog no anula su valor `version`.
+Para los datos de APM, Datadog establece la etiqueta `version` para usted en el siguiente orden de prioridad. Si establece manualmente `version`, Datadog no sobrescribe su valor de `version`.
-| Prioridad | Valor de versión |
+| Prioridad | Valor de Versión |
|--------------|------------|
-| 1 | {tu valor de versión} |
-| 2 | {image_tag}_{first_7_digits_of_git_commit_sha} |
-| 3 | {image_tag} o {first_7_digits_of_git_commit_sha} si sólo uno está disponible |
+| 1 | {su valor de versión} |
+| 2 | {image_tag}_{primer_7_dígitos_del_git_commit_sha} |
+| 3 | {image_tag} o {primer_7_dígitos_del_git_commit_sha} si solo uno está disponible |
Requisitos:
-- Datadog Agent versión 7.52.0 o posterior
-- Si tus servicios se ejecutan en un entorno contenedorizado y `image_tag` es suficiente para el seguimiento de los despliegues de nuevas versiones, no es necesaria ninguna configuración adicional.
-- Si tus servicios no se ejecutan en un entorno contenedorizado o si también te gustaría incluir el git SHA, [integra información de Git en tus artefactos de creación][3]
-
+- Versión del Agente de Datadog 7.52.0 o superior
+- Si sus servicios se ejecutan en un entorno contenedorizado y `image_tag` es suficiente para rastrear nuevas implementaciones de versiones, no se necesita configuración adicional.
+- Si sus servicios no se están ejecutando en un entorno contenedorizado, o si también desea incluir el SHA de Git, [inserte información de Git en sus artefactos de construcción][3].
+
[1]: /es/tracing/services/deployment_tracking/
[2]: /es/watchdog/faulty_deployment_detection/
@@ -313,12 +311,12 @@ Requisitos:
{{% tab "ECS" %}}
-En ECS Fargate con Fluent Bit o FireLens, el etiquetado de servicios unificado solo está disponible para métricas y trazas, no para la recopilación de logs.
+En ECS Fargate usando Fluent Bit o FireLens, unified service tagging solo está disponible para métricas y trazas, no para la recolección de logs.
-##### Configuración completa
+##### Configuración completa {#full-configuration-2}
-Configura las variables de entorno `DD_ENV`, `DD_SERVICE` y `DD_VERSION` (con el etiquetado automático de versiones opcional) y las etiquetas (labels) de Docker correspondientes en el entorno de ejecución de cada contenedor de servicio, para obtener el rango completo del etiquetado de servicios unificado. Por ejemplo, puedes definir toda esta configuración en un mismo lugar a través de tu definición de tareas de ECS.
+Establezca las variables de entorno `DD_ENV`, `DD_SERVICE` y `DD_VERSION` (opcional con etiquetado automático de versiones) y las etiquetas de Docker correspondientes en el entorno de ejecución de cada contenedor de servicio para obtener el rango completo de unified service tagging. Por ejemplo, puede establecer toda esta configuración en un solo lugar a través de la definición de tarea de ECS:
```
"environment": [
@@ -334,7 +332,7 @@ Configura las variables de entorno `DD_ENV`, `DD_SERVICE` y `DD_VERSION` (con el
"name": "DD_VERSION",
"value": ""
}
-
+
],
"dockerLabels": {
"com.datadoghq.tags.env": "",
@@ -343,12 +341,12 @@ Configura las variables de entorno `DD_ENV`, `DD_SERVICE` y `DD_VERSION` (con el
}
```
-En ECS Fargate, debes añadir estas etiquetas a tu contenedor de aplicaciones, no al contenedor del Datadog Agent.
+En ECS Fargate, debe agregar estas etiquetas a su contenedor de aplicación, no al contenedor del Datadog Agent.
-##### Configuración parcial
+##### Configuración parcial {#partial-configuration-2}
-Si tu servicio no necesita las variables de entorno de Datadog (por ejemplo, si se trata de un software de terceros como Redis, PostgreSQL, NGINX y aplicaciones sin rastreo de APM), puedes utilizar simplemente las etiquetas (labels) de Docker en tu definición de tareas de ECS:
+Si su servicio no necesita las variables de entorno de Datadog (por ejemplo, software de terceros como Redis, PostgreSQL, NGINX y aplicaciones que no son rastreadas por APM), puede usar las etiquetas de Docker en su definición de tarea de ECS:
```
"dockerLabels": {
@@ -358,24 +356,24 @@ Si tu servicio no necesita las variables de entorno de Datadog (por ejemplo, si
}
```
-##### Etiquetado automático de versiones para datos de APM en entornos contenedorizados
+##### Etiquetado automático de versiones para datos de APM en entornos contenedorizados {#automatic-version-tagging-for-apm-data-in-containerized-environments-2}
-
-Puedes utilizar la etiqueta (tag) `version` en APM para [monitorizar despliegues][1] e identificar despliegues de código fallidos mediante la [detección automática de despliegues fallidos][2].
+Puede usar la etiqueta `version` en APM para [monitorear implementaciones][1] e identificar implementaciones de código defectuosas a través de [Detección Automática de Implementaciones Defectuosas][2].
-Para datos de APM, Datadog configura la etiqueta (tag) `version` en el siguiente orden de prioridad. Si configuras `version` manualmente, Datadog no anula su valor `version`.
+Para los datos de APM, Datadog establece la etiqueta `version` para usted en el siguiente orden de prioridad. Si establece manualmente `version`, Datadog no sobrescribe su valor de `version`.
-| Prioridad | Valor de versión |
+| Prioridad | Valor de Versión |
|--------------|------------|
-| 1 | {tu valor de versión} |
-| 2 | {image_tag}_{first_7_digits_of_git_commit_sha} |
-| 3 | {image_tag} o {first_7_digits_of_git_commit_sha} si sólo uno está disponible |
+| 1 | {su valor de versión} |
+| 2 | {image_tag}_{primer_7_dígitos_del_git_commit_sha} |
+| 3 | {image_tag} o {primer_7_dígitos_del_git_commit_sha} si solo uno está disponible |
Requisitos:
-- Datadog Agent versión 7.52.0 o posterior
-- Si tus servicios se ejecutan en un entorno contenedorizado y `image_tag` es suficiente para el seguimiento de los despliegues de nuevas versiones, no es necesaria ninguna configuración adicional.
-- Si tus servicios no se ejecutan en un entorno contenedorizado o si también te gustaría incluir el git SHA, [integra información de Git en tus artefactos de creación][3]
+- Versión del Agente de Datadog 7.52.0 o superior
+- Si sus servicios se ejecutan en un entorno contenedorizado y `image_tag` es suficiente para rastrear nuevas implementaciones de versiones, no se necesita configuración adicional.
+- Si sus servicios no se están ejecutando en un entorno contenedorizado, o si también desea incluir el SHA de Git, [inserte información de Git en sus artefactos de construcción][3].
[1]: /es/tracing/services/deployment_tracking/
[2]: /es/watchdog/faulty_deployment_detection/
@@ -384,85 +382,85 @@ Requisitos:
{{% /tab %}}
{{% /tabs %}}
-### Entorno no contenedorizado
+### Entorno no contenedorizado {#non-containerized-environment}
-Según cómo crees e implementes los archivos binarios o ejecutables de tus servicios, tendrás distintas opciones disponibles para configurar las variables de entorno. Dado que puedes ejecutar uno o varios servicios por host, Datadog recomienda definir el contexto de estas variables de entorno en un solo proceso.
+Dependiendo de cómo construya y despliegue los binarios o ejecutables de sus servicios, puede tener varias opciones disponibles para establecer variables de entorno. Dado que puede ejecutar uno o más servicios por host, Datadog recomienda limitar estas variables de entorno a un solo proceso.
-Para crear un único punto de configuración de toda la telemetría emitida directamente desde la herramienta de gestión de [trazas][8], [logs][9], [recursos RUM][10], [tests Synthetic][11], [métricas de StatsD][12] o métricas del sistema de tus servicios, tienes dos opciones:
+Para formar un único punto de configuración para toda la telemetría emitida directamente desde el tiempo de ejecución de sus servicios para [traces][8], [registros][9], [recursos RUM][10], [pruebas Synthetic][11], [métricas StatsD][12] o métricas del sistema, ya sea:
-1. Exportar las variables de entorno en el comando de tu ejecutable:
+1. Exporte las variables de entorno en el comando para su ejecutable:
```
DD_ENV= DD_SERVICE= DD_VERSION= /bin/my-service
```
-2. También puedes utilizar [Chef][13], [Ansible][14] u otra herramienta de orquestación para rellenar el archivo de configuración systemd o initd de un servicio con las variables de entorno `DD`. Cuando se inicie el proceso del servicio, este tendrá acceso a las variables.
+2. O use [Chef][13], [Ansible][14] u otra herramienta de orquestación para poblar el archivo de configuración systemd o initd de un servicio con las variables de entorno `DD`. Cuando se inicia el proceso del servicio, tiene acceso a esas variables.
{{< tabs >}}
{{% tab "Trazas" %}}
- Al configurar tus trazas para llevar a cabo el etiquetado de servicios unificado:
+ Al configurar sus trazas para unified service tagging:
- 1. Configura el [rastreador de APM][1] con `DD_ENV` para que la definición de `env` sea lo más parecida posible a la aplicación que genera las trazas. Este método permite que la etiqueta (tag) `env` se obtenga automáticamente de una etiqueta de los metadatos del tramo.
+ 1. Configure el [Datadog SDK][1] con `DD_ENV` para mantener la definición de `env` más cerca de la aplicación que está generando las trazas. Este método permite que la etiqueta `env` se obtenga automáticamente de una etiqueta en los metadatos del tramo.
- 2. Configura tramos con `DD_VERSION` para añadir la versión a todos los tramos del servicio que pertenece al rastreador (generalmente, `DD_SERVICE`). De este modo, si tu servicio crea tramos con el nombre de un servicio externo, esos tramos no recibirán `version` como etiqueta (tag).
+ 2. Configure los tramos con `DD_VERSION` para agregar la versión a todos los tramos que pertenecen al servicio que pertenece al SDK (generalmente `DD_SERVICE`). Esto significa que si su servicio crea tramos con el nombre de un servicio externo, esos tramos no reciben `version` como etiqueta.
- Siempre que la versión esté presente en tramos, se añadirá a las métricas de rastreo generadas a partir de esos tramos. La versión se puede añadir al código manualmente o bien automáticamente mediante el rastreador de APM. Cuando están configurados, APM y los [clientes DogStatsD][2] los utilizan para etiquetar datos de trazas y métricas de StatsD con `env`, `service` y `version`. Si el rastreador de APM está habilitado, también introducirá los valores de estas variables en tus logs.
+ Mientras la versión esté presente en los tramos, se agrega a las métricas de traza generadas a partir de esos tramos. La versión se puede agregar manualmente en el código o automáticamente por el Datadog SDK. Cuando se configuran, estos son utilizados por el APM y los [clientes de DogStatsD][2] para etiquetar los datos de traza y las métricas de StatsD con `env`, `service` y `version`. Si está habilitado, el Datadog SDK también inyecta los valores de estas variables en sus registros.
- **Nota**: Solo puede haber **un servicio por tramo**. Por lo general, las métricas de rastreo también tienen un único servicio. Sin embargo, si tienes otro servicio definido en las etiquetas (tags) de tus hosts, esa etiqueta de servicio configurada aparecerá en todas las métricas de rastreo emitidas desde ese host.
+ **Nota**: Solo puede haber **un servicio por tramo**. Las métricas de traza generalmente tienen un solo servicio también. Sin embargo, si tiene un servicio diferente definido en las etiquetas de sus hosts, esa etiqueta de servicio configurada aparece en todas las métricas de traza emitidas desde ese host.
[1]: /es/tracing/setup/
-[2]: /es/developers/dogstatsd/
+[2]: /es/extend/dogstatsd/
{{% /tab %}}
- {{% tab "Logs" %}}
+ {{% tab "Registros" %}}
- Si utilizas [trazas y logs conectados][1], activa la introducción automática de logs siempre que tu rastreador de APM lo permita. De esta forma, el rastreador de APM introducirá automáticamente `env`, `service` y `version` en tus logs, lo que significa que no tendrás que configurar esos campos manualmente en otros lugares.
+ Si está utilizando [registros y trazas conectados][1], habilite la inyección automática de registros si es compatible con su Datadog SDK. Luego, el Datadog SDK inyecta automáticamente `env`, `service` y `version` en sus registros, eliminando así la configuración manual para esos campos en otros lugares.
[1]: /es/tracing/other_telemetry/connect_logs_and_traces/
{{% /tab %}}
- {{% tab "RUM y Session Replay" %}}
+ {{% tab "RUM y Reproducción de sesión" %}}
-Si utilizas [RUM y trazas conectados][1], especifica la aplicación de navegador en el campo `service` , define el entorno en el campo `env` y enumera las versiones en el campo `version` de tu archivo de inicialización.
+ Si está utilizando [RUM y trazas conectados][1], especifique la aplicación del navegador en el campo `service`, defina el entorno en el campo `env` y enumere las versiones en el campo `version` de su archivo de inicialización.
- Cuando [crees una aplicación de RUM][2], confirma los nombres de `env` y `service`.
+ Cuando [cree una aplicación RUM][2], confirme los nombres `env` y `service`.
[1]: /es/real_user_monitoring/correlate_with_other_telemetry/apm/
-[2]: /es/real_user_monitoring/browser/setup/
+[2]: /es/real_user_monitoring/application_monitoring/browser/setup/
{{% /tab %}}
{{% tab "Synthetics" %}}
-Si utilizas [trazas y tests conectados del navegador Synthetic][1], especifica una URL a la que haya que enviar las cabeceras en la sección **APM Integration for Browser Tests** (Integración de APM para tests de navegador) de la [página de configuración de integraciones][2].
+ Si está utilizando [pruebas de navegador Synthetics conectadas y trazas][1], especifique una URL para enviar encabezados en la sección **APM Integration for Browser Tests** de la [Integration Settings page][2].
- Puedes utilizar `*` como comodín. Ejemplo: `https://*.datadoghq.com`.
+ Puede usar `*` para comodines, por ejemplo: `https://*.datadoghq.com`.
[1]: /es/synthetics/apm/
[2]: https://app.datadoghq.com/synthetics/settings/integrations
{{% /tab %}}
- {{% tab "Métricas personalizadas" %}}
+ {{% tab "Custom Metrics" %}}
-Las etiquetas (tags) se añaden solo a modo de anexo en el caso de las [métricas de StatsD personalizadas][1]. Por ejemplo, si tienes dos valores distintos para `env`, las métricas se etiquetan con ambos entornos. No existe ningún orden que haga que una etiqueta reemplace a otra con el mismo nombre.
+ Las etiquetas se añaden de manera acumulativa para [métricas de StatsD personalizadas][1]. Por ejemplo, si tiene dos valores diferentes para `env`, las métricas se etiquetan con ambos entornos. No hay un orden en el que una etiqueta anule a otra del mismo nombre.
-Si tu servicio tiene acceso a `DD_ENV`, `DD_SERVICE` y `DD_VERSION`, el cliente DogStatsD añadirá automáticamente las etiquetas (tags) correspondientes a tus métricas personalizadas.
+ Si su servicio tiene acceso a `DD_ENV`, `DD_SERVICE` y `DD_VERSION`, entonces el cliente DogStatsD agrega automáticamente las etiquetas correspondientes a sus métricas personalizadas.
- **Nota**: Los clientes DogStatsD de Datadog en .NET y PHP no admiten esta funcionalidad.
+ **Nota**: Los clientes de Datadog DogStatsD para .NET y PHP no soportan esta funcionalidad.
[1]: /es/metrics/
{{% /tab %}}
- {{% tab "Métricas de sistema" %}}
+ {{% tab "Métricas del sistema" %}}
-Puedes añadir etiquetas (tags) `env` y `service` a las métricas de tu infraestructura. En contextos no contenedorizados, el etiquetado de las métricas de servicios se configura a nivel del Agent.
+ Puede agregar etiquetas `env` y `service` a sus métricas de infraestructura. En contextos no contenedorizados, la etiquetación para métricas de servicio se configura a nivel del Agente.
- Dado que esta configuración no cambia en cada invocación del proceso de un servicio, no recomendamos añadir `version`.
+ Debido a que esta configuración no cambia con cada invocación del proceso de un servicio, no se recomienda agregar `version`.
-#### Un solo servicio por host
+#### Un solo servicio por host {#single-service-per-host}
-Define la siguiente configuración en el [archivo de configuración principal][1] del Agent:
+Establezca la siguiente configuración en el [archivo de configuración principal del Agente][1]:
```yaml
env:
@@ -470,17 +468,17 @@ tags:
- service:
```
-Esta configuración garantiza el etiquetado uniforme de `env` y `service` en todos los datos emitidos por el Agent.
+Esta configuración garantiza una etiquetación consistente de `env` y `service` para todos los datos emitidos por el Agente.
-#### Varios servicios por host
+#### Múltiples servicios por host {#multiple-services-per-host}
-Define la siguiente configuración en el [archivo de configuración principal][1] del Agent:
+Establezca la siguiente configuración en el [archivo de configuración principal del Agente][1]:
```yaml
env:
```
-Para obtener etiquetas (tags) de `service` únicas en las métricas de CPU, de memoria y de E/S de disco a nivel del proceso, deberás configurar un [check del proceso][2] en la carpeta de configuración del Agent (por ejemplo, en la carpeta `conf.d` en `process.d/conf.yaml`):
+Para obtener etiquetas `service` únicas en métricas de CPU, memoria y disco I/O a nivel de proceso, configure una [verificación de proceso][2] en la carpeta de configuración del Agente (por ejemplo, en la carpeta `conf.d` bajo `process.d/conf.yaml`):
```yaml
init_config:
@@ -495,20 +493,20 @@ instances:
service: nginx-web-app
```
-**Nota**: Si ya tienes una etiqueta (tag) `service` configurada globalmente en el archivo de configuración principal de tu Agent, las métricas del proceso se etiquetan con dos servicios. Como esto puede resultar confuso para la interpretación de las métricas, se recomienda establecer la etiqueta `service` únicamente en la configuración del check del proceso.
+**Nota**: Si ya tiene una etiqueta `service` configurada globalmente en el archivo de configuración principal de su Agente, las métricas del proceso se etiquetan con dos servicios. Dado que esto puede causar confusión al interpretar las métricas, se recomienda configurar la etiqueta `service` solo en la configuración de la verificación de proceso.
[1]: /es/agent/configuration/agent-configuration-files
[2]: /es/integrations/process
{{% /tab %}}
{{< /tabs >}}
-### Entorno serverless
+### Entorno Serverless {#serverless-environment}
-Para obtener más información sobre las funciones de AWS Lambda, consulta [cómo conectar tu telemetría de Lambda mediante el uso de etiquetas (tags)][15].
+Para más información sobre funciones de AWS Lambda, consulte [cómo conectar su telemetría de Lambda usando etiquetas][15].
-### OpenTelemetry
+### OpenTelemetry {#opentelemetry}
-Cuando utilices OpenTelemetry, asigna los siguientes [atributos de recursos][16] a sus correspondientes convenciones de Datadog:
+Al usar OpenTelemetry, mapee los siguientes [atributos de recurso][16] a sus convenciones correspondientes de Datadog:
| Convención de OpenTelemetry | Convención de Datadog |
| --- | --- |
@@ -517,15 +515,15 @@ Cuando utilices OpenTelemetry, asigna los siguientes [atributos de recursos][16]
| `service.name` | `service` |
| `service.version` | `version` |
-1: `deployment.environment` queda obsoleto en favor de `deployment.environment.name` en [convenciones semánticas de OpenTelemetry v1.27.0][17].
-2: `deployment.environment.name` es compatible con el Datadog Agent v7.58.0 o posterior y con Datadog Exporter v0.110.0 o posterior.
+1: `deployment.environment` está obsoleto en favor de `deployment.environment.name` en [convenciones semánticas de OpenTelemetry v1.27.0][17].
+2: `deployment.environment.name` es compatible con Datadog Agent 7.58.0+ y Datadog Exporter v0.110.0+.
-
Las variables de entorno específicas de Datadog como DD_SERVICE, DD_ENV o DD_VERSION no se admiten predefinidas en la configuración de OpenTelemetry.
+
Las variables de entorno específicas de Datadog como DD_SERVICE, DD_ENV o DD_VERSION no son compatibles de forma predeterminada en su configuración de OpenTelemetry.
{{< tabs >}}
-{{% tab "Environment variables" %}}
+{{% tab "Variables de entorno" %}}
-Para definir atributos de recursos utilizando variables de entorno, configura `OTEL_RESOURCE_ATTRIBUTES` con los valores adecuados:
+Para establecer atributos de recursos utilizando variables de entorno, configure `OTEL_RESOURCE_ATTRIBUTES` con los valores apropiados:
```shell
export OTEL_RESOURCE_ATTRIBUTES="service.name=my-service,deployment.environment=production,service.version=1.2.3"
@@ -535,9 +533,9 @@ export OTEL_RESOURCE_ATTRIBUTES="service.name=my-service,deployment.environment=
{{% tab "SDK" %}}
-Para definir los atributos de los recursos en el código de tu aplicación, crea un `Resource` con los atributos elegidos y asócialo a tu `TracerProvider`.
+Para establecer atributos de recursos en el código de su aplicación, cree un `Resource` con los atributos deseados y asócialo con su `TracerProvider`.
-El siguiente es un ejemplo de uso de Python:
+Aquí hay un ejemplo usando Python:
```python
from opentelemetry.sdk.resources import Resource
@@ -553,9 +551,9 @@ tracer_provider = TracerProvider(resource=resource)
{{% /tab %}}
-{{% tab "Recopilador" %}}
+{{% tab "Collector" %}}
-Para definir atributos de recursos desde el recopilador OpenTelemetry, utiliza el [procesador de transformación][100] en el archivo de configuración de tu recopilador. El procesador de transformación permite modificar los atributos de los datos de telemetría recopilados antes de enviarlos al exportador de Datadog:
+Para establecer atributos de recursos desde el OpenTelemetry Collector, use el [procesador de transformación][100] en su archivo de configuración del Collector. El procesador de transformación le permite modificar los atributos de los datos de telemetría recopilados antes de enviarlos al exportador de Datadog:
```yaml
processors:
@@ -574,7 +572,7 @@ processors:
{{% /tab %}}
{{< /tabs >}}
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/glossary/_index.md b/content/es/glossary/_index.md
index 4120fd21bb1..c97a5aa53c7 100644
--- a/content/es/glossary/_index.md
+++ b/content/es/glossary/_index.md
@@ -3,13 +3,12 @@ aliases:
- /es/glossary/terms/wall_time/
cascade:
disable_toc: true
-filter_all: Todas
+filter_all: All
scrollspy:
offset: 5
target: '#glossary-nav'
title: Glosario
---
-
{{< jqmath-vanilla >}}
-
¡Bienvenido a nuestro glosario! Este glosario se encuentra en progreso y estamos creando una lista completa de términos de manera activa, lo que tomará tiempo. Si tienes comentarios sobre el funcionamiento de este glosario o los términos que te gustaría encontrar, haz clic en Feedback (Comentarios) y háznoslo saber.
\ No newline at end of file
+
¡Bienvenido a nuestro Glosario! Este es un trabajo en progreso y estamos construyendo activamente una lista completa de términos, lo cual tomará tiempo. Si tienes comentarios sobre cómo funciona este glosario, o términos que te gustaría ver definidos, por favor haz clic en Feedback y háznoslo saber.
\ No newline at end of file
diff --git a/content/es/infrastructure/_index.md b/content/es/infrastructure/_index.md
index 5ed70bba985..cd83dbf7af6 100644
--- a/content/es/infrastructure/_index.md
+++ b/content/es/infrastructure/_index.md
@@ -15,36 +15,37 @@ cascade:
further_reading:
- link: https://app.datadoghq.com/release-notes?category=Infrastructure%20Monitoring
tag: Notas de la versión
- text: ¡Echa un vistazo a las últimas versiones de la Monitorización de la infraestructura
- de Datadog! (Es necesario iniciar sesión en la aplicación)
+ text: ¡Consulta las últimas versiones de Datadog Infrastructure Monitoring! (Se
+ requiere inicio de sesión en la aplicación).
- link: https://dtdg.co/fe
- tag: Habilitar los fundamentos
- text: Participa en una sesión interactiva para potenciar la monitorización de tu
- infraestructura
-title: Infraestructura
+ tag: Habilitación de Fundación
+ text: Únete a una sesión interactiva para potenciar tu Infrastructure Monitoring
+- link: https://learn.datadoghq.com/courses/getting-started-infra-cnm
+ tag: Centro de Aprendizaje
+ text: Introducción a Infrastructure Monitoring y Cloud Network Monitoring (CNM)
+title: Infrastructure
---
-
-{{< learning-center-callout header="Únete a una sesión de Enablement" hide_image="true" btn_title="Inscríbite" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=Infrastructure+Monitoring">}}
- Explora y regístrate para las sesiones de Foundation Enablement. Obtén información sobre cómo la monitorización de infraestructura basada en SaaS de Datadog ofrece métricas, visualizaciones y alertas para asegurar que tus equipos de ingeniería puedan mantener y optimizar tus entornos híbridos o en la nube.
+{{< learning-center-callout header="Únete a una sesión de seminario web de habilitación" hide_image="true" btn_title="Regístrate" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=Infrastructure+Monitoring">}}
+ Explora y regístrate para las sesiones de Habilitación de Fundación. Aprende cómo el Infrastructure Monitoring basado en SaaS de Datadog proporciona métricas, visualizaciones y alertas para asegurar que tus equipos de ingeniería puedan mantener y optimizar tus entornos en la nube o híbridos.
{{< /learning-center-callout >}}
-## Información general
+## Resumen {#overview}
-{{< img src="infrastructure/Hostmap-compressed.mp4" alt="Vídeo del mapa de hosts filtrado por hosts de Nginx" video="true">}}
+{{< img src="infrastructure/Hostmap-compressed.mp4" alt="Video del mapa de servidores filtrado a los servidores de Nginx" video="true">}}
-La monitorización de la infraestructura incluye funciones básicas de Datadog que visualizan, monitorizan y miden el rendimiento de tus hosts, contenedores y procesos.
+El Infrastructure Monitoring incluye características centrales de Datadog que visualizan, monitorean y miden el rendimiento de tus servidores, Containers y procesos.
-## Componentes
+## Componentes {#components}
-{{< whatsnext desc="En esta sección se incluyen los siguientes temas:">}}
- {{< nextlink href="/infrastructure/list" >}}Lista de infraestructuras: consulta una lista de todos tus hosts que monitoriza Datadog.{{< /nextlink >}}
- {{< nextlink href="/infrastructure/hostmap" >}}Mapas de hosts y contenedores: visualiza tus hosts en una sola pantalla con agrupaciones, métricas y filtros personalizados que se destacan a través de distintos colores y formas.{{< /nextlink >}}
- {{< nextlink href="/infrastructure/containers" >}}Vista de contenedores: monitoriza los contenedores de tu entorno con visibilidad en tiempo real.{{< /nextlink >}}
- {{< nextlink href="/infrastructure/process" >}}Vista de procesos: monitoriza tus procesos con visibilidad en tiempo real de los elementos más granulares de un despliegue.{{< /nextlink >}}
+{{< whatsnext desc="Esta sección incluye los siguientes temas:">}}
+ {{< nextlink href="/infrastructure/list" >}}Infrastructure List - Consulta una lista de todos tus servidores monitoreados por Datadog.{{< /nextlink >}}
+ {{< nextlink href="/infrastructure/hostmap" >}}Mapas de servidores y Containers - Visualiza tus servidores juntos en una pantalla con agrupaciones, filtros y métricas personalizadas que se hacen comprensibles por color y forma.{{< /nextlink >}}
+ {{< nextlink href="/infrastructure/containers" >}}Containers View - Monitorea los Containers en tu entorno con visibilidad en tiempo real.{{< /nextlink >}}
+ {{< nextlink href="/infrastructure/process" >}}Processes View - Monitorea tus procesos con visibilidad en tiempo real de los elementos más granulares en un despliegue.{{< /nextlink >}}
{{< /whatsnext >}}
-## Referencias adicionales
+##Lectura Adicional{#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
\ No newline at end of file
diff --git a/content/es/infrastructure/hostmap.md b/content/es/infrastructure/hostmap.md
index 83bdfb60989..5231f552496 100644
--- a/content/es/infrastructure/hostmap.md
+++ b/content/es/infrastructure/hostmap.md
@@ -4,128 +4,60 @@ aliases:
- /es/infrastructure/containermap/
- /es/guides/hostmap
further_reading:
+- link: https://www.datadoghq.com/blog/datadog-host-map
+ tag: Blog
+ text: Un nuevo mapa de servidores para infraestructura moderna
- link: /infrastructure/livecontainers/
tag: Documentación
- text: Obtén visibilidad en tiempo real de todos los contenedores de tu entorno
+ text: Obtén visibilidad en tiempo real de todos los contenedores en tu entorno
- link: /infrastructure/process/
tag: Documentación
- text: Comprender lo que sucede en cualquier nivel del sistema
-title: Mapas de hosts y contenedores
+ text: Entiende lo que está sucediendo en cualquier nivel de tu sistema
+title: Mapa de servidores
---
+El [mapa de servidores][1] de Datadog visualiza tus servidores, pods, contenedores y clústeres, ayudándote a entender y diagnosticar tu infraestructura.
-## Información general
+{{< img src="infrastructure/hostmap/new-host-map.png" alt="El mapa de servidores muestra los servidores agrupados por Availability Zone y coloreados por uso de CPU. Las celdas hexagonales varían de verde (bajo uso) a naranja-rojo (alto uso). Los grupos incluyen un grupo sin Availability Zone con 395 servidores, otro con eastus con 183 y otro con eastus-1 con 153, además de muchas otras regiones." style="width:100%;" >}}
-Los mapas de infraestructuras ([mapas de hosts][4] y [mapas de contenedores][5]) te ayudan a visualizar hosts y contenedores en una pantalla, con métricas que se destacan a través de distintos colores y formas.
+## Uso {#usage}
-{{< img src="infrastructure/containermap/containermap.png" alt="Un mapa de contenedores que muestra los contenedores como rectángulos agrupados por zona de disponibilidad de AWS." style="width:80%;">}}
+{{< img src="infrastructure/hostmap/query-selector.png" alt="El menú desplegable del selector de consultas muestra una lista de consultas sugeridas como '¿Cuál es el uso de CPU en mis servidores?' y '¿Cuántos errores se están registrando en mi infraestructura?', junto con consultas personalizadas guardadas. Un botón de Create y un campo de búsqueda de Filter views están en la parte superior." style="width:60%;" >}}
-Utiliza el selector desplegable de la parte superior izquierda para cambiar entre hosts y contenedores.
+Utiliza el menú desplegable en la esquina superior izquierda para ver consultas sugeridas, o las consultas personalizadas guardadas escritas por ti o por alguien más en tu organización. Para escribir una consulta personalizada, haz clic en {{< ui >}}Create{{< /ui >}}.
-## Instalación
+{{< img src="infrastructure/hostmap/draft-query.png" alt="El editor de Draft Query con dos niveles. El objeto padre está configurado como servidor con Rellenar por uso de CPU. El objeto hijo está configurado como pod con Rellenar por Readiness." style="width:100%;" >}}
-Después de desplegar el [Agent][6], no se necesita ninguna otra configuración. Para recopilar información del contenedor de Docker en la instalación estándar en lugar de con el [Docker Agent][7], el usuario `dd-agent` debe contar con permisos para acceder a `docker.sock`. El permiso se puede otorgar al añadir `dd-agent` al grupo `docker`.
+- {{< ui >}}Parent/Child Object{{< /ui >}}: Selecciona recursos ({{< ui >}}Host{{< /ui >}}, {{< ui >}}Pod{{< /ui >}}, {{< ui >}}Container{{< /ui >}}, {{< ui >}}Cluster{{< /ui >}}) para ver. Los objetos padre e hijo tienen relaciones jerárquicas.
+- {{< ui >}}Fill by{{< /ui >}}: Por defecto, el color de cada objeto representa el uso de CPU, donde el color varía de verde (0% utilizado) a naranja (100% utilizado). Utiliza el menú desplegable {{< ui >}}Fill by{{< /ui >}} para colorear tus objetos según diversas métricas o señales, como memoria o registros de errores.
+- {{< ui >}}Size by{{< /ui >}}: Si no especificas un objeto hijo, puedes usar el selector {{< ui >}}Size by{{< /ui >}} para dimensionar cada objeto según una métrica o señal.
+ {{< img src="infrastructure/hostmap/size-by.png" alt="El editor de consultas del mapa de servidores con el objeto padre configurado como servidor, Rellenar por configurado como uso de CPU y Tamaño por configurado como registros de errores. El mapa a continuación muestra 1.61k servidores como hexágonos de distintos tamaños y colores, con un tooltip en un servidor que muestra un uso promedio de CPU del 88%." style="width:85%;" >}}
+- {{< ui >}}Group by{{< /ui >}}: Organiza espacialmente tus objetos en grupos. Puedes usar múltiples agrupaciones. Por ejemplo, si agrupas por `tags.availability-zone` `tags.instance-type`, tus objetos se organizan primero por Availability Zone y luego se subdividen por tipo de instancia.
-## Uso
+ {{< img src="infrastructure/hostmap/group-by.png" alt="El mapa de servidores agrupado por las etiquetas tags.availability-zone y tags.instance-type. Los servidores se organizan primero en secciones de Availability Zone, como us-east-1a y us-east-1b, y luego se subdividen por tipo de instancia, como m5a.2xlarge y t2.micro. Las celdas se colorean según el uso de CPU de verde a naranja-rojo." style="width:85%;" >}}
+- {{< ui >}}Filter{{< /ui >}}: Limita el mapa de servidores a un subconjunto específico de tu infraestructura. Por ejemplo, puedes filtrar por `production` para ver solo tus recursos de producción. La entrada {{< ui >}}Filter{{< /ui >}} admite operadores lógicos (`AND`, `NOT`, `OR`) y comodines (`*`). Por ejemplo: `(tags.availability-zone:ap* OR tags.availability-zone:eu*) NOT tags.agent_version:5.3*`.
-### Filtro
+## Casos de uso {#use-cases}
-Utiliza la casilla de entrada **Filter** (Filtro) para limitar un mapa de infraestructuras a un subconjunto específico de una infraestructura. La barra de entrada de filtro de la parte superior izquierda permite filtrar el mapa de infraestructuras por etiquetas (tags), así como por los atributos que proporciona Datadog.
+### Solucionar el rendimiento degradado del servidor {#troubleshoot-degraded-server-performance}
-Si la barra de entrada de filtro está vacía, el mapa muestra todos los hosts/contenedores que informan la métrica seleccionada a Datadog.
+Identifica si los problemas de rendimiento provienen de servidores sobrecargados, pods no saludables, reinicios de contenedores o cuellos de botella a nivel de clúster. Verifica `kubernetes_state.pod.status:unready` o `system.cpu.user > 80` y utiliza visualizaciones jerárquicas para aislar la causa raíz.
-Por ejemplo, si etiquetas tus hosts por el entorno en el que se encuentran, puedes filtrar por «producción» para eliminar del mapa los hosts de tu entorno de prueba y otros entornos. Si deseas eliminar todos los roles de host excepto uno en producción, también añade ese rol al filtro; los filtros se combinan con `AND`.
+### Identifica los puntos críticos de costo {#identify-cost-hotspots}
+Identifica los clústeres, nodos o cargas de trabajo que contribuyen desproporcionadamente al gasto en la nube consultando etiquetas como `tags.kube_node_instance_type`, `tags.cloud_provider` o etiquetas de asignación personalizadas. Combina esto con señales de CPU y memoria de contenedores/servidores para detectar subaprovisionamiento o sobreaprovisionamiento.
-**Nota**: Existe una distinción entre filtrar por `tag:value` y `"tag:value"`. El filtrado por `tag:value` coincide estrictamente con la etiqueta, mientras que el filtrado por `"tag:value"` realiza una búsqueda en ese texto.
+### Gestión del Datadog Agent a nivel de flota {#fleet-wide-datadog-agent-management}
-### Grupo
+Encuentra servidores o contenedores que ejecuten versiones desactualizadas del Datadog Agent utilizando consultas como `tags.agent_version < 7.50`. Luego, agrupa por Availability Zone, clúster o servicio para impulsar la planificación de despliegues.
-Utiliza la casilla de entrada **Group** (Grupo) para organizar de manera espacial tus hosts/contenedores en grupos. Cualquier host/contenedor en un grupo comparte la etiqueta, o etiquetas, por el que se agrupa.
+### Monitorea los despliegues de Kubernetes o las migraciones de infraestructura {#monitor-kubernetes-rollouts-or-infrastructure-migrations}.
-Por ejemplo, puedes agrupar tus hosts por zona de disponibilidad de AWS. Si añades una segunda etiqueta de agrupación, como tipo de instancia, los hosts se subdividen en grupos: primero por zona de disponibilidad y luego por tipo de instancia, como se muestra a continuación.
+Visualiza la distribución y salud de los pods, nodos y clústeres durante un despliegue o migración. Visualiza tus clústeres, anidados con pods, y observa los cambios en tiempo real para detectar regresiones.
-{{< img src="infrastructure/hostmap/hostmappart2image2.png" alt="Un mapa de hosts donde los hosts (representados por hexágonos) se dividen en dos grupos, por zona de disponibilidad. Dentro de cada grupo de zonas de disponibilidad, los hosts se subdividen por tipo de instancia." >}}
+### Verifica la higiene de etiquetado y metadatos {#verify-tagging-and-metadata-hygiene}.
-### Relleno y tamaño
+Utiliza operadores lógicos para validar si tus servidores y pods están correctamente etiquetados para propiedad, entorno, región o asignación de costos. Por ejemplo, `tags.env:prod AND NOT (tags.team:*)` para mostrar recursos no asignados o etiquetados incorrectamente.
-De manera predeterminada, el color de cada host se establece para representar el porcentaje de uso de la CPU en ese host/contenedor, donde el color va del verde (0 % utilizado) al naranja (100 % utilizado). Puedes seleccionar diferentes métricas desde el selector **Fill** (Relleno).
-
-Los mapas de infraestructuras también pueden comunicar una métrica opcional adicional con el tamaño del hexágono o rectángulo. Puedes seleccionar esta métrica en el selector **Size** (Tamaño).
-
-**Nota**: La métrica de utilización de la CPU utiliza la medida más confiable y actualizada de utilización de la CPU, ya sea que la informe el Datadog Agent o directamente AWS o vSphere.
-
-### Etiquetas (tags)
-
-Puedes aplicar [etiquetas][1] de forma manual o utilizar [integraciones][2] para aplicarlas de manera automática. Luego, puedes utilizar estas etiquetas para filtrar tus hosts o contenedores.
-
-Por ejemplo, si algunos de tus hosts se ejecutan en AWS, se encontrarán disponibles las siguientes etiquetas específicas de AWS:
-
-* `availability-zone`
-* `region`
-* `image`
-* `instance-type`
-* `security-group`
-* cualquier etiqueta de EC2 que puedas utilizar, como `name`
-
-El Datadog Agent también recopila metadatos del host e información de la aplicación, algunos de los cuales se pueden utilizar como filtro o para agrupar términos. Esos campos incluyen:
-
-- `field:metadata_agent_version`
-- `field:metadata_platform`
-- `field:metadata_processor`
-- `field:metadata_machine`
-- `field:apps`
-
-### Ampliar
-
-Cuando hayas identificado un host o contenedor que desees investigar, haz clic en él para obtener más detalles. Se ampliará y mostrará hasta seis integraciones que informan métricas de ese host. Si hay más de seis integraciones, se enumerarán bajo el encabezado **Apps** (Aplicaciones) en el panel de detalles del host, como se muestra en la siguiente captura de pantalla.
-
-Haz clic en el nombre de una integración a fin de obtener un dashboard condensado de métricas para esa integración. En la siguiente captura de pantalla, se hizo clic en «system» (sistema) para obtener métricas del sistema, como el uso de la CPU, el uso de la memoria, la latencia del disco, etc.
-
-{{< img src="infrastructure/hostmap/blog-host-maps-01.png" alt="Una vista de lo que se muestra cuando un usuario hace clic en un host en particular. Se muestra un panel de información en la parte inferior y se enumeran varias aplicaciones, así como secciones para métricas y checks de estado." style="width:75%;" >}}
-
-### Visualizar hosts en el mapa de hosts que no tienen un Agent instalado
-
-De forma predeterminada, el mapa de hosts solo muestra los hosts que informan la métrica seleccionada, que luego se puede utilizar a fin de establecer un color o tamaño para el hexágono individual dentro de la cuadrícula.
-
-### Actualización y significado de los datos
-
-Los datos del mapa de hosts se actualizan aproximadamente una vez por minuto, a menos que interactúes de manera continua con el mapa. La parte inferior izquierda de la pantalla indica cuándo se actualizaron los datos por última vez.
-
-## Casos de uso
-
-### Optimización de recursos
-
-Si eres usuario de AWS, es posible que utilices varios tipos de instancias. Algunas instancias se encuentran optimizadas para la memoria, otras para la computación, algunas son pequeñas y otras son grandes.
-
-Si deseas reducir tu gasto en AWS, puedes empezar por averiguar para qué se utilizan las costosas instancias. Primero, agrupa por `instance-type` y, a continuación, por `role` o `name`. Echa un vistazo a tus costosos tipos de instancias, como **c3.8xlarge**. ¿Hay roles de host cuya CPU esté infrautilizada? Si es así, amplía los hosts individuales y observa si se ha necesitado toda esa potencia computacional en los últimos meses, o si este grupo de hosts es un candidato para migrar a un tipo de instancia más barato.
-
-A continuación se muestra un subconjunto de la infraestructura de Datadog. Como puedes ver, las instancias **c3.2xlarge** se encuentran muy cargadas.
-
-{{< img src="infrastructure/hostmap/hostmappart1image2.png" alt="La vista de una cantidad de hosts, representados por hexágonos, que se han agrupado por tipo de instancia: m3.large, c3.2xlarge y m1.xlarge. La mayoría de los hosts en m3.large y m1.xlarge son de color verde para indicar una baja utilización de la CPU, pero los hosts en c3.2xlarge son de color naranja, lo que significa una alta utilización de la CPU." style="width:80%;">}}
-
-Si haces clic en el grupo c3.2xlarge y luego en el subgrupo por rol (como se muestra a continuación), verás que solo algunos de los roles se encuentran cargados, mientras que otros están casi inactivos. Si cambiaras estos siete nodos verdes a un c3.xlarge, ahorrarías casi 13.000 $ al año. (0,21 $ ahorrados por hora por host x 24 horas/día * 365 días/año * 7 hosts = 12.877,20 $/año)
-
-{{< img src="infrastructure/hostmap/hostmappart1image3.png" alt="El grupo c3.2xlarge que se mostró anteriormente, ahora un subgrupo por rol. Algunos grupos son naranja uniformemente, pero otros son todos verdes." style="width:80%;">}}
-
-### Ubicación de las zonas de disponibilidad
-
-Los mapas de hosts te permiten ver las distribuciones de máquinas en cada una de tus zonas de disponibilidad (AZ). Filtra los hosts que te interesen, agrúpalos por AZ y podrás ver de inmediato si es necesario reequilibrar los recursos.
-
-En el ejemplo que se muestra a continuación, hay una distribución desigual de hosts con `role:daniels` en las zonas de disponibilidad. (Daniels es el nombre de una aplicación interna).
-
-{{< img src="infrastructure/hostmap/hostmappart1image4.png" alt="Mapa de hosts filtrado por role:daniels y agrupado por zona de disponibilidad. Se muestran tres grupos de hosts." style="width:80%;" >}}
-
-### Investigación del problema
-
-Imagina que tienes un problema en la producción. Es posible que las CPUs de algunos de tus hosts se encuentren vinculadas, lo que genera tiempos de respuesta prolongados. Los mapas de hosts pueden ayudarte a ver rápidamente si hay algo diferente entre los hosts cargados y no cargados. Puedes agrupar de manera rápida por dimensiones que te gustaría investigar y determinar de forma visual si los servidores problemáticos pertenecen a un grupo determinado.
-Por ejemplo, puedes agrupar por AZ, región, tipo de instancia, imagen o cualquier etiqueta que utilices en el sistema.
-
-En la siguiente captura de pantalla, algunos hosts tienen mucha menos memoria utilizable que otros, a pesar de ser parte del mismo clúster. La agrupación por imagen de máquina revela que había dos imágenes diferentes en uso y una de ellas está sobrecargada.
-
-{{< img src="infrastructure/hostmap/hostmappart1image5.png" alt="Mapas de hosts de Datadog con dos bandas de uso de memoria" style="width:80%;" >}}
-
-{{< img src="infrastructure/hostmap/hostmappart1image6.png" alt="Mapas de hosts de Datadog con dos grupos de imágenes" style="width:80%;">}}
-
-## Leer más
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/logs/explorer/search_syntax.md b/content/es/logs/explorer/search_syntax.md
index ea0792f0192..8d904259697 100644
--- a/content/es/logs/explorer/search_syntax.md
+++ b/content/es/logs/explorer/search_syntax.md
@@ -2,144 +2,154 @@
aliases:
- /es/logs/search-syntax
- /es/logs/search_syntax/
-description: Busca a través de todos tus logs.
+description: Busca en todos tus registros.
further_reading:
- link: /getting_started/search/
tag: Documentación
text: Introducción a la búsqueda en Datadog
- link: /logs/explorer/#visualize
tag: Documentación
- text: Aprende a visualizar logs
+ text: Aprende a visualizar registros
- link: /logs/explorer/#patterns
tag: Documentación
- text: Detecta patrones en tus logs
+ text: Detecta patrones dentro de tus registros
- link: /logs/log_configuration/processors
tag: Documentación
- text: Aprender a procesar tus logs
+ text: Aprende a procesar tus registros
- link: /logs/explorer/saved_views/
tag: Documentación
- text: Más información sobre las vistas guardadas
+ text: Aprende sobre Saved Views
- link: /logs/explorer/calculated_fields/formulas
tag: Documentación
- text: Más información sobre fórmulas de campos calculados
-title: Sintaxis de búsqueda de logs
+ text: Aprende más sobre Fórmulas de Campos Calculados
+- link: https://learn.datadoghq.com/courses/log-explorer
+ tag: Centro de Aprendizaje
+ text: Introducción a Log Explorer
+title: Sintaxis de Búsqueda de Registros
---
-
-## Información general
+## Resumen {#overview}
Un filtro de consulta se compone de términos y operadores.
-Existen dos tipos de términos:
+Hay dos tipos de términos:
* Un **término único** es una sola palabra como `test` o `hello`.
-* Una **secuencia** es un grupo de palabras rodeadas de comillas dobles, como `"hello dolly"`.
+* Una **secuencia** es un grupo de palabras rodeadas por comillas dobles, como `"hello dolly"`.
-Para combinar varios términos en una consulta compleja, puedes utilizar cualquiera de los siguientes operadores booleanos que distinguen entre mayúsculas y minúsculas:
+Para combinar múltiples términos en una consulta compleja, puedes usar cualquiera de los siguientes operadores booleanos sensibles a mayúsculas y minúsculas:
| | | |
|--------------|--------------------------------------------------------------------------------------------------------|------------------------------|
| **Operador** | **Descripción** | **Ejemplo** |
-| `AND` | **Intersección**: ambos términos están en los eventos seleccionados (si no se añade nada, se toma AND por defecto). | autenticación Y fallo |
-| `OR` | **Unión**: cualquiera de los dos términos está en los eventos seleccionados. | autenticación O contraseña |
-| `-` | **Exclusión**: el siguiente término NO figura en el evento (se aplica a cada búsqueda de texto sin formato individual). | autenticación Y contraseña |
+| `AND` | **Intersección**: ambos términos están en los eventos seleccionados (si no se agrega nada, se toma AND por defecto) | autenticación AND fallo |
+| `OR` | **Unión**: cualquiera de los términos está contenido en los eventos seleccionados | autenticación OR contraseña |
+| `-` | **Exclusión**: el siguiente término NO está en el evento (aplica a cada búsqueda de texto sin procesar individual) | autenticación AND -contraseña |
-## Búsqueda de texto completo
+## Búsqueda de texto completo {#full-text-search}
-
La función de búsqueda de texto completo solo está disponible en Log Management y funciona en las consultas de monitor, dashboard y notebook. La sintaxis de búsqueda de texto completo no puede utilizarse para definir filtros de índice, filtros de archivo, filtros de pipeline de log, filtros de rehidratación ni en Live tail.
+
La función de búsqueda de texto completo solo está disponible en Log Management y funciona en consultas de monitor, Dashboards y notebook. La sintaxis de búsqueda de texto completo no se puede utilizar para definir filtros de índice, filtros de archivo, filtros de canalización, filtros de rehidratación, o en Live Tail.
-Utiliza la sintaxis `*:search_term` para realizar una búsqueda de texto completo en todos los atributos de log, incluido el mensaje de log.
+Usa la sintaxis `*:search_term` para realizar una búsqueda de texto completo en todos los atributos de registro, incluyendo el mensaje de registro.
-### Ejemplo de término único
+### Ejemplo de término único {#single-term-example}
| Sintaxis de búsqueda | Tipo de búsqueda | Descripción |
| ------------- | ----------- | --------------------------------------------------------- |
-| `*:hello` | Texto completo | Busca en todos los atributos de log la cadena exacta `hello`. |
-| `hello` | Texto libre | Busca la cadena exacta `hello` solo en los atributos `message`, `@title`, `@error.message` y `@error.stack`. |
+| `*:hello` | Texto completo | Busca en todos los atributos de registro la cadena exacta `hello`. |
+| `hello` | Texto libre | Busca solo en los atributos `message`, `@title`, `@error.message` y `@error.stack` la cadena exacta `hello`. |
-### Ejemplo de término de búsqueda con comodín
+### Ejemplo de término de búsqueda con comodín {#search-term-with-wildcard-example}
| Sintaxis de búsqueda | Tipo de búsqueda | Descripción |
| ------------- | ----------- | ------------------------------------------------------------------------------------------- |
-| `*:hello` | Texto completo | Busca en todos los atributos de log la cadena exacta `hello`. |
-| `*:hello*` | Texto completo | Busca en todos los atributos de log las cadenas que empiecen por `hello`. Por ejemplo, `hello_world`. |
+| `*:hello` | Texto completo | Busca en todos los atributos de registro la cadena exacta `hello`. |
+| `*:hello*` | Texto completo | Busca en todos los atributos de registro cadenas que comienzan con `hello`. Por ejemplo, `hello_world`. |
-### Ejemplo de términos múltiples con coincidencia exacta
+### Ejemplo de múltiples términos con coincidencia exacta {#multiple-terms-with-exact-match-example}
| Sintaxis de búsqueda | Tipo de búsqueda | Descripción |
| ------------------- | ----------- |--------------------------------------------------------------------------------------------------- |
-| `*:"hello world"` | Texto completo | Busca en todos los atributos de log la cadena exacta `hello world`. |
-| `hello world` | Texto libre | Busca sólo en el mensaje de log las palabras `hello` y `world`. Por ejemplo `hello beautiful world`. |
-
-## Caracteres especiales de escape y espacios
+| `*:"hello world"` | Texto completo | Busca en todos los atributos de registro la cadena exacta `hello world`. |
+| `hello world` | Texto libre | Busca solo en el mensaje del registro las palabras `hello` y `world`. Por ejemplo `hello beautiful world`. |
-Los siguientes caracteres se consideran especiales y deben escaparse con el carácter `\`: `-` `!` `&&` `||` `>` `>=` `<` `<=` `(` `)` `{` `}` `[` `]` `"` `*` `?` `:` `\` `#` y espacios.
-- `/` no se considera un carácter especial y no necesita escape.
-- `@` no puede utilizarse en las consultas de búsqueda dentro del Log Explorer porque está reservado para la [búsqueda de atributos](#attributes-search).
+## Escapar caracteres especiales y espacios {#escape-special-characters-and-spaces}
-No se pueden buscar caracteres especiales en un mensaje de log. Puedes buscar caracteres especiales cuando están dentro de un atributo.
+Los siguientes caracteres se consideran especiales y requieren ser escapados con el carácter `\`: `=` `-` `!` `&&` `||` `>` `>=` `<` `<=` `(` `)` `{` `}` `[` `]` `"` `*` `?` `:` `\` `#`, y espacios.
+- `/` no se considera un carácter especial y no necesita ser escapado.
+- `@` no se puede usar en consultas de búsqueda dentro de Logs Explorer porque está reservado para [Búsqueda de Atributos](#attributes-search).
-Para buscar caracteres especiales, analízalos en un atributo con el [Analizador Grok][1] y busca los logs que contengan ese atributo.
+No se puede buscar caracteres especiales en un mensaje de registro. Se pueden buscar caracteres especiales cuando están dentro de un atributo.
+Para buscar caracteres especiales, conviértelos en un atributo con el [Grok Parser][1], y busca registros que contengan ese atributo.
-## Búsqueda de atributos
+## Búsqueda de atributos {#attributes-search}
Para buscar en un atributo específico, añade `@` para especificar que estás buscando en un atributo.
-Por ejemplo, si el nombre de tu atributo es **url** y quieres filtrar por el valor **url** `www.datadoghq.com`, introduce:
+Por ejemplo, si el nombre de tu atributo es **url** y deseas filtrar por el valor de **url** `www.datadoghq.com`, ingresa:
```
@url:www.datadoghq.com
```
+### Atributos reservados {#reserved-attributes}
+
+[Atributos reservados][8] como `host`, `source`, `status`, `service`, `trace_id` y `message` no requieren el prefijo `@`. Puedes buscar estos atributos directamente:
+
+```
+service:web-app
+status:error
+host:i-1234567890abcdef0
+```
**Notas**:
-1. **No** es necesario definir una faceta para buscar en los atributos y etiquetas (tags).
+1. No es **necesario** definir una faceta para buscar en atributos y etiquetas.
-2. Las búsquedas por atributos distinguen entre mayúsculas y minúsculas. Utiliza [búsqueda de texto completo](#full-text-search) para obtener resultados que no distingan entre mayúsculas y minúsculas. Otra opción es utilizar el filtro `lowercase` con tu Analizador Grok mientras haces un análisis para obtener resultados que no distingan entre mayúsculas y minúsculas durante la búsqueda.
+2. Las búsquedas de atributos son sensibles a mayúsculas y minúsculas. Usa [búsqueda de texto completo](#full-text-search) para obtener resultados que no distingan entre mayúsculas y minúsculas. Otra opción es usar el `lowercase` filtro con tu Grok Parser mientras realizas el parseo para obtener resultados que no distingan entre mayúsculas y minúsculas durante la búsqueda.
-3. La búsqueda de un valor de atributo que contenga caracteres especiales requiere un carácter de escape o comillas dobles.
- - Por ejemplo, para un atributo `my_attribute` con el valor `hello:world`, busca utilizando: `@my_attribute:hello\:world` o `@my_attribute:"hello:world"`.
- - Para buscar una coincidencia con un único carácter especial o espacio, utiliza el comodín `?`. Por ejemplo, para un atributo `my_attribute` con los valores `hello world`, realiza la búsqueda utilizando: `@my_attribute:hello?world`.
+3. Buscar un valor de atributo que contenga caracteres especiales requiere escapar o usar comillas dobles.
+ - Por ejemplo, para un atributo `my_attribute` con el valor `hello:world`, busca usando: `@my_attribute:hello\:world` o `@my_attribute:"hello:world"`.
+ - Para coincidir con un solo carácter especial o espacio, usa el `?` Wildcard. Por ejemplo, para un atributo `my_attribute` con el valor `hello world`, busca usando: `@my_attribute:hello?world`.
Ejemplos:
-| Consulta de búsqueda | Descripción |
+| Consulta de búsqueda | Descripción |
|----------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `@http.url_details.path:"/api/v1/test"` | Busca todos los logs que coincidan con `/api/v1/test` en el atributo `http.url_details.path`. |
-| `@http.url:/api\-v1/*` | Busca todos los logs que contengan un valor en el atributo `http.url` que empiece por `/api-v1/` |
-| `@http.status_code:[200 TO 299] @http.url_details.path:/api\-v1/*` | Busca todos los logs que contengan un valor `http.status_code` entre 200 y 299, y que contengan un valor en el atributo `http.url_details.path` que empiece por `/api-v1/` |
-| `-@http.status_code:*` | Busca todos los logs que no contengan el atributo `http.status_code` |
+| `@http.url_details.path:"/api/v1/test"` | Busca todos los registros que coincidan con `/api/v1/test` en el atributo `http.url_details.path`. |
+| `@http.url:/api\-v1/*` | Busca todos los registros que contengan un valor en el atributo `http.url` que comience con `/api-v1/` |.
+| `@http.status_code:[200 TO 299] @http.url_details.path:/api\-v1/*` | Busca todos los registros que contengan un valor `http.status_code` entre 200 y 299, y que contengan un valor en el atributo `http.url_details.path` que comience con `/api-v1/` |.
+| `-@http.status_code:*` | Busca todos los registros que no contengan el atributo `http.status_code` |.
-### Buscar utilizando la notación CIDR
-Classless Inter Domain Routing (CIDR) es una notación que permite a los usuarios definir un rango de direcciones IP (también llamadas bloques de CIDR) de forma sucinta. CIDR se utiliza normalmente para definir una red (como una VPC) o una subred (como una subred pública/privada dentro de una VPC).
+### Busca utilizando la notación CIDR {#search-using-cidr-notation}.
+El Enrutamiento Inter-Dominio Sin Clase (CIDR) es una notación que permite a los usuarios definir un rango de direcciones IP (también llamadas bloques CIDR) de manera concisa. CIDR se utiliza comúnmente para definir una red (como una VPC) o una subred (como una subred pública/privada dentro de una VPC).
-Los usuarios pueden utilizar la función `CIDR()` para consultar atributos en logs utilizando la notación CIDR. La función `CIDR()` necesita que se le pase un atributo de log como parámetro por el que filtrar, seguido de uno o varios bloques de CIDR.
+Los usuarios pueden utilizar la función `CIDR()` para consultar atributos en registros utilizando la notación CIDR. La función `CIDR()` necesita recibir un atributo de registro como parámetro para filtrar, seguido de uno o múltiples bloques CIDR.
-#### Ejemplos
-- `CIDR(@network.client.ip,13.0.0.0/8)` coincide y filtra logs que tengan direcciones IP en el campo `network.client.ip` que caen bajo el bloque de CIDR 13.0.0.0/8.
-- `CIDR(@network.ip.list,13.0.0.0/8, 15.0.0.0/8)` coincide y filtra logs que tengan cualquier dirección IP en un atributo matriz `network.ip.list` que pertenezca a los bloques de CIDR 13.0.0.0/8 o 15.0.0.0/8.
-- `source:pan.firewall evt.name:reject CIDR(@network.client.ip, 13.0.0.0/8)` coincidiría y filtraría eventos de rechazo desde el firewall de palo alto que se originan en la subred 13.0.0.0/8
-- `source:vpc NOT(CIDR(@network.client.ip, 13.0.0.0/8)) CIDR(@network.destination.ip, 15.0.0.0/8)` mostrará todos los logs de VPC que no se originan en la subred 13.0.0.0/8, pero que están designados para la subred de destino 15.0.0.0/8 porque deseas analizar el tráfico de red en tus entornos entre subredes.
+#### Ejemplos {#examples}
+- `CIDR(@network.client.ip,13.0.0.0/8)` coincide y filtra registros que tienen direcciones IP en el campo `network.client.ip` que caen bajo el bloque CIDR 13.0.0.0/8.
+- `CIDR(@network.ip.list,13.0.0.0/8, 15.0.0.0/8)` Coincide y filtra registros que tienen cualquier dirección IP en un atributo de arreglo `network.ip.list` que caen bajo los bloques CIDR 13.0.0.0/8 o 15.0.0.0/8.
+- `source:pan.firewall evt.name:reject CIDR(@network.client.ip, 13.0.0.0/8)` Coincidiría y filtraría eventos de rechazo del firewall Palo Alto que se originan en la subred 13.0.0.0/8.
+- `source:vpc NOT(CIDR(@network.client.ip, 13.0.0.0/8)) CIDR(@network.destination.ip, 15.0.0.0/8)` mostrará todos los registros de VPC que no se originan en la subred 13.0.0.0/8 pero están designados para la subred de destino 15.0.0.0/8 porque quieres analizar el tráfico de red en tus entornos entre subredes.
-La función `CIDR()` es compatible con las notaciones CIDR de IPv4 e IPv6 y funciona en Log Explorer, Live Tail, widgets de log en dashboards, monitores de log y configuraciones de log.
+La función `CIDR()` admite tanto las notaciones CIDR de IPv4 como de IPv6 y funciona en Log Explorer, Live Tail, widgets de registro en Dashboards, monitores de registro y configuraciones de registro.
-## Comodines
+## Wildcards {#wildcards}
-Puedes utilizar comodines con la búsqueda de texto libre. Sin embargo, solo busca términos en el mensaje de log, el texto de la columna `content` en Log Explorer. Consulta [búsqueda de texto completo](#full-text-search) si deseas buscar un valor en un atributo de log.
+Puedes utilizar Wildcards con búsqueda de texto libre. Sin embargo, solo busca términos en el mensaje del registro, el texto en la columna `content` en Log Explorer. Consulta [Búsqueda de texto completo](#full-text-search) si deseas buscar un valor en un atributo de registro.
-### Comodín de varios caracteres
+### Wildcard de múltiples caracteres {#multi-character-wildcard}
-Para realizar una búsqueda de comodín de varios caracteres en el mensaje de log (la columna `content` en Log Explorer), utiliza el símbolo `*` como se indica a continuación:
+Para realizar una búsqueda con Wildcard de múltiples caracteres en el mensaje del registro (la columna `content` en Log Explorer), utiliza el símbolo `*` de la siguiente manera:
-* `service:web*` coincide con cada mensaje de log que tenga un servicio que empiece con `web`.
-* `web*` coincide con todos los mensajes de log que empiecen con `web`.
-* `*web` coincide con todos los mensajes de log que terminan con `web`.
+* `service:web*` coincide con cada mensaje de registro que tiene un servicio que comienza con `web`.
+* `web*` coincide con todos los mensajes de registro que comienzan con `web`.
+* `*web` coincide con todos los mensajes de registro que terminan con `web`.
-**Nota**: Los comodines solo funcionan fuera de las comillas dobles. Por ejemplo, `"*test*"` coincide con un log que tenga la cadena `*test*` en su mensaje. `*test*` coincide con un log que tenga el test de cadena en cualquier parte de su mensaje.
+**Nota**: Los wildcards solo funcionan como wildcards fuera de comillas dobles. Por ejemplo, `"*test*"` coincide con un registro que tiene la cadena `*test*` en su mensaje. `*test*` coincide con un registro que tiene la cadena test en cualquier parte de su mensaje.
-Las búsquedas con comodines funcionan dentro de etiquetas y atributos (con o sin facetas) con esta sintaxis. Esta consulta devuelve todos los servicios que terminan con la cadena `mongo`:
+Las búsquedas con Wildcard funcionan dentro de etiquetas y atributos (con o sin facetas) con esta sintaxis. Esta consulta devuelve todos los servicios que terminan con la cadena `mongo`:
@@ -147,73 +157,86 @@ Las búsquedas con comodines funcionan dentro de etiquetas y atributos (con o si
service:*mongo
```
-Las búsquedas con comodines también pueden utilizarse para buscar en el texto sin formato de un log que no forme parte de un atributo de log. Por ejemplo, esta consulta devuelve todos los logs con contenido (mensaje) que contengan la cadena `NETWORK`:
+Las búsquedas con Wildcard también se pueden usar para buscar en el texto plano de un registro que no es parte de un atributo de registro. Por ejemplo, esta consulta devuelve todos los registros con contenido (mensaje) que contienen la cadena `NETWORK`:
```
*NETWORK*
```
-Sin embargo, este término de búsqueda no devuelve logs que contengan la cadena `NETWORK` si se encuentra en un atributo de log y no forma parte del mensaje de log.
+Sin embargo, este término de búsqueda no devuelve registros que contengan la cadena `NETWORK` si está en un atributo de registro y no es parte del mensaje del registro.
-### Buscar comodín
+### Buscar wildcard {#search-wildcard}
-Cuando busques un valor de atributo o etiqueta que contenga caracteres especiales o requiera caracteres de escape o comillas dobles, utiliza el comodín `?` para que coincida con un único carácter especial o espacio. Por ejemplo, para buscar un atributo `my_attribute` con el valor `hello world`: `@my_attribute:hello?world`.
+Al buscar un valor de atributo o etiqueta que contenga caracteres especiales o que requiera escape o comillas dobles, utiliza el wildcard `?` para coincidir con un solo carácter especial o espacio. Por ejemplo, para buscar un atributo `my_attribute` con el valor `hello world`: `@my_attribute:hello?world`.
-## Valores numéricos
+## Valores numéricos {#numerical-values}
-Para buscar en un atributo numérico, primero [añádelo como faceta][2]. A continuación, puedes utilizar operadores numéricos (`<`,`>`, `<=` o `>=`) para realizar una búsqueda sobre facetas numéricas.
-Por ejemplo, recupera todos los logs que tengan un tiempo de respuesta superior a 100ms con:
+Para buscar en un atributo numérico, primero agrégalo como faceta. Luego puedes usar operadores numéricos (`<`, `>`, `<=` o `>=`) para realizar una búsqueda en las facetas numéricas.
+Por ejemplo, recupera todos los registros que tienen un tiempo de respuesta superior a 100 ms con:
```
@http.response_time:>100
```
-Puedes buscar atributos numéricos dentro de un rango específico. Por ejemplo, recupera todos tus errores 4xx con:
+Puedes buscar un atributo numérico dentro de un rango específico. Por ejemplo, recupera todos tus errores 4xx con:
```
@http.status_code:[400 TO 499]
```
-## Etiquetas
+## Etiquetas {#tags}
-Tus logs heredan las etiquetas de los [hosts][3] y las [integraciones][4] que las generan. Pueden utilizarse para buscar y también como facetas:
+Tus registros heredan etiquetas de [hosts][3] y [integrations][4] que las generan. Pueden ser utilizadas en la búsqueda y también como facetas:
* `test` está buscando la cadena "test".
-* `env:(prod OR test)` coincide con todos los logs con la etiqueta `env:prod` o la etiqueta `env:test`
-* `(env:prod AND -version:beta)` coincide con todos los logs que contengan la etiqueta `env:prod` y que no contengan la etiqueta `version:beta`
+* `env:(prod OR test)` coincide con todos los registros con la etiqueta `env:prod` o la etiqueta `env:test`
+* `(env:prod AND -version:beta)` coincide con todos los registros que contienen la etiqueta `env:prod` y que no contienen la etiqueta `version:beta`
-Si tus etiquetas no siguen las [prácticas recomendadas de etiqueta][5] y no utilizan la sintaxis `key:value`, utiliza esta consulta de búsqueda:
+Si tus etiquetas no siguen [las mejores prácticas de etiquetas][5] y no utilizan la sintaxis `key:value`, usa esta consulta de búsqueda:
* `tags:`
-## Matrices
+## Arreglos {#arrays}
-En el ejemplo siguiente, al hacer clic en el valor `Peter` de la faceta, se devuelven todos los logs que contiene un atributo `users.names`, cuyo valor es `Peter` o una matriz que contiene `Peter`:
+En el siguiente ejemplo, al hacer clic en el valor `Peter` en la faceta, se devuelven todos los registros que contienen un atributo `users.names`, cuyo valor es `Peter` o un arreglo que contiene `Peter`:
-{{< img src="logs/explorer/search/array_search.png" alt="Matriz y facetas" style="width:80%;">}}
+{{< img src="logs/explorer/search/array_search.png" alt="Arreglo y facetas" style="width:80%;">}}
-**Nota**: Buscar también puede utilizarse en atributos de matriz sin facetas utilizando una sintaxis equivalente.
+**Nota**: La búsqueda también se puede utilizar en atributos de arreglo sin faceta, utilizando una sintaxis equivalente.
-En el siguiente ejemplo, los logs de CloudWatch para Windows contienen una matriz de objetos JSON bajo `@Event.EventData.Data`. No se puede crear una faceta sobre una matriz de objetos JSON, pero se puede buscar utilizando la siguiente sintaxis.
+En el siguiente ejemplo, los registros de CloudWatch para Windows contienen un arreglo de objetos JSON bajo `@Event.EventData.Data`. No puedes crear una faceta en un arreglo de objetos JSON, pero puedes buscar utilizando la siguiente sintaxis.
-* `@Event.EventData.Data.Name:ObjectServer` coincide con todos los logs con la clave `Name` y el valor `ObjectServer`.
+* `@Event.EventData.Data.Name:ObjectServer` coincide con todos los registros que tienen la clave `Name` y el valor `ObjectServer`.
-{{< img src="logs/explorer/search/facetless_query_json_arrray2.png" alt="Consulta sin facetas en una matriz de objetos JSON" style="width:80%;">}}
-
+{{< img src="logs/explorer/search/facetless_query_json_arrray2.png" alt="Consulta sin facet en un arreglo de objetos JSON" style="width:80%;">}}
+
+### Búsqueda de arreglo anidado {#nested-array-search}
+
+Para buscar un campo anidado en un atributo de arreglo, utiliza el prefijo `@` con la ruta completa del atributo. El Explorador de registros coincide con cualquier elemento en el arreglo:
+
+* `@network.ip.attributes.ip:2a02\:1810*` coincide con todos los registros donde al menos un elemento en el arreglo `network.ip.attributes` tiene un campo `ip` que comienza con `2a02:1810`.
+
+Para coincidir con registros donde un arreglo contiene múltiples valores específicos, lista los valores entre paréntesis:
+
+* `@user_perms:(4 6)` coincide con todos los registros donde el arreglo `user_perms` contiene tanto `4` como `6`.
+
+Para coincidir con registros donde un arreglo contiene cualquier valor dentro de un rango, utiliza una consulta de rango:
+
+* `@user_perms:[2 TO 6]` coincide con todos los registros donde el arreglo `user_perms` contiene al menos un valor entre `2` y `6`.
-## Campos calculados
+## Campos calculados {#calculated-fields}
-Los campos calculados función como atributos de log y pueden utilizarse para la búsqueda, agregación, visualización y definición de otros campos calculados. Utiliza el prefijo `#` cuando hagas referencia a nombres de campos calculados.
+Los campos calculados funcionan como atributos de registro y pueden ser utilizados para búsqueda, agregación, visualización y definición de otros campos calculados. Utiliza el prefijo `#` para referenciar los nombres de los campos calculados.
-{{< img src="logs/explorer/calculated_fields/calculated_field.png" alt="Un campo calculado llamado request_duration que se utiliza para filtrar resultados en el Log Explorer" style="width:100%;" >}}
+{{< img src="logs/explorer/calculated_fields/calculated_field.png" alt="Un campo calculado llamado request_duration utilizado para filtrar resultados en el Explorador de registros" style="width:100%;" >}}
-## Búsquedas guardadas
+## Búsquedas guardadas {#saved-searches}
-Las [Vistas guardadas][6] contienen tu consulta de búsqueda, columnas, horizonte temporal y faceta.
+[Saved Views][6] contienen tu consulta de búsqueda, columnas, horizonte temporal y faceta.
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -223,4 +246,5 @@ Las [Vistas guardadas][6] contienen tu consulta de búsqueda, columnas, horizont
[4]: /es/integrations/#cat-log-collection
[5]: /es/getting_started/tagging/#tags-best-practices
[6]: /es/logs/explorer/saved_views/
-[7]: /es/logs/explorer/facets/#facet-panel
\ No newline at end of file
+[7]: /es/logs/explorer/facets/#facet-panel
+[8]: /es/logs/log_configuration/attributes_naming_convention/#reserved-attributes
\ No newline at end of file
diff --git a/content/es/logs/log_collection/_index.md b/content/es/logs/log_collection/_index.md
index 58f04817bd3..0a07860221d 100644
--- a/content/es/logs/log_collection/_index.md
+++ b/content/es/logs/log_collection/_index.md
@@ -11,7 +11,7 @@ aliases:
- /es/logs/faq/how-to-send-logs-to-datadog-via-external-log-shippers
- /es/logs/languages
- /es/integrations/windows_event_log/
-description: Configura tu entorno para recopilar registros de tu host, contenedores
+description: Configura tu entorno para recopilar registros de tu servidor, contenedores
y servicios.
further_reading:
- link: https://www.datadoghq.com/blog/log-file-control-with-logrotate/
@@ -25,34 +25,40 @@ further_reading:
text: Descubre cómo procesar tus registros
- link: /logs/log_configuration/parsing
tag: Documentación
- text: Aprende más sobre el análisis
+ text: Aprende más sobre el parseo.
- link: /logs/live_tail/
tag: Documentación
- text: Funcionalidad de cola en vivo de Datadog
+ text: Funcionalidad de seguimiento de las últimas líneas en vivo de Datadog.
- link: /logs/explorer/
tag: Documentación
text: Ve cómo explorar tus registros
- link: /logs/logging_without_limits/
tag: Documentación
text: Registro Sin Límites*
+- link: https://learn.datadoghq.com/courses/advanced-log-configuration
+ tag: Centro de Aprendizaje
+ text: Configuración Avanzada de Registros
+- link: https://learn.datadoghq.com/courses/log-config-docker
+ tag: Centro de Aprendizaje
+ text: Configura la recopilación de registros para una aplicación en contenedor.
title: Recopilación de Registros e Integraciones
---
## Resumen {#overview}
Elige una opción de configuración a continuación para comenzar a ingerir tus registros. Si ya estás utilizando un demonio de envío de registros, consulta la documentación dedicada para [Rsyslog][1], [Syslog-ng][2], [NXlog][3], [FluentD][4] o [Logstash][5].
-Consulta la [lista de puntos finales de recopilación de registros de Datadog disponibles](#logging-endpoints) si deseas enviar tus registros directamente a Datadog.
+Consulta la [lista de puntos de conexión de recopilación de registros de Datadog disponibles](#logging-endpoints) si deseas enviar tus registros directamente a Datadog.
-**Nota**: Al enviar registros en formato JSON a Datadog, hay un conjunto de atributos reservados que tienen un significado específico dentro de Datadog. Consulta la sección de [Atributos Reservados](#attributes-and-tags) para aprender más.
+**Nota**: Al enviar registros en formato JSON a Datadog, hay un conjunto de atributos reservados que tienen un significado específico dentro de Datadog. Consulta la [sección de Atributos Reservados](#attributes-and-tags) para aprender más.
## Configuración {#setup}
{{< tabs >}}
-{{% tab "Host" %}}
+{{% tab "Servidor" %}}
-1. Instala el [Agente de Datadog][1].
-2. Para habilitar la recolección de registros, cambie `logs_enabled: false` a `logs_enabled: true` en el archivo de configuración principal de su Agente (`datadog.yaml`). Consulte la [documentación de recolección de registros del Agente Host][5] para obtener más información y ejemplos.
-3. Una vez habilitado, el Agente de Datadog puede configurarse para [seguir archivos de registro o escuchar registros enviados a través de UDP/TCP][2], [filtrar registros o eliminar datos sensibles][3], y [agregar registros de varias líneas][4].
+1. Instale el [Agente de Datadog][1].
+2. Para habilitar la recolección de registros, cambie `logs_enabled: false` a `logs_enabled: true` en el archivo de configuración principal de su Agente (`datadog.yaml`). Consulte la [documentación de recolección de registros del Agente de servidor][5] para más información y ejemplos.
+3. Una vez habilitado, el Agente de Datadog puede configurarse para [realizar el seguimiento de las últimas líneas de los archivos de registro o escuchar los registros enviados por UDP/TCP][2], [filtrar registros o eliminar datos sensibles][3], y [agrupar registros de varias líneas][4].
[1]: https://app.datadoghq.com/account/settings/agent/latest
[2]: /es/agent/logs/#custom-log-collection
@@ -63,8 +69,8 @@ Consulta la [lista de puntos finales de recopilación de registros de Datadog di
{{% tab "Aplicación" %}}
-1. Instala el [Agente de Datadog][1].
-2. Para habilitar la recolección de registros, cambie `logs_enabled: false` a `logs_enabled: true` en el archivo de configuración principal de su Agente (`datadog.yaml`). Consulte la [documentación de recolección de registros del Agente Host][2] para obtener más información y ejemplos.
+1. Instale el [Agente de Datadog][1].
+2. Para habilitar la recolección de registros, cambie `logs_enabled: false` a `logs_enabled: true` en el archivo de configuración principal de su Agente (`datadog.yaml`). Consulte la [documentación de recolección de registros del Agente de servidor][2] para más información y ejemplos.
3. Siga las instrucciones de instalación de su lenguaje de aplicación para configurar un registrador y comenzar a generar registros:
{{< partial name="logs/logs-languages.html" >}}
@@ -75,19 +81,19 @@ Consulta la [lista de puntos finales de recopilación de registros de Datadog di
{{% tab "Contenedor" %}}
-Elija un proveedor de contenedor u orquestador y siga sus instrucciones dedicadas de recolección de registros:
+Elija un proveedor de contenedores u orquestador y siga sus instrucciones dedicadas de recolección de registros:
{{< partial name="logs/logs-containers.html" >}}
**Notas**:
-- El Agente de Datadog puede [recolectar registros directamente desde stdout/stderr del contenedor][1] sin usar un controlador de registro. Cuando se habilita la verificación de Docker del Agente, los metadatos del contenedor y del orquestador se agregan automáticamente como etiquetas a sus registros.
+- El Agente de Datadog puede [recoger registros directamente desde stdout/stderr del contenedor][1] sin usar un controlador de registros. Cuando se habilita la verificación de Docker del Agente, los metadatos del contenedor y del orquestador se añaden automáticamente como etiquetas a tus registros.
-- Es posible recolectar registros de todos sus contenedores o [solo un subconjunto filtrado por imagen de contenedor, etiqueta o nombre][2].
+- Es posible recoger registros de todos tus contenedores o [solo un subconjunto filtrado por imagen de contenedor, etiqueta o nombre][2].
-- La autodetección también se puede utilizar para [configurar la recolección de registros directamente en las etiquetas del contenedor][3].
+- Autodiscovery también se puede usar para [configurar la recopilación de registros directamente en las etiquetas del contenedor][3].
-- En entornos de Kubernetes, también puedes aprovechar [la instalación del daemonset][4].
+- En entornos de Kubernetes, también puedes aprovechar [la instalación de daemonset][4].
[1]: /es/agent/docker/log/
[2]: /es/agent/guide/autodiscovery-management/
@@ -95,7 +101,7 @@ Elija un proveedor de contenedor u orquestador y siga sus instrucciones dedicada
[4]: /es/agent/basic_agent_usage/kubernetes/#log-collection-setup
{{% /tab %}}
-{{% tab "Sin servidor" %}}
+{{% tab "Serverless" %}}
Utiliza el Datadog Forwarder, una función de AWS Lambda que envía registros desde tu entorno a Datadog. Para habilitar la recolección de registros en tu entorno sin servidor de AWS, consulta la [documentación del Datadog Forwarder][1].
@@ -104,20 +110,20 @@ Utiliza el Datadog Forwarder, una función de AWS Lambda que envía registros de
{{% tab "Nube/Integración" %}}
-Selecciona tu proveedor de nube a continuación para ver cómo recolectar automáticamente tus registros y enviarlos a Datadog:
+Selecciona tu proveedor de Nube a continuación para ver cómo recoger automáticamente tus registros y enviarlos a Datadog:
{{< partial name="logs/logs-cloud.html" >}}
-Las integraciones de Datadog y la recolección de registros están vinculadas. Puedes usar el archivo de configuración predeterminado de una integración para habilitar [procesadores][1], [análisis][2] y [facetas][3] en Datadog. Para comenzar la recolección de registros con una integración:
+Las integraciones de Datadog y la recolección de registros están vinculadas. Puedes usar el archivo de configuración predeterminado de una integración para habilitar [procesadores][1], [parseo][2] y [facetas][3] en Datadog. Para comenzar la recolección de registros con una integración:
1. Selecciona una integración de la [página de Integraciones][6] y sigue las instrucciones de configuración.
2. Sigue las instrucciones de recolección de registros de la integración. Esta sección cubre cómo descomentar la sección de registros en el archivo `conf.yaml` de esa integración y configurarlo para tu entorno.
## Reduce las tarifas de transferencia de datos {#reduce-data-transfer-fees}
-Utiliza [Cloud Network Monitoring][7] de Datadog para identificar las aplicaciones de mayor rendimiento de tu organización. Conéctate a Datadog a través de conexiones privadas soportadas y envía datos a través de una red privada para evitar el internet público y reducir tus tarifas de transferencia de datos. Después de cambiar a enlaces privados, utiliza las herramientas de [Cloud Cost Management][8] de Datadog para verificar el impacto y monitorear la reducción en tus costos en la nube.
+Utiliza [Cloud Network Monitoring][7] para identificar las aplicaciones de mayor ancho de banda de tu organización. Conéctate a Datadog a través de conexiones privadas admitidas y envía datos a través de una red privada para evitar el internet público y reducir tus tarifas de transferencia de datos. Después de cambiar a enlaces privados, utiliza las herramientas de [Cloud Cost Management][8] de Datadog para verificar el impacto y monitorear la reducción en tus costos en la nube.
-Para más información, consulta [Cómo enviar registros a Datadog mientras reduces las tarifas de transferencia de datos][9].
+Para más información, consulte [Cómo enviar registros a Datadog mientras reduce las tarifas de transferencia de datos][9].
[1]: /es/logs/log_configuration/processors
[2]: /es/logs/log_configuration/parsing
@@ -132,11 +138,11 @@ Para más información, consulta [Cómo enviar registros a Datadog mientras redu
{{% /tab %}}
-{{% tab "Verificación de Agente" %}}
+{{% tab "Verificación del Agente" %}}
-Si está desarrollando una integración personalizada de Agente, puede enviar registros programáticamente desde su verificación de Agente utilizando el método `send_log`. Esto permite que su integración personalizada emita registros junto con métricas, eventos y verificaciones de servicio.
+Si está desarrollando una integración personalizada del Agente, puede enviar registros programáticamente desde su verificación del Agente utilizando el método `send_log`. Esto permite que su integración personalizada emita registros junto con métricas, eventos y verificaciones de servicio.
-Para aprender cómo enviar registros desde su verificación de Agente personalizada, consulte [Colección de Registros de Integración de Agente][15].
+Para aprender cómo enviar registros desde su verificación personalizada del Agente, consulte [Colección de Registros de Integración del Agente][15].
[15]: /es/logs/log_collection/agent_checks/
{{% /tab %}}
@@ -144,67 +150,67 @@ Para aprender cómo enviar registros desde su verificación de Agente personaliz
## Opciones de configuración adicionales {#additional-configuration-options}
-### Puntos finales de registro {#logging-endpoints}
+### Puntos de conexión para registros {#logging-endpoints}
-Datadog proporciona puntos finales de registro tanto para conexiones cifradas por SSL como para conexiones no cifradas. Utilice el punto final cifrado cuando sea posible. El Agente de Datadog utiliza el punto final cifrado para enviar registros a Datadog. Más información está disponible en la [documentación de seguridad de Datadog][6].
+Datadog proporciona puntos de conexión de registro tanto para conexiones cifradas por SSL como para conexiones no cifradas. Utilice el punto de conexión cifrado cuando sea posible. El Agente de Datadog utiliza el punto de conexión cifrado para enviar registros a Datadog. Más información está disponible en la [documentación de seguridad de Datadog][6].
-#### Puntos finales soportados {#supported-endpoints}
+#### Puntos de conexión soportados {#supported-endpoints}
-Utilice el menú desplegable de selector [sitio][13] en el lado derecho de la página para ver los puntos finales soportados por el sitio de Datadog.
+Utilice el menú desplegable del selector de [sitio][13] en el lado derecho de la página para ver los puntos de conexión soportados por el sitio de Datadog.
-| Sitio | Tipo | Punto final | Puerto | Descripción |
+| Sitio | Tipo | Punto de conexión | Puerto | Descripción |
|------|-------|----------|------|-------------|
-| {{< region-param key=dd_datacenter >}} | HTTPS | {{< region-param key=http_endpoint >}} | 443 | Utilizado por el reenvío personalizado para enviar registros en formato JSON o texto plano a través de HTTPS. Consulte la [documentación de la API HTTP de Registros][16]. |
-| {{< region-param key=dd_datacenter >}} | HTTPS | {{< region-param key=agent_http_endpoint >}} | 443 | Utilizado por el Agente para enviar registros en formato JSON a través de HTTPS. Consulte la [documentación de colección de Registros del Agente Host][17]. |
-| {{< region-param key=dd_datacenter >}} | HTTPS | {{< region-param key=lambda_http_endpoint >}} | 443 | Utilizado por funciones Lambda para enviar registros en formato crudo, Syslog o JSON a través de HTTPS. |
-| {{< region-param key=dd_datacenter >}} | HTTPS | logs.{{< region-param key=browser_sdk_endpoint_domain >}} | 443 | Utilizado por el SDK del navegador para enviar registros en formato JSON a través de HTTPS. |
+| {{< region-param key=dd_datacenter >}} | HTTPS | {{< region-param key=http_endpoint >}} | 443 | Utilizado por el reenvío personalizado para enviar registros en formato JSON o texto plano a través de HTTPS. Consulte la [documentación de la API HTTP de registros][16]. |
+| {{< region-param key=dd_datacenter >}} | HTTPS | {{< region-param key=agent_http_endpoint >}} | 443 | Utilizado por el Agente para enviar registros en formato JSON a través de HTTPS. Consulte la [documentación de recopilación de registros del Agente de servidor][17]. |
+| {{< region-param key=dd_datacenter >}} | HTTPS | {{< region-param key=lambda_http_endpoint >}} | 443 | Utilizado por funciones Lambda para enviar registros en formato sin procesar, Syslog o JSON a través de HTTPS. |
+| {{< region-param key=dd_datacenter >}} | HTTPS | registros.{{< region-param key=browser_sdk_endpoint_domain >}} | 443 | Utilizado por el SDK de navegador para enviar registros en formato JSON a través de HTTPS. |
### Reenvío de registros personalizado {#custom-log-forwarding}
-Cualquier proceso personalizado o biblioteca de registro capaz de reenviar registros a través de **HTTP** puede ser utilizado junto con Datadog Logs.
+Cualquier proceso personalizado o biblioteca de registro capaz de reenviar registros a través de **HTTP** puede ser utilizado junto con los registros de Datadog.
-Puedes enviar registros a la plataforma Datadog a través de HTTP. Consulta la [documentación de la API HTTP de Datadog Logs][15] para comenzar.
+Puede enviar registros a la plataforma de Datadog a través de HTTP. Consulte la [documentación de la API HTTP de registros de Datadog][15] para comenzar.
**Notas**:
-* La API HTTPS admite registros de tamaños de hasta 1MB. Sin embargo, para un rendimiento óptimo, se recomienda que un registro individual no sea mayor a 25K bytes. Si utilizas el Agente de Datadog para el registro, está configurado para dividir un registro a 900kB (900000 bytes).
+* La API HTTPS admite registros de tamaños de hasta 1 MB. Sin embargo, para un rendimiento óptimo, se recomienda que un registro individual no sea mayor a 25 K bytes. Si utiliza el Datadog Agent para el registro, está configurado para dividir un registro a 900 kB (900000 bytes).
* Un evento de registro no debe tener más de 100 etiquetas, y cada etiqueta no debe exceder 256 caracteres para un máximo de 10 millones de etiquetas únicas por día.
-* Un evento de registro convertido a formato JSON debe contener menos de 256 atributos. Cada una de las claves de esos atributos debe tener menos de 50 caracteres, anidados en menos de 20 niveles sucesivos, y su respectivo valor debe ser menor a 1024 caracteres si se promueve como un facet.
+* Un evento de registro convertido a formato JSON debe contener menos de 256 atributos. Cada una de las claves de esos atributos debe tener menos de 50 caracteres, estar anidada en menos de 20 niveles sucesivos, y su respectivo valor debe ser menor a 1024 caracteres si se promueve como faceta.
* Los eventos de registro pueden ser enviados con un [timestamp][14] que esté hasta 18 horas en el pasado.
-Vista previa disponible: Puedes enviar registros de los últimos 7 días, en lugar del límite actual de 18 horas. Regístrate para la Vista previa.
+Vista previa disponible: Puede enviar registros de los últimos 7 días, en lugar del límite actual de 18 horas. Regístrese para la Vista previa.
Los eventos de registro que no cumplan con estos límites pueden ser transformados o truncados por el sistema o no indexados si están fuera del rango de tiempo proporcionado. Sin embargo, Datadog intenta preservar la mayor cantidad de datos de usuario posible.
-Hay una truncación adicional en los campos que se aplica solo a los registros indexados: el valor se trunca a 75 KiB para el campo de mensaje y 25 KiB para los campos no de mensaje. Datadog todavía almacena el texto completo, y sigue siendo visible en las consultas de lista regulares en el Explorador de Registros. Sin embargo, la versión truncada se mostrará al realizar una consulta agrupada, como al agrupar registros por ese campo truncado o realizar operaciones similares que muestren ese campo específico.
+Hay un truncamiento adicional en los campos que se aplica solo a los registros indexados: el valor se trunca a 75 KiB para el campo de mensaje y 25 KiB para los campos que no son de mensaje. Datadog aún almacena el texto completo, y permanece visible en las consultas de lista regulares en el Explorador de Registros. Sin embargo, la versión truncada se mostrará al realizar una consulta agrupada, como cuando se agrupan registros por ese campo truncado o al realizar operaciones similares que muestren ese campo específico.
{{% collapse-content title="TCP" level="h3" expanded=false %}}
{{% logs-tcp-disclaimer %}}
-| Sitio | Tipo | Punto final | Puerto | Descripción |
+| Sitio | Tipo | Punto de conexión | Puerto | Descripción |
|------|-------------|---------------------------------------------------------------------------|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| EE. UU. | TCP | `agent-intake.logs.datadoghq.com` | 10514 | Usado por el Agente para enviar registros sin TLS.
-| EE. UU. | TCP y TLS | `agent-intake.logs.datadoghq.com` | 10516 | Usado por el Agente para enviar registros con TLS.
-| EE. UU. | TCP y TLS | `intake.logs.datadoghq.com` | 443 | Usado por reenvíos personalizados para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. |
-| EE. UU. | TCP y TLS | `functions-intake.logs.datadoghq.com` | 443 | Usado por funciones de Azure para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. **Nota**: Este punto final puede ser útil con otros proveedores de nube. |
-| EE. UU. | TCP y TLS | `lambda-intake.logs.datadoghq.com` | 443 | Usado por funciones de Lambda para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. |
-| UE | TCP y TLS | `agent-intake.logs.datadoghq.eu` | 443 | Usado por el Agente para enviar registros en formato protobuf a través de una conexión TCP cifrada con SSL. |
-| UE | TCP y TLS | `functions-intake.logs.datadoghq.eu` | 443 | Usado por funciones de Azure para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. **Nota**: Este punto final puede ser útil con otros proveedores de nube. |
-| UE | TCP y TLS | `lambda-intake.logs.datadoghq.eu` | 443 | Usado por funciones de Lambda para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. |
+| EE. UU. | TCP | `agent-intake.logs.datadoghq.com` | 10514 | Usado por el Agent para enviar registros sin TLS.
+| EE. UU. | TCP y TLS | `agent-intake.logs.datadoghq.com` | 10516 | Usado por el Agent para enviar registros con TLS.
+| EE. UU. | TCP y TLS | `intake.logs.datadoghq.com` | 443 | Usado por reenviadores personalizados para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. |
+| EE. UU. | TCP y TLS | `functions-intake.logs.datadoghq.com` | 443 | Usado por funciones de Azure para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. **Nota**: Este punto de conexión puede ser útil con otros proveedores de nube. |
+| EE. UU. | TCP y TLS | `lambda-intake.logs.datadoghq.com` | 443 | Usado por funciones Lambda para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. |
+| UE | TCP y TLS | `agent-intake.logs.datadoghq.eu` | 443 | Usado por el Agent para enviar registros en formato protobuf a través de una conexión TCP cifrada con SSL. |
+| UE | TCP y TLS | `functions-intake.logs.datadoghq.eu` | 443 | Usado por las funciones de Azure para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. **Nota**: Este punto de conexión puede ser útil con otros proveedores de nube. |
+| UE | TCP y TLS | `lambda-intake.logs.datadoghq.eu` | 443 | Usado por las funciones de Lambda para enviar registros en formato sin procesar, Syslog o JSON a través de una conexión TCP cifrada con SSL. |
{{% /collapse-content %}}
### Atributos y etiquetas {#attributes-and-tags}
-Los atributos prescriben [facetas de registros][9], que se utilizan para filtrar y buscar en el Explorador de Registros. Consulte la documentación dedicada de [atributos y alias][10] para obtener una lista de atributos reservados y estándar, y para aprender cómo soportar una convención de nombres con atributos de registros y alias.
+Los atributos prescriben [facetas de registros][9], que se utilizan para filtrar y buscar en el Explorador de Registros. Consulte la documentación dedicada de [atributos y alias][10] para obtener una lista de atributos reservados y atributos estándar y para aprender cómo soportar una convención de nombres con atributos de registros y alias.
#### Atributos para trazas de pila {#attributes-for-stack-traces}
-Al registrar trazas de pila, hay atributos específicos que tienen una visualización de interfaz de usuario dedicada dentro de su aplicación de Datadog, como el nombre del registrador, el hilo actual, el tipo de error y la traza de pila en sí.
+Al registrar trazas de pila, hay atributos específicos que tienen una visualización de interfaz de usuario dedicada dentro de su aplicación Datadog, como el nombre del registrador, el hilo actual, el tipo de error y la traza de pila en sí.
{{< img src="logs/log_collection/stack_trace.png" style="width:80%;" alt="Atributos para una traza de pila analizada" >}}
@@ -218,13 +224,13 @@ Para habilitar estas funcionalidades, utilice los siguientes nombres de atributo
| `error.message` | Mensaje de error contenido en la traza de pila |
| `error.kind` | El tipo o "clase" de un error (por ejemplo, "Excepción" o "OSError") |
-**Nota**: Por defecto, las tuberías de integración intentan reasignar los parámetros de la biblioteca de registro predeterminada a esos atributos específicos y analizar trazas de pila o traceback para extraer automáticamente el `error.message` y `error.kind`.
+**Nota**: Por defecto, las Pipelines de integración intentan reasignar los parámetros de la biblioteca de registros predeterminada a esos atributos específicos y analizar trazas de pila o traceback para extraer automáticamente el `error.message` y `error.kind`.
-Para más información, consulte la documentación completa de [atributos de código fuente][11].
+Para más información, consulte la documentación completa de [atributos del código fuente][11].
## Próximos pasos {#next-steps}
-Una vez que los registros son recolectados e ingeridos, están disponibles en **Explorador de Registros**. El Explorador de Registros es donde puede buscar, enriquecer y ver alertas sobre sus registros. Consulte la documentación de [Explorador de Registros][12] para comenzar a analizar sus datos de registro, o vea la documentación adicional de gestión de registros a continuación.
+Una vez que se recopilan e ingresan los registros, están disponibles en **Explorador de Registros**. El Explorador de Registros es donde puede buscar, enriquecer y ver alertas sobre sus registros. Consulte la documentación del [Explorador de Registros][12] para comenzar a analizar sus datos de registro, o vea la documentación adicional de gestión de registros a continuación.
{{< img src="logs/explore.png" alt="Registros que aparecen en el Explorador de Registros" style="width:100%" >}}
diff --git a/content/es/logs/log_configuration/parsing.md b/content/es/logs/log_configuration/parsing.md
index 39cc5fff4e7..75333fc528b 100644
--- a/content/es/logs/log_configuration/parsing.md
+++ b/content/es/logs/log_configuration/parsing.md
@@ -13,36 +13,39 @@ aliases:
description: Analiza tus registros utilizando el Procesador Grok
further_reading:
- link: https://learn.datadoghq.com/courses/log-pipelines
- tag: Centro de aprendizaje
- text: Aprende a construir y modificar tuberías de registros
+ tag: Centro de Aprendizaje
+ text: Aprende a construir y modificar canalizaciones de registros
- link: /logs/log_configuration/processors
tag: Documentación
text: Aprende a procesar tus registros
- link: https://www.youtube.com/watch?v=AwW70AUmaaQ&list=PLdh-RwQzDsaM9Sq_fi-yXuzhmE7nOlqLE&index=3
tag: Video
- text: 'Consejos y trucos de Datadog: Usa el análisis Grok para extraer campos de
+ text: 'Consejos y Trucos de Datadog: Usa el análisis Grok para extraer campos de
los registros'
- link: /logs/faq/how-to-investigate-a-log-parsing-issue/
- tag: FAQ
+ tag: PREGUNTAS FRECUENTES
text: ¿Cómo investigar un problema de análisis de registros?
- link: /logs/guide/log-parsing-best-practice/
- tag: FAQ
+ tag: PREGUNTAS FRECUENTES
text: Análisis de Registros - Mejores Prácticas
- link: /logs/logging_without_limits/
tag: Documentación
text: Controla el volumen de registros indexados por Datadog
+- link: https://learn.datadoghq.com/courses/debugging-log-pipelines
+ tag: Centro de Aprendizaje
+ text: Depuración de Canalizaciones de Registros
title: Análisis
---
-{{< learning-center-callout header="Prueba el análisis Grok en el Centro de Aprendizaje" btn_title="Enroll Now" btn_url="https://learn.datadoghq.com/courses/log-pipelines">}}
- Aprende a construir y modificar tuberías de registros, gestionarlas con el Escáner de Tuberías y estandarizar los nombres de atributos en los registros procesados para mantener la consistencia.
+{{< learning-center-callout header="Prueba el análisis Grok en el Centro de Aprendizaje" btn_title="Inscríbete Ahora" btn_url="https://learn.datadoghq.com/courses/log-pipelines">}}
+ Aprende a construir y modificar canalizaciones de registros, gestionarlas con el Escáner de Canalizaciones y estandarizar los nombres de atributos en los registros procesados para mantener la consistencia.
{{< /learning-center-callout >}}
## Resumen {#overview}
Datadog analiza automáticamente los registros en formato JSON. Para otros formatos, Datadog te permite enriquecer tus registros con la ayuda del Analizador Grok.
-La sintaxis Grok proporciona una forma más fácil de analizar registros que las expresiones regulares puras. El Analizador Grok te permite extraer atributos de mensajes de texto semiestructurados.
+La sintaxis Grok proporciona una forma más fácil de analizar registros que las expresiones regulares puras. El Grok Parser te permite extraer atributos de mensajes de texto semiestructurados.
-Grok viene con patrones reutilizables para analizar enteros, direcciones IP, nombres de host, etc. Estos valores deben enviarse al analizador grok como cadenas.
+Grok viene con patrones reutilizables para analizar enteros, direcciones IP, nombres de host, etc. Estos valores deben enviarse al grok parser como cadenas.
Puedes escribir reglas de análisis con la sintaxis `%{MATCHER:EXTRACT:FILTER}`:
@@ -52,7 +55,7 @@ Puedes escribir reglas de análisis con la sintaxis `%{MATCHER:EXTRACT:FILTER}`:
* **Filter** (opcional): Un post-procesador de la coincidencia para transformarla.
-Ejemplo de un registro clásico no estructurado:
+Ejemplo de un registro no estructurado clásico:
```text
john connected on 11/08/2017
@@ -75,64 +78,75 @@ Después de procesar, se genera el siguiente registro estructurado:
**Nota**:
-* Si tienes múltiples reglas de análisis en un solo analizador Grok:
- * Solo una puede coincidir con cualquier registro dado. El primero que coincida, de arriba hacia abajo, es el que realiza el análisis.
+* Si tienes múltiples reglas de análisis en un solo Grok parser:
+ * Solo una puede coincidir con cualquier registro dado. La primera que coincida, de arriba hacia abajo, es la que realiza el análisis.
* Cada regla puede hacer referencia a reglas de análisis definidas por encima de sí misma en la lista.
-* Debes tener nombres de regla únicos dentro del mismo analizador Grok.
+* Debes tener nombres de regla únicos dentro del mismo Grok parser.
* El nombre de la regla debe contener solo: caracteres alfanuméricos, `_`, y `.`. Debe comenzar con un carácter alfanumérico.
* Las propiedades con valores nulos o vacíos no se muestran.
* Debes definir tu regla de análisis para que coincida con toda la entrada del registro, ya que cada regla se aplica desde el principio hasta el final del registro.
-* Ciertos registros pueden producir grandes espacios en blanco. Usa `\n` y `\s+` para tener en cuenta los saltos de línea y los espacios en blanco.
+* Ciertos registros pueden producir grandes espacios en blanco. Utiliza `\n` y `\s+` para tener en cuenta los saltos de línea y los espacios en blanco.
-### Coincidente y filtro {#matcher-and-filter}
+### Coincididor y filtro {#matcher-and-filter}
-
Las características de análisis de Grok disponibles en tiempo de consulta (en el Explorador de Registros) admiten un subconjunto limitado de coincidencias (datos, entero, noEspacio, número y palabra) y filtros (número y entero).
-El siguiente conjunto completo de coincidencias y filtros es específico para la funcionalidad de tiempo de ingestiónGrok Parser.
+
Las características de análisis Grok disponibles en tiempo de consulta (en el Explorador de registros) admiten un subconjunto limitado de coincididores (data, entero, notSpace, número y palabra) y filtros (número y entero).
-Aquí hay una lista de todos los coincidencias y filtros implementados nativamente por Datadog:
+Aquí hay una lista de todos los coincididores y filtros implementados nativamente por Datadog:
{{< tabs >}}
-{{% tab "Coincidentes" %}}
+{{% tab "Coincididores" %}}
-`date("pattern"[, "timezoneId"[, "localeId"]])`
-: Coincide con una fecha con el patrón especificado y analiza para producir una marca de tiempo Unix. [Vea los ejemplos de coincidencia de fecha](#parsing-dates).
+**Coincididores de tiempo de consulta y tiempo de ingestión:**
-`regex("pattern")`
-: Coincide con una expresión regular. [Verifique los ejemplos de coincidencia de regex](#regex).
+Los siguientes coincididores están disponibles tanto para el análisis en tiempo de consulta (Explorador de registros) como para el análisis en tiempo de ingestión (Analizador Grok):
+
+`word`
+: Coincide con una _palabra_, que comienza con un límite de palabra; contiene caracteres de a-z, A-Z, 0-9, incluyendo el `_` (carácter de subrayado); y termina con un límite de palabra. Equivalente a `\b\w+\b` en regex.
`notSpace`
: Coincide con cualquier cadena hasta el siguiente espacio.
+`number`
+Coincide con un número decimal de punto flotante y lo analiza como un número de doble precisión.
+
+`integer`
+Coincide con un número entero y lo analiza como un número entero.
+
+`data`
+Coincide con cualquier cadena, incluyendo espacios y saltos de línea. Equivalente a `.*` en regex. Utilice cuando ninguno de los patrones anteriores sea apropiado.
+
+**Coincididores solo para el tiempo de ingestión:**
+
+Los siguientes coincididores solo están disponibles para el análisis en tiempo de ingestión con el procesador Grok Parser y no pueden ser utilizados en el Explorador de registros:
+
+`date("pattern"[, "timezoneId"[, "localeId"]])`
+Coincide con una fecha con el patrón especificado y la analiza para producir un timestamp Unix. [Vea los ejemplos de Matcher de fecha](#parsing-dates).
+
+`regex("pattern")`
+Coincide con una expresión regular. [Vea los ejemplos de coincididor de regex](#regex).
+
`boolean("truePattern", "falsePattern")`
-: Coincide y analiza un booleano, definiendo opcionalmente los patrones de verdadero y falso (por defecto es `true` y `false`, ignorando mayúsculas y minúsculas).
+Coincide y analiza un Booleano, definiendo opcionalmente los patrones de verdadero y falso (por defecto es `true` y `false`, ignorando mayúsculas y minúsculas).
`numberStr`
-: Coincide con un número de punto flotante decimal y lo analiza como una cadena.
-
-`number`
-: Coincide con un número de punto flotante decimal y lo analiza como un número de doble precisión.
+Coincide con un número decimal de punto flotante y lo analiza como una cadena.
`numberExtStr`
-: Coincide con un número de punto flotante (con soporte para notación científica) y lo analiza como una cadena.
+Coincide con un número de punto flotante (con soporte para notación científica) y lo analiza como una cadena.
`numberExt`
-: Coincide con un número de punto flotante (con soporte para notación científica) y lo analiza como un número de doble precisión.
+Coincide con un número de punto flotante (con soporte para notación científica) y lo analiza como un número de doble precisión.
`integerStr`
: Coincide con un número entero y lo analiza como una cadena.
-`integer`
-: Coincide con un número entero y lo analiza como un número entero.
-
`integerExtStr`
: Coincide con un número entero (con soporte para notación científica) y lo analiza como una cadena.
`integerExt`
: Coincide con un número entero (con soporte para notación científica) y lo analiza como un número entero.
-`word`
-: Coincide con una _palabra_, que comienza con un límite de palabra; contiene caracteres de a-z, A-Z, 0-9, incluyendo el `_` (carácter de subrayado); y termina con un límite de palabra. Equivalente a `\b\w+\b` en regex.
-
`doubleQuotedString`
: Coincide con una cadena entre comillas dobles.
@@ -166,20 +180,25 @@ Aquí hay una lista de todos los coincidencias y filtros implementados nativamen
`port`
: Coincide con un número de puerto.
-`data`
-: Coincide con cualquier cadena, incluyendo espacios y saltos de línea. Equivalente a `.*` en regex. Utilice cuando ninguno de los patrones anteriores sea apropiado.
-
{{% /tab %}}
{{% tab "Filtros" %}}
+**Filtros de tiempo de consulta y de tiempo de ingestión:**
+
+Los siguientes filtros están disponibles tanto para el análisis de tiempo de consulta (Explorador de Registros) como para el análisis de tiempo de ingestión (Procesador Grok):
+
`number`
: Analiza una coincidencia como un número de doble precisión.
`integer`
: Analiza una coincidencia como un número entero.
+**Filtros solo de tiempo de ingestión:**
+
+Los siguientes filtros solo están disponibles para el análisis de tiempo de ingestión con el procesador Grok Parser y no se pueden usar en el Explorador de Registros:
+
`boolean`
-: Analiza las cadenas 'true' y 'false' como booleanos ignorando mayúsculas y minúsculas.
+: Analiza cadenas 'true' y 'false' como booleanos ignorando mayúsculas y minúsculas.
`nullIf("value")`
: Devuelve nulo si la coincidencia es igual al valor proporcionado.
@@ -188,69 +207,69 @@ Aquí hay una lista de todos los coincidencias y filtros implementados nativamen
: Analiza JSON correctamente formateado.
`rubyhash`
-: Analiza un hash de Ruby correctamente formateado como `{name => "John", "job" => {"company" => "Big Company", "title" => "CTO"}}`.
+: Analiza un hash de Ruby correctamente formateado como `{name => "John", "job" => {"company" => "Big Company", "title" => "CTO"}}`
`useragent([decodeuricomponent:true/false])`
-: Analiza un agente de usuario y devuelve un objeto JSON que contiene el dispositivo, el sistema operativo y el navegador representado por el agente. [Consulta el procesador de Agentes de Usuario][1].
+: Analiza un agente de usuario y devuelve un objeto JSON que contiene el dispositivo, el sistema operativo y el navegador representado por el agente. [Consulta el procesador Agent][1].
`querystring`
-: Extrae todos los pares clave-valor en una cadena de consulta de URL coincidente (por ejemplo, `?productId=superproduct&promotionCode=superpromo`).
+Extrae todos los pares clave-valor en una cadena de consulta de URL que coincida (por ejemplo, `?productId=superproduct&promotionCode=superpromo`).
`decodeuricomponent`
-: Decodifica componentes de URI. Por ejemplo, transforma `%2Fservice%2Ftest` en `/service/test`.
+Decodifica componentes de URI. Por ejemplo, transforma `%2Fservice%2Ftest` en `/service/test`.
`lowercase`
-: Devuelve la cadena en minúsculas.
+Devuelve la cadena en minúsculas.
`uppercase`
-: Devuelve la cadena en mayúsculas.
+Devuelve la cadena en mayúsculas.
`keyvalue([separatorStr[, characterAllowList[, quotingStr[, delimiter]]]])`
-: Extrae el patrón de clave-valor y devuelve un objeto JSON. Consulta los [ejemplos de filtro de clave-valor](#key-value-or-logfmt).
+Extrae el patrón de clave-valor y devuelve un objeto JSON. Consulta los [ejemplos de filtro de clave-valor](#key-value-or-logfmt).
`xml`
-: Analiza XML correctamente formateado. Consulta los [ejemplos de filtro XML](#parsing-xml).
+Analiza XML correctamente formateado. Consulta los [ejemplos de filtro XML](#parsing-xml).
`csv(headers[, separator[, quotingcharacter]])`
: Analiza líneas de CSV o TSV correctamente formateadas. Consulta los [ejemplos de filtro CSV](#parsing-csv).
`scale(factor)`
-: Multiplica el valor numérico esperado por el factor proporcionado.
+Multiplica el valor numérico esperado por el factor proporcionado.
`array([[openCloseStr, ] separator][, subRuleOrFilter)`
-: Analiza una secuencia de cadenas de tokens y la devuelve como un arreglo. Consulta el [ejemplo de lista a arreglo](#list-to-array).
+Analiza una secuencia de cadenas de tokens y la devuelve como un arreglo. Consulta el [ejemplo de lista a arreglo](#list-to-array).
`url`
-: Analiza una URL y devuelve todos los miembros tokenizados (dominio, parámetros de consulta, puerto, etc.) en un objeto JSON. [Más información sobre cómo analizar URLs][2].
+Analiza una URL y devuelve todos los miembros tokenizados (dominio, parámetros de consulta, puerto, etc.) en un objeto JSON. [Más información sobre cómo analizar URLs][2].
-[1]: /es/logs/log_configuration/processors/#user-agent-parser
-[2]: /es/logs/log_configuration/processors/#url-parser
+[1]: /es/logs/log_configuration/processors/user_agent_parser/
+[2]: /es/logs/log_configuration/processors/url_parser/
{{% /tab %}}
{{< /tabs >}}
## Configuraciones avanzadas {#advanced-settings}
-Utiliza la sección **Configuraciones Avanzadas** al final de tu procesador Grok para analizar un atributo específico en lugar del atributo `message` predeterminado, o para definir reglas auxiliares que reutilicen patrones comunes en múltiples reglas de análisis.
+Utilice la sección **Configuraciones avanzadas** en la parte inferior de su procesador Grok para parsear un atributo específico en lugar del atributo predeterminado `message`, o para definir reglas auxiliares que reutilicen patrones comunes en múltiples reglas de parseo.
-### Analizando un atributo de texto específico {#parsing-a-specific-text-attribute}
+### Parseando un atributo de texto específico {#parsing-a-specific-text-attribute}
-Utiliza el campo **Extraer de** para aplicar tu procesador Grok a un atributo de texto dado en lugar del atributo `message` predeterminado.
+Utilice el campo **Extraer de** para aplicar su procesador Grok a un atributo de texto dado en lugar del atributo predeterminado `message`.
-Por ejemplo, considera un registro que contiene un atributo `command.line` que debe ser analizado como un par clave-valor. Extrae de `command.line` para analizar su contenido y crear atributos estructurados a partir de los datos del comando.
+Por ejemplo, considere un registro que contenga un atributo `command.line` que debe ser parseado como un par clave-valor. Extraiga de `command.line` para parsear su contenido y crear atributos estructurados a partir de los datos del comando.
-{{< img src="/logs/processing/parsing/grok_advanced_settings_extract.png" alt="Configuraciones Avanzadas con ejemplo de atributo command.line extraído" style="width:80%;">}}
+{{< img src="/logs/processing/parsing/grok_advanced_settings_extract.png" alt="Configuraciones avanzadas con ejemplo de atributo command.line extraído" style="width:80%;">}}
### Usando reglas auxiliares para reutilizar patrones comunes {#using-helper-rules-to-reuse-common-patterns}
-Utiliza el campo **Reglas Auxiliares** para definir tokens para tus reglas de análisis. Las reglas auxiliares te permiten reutilizar patrones comunes de Grok en tus reglas de análisis. Esto es útil cuando tienes varias reglas en el mismo analizador Grok que utilizan los mismos tokens.
+Utilice el campo **Reglas Auxiliares** para definir tokens para sus reglas de parseo. Las reglas auxiliares le permiten reutilizar patrones comunes de Grok en sus reglas de parseo. Esto es útil cuando tiene varias reglas en el mismo parser Grok que utilizan los mismos tokens.
-Ejemplo de un registro clásico no estructurado:
+Ejemplo de un registro no estructurado clásico:
```text
john id:12345 connected on 11/08/2017 on server XYZ in production
```
-Utiliza la siguiente regla de análisis:
+Utilice la siguiente regla de parseo:
```text
MyParsingRule %{user} %{connection} %{server}
@@ -266,16 +285,16 @@ server on server %{notSpace:server.name} in %{notSpace:server.env}
## Ejemplos {#examples}
-Algunos ejemplos que demuestran cómo usar analizadores:
+Algunos ejemplos que demuestran cómo usar parseadores:
* [Clave-valor o logfmt](#key-value-or-logfmt)
-* [Análisis de fechas](#parsing-dates)
-* [Patrones alternos](#alternating-pattern)
+* [Parseando fechas](#parsing-dates)
+* [Patrones alternantes](#alternating-pattern)
* [Atributo opcional](#optional-attribute)
* [JSON anidado](#nested-json)
-* [Expresiones regulares](#regex)
+* [Expresión regular](#regex)
* [Listas y arreglos](#list-to-array)
-* [Formato Glog](#glog-format)
+* [ Formato Glog](#glog-format)
* [XML](#parsing-xml)
* [CSV](#parsing-csv)
@@ -284,11 +303,11 @@ Algunos ejemplos que demuestran cómo usar analizadores:
Este es el filtro central de clave-valor: `keyvalue([separatorStr[, characterAllowList[, quotingStr[, delimiter]]]])` donde:
* `separatorStr`: define el separador entre claves y valores. Por defecto es `=`.
-* `characterAllowList`: define caracteres de valor adicionales no escapados además del valor por defecto `\\w.\\-_@`. Se usa solo para valores no entrecomillados (por ejemplo, `key=@valueStr`).
+* `characterAllowList`: define caracteres adicionales de valor no escapados además del valor por defecto `\\w.\\-_@`. Se utiliza solo para valores no entrecomillados (por ejemplo, `key=@valueStr`).
* `quotingStr`: define comillas, reemplazando la detección de comillas por defecto: `<>`, `""`, `''`.
-* `delimiter`: define el separador entre los diferentes pares de clave-valor (por ejemplo, `|` es el delimitador en `key1=value1|key2=value2`). Por defecto, se establece en ` ` (espacio normal), `,` y `;`.
+* `delimiter`: define el separador entre los diferentes pares de clave-valor (por ejemplo, `|` es el delimitador en `key1=value1|key2=value2`). Por defecto es ` ` (espacio normal), `,` y `;`.
-Utiliza filtros como **keyvalue** para mapear más fácilmente cadenas a atributos para formatos keyvalue o logfmt:
+Utiliza filtros como **keyvalue** para mapear más fácilmente cadenas a atributos para formatos de keyvalue o logfmt:
**Registro:**
@@ -302,8 +321,8 @@ user=john connect_date=11/08/2017 id=123 action=click
rule %{data::keyvalue}
```
-No es necesario especificar el nombre de tus parámetros, ya que ya están contenidos en el registro.
-Si agregas un atributo **extract** en tu patrón de regla, verás:
+No necesitas especificar el nombre de tus parámetros ya que ya están contenidos en el registro.
+Si agregas un atributo **extraer** `my_attribute` en tu patrón de regla, verás:
```json
{
@@ -315,7 +334,7 @@ Si agregas un atributo **extract** en tu patrón de regla, verás:
}
```
-Si `=` no es el separador predeterminado entre tus claves y valores, agrega un parámetro en tu regla de análisis con un separador.
+Si `=` no es el separador por defecto entre tu clave y valores, agrega un parámetro en tu regla de parseo con un separador.
**Registro:**
@@ -329,7 +348,7 @@ user: john connect_date: 11/08/2017 id: 123 action: click
rule %{data::keyvalue(": ")}
```
-Si los registros contienen caracteres especiales en un valor de atributo, como `/` en una URL, agrégalo a la lista de permitidos en la regla de análisis:
+Si los registros contienen caracteres especiales en un valor de atributo, como `/` en una URL por ejemplo, agrégalo a la lista de permitidos en la regla de parseo:
**Registro:**
@@ -345,10 +364,10 @@ rule %{data::keyvalue("=","/:")}
Otros ejemplos:
-| **Cadena cruda** | **Regla de análisis** | **Resultado** |
+| **Cadena sin procesar** | **Regla de parseo** | **Resultado** |
|:-----------------------------|:------------------------------------------------------|:--------------------------------------|
-| key=valueStr | `%{data::keyvalue}` | {"key": "valueStr"} |
-| key=\ | `%{data::keyvalue}` | {"key": "valueStr"} |
+| clave=valueStr | `%{data::keyvalue}` | {"key": "valueStr"} |
+| clave=\ | `%{data::keyvalue}` | {"key": "valueStr"} |
| "key"="valueStr" | `%{data::keyvalue}` | {"key": "valueStr"} |
| key:valueStr | `%{data::keyvalue(":")}` | {"key": "valueStr"} |
| key:"/valueStr" | `%{data::keyvalue(":", "/")}` | {"key": "/valueStr"} |
@@ -357,8 +376,8 @@ Otros ejemplos:
| key1=value1\|key2=value2 | %{data::keyvalue("=", "", "", "|")} | {"key1": "value1", "key2": "value2"} |
| key1="value1"\|key2="value2" | %{data::keyvalue("=", "", "", "|")} | {"key1": "value1", "key2": "value2"} |
-**Ejemplo de cadena de cita múltiple**: Cuando se definen múltiples cadenas de cita, el comportamiento predeterminado se reemplaza con un carácter de cita definido.
-La clave-valor siempre coincide con entradas sin ningún carácter de cita, independientemente de lo que se especifique en `quotingStr`. Cuando se utilizan caracteres de cita, se ignora el `characterAllowList` ya que todo lo que está entre los caracteres de cita se extrae.
+**Ejemplo de múltiples cadenas de comillas**: Cuando se definen múltiples cadenas de comillas, el comportamiento predeterminado se reemplaza con un carácter de comillas definido.
+La clave-valor siempre coincide con entradas sin ningún carácter de comillas, independientemente de lo que se especifique en `quotingStr`. Cuando se utilizan caracteres de comillas, el `characterAllowList` se ignora ya que todo lo que está entre los caracteres de comillas se extrae.
**Registro:**
@@ -380,15 +399,15 @@ La clave-valor siempre coincide con entradas sin ningún carácter de cita, inde
**Nota**:
-* Los valores vacíos (`key=`) o `null` valores (`key=null`) no se muestran en el JSON de salida.
-* Si defines un filtro de *clavevalor* en un `data` objeto, y este filtro no coincide, entonces se devuelve un JSON vacío `{}` (por ejemplo, entrada: `key:=valueStr`, regla de análisis: `rule_test %{data::keyvalue("=")}`, salida: `{}`).
-* Definir `""` como `quotingStr` mantiene la configuración predeterminada para la cita.
+* Los valores vacíos (`key=`) o los valores (`null`) no se muestran en el JSON de salida.
+* Si defines un filtro de *clave-valor* en un `data` objeto, y este filtro no coincide, entonces se devuelve un JSON vacío `{}` (por ejemplo, entrada: `key:=valueStr`, regla de parseo: `rule_test %{data::keyvalue("=")}`, salida: `{}`).
+* Definir `""` como `quotingStr` mantiene la configuración predeterminada para las comillas.
-### Analizando fechas {#parsing-dates}
+### Parseando fechas {#parsing-dates}
El comparador de fechas transforma tu marca de tiempo en el formato EPOCH (unidad de medida **milisegundo**).
-| **Cadena cruda** | **Regla de análisis** | **Resultado** |
+| **Cadena sin procesar** | **Regla de parseo** | **Resultado** |
|:-------------------------------------|:----------------------------------------------------------|:------------------------|
| 14:20:15 | `%{date("HH:mm:ss"):date}` | {"date": 51615000} |
| 02:20:15 PM | `%{date("hh:mm:ss a"):date}` | {"date": 51615000} |
@@ -400,23 +419,23 @@ El comparador de fechas transforma tu marca de tiempo en el formato EPOCH (unida
| 2016-11-29T16:21:36.431+00:00 | `%{date("yyyy-MM-dd'T'HH:mm:ss.SSSZZ"):date}` | {"date": 1480436496431} |
| 06/Feb/2009:12:14:14.655 | `%{date("dd/MMM/yyyy:HH:mm:ss.SSS"):date}` | {"date": 1233922454655} |
| 2007-08-31 19:22:22.427 ADT | `%{date("yyyy-MM-dd HH:mm:ss.SSS z"):date}` | {"date": 1188598942427} |
-| Jue 16 Jun 2016 08:29:031 | `%{date("EEE MMM dd HH:mm:ss yyyy","Europe/Paris"):date}` | {"date": 1466058543000} |
-| Jue 16 Jun 2016 08:29:031 | `%{date("EEE MMM dd HH:mm:ss yyyy","UTC+5"):date}` | {"date": 1466047743000} |
-| Jue 16 Jun 2016 08:29:031 | `%{date("EEE MMM dd HH:mm:ss yyyy","+3"):date}` | {"date": 1466054943000} |
+| Jue Jun 16 08:29:03 20161 | `%{date("EEE MMM dd HH:mm:ss yyyy","Europe/Paris"):date}` | {"date": 1466058543000} |
+| Jue Jun 16 08:29:03 20161 | `%{date("EEE MMM dd HH:mm:ss yyyy","UTC+5"):date}` | {"date": 1466047743000} |
+| Jue Jun 16 08:29:03 20161 | `%{date("EEE MMM dd HH:mm:ss yyyy","+3"):date}` | {"date": 1466054943000} |
-1 Utilice el `timezone` parámetro si realiza sus propias localizaciones y sus marcas de tiempo _no_ están en UTC.
-El formato soportado para zonas horarias es:
+1 Usa el `timezone` parámetro si realizas tus propias localizaciones y tus marcas de tiempo _no_ están en UTC.
+El formato soportado para las zonas horarias es:
* `GMT`, `UTC`, `UT` o `Z`
-* `+hh:mm`, `-hh:mm`, `+hhmm`, `-hhmm`. El rango máximo soportado es de +18:00 a -18:00 inclusive.
-* Zonas horarias que comienzan con `UTC+`, `UTC-`, `GMT+`, `GMT-`, `UT+` o `UT-`. El rango máximo soportado es de +18:00 a -18:00 inclusive.
-* IDs de zonas horarias extraídos de la base de datos TZ. Para más información, consulte [nombres de la base de datos TZ][2].
+* `+hh:mm`, `-hh:mm`, `+hhmm`, `-hhmm`. El rango máximo soportado es de +18:00 a -18:00, inclusive.
+* Zonas horarias que comienzan con `UTC+`, `UTC-`, `GMT+`, `GMT-`, `UT+` o `UT-`. El rango máximo soportado es de +18:00 a -18:00, inclusive.
+* Los identificadores de zona horaria se obtienen de la base de datos TZ. Para más información, consulte [nombres de la base de datos TZ][2].
-**Nota**: Analizar una fecha **no** establece su valor como la fecha oficial del registro. Para esto, utilice el [Remapeador de Fecha de Registro][3] en un Procesador posterior.
+**Nota**: El parseo de una fecha **no** establece su valor como la fecha oficial del registro. Para esto, use el [Log Date Remapper][3] en un procesador posterior.
### Patrón alternante {#alternating-pattern}
-Si tiene registros con dos formatos posibles que difieren en solo un atributo, establezca una única regla utilizando alternante con `(|)`. Esta regla es equivalente a un OR booleano.
+Si tiene registros con dos formatos posibles que difieren en solo un atributo, establezca una única regla usando alternante con `(|)`. Esta regla es equivalente a un OR booleano.
**Registro**:
@@ -471,7 +490,7 @@ john connected on 11/08/2017
MyParsingRule %{word:user.firstname} (%{integer:user.id} )?connected on %{date("MM/dd/yyyy"):connect_date}
```
-**Nota**: Una regla no coincidirá si incluye un espacio después de la primera palabra en la sección opcional.
+**Nota**: Una regla no coincidirá si incluyes un espacio después de la primera palabra en la sección opcional.
**Resultado**:
`(%{integer:user.id} )?`
@@ -499,7 +518,7 @@ MyParsingRule %{word:user.firstname} (%{integer:user.id} )?connected on %{date("
### JSON anidado {#nested-json}
-Utilice el filtro `json` para analizar un objeto JSON anidado después de un prefijo de texto sin procesar:
+Usa el filtro `json` para parsear un objeto JSON anidado después de un prefijo de texto sin procesar:
**Registro**:
@@ -553,7 +572,7 @@ MyParsingRule %{regex("[a-z]*"):user.firstname}_%{regex("[a-zA-Z0-9]*"):user.id}
### Lista a arreglo {#list-to-array}
-Utilice el filtro `array([[openCloseStr, ] separator][, subRuleOrFilter)` para extraer una lista en un arreglo en un solo atributo. El `subRuleOrFilter` es opcional y acepta estos [filtros][4].
+Usa el filtro `array([[openCloseStr, ] separator][, subRuleOrFilter)` para extraer una lista en un arreglo en un solo atributo. El `subRuleOrFilter` es opcional y acepta estos [filtros][4].
**Registro**:
@@ -600,15 +619,15 @@ myParsingRule Users %{data:users:array("{}","-", uppercase)} have been added to
### Formato Glog {#glog-format}
-Los componentes de Kubernetes a veces registran en el formato `glog`; este ejemplo es del elemento Kube Scheduler en la Biblioteca de Pipeline.
+Los componentes de Kubernetes a veces registran información en el formato `glog`; este ejemplo es del elemento Kube Scheduler en la Biblioteca de canalización.
-Línea de registro de ejemplo:
+Ejemplo de línea de registro:
```text
W0424 11:47:41.605188 1 authorization.go:47] Authorization is disabled
```
-Regla de análisis:
+Regla de parseo:
```text
kube_scheduler %{regex("\\w"):level}%{date("MMdd HH:mm:ss.SSSSSS"):timestamp}\s+%{number:logger.thread_id} %{notSpace:logger.name}:%{number:logger.lineno}\] %{data:msg}
@@ -629,9 +648,9 @@ Y JSON extraído:
}
```
-### Análisis de XML {#parsing-xml}
+###Parseo de XML{#parsing-xml}
-El analizador XML transforma mensajes formateados en XML a JSON.
+El analizador XML transforma mensajes en formato XML a JSON.
**Registro:**
@@ -667,23 +686,23 @@ rule %{data::xml}
**Notas**:
-* Si el XML contiene etiquetas que tienen tanto un atributo como un valor de cadena entre las dos etiquetas, se genera un atributo `value`. Por ejemplo: `Harry Potter` se convierte en `{"title": {"lang": "en", "value": "Harry Potter" } }`
+* Si el XML contiene etiquetas que tienen tanto un atributo como un valor de cadena entre las dos etiquetas, se genera un `value` atributo. Por ejemplo: `Harry Potter` se convierte en `{"title": {"lang": "en", "value": "Harry Potter" } }`
* Las etiquetas repetidas se convierten automáticamente en arreglos. Por ejemplo: `Harry PotterEveryday Italian` se convierte en `{ "bookstore": { "book": [ "Harry Potter", "Everyday Italian" ] } }`
-### Análisis de CSV {#parsing-csv}
+###Parseo de CSV{#parsing-csv}
-Utiliza el filtro **CSV** para mapear más fácilmente cadenas a atributos cuando están separadas por un carácter dado (`,` por defecto).
+Usa el filtro **CSV** para mapear más fácilmente cadenas a atributos cuando están separadas por un carácter dado (`,` por defecto).
El filtro CSV se define como `csv(headers[, separator[, quotingcharacter]])` donde:
* `headers`: Define los nombres de las claves separados por `,`. Los nombres de las claves deben comenzar con un carácter alfabético y pueden contener cualquier carácter alfanumérico además de `_`.
-* `separator`: Define los separadores utilizados para separar los diferentes valores. Solo se acepta un carácter. Predeterminado: `,`. **Nota**: Utilice `tab` para el `separator` para representar el carácter de tabulación para TSVs.
-* `quotingcharacter`: Define el carácter de comillas. Solo se acepta un carácter. Predeterminado: `"`
+* `separator`: Define los separadores utilizados para separar los diferentes valores. Solo se acepta un carácter. Por defecto: `,`. **Nota**: Usa `tab` para el `separator` para representar el carácter de tabulación para TSVs.
+* `quotingcharacter`: Define el carácter de comillas. Solo se acepta un carácter. Por defecto: `"`
**Nota**:
* Los valores que contienen un carácter separador deben estar entre comillas.
-* Los valores entre comillas que contienen un carácter de comillas deben ser escapados con caracteres de comillas. Por ejemplo, `""` dentro de un valor entre comillas representa `"`.
+* Los valores entre comillas que contienen un carácter de comillas deben escaparse usando un carácter de comillas. Por ejemplo, `""` dentro de un valor entre comillas representa `"`.
* Si el registro no contiene la misma cantidad de valores que la cantidad de claves en el encabezado, el analizador CSV emparejará los primeros.
* Los enteros y los dobles se convierten automáticamente si es posible.
@@ -715,7 +734,7 @@ myParsingRule %{data:user:csv("first_name,name,st_nb,st_name,city")}
Otros ejemplos:
-| **Cadena cruda** | **Regla de análisis** | **Resultado** |
+| **Cadena sin procesar** | **Regla de parseo** | **Resultado** |
|:-----------------------------|:-------------------------------------------------------------------------|:------------------------------------------------|
| `John,Doe` | `%{data::csv("firstname,name")}` | {"firstname": "John", "name":"Doe"} |
| `"John ""Da Man""",Doe` | `%{data::csv("firstname,name")}` | {"firstname": "John \"Da Man\"", "name":"Doe"} |
@@ -724,11 +743,11 @@ Otros ejemplos:
| `value1,value2,value3` | `%{data::csv("key1,key2")}` | {"key1": "value1", "key2":"value2"} |
| `value1,value2` | `%{data::csv("key1,key2,key3")}` | {"key1": "value1", "key2":"value2"} |
| `value1,,value3` | `%{data::csv("key1,key2,key3")}` | {"key1": "value1", "key3":"value3"} |
-| Value1 Value2 Value3 (TSV) | `%{data::csv("key1,key2,key3","tab")}` | {"key1": "value1", "key2": "value2", "key3":"value3"} |
+| Valor1 Valor2 Valor3 (TSV) | `%{data::csv("key1,key2,key3","tab")}` | {"key1": "value1", "key2": "value2", "key3":"value3"} |
### Utiliza el comparador de datos para descartar texto innecesario {#use-data-matcher-to-discard-unneeded-text}
-Si tienes un registro donde después de haber analizado lo necesario y sabes que el texto después de ese punto es seguro para descartar, puedes usar el comparador de datos para hacerlo. Para el siguiente ejemplo de registro, puedes usar el `data` comparador para descartar el `%` al final.
+Si tienes un registro en el que, después de parsear lo necesario y sabiendo que el texto posterior es seguro de descartar, puedes usar el comparador de datos para hacerlo. Para el siguiente ejemplo de registro, puedes usar el `data` comparador para descartar el `%` al final.
**Registro**:
@@ -753,7 +772,7 @@ MyParsingRule Usage\:\s+%{number:usage}%{data:ignore}
### Caracteres de control ASCII {#ascii-control-characters}
-Si tus registros contienen caracteres de control ASCII, se serializan al ser ingeridos. Estos pueden ser manejados escapando explícitamente el valor serializado dentro de tu parser grok.
+Si tus registros contienen caracteres de control ASCII, se serializan al ser ingeridos. Estos pueden manejarse escapando explícitamente el valor serializado dentro de tu analizador grok.
## Lectura adicional {#further-reading}
@@ -761,5 +780,5 @@ Si tus registros contienen caracteres de control ASCII, se serializan al ser ing
[1]: https://github.com/google/re2/wiki/Syntax
[2]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-[3]: /es/logs/log_configuration/processors/#log-date-remapper
+[3]: /es/logs/log_configuration/processors/log_date_remapper/
[4]: /es/logs/log_configuration/parsing/?tab=filters&tabs=filters#matcher-and-filter
\ No newline at end of file
diff --git a/content/es/metrics/advanced-filtering.md b/content/es/metrics/advanced-filtering.md
index c1b5b51a99c..540f9ff2ff6 100644
--- a/content/es/metrics/advanced-filtering.md
+++ b/content/es/metrics/advanced-filtering.md
@@ -1,33 +1,35 @@
---
-description: Filtra tus datos para acotar el contexto de las métricas devueltas.
+description: Filtra tus datos para reducir el contexto de las métricas devueltas.
further_reading:
+- link: /getting_started/search/
+ tag: Documentación
+ text: Introducción a la búsqueda en Datadog
- link: /metrics/explorer/
tag: Documentación
- text: Explorador de métricas
+ text: Metrics Explorer
- link: /metrics/summary/
tag: Documentación
- text: Resumen de métricas
+ text: Metrics Summary
- link: /metrics/distributions/
tag: Documentación
text: Distribuciones de métricas
- link: /logs/explorer/search_syntax/
tag: Documentación
- text: Filtro de búsqueda y sintaxis de búsqueda de logs
+ text: Filtro de consulta de registros y sintaxis de búsqueda
- link: /dashboards/functions/exclusion/
tag: Documentación
text: Funciones de exclusión
title: Filtrado avanzado
---
+## Resumen {#overview}
-## Información general
-
-Al utilizar el Explorador de métricas, los monitores o los dashboards para la consulta de métricas puedes filtrar los datos para acotar el contexto de las series temporales devueltas. Cualquier métrica puede filtrarse por etiqueta (tag) utilizando el campo **desde** a la derecha de la métrica.
+Al usar el Metrics Explorer, monitors o tableros para consultar datos de métricas, puedes filtrar los datos para reducir el contexto de las series temporales devueltas. Cualquier métrica puede ser filtrada por etiqueta(s) usando el campo **de** a la derecha de la métrica.
-También puedes realizar filtrados avanzados con filtros de valores de etiquetas booleanos o comodines. Para realizar consultas fuera de los datos de métricas como logs, trazas (traces), Network Monitoring, Real User Monitoring, Synthetics o Seguridad, consulta la documentación de configuración [Sintaxis para la búsqueda de logs][1].
+También puedes realizar filtrado avanzado con filtros de valores de etiquetas booleanas o Wildcard. Para consultas fuera de los datos de métricas, como registros, trazas, Network Monitoring, RUM, Synthetics o Security, consulta la documentación de [Sintaxis de búsqueda de registros][1] para la configuración.
-## Consultas booleanas filtradas
+## Consultas filtradas booleanas {#boolean-filtered-queries}
-Se admite la siguiente sintaxis para las consultas de métricas con filtrado booleano:
+La siguiente sintaxis es compatible para consultas de métricas filtradas booleanas:
- `!`
- `,`
@@ -37,73 +39,74 @@ Se admite la siguiente sintaxis para las consultas de métricas con filtrado boo
- `IN`, `in`
- `NOT IN`, `not in`
-Cuándo incluir o excluir varias etiquetas:
-* Para incluirlas, se emplea la lógica `AND`
-* Para excluirlas, se emplea la lógica `OR`
+Al incluir o excluir múltiples etiquetas:
+* Incluir utiliza la lógica `AND`
+* Excluir utiliza la lógica `OR`
-Para más información sobre etiquetas, consulta la guía [Empezando con el uso de etiquetas][2].
+Para más información sobre etiquetas, consulte la guía [Introducción al uso de etiquetas][2].
-**Nota:** La sintaxis booleana simbólica (`!`, `,`) no puede utilizarse con operadores de sintaxis funcional (`NOT`, `AND`, `OR`, `IN`, `NOT IN`). La siguiente consulta se considerar _inválida_:
+**Nota:** La sintaxis booleana simbólica (`!`, `,`) no se puede usar con operadores de sintaxis funcional (`NOT`, `AND`, `OR`, `IN`, `NOT IN`). La siguiente consulta se considera _inválida_:
`avg:mymetric{env:prod AND !region:us-east}`
-### Ejemplos de consultas con filtrado booleano
+### Ejemplos de consultas filtradas booleanas {#boolean-filtered-query-examples}
-Para utilizar los siguientes ejemplos, haz clic en el icono de código `>` para ver el editor de consultas en la interfaz de usuario y, a continuación, copia y pega el ejemplo de consulta en el editor de consultas.
+Para usar los ejemplos a continuación, haga clic en el ícono de código `>` para ver el editor de consultas en la interfaz de usuario, y luego copie y pegue el ejemplo de consulta en el editor de consultas.
```
avg:system.cpu.user{env:staging AND (availability-zone:us-east-1a OR availability-zone:us-east-1c)} by {availability-zone}
```
-{{< img src="metrics/advanced-filtering/graph_editor_code_option.mp4" alt="Haz clic en el icono de código para ver la consulta sin procesar" video=true >}}
+{{< img src="metrics/advanced-filtering/graph_editor_code_option.mp4" alt="Haga clic en el ícono de código para ver la consulta en bruto" video=true >}}
```
avg:system.cpu.user{env:shop.ist AND availability-zone IN (us-east-1a, us-east-1b, us-east4-b)} by {availability-zone}
```
-{{< img src="metrics/advanced-filtering/boolean_and_in.png" alt="Ejemplo booleano AND IN" style="width:100%;" >}}
+{{< img src="metrics/advanced-filtering/boolean_and_in.png" alt="Ejemplo booleano Y EN" style="width:100%;" >}}
+
```
avg:system.cpu.user{env:prod AND location NOT IN (atlanta,seattle,las-vegas)}
```
-{{< img src="metrics/advanced-filtering/boolean_not_in.png" alt="Ejemplo booleano NOT IN" style="width:100%;" >}}
+{{< img src="metrics/advanced-filtering/boolean_not_in.png" alt="Ejemplo booleano NO EN" style="width:100%;" >}}
-## Consultas filtradas con comodín
+## Consultas filtradas con Wildcard {#wildcard-filtered-queries}
-Se admite el filtrado con etiquetas de prefijo, sufijo y comodín de subcadena:
+Se admiten filtros de etiquetas con Wildcard de prefijo, sufijo y subcadena:
- `pod_name: web-*`
- `cluster:*-trace`
- `node:*-prod-*`
-### Ejemplos de consultas filtradas con comodín
+### Ejemplos de consultas filtradas con Wildcard {#wildcard-filtered-query-examples}
```
avg:system.disk.in_use{!device:/dev/loop*} by {device}
```
-{{< img src="metrics/advanced-filtering/wildcard_suffix_example.png" alt="Comodín utilizado como sufijo" style="width:100%;" >}}
+{{< img src="metrics/advanced-filtering/wildcard_suffix_example.png" alt="Wildcard utilizado como sufijo" style="width:100%;" >}}
```
sum:kubernetes.pods.running{service:*-canary} by {service}
```
-{{< img src="metrics/advanced-filtering/wildcard_prefix_example.png" alt="Comodín utilizado como prefijo" style="width:100%;" >}}
+{{< img src="metrics/advanced-filtering/wildcard_prefix_example.png" alt="Wildcard utilizado como prefijo" style="width:100%;" >}}
```
avg:system.disk.utilized{region:*east*} by {region}
```
-{{< img src="metrics/advanced-filtering/wildcard_infix.png" alt="Comodín utilizado como infix" style="width:100%;" >}}
+{{< img src="metrics/advanced-filtering/wildcard_infix.png" alt="Wildcard utilizado como infijo" style="width:100%;" >}}
-## Funciones de exclusión
+## Funciones de exclusión {#exclusion-functions}
-Añade una [función de exclusión][3] a tu consulta para:
-- Excluye valores N/A.
-- Aplica un valor mínimo o máximo a las métricas que lleguen al umbral.
-- Excluye los valores que estén por encima o por debajo de los valores del umbral.
+Agrega una [función de exclusión][3] a tu consulta para:
+- Excluir valores N/A.
+- Aplica un valor mínimo o máximo a las métricas que cumplen con el umbral.
+- Excluir valores que están por encima o por debajo de los valores umbral.
-Las funciones no eliminan puntos de datos de Datadog, pero sí de tus visualizaciones.
+Las funciones no eliminan puntos de datos de Datadog, pero sí eliminan puntos de datos de las visualizaciones.
-## Para leer más
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/metrics/types.md b/content/es/metrics/types.md
index cf79f448eed..2ed7854e194 100644
--- a/content/es/metrics/types.md
+++ b/content/es/metrics/types.md
@@ -1,7 +1,7 @@
---
algolia:
tags:
- - Tipos de métricas
+ - metric types
aliases:
- /es/developers/metrics/counts/
- /es/developers/metrics/distributions/
@@ -13,175 +13,179 @@ aliases:
- /es/developers/metrics/metrics_type/
- /es/developers/metrics/types/
further_reading:
-- link: developers/dogstatsd
+- link: extend/dogstatsd
tag: Documentación
- text: Más información sobre DogStatsD
-- link: desarrolladores/bibliotecas
+ text: Aprende más sobre DogStatsD
+- link: /metrics/units
tag: Documentación
- text: API oficial y creada por la comunidad y bibliotecas cliente de DogStatsD
-title: Tipos de métricas
+ text: Unidades de Métricas
+- link: extend/libraries
+ tag: Documentación
+ text: Bibliotecas de API y clientes de DogStatsD creadas oficialmente y por la comunidad
+title: Tipos de Métricas
---
+## Resumen {#overview}
-## Información general
-
-Cada métrica enviada a Datadog debe tener un tipo. El tipo de métrica afecta a la forma en que se muestran los valores de la métrica cuando se consulta, así como a las posibilidades asociadas de creación de gráficas dentro de Datadog utilizando [modificadores][1] y [funciones][2] adicionales. El tipo de métrica se muestra en el panel lateral de detalles de la métrica en la [página Resumen de métricas][3].
+Cada métrica enviada a Datadog debe tener un tipo. El tipo de una métrica afecta cómo se muestran los valores de la métrica al consultarlos, así como las posibilidades de graficado asociadas dentro de Datadog utilizando [modificadores][1] y [funciones][2]. El tipo de una métrica se muestra en el panel lateral de detalles para la métrica dada en la [Metrics Summary page][3].
-**Nota**: Al cambiar el tipo de métrica en este panel lateral de detalles se puede cambiar el comportamiento de la métrica en todas las visualizaciones y monitores existentes, lo que puede llevar a que los datos históricos no tengan sentido.
+**Nota**: Cambiar el tipo de métrica en este panel lateral de detalles puede cambiar el comportamiento de la métrica en todas las visualizaciones y monitores existentes, lo que potencialmente puede hacer que los datos históricos sean incomprensibles.
-Se aceptan los siguientes tipos de envíos de métricas:
+Los siguientes tipos de envío de métricas son aceptados:
- [COUNT](?tab=count#metric-types)
-- [RATE](?tab=rate#metric-types)
+- [TASA](?tab=rate#metric-types)
- [GAUGE](?tab=gauge#metric-types)
- [SET][4]
-- [HISTOGRAM](?tab=histogram#metric-types)
-- [DISTRIBUTION](?tab=distribution#metric-types)
+- [HISTOGRAMA](?tab=histogram#metric-types)
+- [DISTRIBUCIÓN](?tab=distribution#metric-types)
-Estos diferentes tipos de envíos de métricas se asignan a cuatro tipos de métricas dentro de la aplicación, que se encuentran en la aplicación web Datadog:
+Estos diferentes tipos de envío de métricas se asignan a cuatro tipos de métricas en la aplicación que se encuentran dentro de la aplicación web de Datadog:
- COUNT
- RATE
- GAUGE
- DISTRIBUTION
-**Nota**: Si envías una métrica a Datadog sin un tipo, el tipo de la métrica aparece como `Not Assigned` en Datadog. El tipo de métrica `Not Assigned` no se puede cambiar a otro tipo dentro de la aplicación hasta que se envíe un tipo inicial de métrica.
+**Nota**: Si envías una métrica a Datadog sin un tipo, el tipo de métrica aparece como `Not Assigned` dentro de Datadog. El tipo de métrica `Not Assigned` no puede ser cambiado a otro tipo en la aplicación hasta que se envíe un tipo de métrica inicial.
-## Envío comparado con tipo dentro de la aplicación
+## Envío vs. tipo en la aplicación {#submission-vs-in-app-type}
-Las métricas se envían a Datadog de tres formas principales:
+Las métricas se envían a Datadog de tres maneras principales:
-- [Check del Agent][5]
+- [Verificación del agente][5]
- [DogStatsD][6]
-- [API HTTP Datadog][7]
+- [Datadog's HTTP API][7]
-La mayoría de los datos que recibe Datadog son enviados por el Agent, ya sea a través de un check del Agent o DogStatsD. Para estos métodos de envío, el tipo de métrica determina cómo se agregan los múltiples valores recopilados en un Agent en [un intervalo de tiempo de descarga][8]. El Agent combina estos valores en un único valor de métrica representativo para ese intervalo. Este valor combinado se almacena con una única marca de tiempo en Datadog.
+La mayoría de los datos que recibe Datadog son enviados por el Agente, ya sea a través de una verificación del Agente o DogStatsD. Para estos métodos de envío, el tipo de una métrica determina cómo se agregan múltiples valores recolectados en un Agent en un intervalo de flush. El Agente combina estos valores en un único valor métrico representativo para ese intervalo. Este valor combinado se almacena con una única marca de tiempo en Datadog.
-Los datos enviados directamente a la API Datadog no son agregados por Datadog, a excepción de las métricas de distribución. Los valores brutos enviados a Datadog se almacenan tal cual.
+Los datos enviados directamente a la API de Datadog no son agregados por Datadog, con la excepción de las métricas de distribución. Los valores crudos enviados a Datadog se almacenan tal como están.
-Para saber cómo se asignan los distintos tipos de envíos de métricas a sus correspondientes tipos dentro de la aplicación, consulta la sección [Tipos de envío y tipos dentro de la aplicación de Datadog](#submission-types-and-datadog-in-app-types).
+Lee la sección [Tipos de envío y tipos en la aplicación de Datadog](#submission-types-and-datadog-in-app-types) para aprender cómo se mapean los diferentes tipos de envío de métricas a sus tipos correspondientes en la aplicación.
-## Tipos de métricas
+## Tipos de métricas {#metric-types}
-### Definición
+### Definición {#definition}
{{< tabs >}}
{{% tab "COUNT" %}}
-El tipo de envío de métricas COUNT representa el número total de ocurrencias de eventos en un intervalo de tiempo. Un COUNT puede utilizarse para realizar un seguimiento del número total de conexiones realizadas a una base de datos o del número total de solicitudes a un endpoint. Este número de eventos puede acumularse o disminuir con el tiempo y no se incrementa monotónicamente.
+El tipo de envío de métrica COUNT representa el número total de ocurrencias de eventos en un intervalo de tiempo. Un COUNT puede usarse para rastrear el número total de conexiones realizadas a una base de datos o el número total de solicitudes a un endpoint. Este número de eventos puede acumularse o disminuir con el tiempo; no es monotonamente creciente.
**Nota**: Un COUNT es diferente del tipo de métrica RATE, que representa el número de ocurrencias de eventos normalizadas por segundo dado el intervalo de tiempo definido.
{{% /tab %}}
{{% tab "RATE" %}}
-El tipo de envío de métricas RATE representa el número total de ocurrencias de eventos por segundo en un intervalo de tiempo. Un RATE se puede utilizar para realizar un seguimiento de la frecuencia con la que ocurre algo, como la frecuencia de las conexiones realizadas a una base de datos o el flujo de solicitudes realizadas a un endpoint.
+El tipo de envío de métrica RATE representa el número total de ocurrencias de eventos por segundo en un intervalo de tiempo. Un RATE puede usarse para rastrear con qué frecuencia está ocurriendo algo, como la frecuencia de conexiones realizadas a una base de datos o el flujo de solicitudes realizadas a un endpoint.
-**Nota**: Un RATE es diferente del tipo de envío de métricas COUNT, que representa el número total de ocurrencias de eventos en el intervalo de tiempo dado.
+**Nota**: Una RATE es diferente del tipo de envío de métrica COUNT, que representa el número total de ocurrencias de eventos en el intervalo de tiempo dado.
{{% /tab %}}
{{% tab "GAUGE" %}}
-El tipo de envío de métricas GAUGE representa un snapshot de eventos en un intervalo de tiempo. Este valor representativo de snapshot es el último valor enviado al Agent durante un intervalo de tiempo. Un GAUGE se puede utilizar para tomar una medida de algo que informa continuamente, como el espacio disponible en disco o la memoria utilizada.
+El tipo de envío de métrica GAUGE representa una instantánea de eventos en un intervalo de tiempo. Este valor de instantánea representativa es el último valor enviado al Agent durante un intervalo de tiempo. Un GAUGE puede usarse para medir algo que reporta continuamente, como el espacio en disco disponible o la memoria utilizada.
{{% /tab %}}
-{{% tab "HISTOGRAM" %}}
+{{% tab "HISTOGRAMA" %}}
-El tipo de envío de métricas HISTOGRAM representa la distribución estadística de un conjunto de valores calculados del lado del Agent en un intervalo de tiempo. El tipo de métrica HISTOGRAM es una extensión del tipo de métrica de temporización StatsD. El Agent agrega los valores que se envían en un intervalo de tiempo definido y produce diferentes métricas que representan el conjunto de valores.
+El tipo de envío de métrica HISTOGRAMA representa la distribución estadística de un conjunto de valores calculados del lado del Agent en un intervalo de tiempo. El tipo de métrica HISTOGRAMA de Datadog es una extensión del tipo de métrica de tiempo StatsD. El Agent agrega los valores que se envían en un intervalo de tiempo definido y produce diferentes métricas que representan el conjunto de valores.
-Si envías valores `X` para una métrica HISTOGRAM `` en un intervalo de tiempo dado, las siguientes métricas son producidas por el Agent por defecto:
+Si envías `X` valores para una métrica HISTOGRAMA `` en un intervalo de tiempo dado, las siguientes métricas son producidas por el Agent por defecto:
`.avg`
-: Representa la media de los valores `X` en un intervalo de tiempo.
-**Tipo dentro de la aplicación de Datadog**: GAUGE
+: Representa el promedio de esos `X` valores en el intervalo de tiempo.
+**Tipo en la aplicación de Datadog**: GAUGE
`.count`
-: Representa el número de valores enviados durante el intervalo, `X`. El Agent envía este número como un RATE por lo que mostraría en el valor `X/interval` en la aplicación.
-**Tipo dentro de la aplicación de Datadog**: RATE
+: Representa el número de valores enviados durante el intervalo, `X`. El Agent envía este número como un RATE, por lo que mostraría en la aplicación el valor de `X/interval`.
+**Tipo en la aplicación de Datadog**: RATE
`.median`
-: Representa la mediana de los valores `X` en un intervalo de tiempo.
-**Tipo dentro de la aplicación de Datadog**: GAUGE
+: Representa la mediana de esos `X` valores en el intervalo de tiempo.
+**Tipo en la aplicación de Datadog**: GAUGE
`.95percentile`
-: Representa el percentil 95 de esos valores `X` en un intervalo de tiempo.
-**Tipo dentro de la aplicación de Datadog**: GAUGE
+: Representa el percentil 95 de esos `X` valores en el intervalo de tiempo.
+**Tipo en la aplicación de Datadog**: GAUGE
`.max`
-: Representa el valor máximo de los valores de `X` enviados durante el intervalo de tiempo.
-**Tipo dentro de la aplicación de Datadog**: GAUGE
+: Representa el valor máximo de esos `X` valores enviados durante el intervalo de tiempo.
+**Tipo en la aplicación de Datadog**: GAUGE
-**Nota**:
+**Notas**:
-- Configura qué agregaciones quieres enviar a Datadog con el parámetro `histogram_aggregates` en tu [archivo de configuración `datadog.yaml`][1]. Por defecto, sólo se envían a Datadog las agregaciones `max`, `median`, `avg` y `count`. También están disponibles las agregaciones `sum` y `min`.
-- Configura qué agregación de percentiles quieres enviar a Datadog con el parámetro `histogram_percentiles` en tu [archivo de configuración `datadog.yaml`][2]. Por defecto, sólo se envía el `95percentile` a Datadog.
+- Configura qué agregaciones deseas enviar a Datadog con el parámetro `histogram_aggregates` en tu [`datadog.yaml` archivo de configuración][1]. Por defecto, solo se envían a Datadog las agregaciones `max`, `median`, `avg` y `count`. `sum` y `min` también están disponibles.
+- Configura qué agregación de percentil deseas enviar a Datadog con el parámetro `histogram_percentiles` en tu [`datadog.yaml` archivo de configuración][2]. Por defecto, solo se envía el `95percentile` a Datadog.
[1]: https://github.com/DataDog/datadog-agent/blob/04d8ae9dd4bc6c7a64a8777e8a38127455ae3886/pkg/config/config_template.yaml#L106-L114
[2]: https://github.com/DataDog/datadog-agent/blob/04d8ae9dd4bc6c7a64a8777e8a38127455ae3886/pkg/config/config_template.yaml#L116-L121
{{% /tab %}}
-{{% tab "DISTRIBUTION" %}}
+{{% tab "DISTRIBUCIÓN" %}}
-El tipo de envío de métricas DISTRIBUTION representa la distribución estadística global de un conjunto de valores calculados en toda tu infraestructura distribuida en un intervalo de tiempo. Una DISTRIBUTION puede utilizarse para instrumentar objetos lógicos, como servicios, independientemente de los hosts subyacentes.
+El tipo de envío de métrica de DISTRIBUTION representa la distribución estadística global de un conjunto de valores calculados a través de toda su infraestructura distribuida en un intervalo de tiempo. Un DISTRIBUTION puede ser utilizado para instrumentar objetos lógicos, como servicios, independientemente de los hosts subyacentes.
-A diferencia del tipo de métrica HISTOGRAM, que agrega en el Agent durante un intervalo de tiempo determinado, una métrica DISTRIBUTION envía todos los datos brutos a Datadog durante un intervalo de tiempo. La agregación se realiza en el servidor. Dado que la estructura de datos subyacente representa datos brutos, no agregados, las distribuciones ofrecen dos características principales:
+A diferencia del tipo de métrica HISTOGRAMA, que agrega en el Agent durante un intervalo de tiempo dado, una métrica de DISTRIBUTION envía todos los datos en bruto durante un intervalo de tiempo a Datadog. Las agregaciones ocurren del lado del servidor. Debido a que la estructura de datos subyacente representa datos en bruto, no agregados, las distribuciones proporcionan dos características principales:
-- Cálculo de agregaciones de percentiles
-- Personalización del etiquetado
+- Cálculo de agregaciones percentiles
+- Personalización de etiquetado
-Si envías valores `X` para una métrica DISTRIBUTION `` en un intervalo de tiempo determinado, las siguientes agregaciones están disponibles para consultas por defecto:
+Si envía `X` valores para una métrica de DISTRIBUTION `` en un intervalo de tiempo dado, las siguientes agregaciones están disponibles para consulta por defecto:
`avg:`
-: Representa la media de los valores `X` en el intervalo de tiempo.
-**Tipo dentro de la aplicación Datadog**: GAUGE
+: Representa el promedio de esos `X` valores en el intervalo de tiempo.
+**Tipo en la aplicación de Datadog**: GAUGE
`count:`
-: Representa el número de puntos enviados en el intervalo de tiempo, `X`. A continuación, el Agent lo envía como COUNT.
-**Tipo dentro de la aplicación Datadog**: COUNT
+: Representa el número de puntos enviados en el intervalo de tiempo, `X`. El Agent luego lo envía como un COUNT.
+**Tipo en la aplicación de Datadog**: COUNT
`max:`
-: Representa el valor máximo de los valores de `X` enviados en el intervalo de tiempo.
-**Tipo dentro de la aplicación Datadog**: GAUGE
+Representa el valor máximo de esos `X` valores enviados en el intervalo de tiempo.
+**Tipo de In-App de Datadog**: GAUGE
`min:`
-: Representa el valor mínimo de los `X` enviados en el intervalo de tiempo.
-**Tipo dentro de la aplicación Datadog**: GAUGE
+Representa el valor mínimo de esos `X` enviados en el intervalo de tiempo.
+**Tipo de In-App de Datadog**: GAUGE
`sum:`
-: Representa la suma de todos los valores de `X` enviados en el intervalo de tiempo.
-**Tipo dentro de la aplicación Datadog**: COUNT
+Representa la suma de todos los `X` valores enviados en el intervalo de tiempo.
+**Tipo de In-App de Datadog**: COUNT
+
+**Nota**: Mientras que las diferentes agregaciones de los valores de métricas de distribución son representadas como GAUGE o COUNT en la aplicación, la métrica en sí mantiene el tipo `DISTRIBUTION`.
{{% /tab %}}
{{< /tabs >}}
-### Ejemplo
+### Ejemplo {#example}
{{< tabs >}}
{{% tab "COUNT" %}}
-Supongamos que estás enviando una métrica COUNT `notifications.sent`, desde un único host que ejecuta el Datadog Agent. Este host emite los siguientes valores en un intervalo de tiempo de descarga: `[1,1,1,2,2,2,3,3]`.
+Supongamos que está enviando una métrica de COUNT, `notifications.sent`, desde un único host que ejecuta el Datadog Agent. Este host emite los siguientes valores en un intervalo de flush: `[1,1,1,2,2,2,3,3]`.
-El Agent suma todos los valores recibidos en un intervalo de tiempo. A continuación, envía el número total, en este caso `15`, como el valor de métrica COUNT.
+El Agente suma todos los valores recibidos en un intervalo de tiempo. Luego, envía el número total, en este caso `15`, como el valor de la métrica COUNT.
{{% /tab %}}
{{% tab "RATE" %}}
-Supongamos que estás enviando una métrica RATE `queue_messages.rate`, desde un único host que ejecuta el Datadog Agent. Este host emite los siguientes valores en un intervalo de tiempo de descarga: `[1,1,1,2,2,2,3,3]`.
+Supongamos que está enviando una métrica de RATE, `queue_messages.rate`, desde un único servidor que ejecuta el Datadog Agent. Este servidor emite los siguientes valores en un intervalo de tiempo de flush: `[1,1,1,2,2,2,3,3]`.
-El Agent suma todos los valores recibidos en un intervalo de tiempo. A continuación, envía el número total dividido por el número total de segundos de este intervalo de tiempo. En este caso, si el intervalo de descarga es de 10 segundos, el valor enviado sería `1.5` como el valor de métrica RATE.
+El Agente suma todos los valores recibidos en un intervalo de tiempo. Luego, envía el número total dividido por el número total de segundos en este intervalo de tiempo. En este caso, si el intervalo de flush es de 10 segundos, el valor enviado sería `1.5` como el valor de la métrica RATE.
{{% /tab %}}
{{% tab "GAUGE" %}}
-Supongamos que estás enviando una métrica GAUGE `temperature`, desde un único host que ejecuta el Datadog Agent. Este host emite los siguientes valores en un intervalo de tiempo de descarga: `[71,71,71,71,71,71,71.5]`.
+Supongamos que está enviando una métrica de GAUGE, `temperature`, desde un único servidor que ejecuta el Datadog Agent. Este servidor emite los siguientes valores en un intervalo de tiempo de flush: `[71,71,71,71,71,71,71.5]`.
-El Agent envía el último número reportado, en este caso `71.5`, como el valor de métrica GAUGE.
+El Agente envía el último número reportado, en este caso `71.5`, como el valor de la métrica GAUGE.
{{% /tab %}}
{{% tab "HISTOGRAM" %}}
-Por ejemplo, supongamos que estás enviando una métrica HISTOGRAM, `request.response_time.histogram`, desde un servidor web que informa de los valores `[1,1,1,2,2,2,3,3]` en un intervalo de tiempo de descarga. Por defecto, el Agent envía las siguientes métricas a Datadog, que representan la distribución estadística de estos valores en este intervalo de tiempo:
+Por ejemplo, supongamos que está enviando una métrica de HISTOGRAM, `request.response_time.histogram`, desde un servidor web que reporta los valores `[1,1,1,2,2,2,3,3]` en un intervalo de tiempo de flush de 10 segundos. Por defecto, el Agente envía las siguientes métricas a Datadog, que representan la distribución estadística de estos valores en este intervalo de tiempo:
-| Nombre de la métrica | Valor | Tipo dentro de la aplicación Datadog |
+| Nombre de la Métrica | Valor | Tipo en la Aplicación de Datadog |
| ---------------------------------------------- | ------ | ------------------- |
| `request.response_time.histogram.avg` | `1.88` | GAUGE |
| `request.response_time.histogram.count` | `0.8` | RATE |
@@ -192,9 +196,9 @@ Por ejemplo, supongamos que estás enviando una métrica HISTOGRAM, `request.res
{{% /tab %}}
{{% tab "DISTRIBUTION" %}}
-Supongamos que estás enviando una métrica DISTRIBUTION, `request.response_time.distribution`, desde dos servidores web: `webserver:web_1` y `webserver:web_2`. Supongamos que en un periodo de descarga determinado, `webserver:web_1` informa la métrica con los valores `[1,1,1,2,2,2,3,3]` y que `webserver:web_2` informa la misma métrica con los valores `[1,1,2]`. Durante este intervalo de tiempo, las cinco agregaciones siguientes representan la distribución estadística global de todos los valores recopilados de ambos servidores web:
+Supongamos que estás enviando una métrica de DISTRIBUTION, `request.response_time.distribution`, desde dos servidores web: `webserver:web_1` y `webserver:web_2`. Supongamos que en un intervalo de tiempo de flush dado, `webserver:web_1` reporta la métrica con los valores `[1,1,1,2,2,2,3,3]`, y `webserver:web_2` reporta la misma métrica con los valores `[1,1,2]`. Durante este intervalo de tiempo, las siguientes cinco agregaciones representarán la distribución estadística global de todos los valores recolectados de ambos servidores web:
-| Nombre de la métrica | Valor | Tipo dentro de la aplicación Datadog |
+| Nombre de la Métrica | Valor | Tipo en la Aplicación de Datadog |
| ------------------------------------------ | ------ | ------------------- |
| `avg:request.response_time.distribution` | `1.73` | GAUGE |
| `count:request.response_time.distribution` | `11` | COUNT |
@@ -202,97 +206,99 @@ Supongamos que estás enviando una métrica DISTRIBUTION, `request.response_time
| `min:request.response_time.distribution` | `1` | GAUGE |
| `sum:request.response_time.distribution` | `19` | COUNT |
-#### Cálculo de agregaciones de percentiles
+#### Cálculo de agregaciones percentiles {#calculation-of-percentile-aggregations}
-Al igual que otros tipos de métricas, como GAUGE or HISTOGRAM, el tipo de métrica DISTRIBUTION dispone de las siguientes agregaciones: `count` `min` , `max`, `sum` y `avg`. Las métricas de distribución se etiquetan inicialmente del mismo modo que las demás métricas (con etiquetas (tags) personalizadas definidas en el código).
+Al igual que otros tipos de métricas, como GAUGE o HISTOGRAM, el tipo de métrica DISTRIBUTION tiene las siguientes agregaciones disponibles: `count`, `min`, `max`, `sum`, y `avg`. Las métricas de DISTRIBUTION se etiquetan inicialmente de la misma manera que otras métricas (con etiquetas personalizadas establecidas en el código).
-Se pueden añadir agregaciones de percentiles adicionales (`p50`, `p75`, `p90`, `p95`, `p99`) a las métricas de distribución. Si se añadieran agregaciones de percentiles a tu métrica de distribución dentro de la aplicación, las siguientes cinco agregaciones adicionales estarían disponibles para consultas:
+Se pueden agregar agregaciones percentiles adicionales (`p50`, `p75`, `p90`, `p95`, `p99`) a las métricas de DISTRIBUTION desde el [panel lateral de detalles de la métrica][2]. Si se agregaran agregaciones percentiles a su métrica de DISTRIBUTION en la aplicación, las siguientes cinco agregaciones adicionales están disponibles para consulta:
-| Nombre de la métrica | Valor | Tipo dentro de la aplicación Datadog |
+| Nombre de la métrica | Valor | Tipo en la aplicación de Datadog |
| ---------------------------------------- | ----- | ------------------- |
| `p50:request.response_time.distribution` | `2` | GAUGE |
| `p75:request.response_time.distribution` | `2` | GAUGE |
| `p90:request.response_time.distribution` | `3` | GAUGE |
| `p95:request.response_time.distribution` | `3` | GAUGE |
-| `p99:request.response_time.distribution` | `3` | gauge |
+| `p99:request.response_time.distribution` | `3` | GAUGE |
-Es decir, para una métrica de distribución con agregaciones de percentiles añadidos durante un intervalo de tiempo determinado, están disponibles las 10 agregaciones siguientes: `count`, `sum`, `min`, `max`, `avg`, `p50`, `p75`, `p90`, `p95` y `p99`.
+Es decir, para una métrica de DISTRIBUTION con agregaciones percentiles añadidas durante un intervalo de tiempo dado, las siguientes 10 agregaciones están disponibles: `count`, `sum`, `min`, `max`, `avg`, `p50`, `p75`, `p90`, `p95`, y `p99`.
-#### Personalización del etiquetado
+**Nota**: Mientras que las diferentes agregaciones de los valores de la métrica DISTRIBUTION se _representan_ como GAUGE o COUNT en la aplicación, la métrica en sí mantiene el tipo `DISTRIBUTION`.
-Esta funcionalidad te permite controlar el etiquetado de métricas donde la granularidad a nivel de host no es necesaria. Consulta más información sobre [Metrics without LimitsTM][1].
+#### Personalización de etiquetas {#customization-of-tagging}
-**Nota**: La exclusión de etiquetas con `!` no se admite con esta función.
+Esta funcionalidad le permite controlar la etiquetación para métricas donde la granularidad a nivel de servidor no es necesaria. Aprenda más sobre [Metrics without Limits™][1].
+**Nota**: La exclusión de etiquetas no es compatible con la personalización de etiquetas basada en la lista permitida. No se aceptan etiquetas que comiencen con `!`.
[1]: /es/metrics/metrics-without-limits/
+[2]: /es/metrics/summary/#metric-details-sidepanel
{{% /tab %}}
{{< /tabs >}}
-### Envío
+### Envío {#submission}
{{< tabs >}}
{{% tab "COUNT" %}}
-Envía tu tipo de métrica COUNT de una de las siguientes fuentes:
+Envía tus métricas de tipo COUNT desde una de las siguientes fuentes:
-| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipo dentro de la aplicación Datadog |
+| Fuente de Envío | Método de Envío (python) | Tipo de Envío | Tipo en la Aplicación de Datadog |
| ----------------- | ------------------------------------ | --------------- | ------------------- |
-| [Check del Agent][1] | `self.count(...)` | COUNT | COUNT |
-| [Check del Agent][2] | `self.monotonic_count(...)` | COUNT | COUNT |
+| [Verificación de Agente][1] | `self.count(...)` | COUNT | COUNT |
+| [Verificación de Agente][2] | `self.monotonic_count(...)` | COUNT | COUNT |
| [API][3] | `api.Metric.send(type="count", ...)` | COUNT | COUNT |
| [DogStatsD][4] | `dog.count(...)` | COUNT | RATE |
| [DogStatsD][4] | `dog.increment(...)` | COUNT | RATE |
| [DogStatsD][4] | `dog.decrement(...)` | COUNT | RATE |
-**Nota**: Cuando se envía un tipo de métrica COUNT a través de DogStatsD, la métrica aparece como RATE dentro de la aplicación para asegurar una comparación relevante a través de diferentes Agents. Consecuentemente, los recuentos de StatsD pueden aparecer con un valor decimal en Datadog (ya que están normalizados dentro de un intervalo de tiempo para reportar unidades por segundo).
+**Nota**: Al enviar un tipo de métrica COUNT a través de DogStatsD, la métrica aparece como RATE en la aplicación para asegurar una comparación relevante entre diferentes Agentes. Consecuentemente, los conteos de StatsD pueden aparecer con un valor decimal dentro de Datadog (ya que están normalizados sobre un intervalo de tiempo para reportar unidades por segundo).
[1]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=count#count
[2]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=count#monotonic-count
-[3]: /es/api/v1/metrics/#submit-metrics
+[3]: /es/api/latest/metrics/#submit-metrics
[4]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#count
{{% /tab %}}
{{% tab "RATE" %}}
-Envía tu tipo de métrica RATE de una de las siguientes fuentes:
+Envía tus métricas de tipo RATE desde una de las siguientes fuentes:
-| Fuente de envío | Método de envío (Python) | Tipo de presentación | Tipo dentro de la aplicación Datadog |
+| Fuente de Envío | Método de Envío (python) | Tipo de Envío | Tipo en la Aplicación de Datadog |
| ----------------- | ----------------------------------- | --------------- | ------------------- |
-| [Check del Agent][1] | `self.rate(...)` | RATE | GAUGE |
+| [Verificación de Agente][1] | `self.rate(...)` | RATE | GAUGE |
| [API][2] | `api.Metric.send(type="rate", ...)` | RATE | RATE |
-**Nota**: Al enviar un tipo de métrica RATE a través de DogStatsD, la métrica aparece como GAUGE dentro de la aplicación para garantizar una comparación pertinente entre diferentes Agents.
+**Nota**: Para obtener métricas de RATE a través de DogStatsD, envíe ya sea una métrica de [COUNT][16] o [HISTOGRAM][18]. Los valores de las métricas COUNT y los valores de `.count` son deltas normalizados en el tiempo del valor de la métrica durante el período de vaciado de StatsD.
[1]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=rate
-[2]: /es/api/v1/metrics/#submit-metrics
+[2]: /es/api/latest/metrics/#submit-metrics
{{% /tab %}}
{{% tab "GAUGE" %}}
-Envía tu tipo de métrica GAUGE de una de las siguientes fuentes:
+Envía tus métricas de tipo GAUGE desde una de las siguientes fuentes:
-| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipo dentro de la aplicación Datadog |
+| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipo en la aplicación de Datadog |
| ----------------- | ------------------------------------ | --------------- | ------------------- |
-| [Check del Agent][1] | `self.gauge(...)` | GAUGE | GAUGE |
+| [Verificación de agente][1] | `self.gauge(...)` | GAUGE | GAUGE |
| [API][2] | `api.Metric.send(type="gauge", ...)` | GAUGE | GAUGE |
| [DogStatsD][3] | `dog.gauge(...)` | GAUGE | GAUGE |
[1]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=gauge
-[2]: /es/api/v1/metrics/#submit-metrics
+[2]: /es/api/latest/metrics/#submit-metrics
[3]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#gauge
{{% /tab %}}
{{% tab "HISTOGRAM" %}}
-Envía tu tipo de métrica HISTOGRAM de una de las siguientes fuentes:
+Envía tus métricas de tipo HISTOGRAM desde una de las siguientes fuentes:
-| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipos dentro de la aplicación Datadog |
+| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipos en la aplicación de Datadog |
| ----------------- | -------------------------- | --------------- | -------------------- |
-| [Check del Agent][1] | `self.histogram(...)` | HISTOGRAM | GAUGE, RATE |
+| [Verificación de agente][1] | `self.histogram(...)` | HISTOGRAM | GAUGE, RATE |
| [DogStatsD][2] | `dog.histogram(...)` | HISTOGRAM | GAUGE, RATE |
-Enviar una métrica TIMER al Datadog Agent equivale a enviar un tipo de métrica HISTOGRAM en DogStatsD (no confundir con los temporizadores del StatsD estándar). El [`TIMER` de DogStatsD][3] representa sólo datos de duración. Por ejemplo, el tiempo que tarda en ejecutarse una sección de código o el tiempo que tarda en renderizarse completamente una página.
+Enviar una métrica de TIMER al Agente de Datadog es equivalente a enviar un tipo de métrica HISTOGRAM dentro de DogStatsD (no debe confundirse con temporizadores en el StatsD estándar). [DogStatsD `TIMER`][3] representa solo datos de duración. Por ejemplo, la cantidad de tiempo que toma ejecutar una sección de código o cuánto tiempo toma renderizar completamente una página.
[1]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=histogram
@@ -301,39 +307,45 @@ Enviar una métrica TIMER al Datadog Agent equivale a enviar un tipo de métrica
{{% /tab %}}
{{% tab "DISTRIBUTION" %}}
-Envía tu tipo de métrica DISTRIBUTION de una de las siguientes fuentes:
+Envía tus métricas de tipo DISTRIBUTION desde la siguiente fuente:
-| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipos dentro de la aplicación Datadog |
+| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipos en la aplicación de Datadog |
| ----------------- | -------------------------- | --------------- | -------------------- |
| [DogStatsD][1] | `dog.distribution(...)` | DISTRIBUTION | GAUGE, COUNT |
+| [API][2] | `api_instance.submit_distribution_points(...)` | DISTRIBUCIÓN | GAUGE, COUNT |
+**Nota**: Mientras que las diferentes agregaciones de los valores de la métrica de distribución se _representan_ como gauges o counts en la aplicación, la métrica en sí mantiene el tipo `DISTRIBUTION`.
[1]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#distribution
+[2]: /es/api/latest/metrics/#submit-distribution-points
{{% /tab %}}
{{< /tabs >}}
-## Tipos de envío y tipos dentro de la aplicación Datadog
+## Tipos de envío y tipos en la aplicación de Datadog {#submission-types-and-datadog-in-app-types}
-A continuación se muestra un resumen de todas las fuentes y los métodos de envío de métricas disponibles. Esta tabla muestra la correspondencia entre el tipo de envío de métrica correspondiente y los tipos dentro de la aplicación:
+A continuación se presenta un resumen de todas las fuentes y métodos de envío de métricas disponibles. Esta tabla muestra la correspondencia entre el tipo de envío de métricas correspondiente y los tipos en la aplicación:
-| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipos dentro de la aplicación Datadog |
+| Fuente de envío | Método de envío (Python) | Tipo de envío | Tipos en la aplicación de Datadog |
| ----------------- | ------------------------------------ | --------------- | -------------------- |
-| [Check del Agent][9] | `self.count(...)` | COUNT | COUNT |
-| [Check del Agent][10] | `self.monotonic_count(...)` | COUNT | COUNT |
-| [Check del Agent][11] | `self.gauge(...)` | GAUGE | GAUGE |
-| [Check del Agent][12] | `self.histogram(...)` | HISTOGRAM | GAUGE, RATE |
-| [Check del Agent][13] | `self.rate(...)` | RATE | GAUGE |
-| [API][7] | `api.Metric.send(type="count", ...)` | COUNT | COUNT |
+| [Agent check][9] | `self.count(...)` | CONTADOR | CONTADOR |
+| [Agent check][10] | `self.monotonic_count(...)` | CONTADOR | CONTADOR |
+| [Agent check][11] | `self.gauge(...)` | GAUGE | GAUGE |
+| [Agent check][12] | `self.histogram(...)` | HISTOGRAMA | GAUGE, TASA |
+| [Agent check][13] | `self.rate(...)` | TASA | GAUGE |
+| [API][7] | `api.Metric.send(type="count", ...)` | CONTADOR | CONTADOR |
| [API][7] | `api.Metric.send(type="gauge", ...)` | GAUGE | GAUGE |
-| [API][7] | `api.Metric.send(type="rate", ...)` | RATE | RATE |
+| [API][7] | `api.Metric.send(type="rate", ...)` | TASA | TASA |
| [DogStatsD][14] | `dog.gauge(...)` | GAUGE | GAUGE |
-| [DogStatsD][15] | `dog.distribution(...)` | DISTRIBUCIÓN | GAUGE, COUNT |
-| [DogStatsD][16] | `dog.count(...)` | COUNT | RATE |
-| [DogStatsD][16] | `dog.increment(...)` | COUNT | RATE |
-| [DogStatsD][16] | `dog.decrement(...)` | COUNT | RATE |
-| [DogStatsD][17] | `dog.set(...)` | SET (Conjunto) | GAUGE |
-| [DogStatsD][18] | `dog.histogram(...)` | HISTOGRAM | gaugeTARIFA |
-## Lectura adicional
+| [DogStatsD][15] | `dog.distribution(...)` | DISTRIBUCIÓN | DISTRIBUCIÓN |
+| [DogStatsD][16] | `dog.count(...)` | CONTADOR | TASA |
+| [DogStatsD][16] | `dog.increment(...)` | CONTADOR | TASA |
+| [DogStatsD][16] | `dog.decrement(...)` | CONTADOR | TASA |
+| [DogStatsD][17] | `dog.set(...)` | SET | GAUGE |
+| [DogStatsD][18] | `dog.histogram(...)` | HISTOGRAMA | GAUGE, TASA |
+
+**Nota**: Mientras que las diferentes agregaciones de los valores de la métrica de distribución se _representan_ como GAUGE o CONTADOR en la aplicación, la métrica en sí mantiene el tipo `DISTRIBUTION`. Consulte la sección de [Definiciones][19] de esta página para más información.
+
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -343,8 +355,8 @@ A continuación se muestra un resumen de todas las fuentes y los métodos de env
[4]: https://statsd.readthedocs.io/en/v3.3/types.html#sets
[5]: /es/metrics/custom_metrics/agent_metrics_submission/
[6]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/
-[7]: /es/api/v1/metrics/#submit-metrics
-[8]: /es/developers/dogstatsd/#how-it-works
+[7]: /es/api/latest/metrics/#submit-metrics
+[8]: /es/extend/dogstatsd/#how-it-works
[9]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=count#count
[10]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=count#monotonic-count
[11]: /es/metrics/custom_metrics/agent_metrics_submission/?tab=gauge
@@ -354,4 +366,5 @@ A continuación se muestra un resumen de todas las fuentes y los métodos de env
[15]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#distribution
[16]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#count
[17]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#set
-[18]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#histogram
\ No newline at end of file
+[18]: /es/metrics/custom_metrics/dogstatsd_metrics_submission/#histogram
+[19]: /es/metrics/types/?tab=distribution#definition
\ No newline at end of file
diff --git a/content/es/monitors/notify/_index.md b/content/es/monitors/notify/_index.md
index 508f40fafd2..d9900f0a0fb 100644
--- a/content/es/monitors/notify/_index.md
+++ b/content/es/monitors/notify/_index.md
@@ -4,40 +4,47 @@ aliases:
- /es/monitors/faq/how-do-i-setup-conditional-contacts-and-messages-in-a-single-monitor
- /es/developers/faq/what-do-notifications-do-in-datadog
- /es/monitors/notifications/
-description: Enviar notificaciones a tus equipos cuando los monitores activan alertas
+description: Envía notificaciones a tus equipos cuando los seguimientos generen alertas.
further_reading:
- link: /monitors/
tag: Documentación
- text: Crear Monitors
+ text: Crea seguimientos
- link: /monitors/manage/
tag: Documentación
- text: Gestionar los monitores
+ text: Administra seguimientos
- link: https://learn.datadoghq.com/courses/alert-monitor-notifications
- tag: Centro de aprendizaje
- text: Realiza un curso para personalizar las notificaciones de monitor de alertas
+ tag: Centro de Aprendizaje
+ text: Toma un curso para personalizar las notificaciones de los seguimientos de
+ alerta
- link: https://www.datadoghq.com/blog/monitor-notification-rules/
tag: Blog
- text: Dirigir tus alertas de monitor con las reglas de notificación de monitor de
- Datadog
+ text: Dirige tus alertas de seguimiento con las reglas de notificación de seguimientos
+ de Datadog
title: Notificaciones
---
+## Resumen {#overview}
-## Información general
+Las notificaciones son un componente clave de los seguimientos que mantienen a tu equipo informado sobre problemas y apoyan la resolución de problemas. Al [crear tu seguimiento][1], configura tu respuesta a:
+- Elabora un mensaje que se pueda accionar.
+- Activa un flujo de trabajo o crea un flujo de trabajo a partir de un seguimiento.
+- [Crea una incidencia automáticamente][2].
+- Crea un incidente automáticamente.
-Las notificaciones son un componente clave de los monitores, que mantienen a tu equipo informado de los problemas y ayudan a solucionarlos. Al [crear tu monitor][1], configura tu respuesta para:
-- Crear un mensaje procesable.
-- Activa un flujo de trabajo o crea un flujo de trabajo a partir de un monitor.
-- [Crear automáticamente un incidente][2].
-- Crear automáticamente un incidente.
+## Construyendo títulos y mensajes efectivos {#constructing-effective-titles-and-messages}
-## Crear títulos y mensajes eficaces
+Este enfoque ayuda a garantizar que los títulos y mensajes de tu seguimiento sean claros, accionables y adaptados a las necesidades de tu audiencia.
+- **Títulos únicos**: Agrega un título único a tu seguimiento (esto es obligatorio). Para seguimientos de múltiples alertas, se insertan automáticamente algunas etiquetas que identifican su contexto de activación. Puede usar [variables de etiqueta][3] para mejorar la especificidad.
+- **Campo de mensaje**: El campo de mensaje admite el formato estándar de [Markdown][4] y [variables][5]. Utilice [variables condicionales][6] para modular el texto de notificación enviado a diferentes contactos con [@notifications](#notifications). Utilice [variables de plantilla sintéticas][23] para enriquecer el mensaje de alerta con el contexto de fallos sintéticos.
-Este enfoque ayuda a garantizar que los títulos y mensajes de monitor sean claros, prácticos y adaptados a las necesidades de tu público.
-- **Títulos exclusivos**: Añade un título único a tu monitor (obligatorio). Para los monitores de alertas múltiples, se insertan automáticamente algunas etiquetas (tags) que identifican tu contexto de activación. Puedes utilizar [variables de etiqueta][3] para mejorar la especificidad.
-- **Campo de mensaje**: El campo de mensaje admite el [formato Markdown][4] y [variables][5] estándar. Utiliza [variables condicionales][6] para modular el texto de notificación enviado a diferentes contactos con [@notificaciones](#notifications).
+
El soporte para el formato Markdown varía según el método de notificación. Algunos canales solo admiten un subconjunto de la sintaxis de Markdown.
+
+## Notificaciones de Slack: Admiten formato básico (negrita, cursiva, código en línea, enlaces). Los encabezados de Markdown (por ejemplo, #, ) y las tablas no se renderizan; aparecen como texto plano.
+ Notificaciones por correo electrónico: Admiten formato básico (negrita, cursiva, código en línea, enlaces). Las tablas no se renderizan como tablas de Markdown y aparecen como texto plano en el cuerpo del mensaje.
+
+
-{{% collapse-content title="Ejemplo de mensaje monitor" level="h4" expanded=false %}}
-Un caso de uso frecuente de un mensaje de monitor consiste en incluir una forma de resolver el problema paso a paso, por ejemplo:
+{{% collapse-content title="Ejemplo de mensaje de seguimiento" level="h4" expanded=false %}}
+Un caso de uso común para el mensaje de seguimiento es incluir una forma paso a paso para resolver el problema, por ejemplo:
```text
{{#is_alert}} <-- conditional variable
@@ -58,111 +65,113 @@ Steps to free up disk space on {{host.name}}: <-- tag variable
{{% /collapse-content %}}
-## Destinatarios de notificaciones
-Datadog recomienda utilizar [reglas de notificación de monitor][22] para gestionar las notificaciones de monitores. Con las reglas de notificación puedes definir de forma automática qué destinatarios de notificaciones se añaden a un monitor, en función de una serie de condiciones predefinidas. Crea diferentes reglas para dirigir las alertas de monitor en función de las etiquetas de notificación de monitor, para no tener que configurar manualmente los destinatarios ni la lógica de enrutamiento de notificaciones para cada monitor individual.
+## Destinatarios de notificaciones {#notification-recipients}
+Datadog recomienda usar [reglas de notificación de seguimiento][22] para gestionar las notificaciones del seguimiento. Con las reglas de notificación, puedes automatizar qué destinatarios de notificación se añaden a un seguimiento basado en conjuntos de condiciones predefinidos. Crea diferentes reglas para dirigir las alertas del seguimiento según las etiquetas de la notificación del seguimiento, de modo que no tengas que configurar manualmente los destinatarios ni la lógica de enrutamiento de notificaciones para cada seguimiento individual.
-Tanto en las reglas de notificación como en los monitores individuales, puedes utilizar una`@notification` para añadir un miembro del equipo, una integración, un flujo de trabajo o un caso a tu notificación. A medida que escribes, Datadog te recomienda automáticamente las opciones existentes en un menú desplegable. Haz clic en una opción para añadirla a tu notificación. También puedes hacer clic en **@ Add Mention**, **Add Workflow** o **Add Case** (@ Añadir mención, Añadir flujo de trabajo o **Añadir caso).
+Tanto en las reglas de notificación como en los seguimientos individuales, puedes usar un `@notification` para añadir a un miembro del equipo, integración, flujo de trabajo o incidencia a tu notificación. A medida que escribes, Datadog recomienda automáticamente opciones existentes en un menú desplegable. Haz clic en una opción para añadirla a tu notificación. Alternativamente, haz clic en **@ Añadir Mención**, **Añadir Flujo de Trabajo**, o **Añadir Caso**.
-Una @notificación debe tener un espacio entre ella y el último carácter de la línea:
+Una @notificación debe tener un espacio entre ella y el último carácter de línea:
-| 🟢 Formato correcto | ❌ Formato incorrecto |
+| Formato Correcto | Formato Incorrecto |
|------------------|-------------------|
| `Disk space is low @ops-team@company.com` | `Disk space is low@ops-team@company.com` |
-{{% collapse-content title="Correo electrónico" level="h4" expanded=false %}}
-{{% notifications-email %}}
+{{% collapse-content title="Integrations" level="h4" expanded=false %}}
+{{% notifications-integrations %}}
{{% /collapse-content %}}
{{% collapse-content title="Teams" level="h4" expanded=false %}}
-Si se configura un canal de notificación, puedes dirigir las notificaciones a un equipo específico. Las alertas de monitor dirigidas a @team-handle se redirigen al canal de comunicación seleccionado. Para obtener más información sobre cómo configurar un canal de notificación para tu equipo, consulta la documentación [Teams][7].
+{{% notifications-teams %}}
{{% /collapse-content %}}
-{{% collapse-content title="Integraciones" level="h4" expanded=false %}}
-
-{{% notifications-integrations %}}
+{{% collapse-content title="Incidencias" level="h4" expanded=false %}}
+{{% notifications-cases %}}
+{{% /collapse-content %}}
+{{% collapse-content title="Correo Electrónico" level="h4" expanded=false %}}
+{{% notifications-email %}}
{{% /collapse-content %}}
-### Edición en bloque de @-handles de monitor
-Datadog permite editar los destinatarios de los mensajes de alerta en varios monitores a la vez. Utiliza esta función para añadir, eliminar o sustituir eficazmente `@-handles` en el cuerpo del mensaje del monitor. Los casos de uso incluyen:
+###Edición masiva de manejadores de seguimiento @-{#bulk-editing-monitor-handles}
+Datadog admite la edición de destinatarios de mensajes de alerta en múltiples seguimientos a la vez. Utiliza esta función para añadir, eliminar o reemplazar eficientemente `@-handles` en el cuerpo del mensaje del seguimiento. Los casos de uso incluyen:
-- **Intercambiar un manejador**: Sustituye un identificador por otro en varios monitores. Por ejemplo, cambia `@pagerduty-sre` por `@oncall-sre`. También puedes cambiar un único identificador por varios identificadores, como por ejemplo sustituyendo `@pagerduty-sre` por `@pagerduty-sre` y `@oncall-sre`, para admitir la doble paginación o ampliar la cobertura de las alertas.
-- **Añadir un identificador**: Añade un nuevo destinatario sin eliminar los existentes. Por ejemplo, añade `@slack-infra-leads` a todos los monitores seleccionados.
-- **Eliminar un identificador**: Elimina un identificador específico de los mensajes de monitor. Por ejemplo, elimina `@webhook-my-legacy-event-intake`.
+- **Intercambiar un manejador**: Reemplazar un manejador por otro en múltiples seguimientos. Por ejemplo, cambia `@pagerduty-sre` a `@oncall-sre`. También puedes intercambiar un solo manejador por múltiples manejadores, como reemplazar `@pagerduty-sre` con `@pagerduty-sre` y `@oncall-sre`, para soportar la paginación dual o una cobertura de alertas ampliada.
+- **Agregar un manejador**: Agrega un nuevo destinatario sin eliminar los existentes. Por ejemplo, agrega `@slack-infra-leads` a todos los seguimientos seleccionados.
+- **Eliminar un manejador**: Elimina un manejador específico de los mensajes del seguimiento. Por ejemplo, elimina `@webhook-my-legacy-event-intake`.
-## Flujos de trabajo
-Puedes activar una [automatización de flujo de trabajo][8] o crear un nuevo flujo de trabajo a partir de un monitor.
+## Flujo de trabajo {#workflows}
+Puedes activar una [automatización de flujo de trabajo][8] o crear un nuevo flujo de trabajo desde un seguimiento.
-Antes de añadir un flujo de trabajo a un monitor, [añade un activador de monitor al flujo de trabajo][9].
+Antes de agregar un flujo de trabajo a un seguimiento, [agrega un disparador de seguimiento al flujo de trabajo][9].
-Después de añadir el activador de monitor, [añade un flujo de trabajo a tu monitor][10] o crea un nuevo flujo de trabajo. Para crear un nuevo flujo de trabajo a partir de la página de monitores:
+Después de agregar el disparador de seguimiento, [agrega un flujo de trabajo existente a tu seguimiento][10] o crea un nuevo flujo de trabajo. Para crear un nuevo flujo de trabajo desde la página de seguimientos:
-1. Haz clic en **Add Workflow** (Añadir flujo de trabajo).
-1. Haz clic en el icono **+** y selecciona un Blueprint (Proyecto), o selecciona **Start From Scratch** (Empezar desde cero).
- {{< img src="/monitors/notifications/create-workflow.png" alt="Haz clic en el botón + para añadir un nuevo flujo de trabajo" style="width:90%;">}}
+1. Haz clic en **Agregar flujo de trabajo**.
+1. Haz clic en el ícono **+** y selecciona un Plano, o selecciona **Comenzar Desde Cero**.
+ {{< img src="/monitors/notifications/create-workflow.png" alt="Haz clic en el botón + para agregar un nuevo flujo de trabajo" style="width:90%;">}}
-Para obtener más información sobre la creación de un flujo de trabajo, consulta [Crear flujos de trabajo][11].
+Para más información sobre cómo construir un flujo de trabajo, consulta [Construir flujo de trabajo][11].
-## Incidentes
-Los incidentes pueden crearse automáticamente a partir de un monitor cuando el monitor pasa a un estado `alert`, `warn` o `no data`. Haz clic en **Add Incident** (Añadir incidente) y selecciona una opción de `@incident (incidente)-`. Los administradores pueden crear opciones de `@incident (incidente)-` en [Configuración de incidentes][12].
+## Incidente {#incidents}
+Los incidentes pueden ser creados automáticamente desde un seguimiento cuando el seguimiento cambia a un estado de `alert`, `warn` o `no data`. Haz clic en **Agregar incidente** y selecciona una opción de `@incident-`. Los administradores pueden crear `@incident-` opciones en [Configuraciones de incidentes][12].
-Cuando se crea un incidente a partir de un monitor, los [valores de campo][13] del incidente se rellenan automáticamente en función de las etiquetas de monitor. Por ejemplo, si tu monitor tiene una etiqueta `service:payments`, el campo de servicio del incidente se definirá para "pagos". Para recibir notificaciones de estos incidentes, asegúrate de que las etiquetas de monitor coinciden con tus reglas de notificación de incidentes. **Nota**: Las reglas de notificación de incidentes se configuran por separado de las reglas de notificación de monitor y deben configurarse de forma independiente. Para obtener más información, consulta [Notificación de incidentes][14].
+Cuando se crea un incidente a partir de un seguimiento, los [valores de campo][13] del incidente se completan automáticamente según las etiquetas del seguimiento. Por ejemplo, si su seguimiento tiene una etiqueta `service:payments`, el campo de servicio del incidente se establecerá en "pagos". Para recibir notificaciones sobre estos incidentes, asegúrese de que las etiquetas del monitor se alineen con sus reglas de notificación de incidentes. **Nota**: Las reglas de notificación de incidentes se configuran por separado de las reglas de notificación de monitores y deben establecerse de manera independiente. Para más información, consulte [Notificación de Incidentes][14].
-## Alternar contenido adicional
+## Alternar contenido adicional {#toggle-additional-content}
-Las notificaciones del monitor incluyen contenidos como la consulta de monitor, las @-mentions utilizadas, las snapshots de métrica (para monitores de métrica) y enlaces a páginas relevantes en Datadog. Tienes la opción de elegir qué contenido deseas incluir o excluir de notificaciones para monitores individuales.
+Las notificaciones de monitores incluyen contenido como la consulta del monitor, las menciones @ utilizadas, instantáneas de métricas (para monitores de métricas) y enlaces de regreso a páginas relevantes en Datadog. Tiene la opción de elegir qué contenido le gustaría incluir o excluir de las notificaciones para monitor individuales.
-
Las métricas de distribución con agregadores de percentiles (como `p50`, `p75`, `p95` o `p99`) no generan un gráfico de snapshot en las notificaciones.
+
Las métricas de distribución con agregadores de percentiles (como `p50`, `p75`, `p95` o `p99`) no generan un gráfico de instantánea en las notificaciones.
-{{< img src="monitors/notifications/monitor_notification_presets.png" alt="Establecer una configuración previa de un monitor" style="width:70%;" >}}
+{{< img src="monitors/notifications/monitor_notification_presets.png" alt="Establecer un preajuste de monitor" style="width:70%;" >}}
Las opciones son:
-- **Por defecto**: no se oculta ningún contenido.
-- **Ocultar consulta**: elimina la consulta del monitor del mensaje de notificación.
-- **Ocultar identificadores**: eliminar las @-mentions que se utilizan en el mensaje de notificación.
-- **Ocultar todo**: el mensaje de notificación no incluye consultas, identificadores, snapshots (para monitores de métrica), ni enlaces adicionales en los pies de página.
+- **Predeterminado**: No se oculta contenido.
+- **Ocultar Consulta**: Eliminar la consulta del monitor del mensaje de notificación.
+- **Ocultar Menciones**: Eliminar las menciones @ que se utilizan en el mensaje de notificación.
+- **Ocultar Todo**: El mensaje de notificación no incluye consulta, menciones, ninguna instantánea (para monitores de métricas) o enlaces adicionales en los pies de página.
-**Nota**: Según la integración, es posible que algunos contenidos no se muestren por defecto.
+**Nota**: Dependiendo de la integración, es posible que algún contenido no se muestre de forma predeterminada.
-## Renotificación
+## Re-notificar {#renotify}
-Activa la renotificación (opcional) para recordar a tu equipo que un problema no está resuelto.
+Habilitar re-notificación de monitor (opcional) para recordar a su equipo que un problema no está resuelto.
- {{< img src="monitors/notifications/renotify_options.png" alt="Activar la renotificación" style="width:90%;" >}}
+ {{< img src="monitors/notifications/renotify_options.png" alt="Habilitar renotificación" style="width:90%;" >}}
-Configura el intervalo de renotificación, los estados del monitor desde los que el monitor vuelve a notificar (dentro de `alert`, `no data` y `warn`) y, opcionalmente, establece un límite al número de mensajes de renovación enviados.
+Configura el intervalo de renotificación, los estados del monitor desde los cuales el monitor renotifica (dentro de `alert`, `no data` y `warn`) y opcionalmente establece un límite al número de mensajes de renotificación enviados.
-Por ejemplo, configura el monitor para `stop renotifying after 1 occurrence`, para recibir un único mensaje de escalado después de la alerta principal.
-**Nota:** Las [variables de atributos y etiquetas][3] en la renotificación se rellenan con los datos disponibles para el monitor durante el periodo de tiempo de la renotificación.
+Por ejemplo, configura el monitor a `stop renotifying after 1 occurrence` para recibir un único mensaje de escalación después de la alerta principal.
+**Nota:** [Las variables de atributo y etiqueta][3] en la renotificación se completan con los datos disponibles para el monitor durante el período de tiempo de la renotificación.
-Si se activa la renotificación, se te da la opción de incluir un mensaje de escalada que se envía si el monitor permanece en uno de los estados elegidos durante el periodo especificado.
+Si la renotificación está habilitada, se te da la opción de incluir un mensaje de escalación que se envía si el monitor permanece en uno de los estados elegidos durante el período de tiempo especificado.
-El mensaje de escalada puede añadirse de las siguientes maneras:
+El mensaje de escalación se puede agregar de las siguientes maneras:
-* En el bloque `{{#is_renotify}}` del mensaje original de notificación (recomendado).
-* En el campo *Renotification message* (Mensaje de renotificación) de la sección `Configure notifications and automations`.
-* Con el atributo `escalation_message` de la API.
+* En el `{{#is_renotify}}` bloque en el mensaje de notificación original (recomendado).
+* En el campo *Mensaje de renotificación* en la sección `Configure notifications and automations`.
+* Con el atributo `escalation_message` en la API.
-Si utilizas el bloque `{{#is_renotify}}`, el mensaje original de notificación también se incluye en la nueva notificación, por lo tanto:
+Si utilizas el `{{#is_renotify}}` bloque, el mensaje de notificación original también se incluye en la renotificación, así que:
-1. Incluye solo detalles adicionales en el bloque `{{#is_renotify}}` y no repitas los detalles del mensaje original.
-2. Envía el mensaje de escalada a un subconjunto de grupos.
+1. Incluye solo detalles adicionales en el `{{#is_renotify}}` bloque y no repitas los detalles del mensaje original.
+2. Envía el mensaje de escalación a un subconjunto de grupos.
Aprende a configurar tus monitores para esos casos de uso en la [sección de ejemplos][15].
-## Metadatos
+## Metadatos {#metadata}
-Añade metadatos (Prioridad, Etiquetas, Equipo Datadog) a tu monitor. monitor. La prioridad de un monitor te permite definir la importancia de tu monitor a través del nivel P (P1 a P5). Las etiquetas de monitores, que son diferentes de las etiquetas de métricas, se utilizan en la interfaz de usuario para agrupar y buscar monitores. Si se configuran políticas de etiquetas, es necesario añadir las etiquetas y los valores de etiqueta necesarios. Para obtener más información, consulta [Políticas de etiquetas][16]. Datadog Teams te permite definir una capa de propiedad para este monitor y ver todos los monitores vinculados a tu equipo. Para obtener más información, consulta [Datadog Teams][17].
+Agrega metadatos (Prioridad, Etiquetas, Equipo de Datadog) a tu monitor. La prioridad del monitor te permite establecer la importancia de tu monitor a través del nivel P (P1 a P5). La etiqueta del monitor--que es diferente de las etiquetas de métrica--se utiliza en la interfaz de usuario para agrupar y buscar monitores. Si se configuran políticas de etiquetas, se deben agregar las etiquetas y los valores de etiqueta requeridos. Para aprender más, consulte [Políticas de Etiquetas][16]. Datadog Teams te permite establecer un nivel de propiedad para este monitor y ver todos los monitores vinculados a tu equipo. Para aprender más, consulta [Datadog Teams][17].
-{{< img src="monitors/notifications/notifications_metadata.png" alt="Ver una configuración de etiqueta de política. En 'Policy tags' (Etiquetas de política) hay tres ejemplos de etiquetas: cost_center, product_id y env, al lado del menú desplegable 'Select value' (Seleccionar valor)." style="width:100%;" >}}
+{{< img src="monitors/notifications/notifications_metadata.png" alt="Vista de la configuración de etiquetas de política. Debajo de 'Etiquetas de política' hay tres etiquetas de ejemplo: cost_center, product_id y env, junto a un menú desplegable de 'Seleccionar valor'." style="width:100%;" >}}
{{% collapse-content title="Prioridad" level="h4" expanded=false %}}
-Añade una prioridad (opcional) asociada a tus monitores. Los valores van de P1 a P5, siendo P1 la prioridad más alta y P5 la más baja.
-Para anular la prioridad del monitor en el mensaje de notificación, utiliza `{{override_priority 'Pi'}}` donde `Pi` está entre P1 y P5.
+Agrega una prioridad (opcional) asociada con tus monitores. Los valores varían de P1 a P5, siendo P1 la prioridad más alta y P5 la más baja.
+Para anular la prioridad del monitor en el mensaje de notificación, usa `{{override_priority 'Pi'}}` where `Pi` está entre P1 y P5.
-Por ejemplo, puedes establecer prioridades diferentes para notificaciones `alert` y `warning`:
+Por ejemplo, puedes establecer diferentes prioridades para `alert` y `warning` notificaciones:
```
{{#is_alert}}
@@ -177,35 +186,35 @@ Por ejemplo, puedes establecer prioridades diferentes para notificaciones `alert
{{% /collapse-content %}}
-## Agregación
+## Agregación {#aggregation}
-Si la consulta del monitor está agrupada, puedes eliminar una o más de las dimensiones de la agrupación de notificaciones, o eliminarlas todas y notificar como una Alerta simple.
+Si la consulta del monitor está agrupada, puedes eliminar una o más de las dimensiones de la agrupación de notificaciones, o eliminarlas todas y notificar como una alerta simple.
-{{< img src="monitors/notifications/notifications_aggregation.png" alt="Vista de configuración agregada establecida en multialerta." style="width:100%;" >}}
+{{< img src="monitors/notifications/notifications_aggregation.png" alt="Vista de la configuración de agregación establecida en multi-alerta." style="width:100%;" >}}
-Encontrarás más información sobre esta función en [Configurar monitores][18]
+Encuentra más información sobre esta función en [Configurar Monitores][18]
-## Notificaciones de test
+## Notificaciones de prueba {#test-notifications}
-Después de definir tu monitor, prueba las notificaciones con el botón **Test Notifications** (Notificaciones de test) situado en la parte inferior derecha de la página del monitor.
+Después de definir tu monitor, prueba las notificaciones con el botón **Notificaciones de Prueba** en la parte inferior derecha de la página del monitor.
-Se admiten notificaciones de tests para los siguientes [tipos de monitor][19]: hosts, métricas, anomalías, outliers, previsión, logs, rum, apm, integraciones (sólo check), procesos (sólo check), redes (sólo check), checks personalizados, eventos y compuestos.
+Las notificaciones de prueba son compatibles con los [tipos de monitores][19]: host, métrica, anomalía, valor anómalo, pronóstico, registros, rum, apm, integración (solo verificación), proceso (solo verificación), red (solo verificación), verificación personalizada, evento y composite.
-1. En la ventana emergente de notificaciones de tests, elige la transición de monitor a probar y el grupo (disponible sólo si la consulta tiene [agrupación][20]). Sólo puedes probar estados que estén disponibles en la configuración del monitor para ver los umbrales especificados en las condiciones de alerta. Los [umbrales de recuperación][21] son una excepción, ya que Datadog envía una notificación de recuperación una vez que el monitor deja de estar en alerta o no tiene condiciones de alerta.
+1. Desde la ventana emergente de notificaciones de prueba, elige la transición del monitor para probar y el grupo (disponible solo si la consulta tiene [agrupación][20]). Solo puedes probar los estados que están disponibles en la configuración del monitor para los umbrales especificados en las condiciones de alerta. Los [umbrales de recuperación][21] son una excepción, ya que Datadog envía una notificación de recuperación una vez que el monitor ya no está en alerta o no tiene condiciones de advertencia.
{{< img src="/monitors/notifications/test_notification_modal.png" alt="Prueba las notificaciones para este monitor" style="width:70%;" >}}
-1. Haz clic en **Run Test** (Ejecutar test) para enviar notificaciones a las personas y servicios que figuran en el monitor.
+1. Haz clic en **Ejecutar Prueba** para enviar notificaciones a las personas y servicios listados en el monitor.
-### Eventos
+### Eventos {#events}
-Las notificaciones de test producen eventos que se pueden buscar en el Event Explorer. Estas notificaciones indican quién inició el test en el cuerpo del mensaje con `[TEST]` en el título de la notificación.
+Las notificaciones de prueba producen eventos que pueden ser buscados dentro del explorador de eventos. Estas notificaciones indican quién inició la prueba en el cuerpo del mensaje con `[TEST]` en el título de la notificación.
-Las variables de etiqueta solo se rellenan en el texto de eventos secundarios de Datadog. El evento principal solo muestra un resumen de agregación.
+Las variables de etiqueta solo se completan en el texto de los eventos secundarios de Datadog. El evento principal solo muestra un resumen de agregación.
### Variables {#variables-test-notification}
-Las variables de mensaje se rellenan automáticamente con un grupo seleccionado aleatoriamente según la definición de contexto de tu monitor, por ejemplo:
+Las variables de mensaje se completan automáticamente con un grupo seleccionado aleatoriamente basado en el contexto de la definición de tu monitor, por ejemplo:
```text
{{#is_alert}}
@@ -213,24 +222,23 @@ Las variables de mensaje se rellenan automáticamente con un grupo seleccionado
{{/is_alert}}
```
-## Referencias adicionales
+## Lectura Adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
[1]: /es/monitors/configuration
-[2]: /es/service_management/case_management/create_case/#automatic-case-creation
+[2]: /es/incident_response/case_management/create_case/#automatic-case-creation
[3]: /es/monitors/notify/variables/?tabs=is_alert#attribute-and-tag-variables
[4]: http://daringfireball.net/projects/markdown/syntax
[5]: /es/monitors/notify/variables/
[6]: /es/monitors/notify/variables/#conditional-variables
-[7]: /es/account_management/teams/#send-notifications-to-a-specific-communication-channel
[8]: /es/service_management/workflows/
[9]: /es/service_management/workflows/trigger/#add-a-monitor-trigger-to-your-workflow
[10]: /es/service_management/workflows/trigger/#add-the-workflow-to-your-monitor
[11]: /es/service_management/workflows/build/
[12]: https://app.datadoghq.com/incidents/settings?section=global-settings
-[13]: /es/service_management/incident_management/incident_settings/property_fields
-[14]: /es/service_management/incident_management/notification
+[13]: /es/incident_response/incident_management/setup_and_configuration/property_fields
+[14]: /es/incident_response/incident_management/notification
[15]: /es/monitors/notify/variables/?tab=is_renotify#examples
[16]: /es/monitors/settings/#tag-policies
[17]: /es/account_management/teams/
@@ -238,4 +246,5 @@ Las variables de mensaje se rellenan automáticamente con un grupo seleccionado
[19]: /es/monitors/types
[20]: /es/monitors/configuration/
[21]: /es/monitors/guide/recovery-thresholds/
-[22]: /es/monitors/notify/notification_rules
\ No newline at end of file
+[22]: /es/monitors/notify/notification_rules
+[23]: /es/synthetics/notifications/template_variables/
\ No newline at end of file
diff --git a/content/es/monitors/notify/variables.md b/content/es/monitors/notify/variables.md
index d1d09b2728f..3430b0feee7 100644
--- a/content/es/monitors/notify/variables.md
+++ b/content/es/monitors/notify/variables.md
@@ -1,5 +1,5 @@
---
-description: Utiliza variables para personalizar tus notificaciones de monitor
+description: Utiliza variables para personalizar las notificaciones de tu seguimiento
further_reading:
- link: /monitors/guide/template-variable-evaluation/
tag: Guía
@@ -7,62 +7,61 @@ further_reading:
de plantilla
- link: /monitors/
tag: Documentación
- text: Crear monitores
+ text: Crea seguimientos
- link: /monitors/notify/
tag: Documentación
- text: Notificaciones de monitor
+ text: Notificaciones de seguimientos
- link: /monitors/manage/
tag: Documentación
- text: Gestionar los monitores
+ text: Gestiona seguimientos
- link: https://learn.datadoghq.com/courses/alert-monitor-notifications
- tag: Centro de aprendizaje
- text: Realiza un curso para personalizar las notificaciones del monitor de alertas
+ tag: Centro de Aprendizaje
+ text: Toma un curso para personalizar las notificaciones de seguimiento de alertas
- link: https://www.datadoghq.com/blog/monitor-notification-rules/
tag: Blog
- text: Dirige tus alertas de monitor con las reglas de notificación de monitor de
- Datadog
+ text: Dirige tus alertas de seguimiento con las reglas de notificación de seguimientos
+ de Datadog
title: Variables
---
+Utiliza variables en los mensajes de notificación para mostrar mensajes condicionales y dirigir la notificación a diferentes equipos utilizando [variables condicionales](#conditional-variables), o para enriquecer su contenido utilizando [variables de atributo y etiqueta](#attribute-and-tag-variables) y [variables de plantilla](#template-variables).
-Utiliza variables en los mensajes de notificación para mostrar mensajes condicionales y dirigir la notificación a diferentes equipos utilizando [variables condicionales](#conditional-variables), o para enriquecer tu contenido utilizando [variables de atributo y etiqueta (tag)](#attribute-and-tag-variables) y [variables de plantilla](#template-variables).
+## Variables condicionales {#conditional-variables}
-## Variables condicionales
+Las variables condicionales utilizan `if-else` lógica para mostrar un mensaje distinto según el estado del monitor y los detalles de cómo fue desencadenado. Estas variables pueden ser utilizadas dentro del asunto o cuerpo del mensaje de notificación.
-Las variables condicionales utilizan la lógica de `if-else` para mostrar un mensaje diferente dependiendo del estado del monitor y de los detalles de cómo se activó. Estas variables pueden utilizarse dentro del asunto o del cuerpo del mensaje de notificación.
+Las siguientes variables condicionales están disponibles:
-Están disponibles las siguientes variables condicionales:
-
-| Variable condicional | El texto se muestra si |
+| Variable Condicional | El texto se muestra si |
|----------------------------|--------------------------------------------------------------------|
-| `{{#is_alert}}` | El monitor alerta |
-| `{{^is_alert}}` | El monitor no alerta |
-| `{{#is_match}}` | El contexto coincide con la subcadena proporcionada. Si se utiliza un valor numérico, se convierte en una cadena.|
-| `{{^is_match}}` | El contexto no coincide con la subcadena proporcionada |
-| `{{#is_exact_match}}` | El contexto coincide exactamente con la cadena proporcionada. Si se utiliza un número, se considera el valor numérico, independientemente de su tipo. Esto significa que mientras dos números tengan el mismo valor, la función los considerará iguales. |
-| `{{^is_exact_match}}` | El contexto no coincide exactamente con la cadena proporcionada |
-| `{{#is_no_data}}` | El monitor se activa si faltan datos |
-| `{{^is_no_data}}` | El monitor no se activa si faltan datos |
-| `{{#is_warning}}` | El monitor advierte |
-| `{{^is_warning}}` | El monitor no advierte |
-| `{{#is_recovery}}` | El monitor se recupera de `ALERT`, `WARNING`, `UNKNOWN`, o `NO DATA` |
-| `{{^is_recovery}}` | El monitor no se recupera de `ALERT`, `WARNING`, `UNKNOWN`, o `NO DATA` |
-| `{{#is_warning_recovery}}` | El monitor se recupera de `WARNING` a `OK` |
-| `{{^is_warning_recovery}}` | El monitor no se recupera de `WARNING` a `OK` |
-| `{{#is_alert_recovery}}` | El monitor se recupera de `ALERT` a `OK` |
-| `{{^is_alert_recovery}}` | El monitor no se recupera de ALERT a OK |
-| `{{#is_alert_to_warning}}` | El monitor pasa de `ALERT` a `WARNING` |
-| `{{^is_alert_to_warning}}` | El monitor no pasa de `ALERT` a `WARNING` |
-| `{{#is_no_data_recovery}}` | El monitor se recupera de `NO DATA` |
-| `{{^is_no_data_recovery}}` | El monitor no se recupera de `NO DATA` |
-| `{{#is_priority 'value'}}` | El monitor tiene prioridad `value`. El valor oscila entre `P1` y `P5` |
-| `{{#is_unknown}}` | El monitor está en estado unknown |
-| `{{^is_unknown}}` | El monitor no está en estado unknown |
-| `{{#is_renotify}}` | El monitor hace renotificación |
-| `{{^is_renotify}}` | El monitor no hace renotificación |
-
-### Ejemplos
-
-Las variables condicionales deben tener un par de apertura y cierre con el texto y **@-notifications** en medio. Las variables basadas en el estado del monitor (como `is_alert` o `is_warning`) deben tener su propio bloque de mensajes. Dado que un monitor solo puede estar en un estado a la vez, no puedes combinarlos. Sin embargo, puedes anidar condicionales que coincidan en atributos, consulta los ejemplos de `is_renotify`.
+| `{{#is_alert}}` | The monitor alerts |
+| `{{^is_alert}}` | The monitor does not alert |
+| `{{#is_match}}` | The context matches the provided substring. If a numeric value is used, it is converted to a string.|
+| `{{^is_match}}` | The context does not match the provided substring |
+| `{{#is_exact_match}}` | The context exactly matches the provided string. If a number is used, the numeric value is considered, regardless of its type. This means that as long as two numbers have the same value, they are considered equal by the function. |
+| `{{^is_exact_match}}` | The context does not exactly match the provided string |
+| `{{#is_no_data}}` | The monitor is triggered for missing data |
+| `{{^is_no_data}}` | The monitor is not triggered for missing data |
+| `{{#is_warning}}` | The monitor warns |
+| `{{^is_warning}}` | The monitor does not warn |
+| `{{#is_recovery}}` | The monitor recovers from `ALERTA`, `ADVERTENCIA`, `DESCONOCIDO`, or `SIN DATOS` |
+| `{{^is_recovery}}` | The monitor does not recover from `ALERTA`, `ADVERTENCIA`, `DESCONOCIDO`, or `SIN DATOS` |
+| `{{#is_warning_recovery}}` | The monitor recovers from `ADVERTENCIA` to `OK` |
+| `{{^is_warning_recovery}}` | The monitor does not recover from `ADVERTENCIA` to `OK` |
+| `{{#is_alert_recovery}}` | The monitor recovers from `ALERTA` to `OK` |
+| `{{^is_alert_recovery}}` | The monitor does not recover from an ALERT to OK |
+| `{{#is_alert_to_warning}}` | The monitor transitions from `ALERTA` to `ADVERTENCIA` |
+| `{{^is_alert_to_warning}}` | The monitor does not transition from `ALERTA` to `ADVERTENCIA` |
+| `{{#is_no_data_recovery}}` | The monitor recovers from `SIN DATOS` |
+| `{{^is_no_data_recovery}}` | The monitor does not recover from `SIN DATOS` |
+| `{{#is_priority 'value'}}` | The monitor has priority `value`. Value ranges from `P1` to `P5` |
+| `{{#is_unknown}}` | The monitor is in the unknown state |
+| `{{^is_unknown}}` | The monitor is not in the unknown state |
+| `{{#is_renotify}}` | The monitor is renotifying |
+| `{{^is_renotify}}` | El monitor no está renotificando. |
+
+### Ejemplos {#examples}
+
+Las variables condicionales deben tener un par de apertura y cierre con el texto y **@-notificaciones** en medio. Las variables basadas en el estado del monitor (como `is_alert` o `is_warning`), deben tener su propio bloque de mensaje. Debido a que un monitor solo puede estar en un estado a la vez, no puedes combinar estos. Sin embargo, puedes anidar condicionales que coincidan con atributos, consulta los `is_renotify` ejemplos.
{{< tabs >}}
{{% tab "is_alert" %}}
@@ -89,7 +88,7 @@ Para enviar un mensaje de notificación cuando un monitor advierte, utiliza el f
{{% /tab %}}
{{% tab "is_recovery" %}}
-Para enviar un mensaje de notificación cuando se recupere un monitor, utiliza el formato:
+Para enviar un mensaje de notificación cuando un monitor se recupera, utiliza el formato:
```text
{{#is_recovery}}
@@ -108,7 +107,7 @@ Busca una subcadena en una [variable de etiqueta](#attribute-and-tag-variables)
{{/is_match}}
```
-Para notificar a tu equipo de base de datos si un host desencadenante tiene la etiqueta `role:db_cassandra` o `role:db_postgres`, utiliza lo siguiente:
+Para notificar a tu equipo de base de datos si un servidor desencadenante tiene la etiqueta `role:db_cassandra` o `role:db_postgres`, utiliza lo siguiente:
```text
{{#is_match "host.role.name" "db"}}
@@ -117,7 +116,7 @@ Para notificar a tu equipo de base de datos si un host desencadenante tiene la e
{{/is_match}}
```
-La condición `is_match` también permite unir varias cadenas:
+La `is_match` condición también admite la coincidencia de múltiples cadenas:
```text
{{#is_match "host.role.name" "db" "database"}}
@@ -126,7 +125,7 @@ La condición `is_match` también permite unir varias cadenas:
{{/is_match}}
```
-Para enviar una notificación diferente si la etiqueta no contiene `db`, utiliza la negación de la condición como se indica a continuación:
+Para enviar una notificación diferente si la etiqueta no contiene `db`, utiliza la negación de la condición de la siguiente manera:
```text
{{^is_match "host.role.name" "db"}}
@@ -135,7 +134,7 @@ Para enviar una notificación diferente si la etiqueta no contiene `db`, utiliza
{{/is_match}}
```
-O utiliza el parámetro `{{else}}` del primer ejemplo:
+O utiliza el `{{else}}` parámetro en el primer ejemplo:
```text
{{#is_match "host.role.name" "db"}}
@@ -146,7 +145,7 @@ O utiliza el parámetro `{{else}}` del primer ejemplo:
@slack-example
{{/is_match}}
```
-**Nota**: Para comprobar si uns `` no existe o si está vacía, utiliza `is_exact_match`. Consulta la pestaña `is_exact_match` para más detalles.
+**Nota**: Para verificar si un `` no existe o si está vacío, utiliza `is_exact_match`. Consulta la pestaña `is_exact_match` para más detalles.
{{% /tab %}}
{{% tab "is_exact_match" %}}
@@ -159,7 +158,7 @@ Busca una cadena exacta en una [variable de etiqueta](#attribute-and-tag-variabl
{{/is_exact_match}}
```
-Para notificar a tu equipo de desarrollo si un host desencadenante tiene el nombre `production`, utiliza lo siguiente:
+Para notificar a tu equipo de desarrollo si un servidor desencadenante tiene el nombre `production`, utiliza lo siguiente:
```text
{{#is_exact_match "host.name" "production"}}
@@ -168,7 +167,7 @@ Para notificar a tu equipo de desarrollo si un host desencadenante tiene el nomb
{{/is_exact_match}}
```
-La condición `is_exact_match` también permite buscar varias cadenas:
+La `is_exact_match` condición también admite la coincidencia de múltiples cadenas:
```text
{{#is_exact_match "host.name" "production" "staging"}}
@@ -177,7 +176,7 @@ La condición `is_exact_match` también permite buscar varias cadenas:
{{/is_exact_match}}
```
-La variable condicional `is_exact_match` también admite [variables de plantilla `{{value}}`](#template-variables):
+La `is_exact_match` variable condicional también admite [`{{value}}` variables de plantilla](#template-variables):
```text
{{#is_exact_match "value" ""}}
@@ -185,7 +184,7 @@ La variable condicional `is_exact_match` también admite [variables de plantilla
{{/is_exact_match}}
```
-Para notificar a tu equipo de desarrollo si el valor que ha superado el umbral de tu monitor es 5 (o 5,0), utiliza lo siguiente:
+Para notificar a tu equipo de desarrollo si el valor que superó el umbral de tu monitor es 5 (o 5.0), utiliza lo siguiente:
```text
{{#is_exact_match "value" "5"}}
@@ -193,7 +192,8 @@ Para notificar a tu equipo de desarrollo si el valor que ha superado el umbral d
{{/is_exact_match}}
```
-La variable condicional `is_exact_match` también admite una cadena vacía para que `` compruebe si el atributo o etiqueta está vacío o no existe.
+La `is_exact_match` variable condicional también admite una cadena vacía para el `` para verificar si el atributo o etiqueta está vacío o no existe.
+
```text
{{#is_exact_match "host.datacenter" ""}}
This displays if the attribute or tag does not exist or if it's empty
@@ -204,87 +204,87 @@ La variable condicional `is_exact_match` también admite una cadena vacía para
{{% /tab %}}
{{% tab "is_renotify" %}}
-Para enviar un mensaje de escalada a un destino diferente solo para el entorno `production`:
+Para enviar un mensaje de escalación a un destino diferente solo para el entorno `production`:
```text
{{#is_renotify}}
{{#is_match "env" "production"}}
- Este es un mensaje de escalada enviado a @dev-team@company.com
+ This is an escalation message sent to @dev-team@company.com
{{/is_match}}
{{/is_renotify}}
```
-Para enviar un mensaje de escalada diferente que no contenga los detalles del mensaje original, utiliza una combinación de bloques `{{^is_renotify}}` y `{{#is_renotify}}`:
+Para enviar un mensaje de escalación diferente que no contenga los detalles del mensaje original, utiliza una combinación de `{{^is_renotify}}` and `{{#is_renotify}}` bloques:
```text
{{^is_renotify}}
-Este monitor alerta y envía un primer mensaje a @dev-team@company.com
+This monitor is alerting and sending a first message @dev-team@company.com
-Para resolver este monitor sigue los pasos:
+To solve this monitor follow the steps:
1. Go there
2. Do this
{{/is_renotify}}
-Esta parte es genérica y se envía para el primer desencadenante y el mensaje de escalada.
+This part is generic and sent both for the first trigger and the escalation message.
{{#is_renotify}}
- Este es el mensaje de escalada @dev-team@company.com
+ This is the escalation message @dev-team@company.com
{{/is_renotify}}
```
-En la renotificación del monitor, los usuarios recibirán el siguiente mensaje de escalada:
+En la renotificación del monitor, los usuarios recibirán el siguiente mensaje de escalación:
```
-Esta parte es genérica y se envía tanto para el primer desencadenante como para el mensaje de escalada.
+This part is generic and sent both for the first trigger and the escalation message.
-Este es el mensaje de escalada @dev-team@company.com
+This is the escalation message @dev-team@company.com
```
{{% /tab %}}
{{< /tabs >}}
-Si configura un bloque condicional para una transición de estado en condiciones `alert` o `warning` con un identificador **@-notifications**, Datadog recomienda que configures una condición `recovery` correspondiente para enviar una notificación de recuperación al identificador.
+Si configuras un bloque condicional para una transición de estado en las condiciones `alert` o `warning` con un manejador de **@-notifications**, Datadog recomienda que configures una condición correspondiente `recovery` para enviar una notificación de recuperación al manejador.
-**Nota**: Cualquier texto o identificador de notificación colocado **fuera** de las variables condicionales configuradas se invoca con cada transición de estado del monitor. Cualquier texto o identificador de notificación colocado **dentro** de las variables condicionales configuradas solo se invoca si la transición de estado del monitor coincide con su condición.
+**Nota**: Cualquier texto o manejador de notificación colocado **fuera** de las variables condicionales configuradas se invoca con cada transición de estado del monitor. Cualquier texto o manejador de notificación colocado **dentro** de las variables condicionales configuradas solo se invoca si la transición de estado del monitor coincide con su condición.
-## Variables de atributos y etiquetas
+## Variables de atributo y etiqueta {#attribute-and-tag-variables}
-Utiliza variables de atributos y etiquetas para mostrar mensajes de alerta personalizados, informativos y específicos que ayuden a comprender la naturaleza de la alerta. Consulta las siguientes secciones para ver ejemplos y casos de uso:
+Utiliza variables de atributo y etiqueta para renderizar mensajes de alerta que sean personalizados, informativos y específicos para ayudar a entender la naturaleza de la alerta. Consulta las siguientes secciones para ejemplos y casos de uso:
- [Variables de alerta múltiple](#multi-alert-variables)
- [Variables de atributo/etiqueta coincidentes](#matching-attributetag-variables)
Etiquetas
-: se adjuntan automáticamente (como nombre de host, nombre de contenedor, nombre de archivo de log y nombre de función sin servidor) o se añaden mediante etiquetas personalizadas (como equipo responsable, entorno, aplicación o versión).
+: Adjuntas automáticamente (como nombre de servidor, nombre de contenedor, nombre de archivo de registro y nombre de función sin servidor) o añadidas a través de etiquetas personalizadas (como equipo a cargo, entorno, aplicación o versión).
Atributos
-: basados en el contenido de log y analizados o añadidos mediante búsquedas en tablas de referencia (por ejemplo, geoip).
+: Basados en el contenido del registro y ya sea analizados o añadidos mediante búsquedas en tablas de referencia (por ejemplo, geoip).
-**Nota**: Si el monitor está configurado para recuperarse en condiciones sin datos (por ejemplo, cuando no hay eventos que coincidan con la consulta), el mensaje de recuperación no contiene datos. Para mantener la información en el mensaje de recuperación, agrupa por etiquetas adicionales, a las que se puede acceder mediante `{{tag.name}}`.
+**Nota**: Si el monitor está configurado para recuperarse en condiciones de sin datos (por ejemplo, cuando no hay eventos que coincidan con la consulta), el mensaje de recuperación no contiene ningún dato. Para persistir información en el mensaje de recuperación, agrupa por etiquetas adicionales, que son accesibles mediante `{{tag.name}}`.
-### Variables de alerta múltiple
+### Variables de alerta múltiple {#multi-alert-variables}
-Configura variables de multialertas en [monitores de multialertas][1] en función de la dimensión seleccionada en el cuadro de grupo de multialertas. Enriquece las notificaciones incluyendo dinámicamente en cada alerta el valor asociado a la dimensión agrupada.
+Configura las variables de alerta múltiple en [monitores de alerta múltiple][1] según la dimensión seleccionada en el cuadro de grupo de alerta múltiple. Enriquece las notificaciones incluyendo dinámicamente el valor asociado con la dimensión de agrupación en cada alerta.
-**Nota**: Cuando se utiliza el campo `group_by` en la agregación, las etiquetas y alertas adicionales del monitor pueden heredarse automáticamente. Esto significa que cualquier alerta o configuración establecida en el endpoint supervisado podría aplicarse a cada grupo resultante de la agregación.
+**Nota**: Cuando uses el campo `group_by` en la agregación, se pueden heredar automáticamente etiquetas y alertas adicionales del monitor. Esto significa que cualquier alerta o configuración establecida en el punto de conexión monitoreado podría aplicarse a cada grupo resultante de la agregación.
{{< tabs >}}
{{% tab "Agrupar por etiqueta" %}}
-Si una métrica está etiquetada con cualquier etiqueta en el formato `key:value` y la consulta de monitor está agrupada por esta etiqueta, utiliza la variable:
+Si una métrica está etiquetada con cualquier etiqueta en el formato `key:value` y la consulta del monitor está agrupada por esta etiqueta, usa la variable:
```
{{ key.name }}
```
-Esta variable inserta el `value` asociado al `key` en cada notificación de alerta. Por ejemplo, si tu monitor activa una alerta para cada `env`, entonces la variable `{{env.name}}` está disponible en tu mensaje de notificación.
+Esta variable inserta el `value` asociado con el `key` en cada notificación de alerta. Por ejemplo, si tu monitor activa una alerta para cada `env`, entonces la variable `{{env.name}}` está disponible en tu mensaje de notificación.
-Si un grupo tiene varios `values` asociados a la misma `key`, el mensaje de alerta muestra una cadena separada por comas de todos los valores, en orden lexicográfico.
+Si un grupo tiene múltiples `values` asociados con el mismo `key`, el mensaje de alerta muestra una cadena de todos los valores separados por comas, en orden lexicográfico.
-#### Clave de etiqueta con punto
+#### Clave de etiqueta con punto {#tag-key-with-period}
-Si la clave de tu etiqueta contiene un punto, pon entre paréntesis la clave completa cuando utilices una variable de etiqueta. Por ejemplo, si tu etiqueta es `dot.key.test:five` y tu monitor está agrupado por `dot.key.test`, utiliza:
+Si la clave de tu etiqueta tiene un punto, incluye corchetes alrededor de la clave completa al usar una variable de etiqueta. Por ejemplo, si tu etiqueta es `dot.key.test:five` y tu monitor está agrupado por `dot.key.test`, usa:
```text
{{[dot.key.test].name}}
@@ -294,19 +294,19 @@ Si la clave de tu etiqueta contiene un punto, pon entre paréntesis la clave com
{{% tab "Agrupar por faceta" %}}
-Monitores de logs, monitores de Trace Analytics, monitores RUM y monitores de eventos pueden usar facetas como variables si el monitor está agrupado por facetas. Si un monitor de log está agrupado por `@facet_key`, utiliza la variable:
+Los monitores de registro, los monitores de Trace Analytics, los monitores de RUM y los monitores de eventos pueden usar facetas como variables si el monitor está agrupado por faceta. Si un monitor de registro está agrupado por `@facet_key`, usa la variable:
```text
{{ @facet_key.name }}
```
-**Ejemplo**: Para incluir información específica de un grupo en un monitor de log de alerta múltiple agrupado por `@machine_id`:
+**Ejemplo**: Para incluir información específica del grupo en un monitor de registros de alertas múltiples group by `@machine_id`:
```text
-Esta alerta se activó en {{ @machine_id.name }}
+This alert was triggered on {{ @machine_id.name }}
```
-Si tu faceta tiene puntos, utiliza corchetes alrededor de la faceta, por ejemplo:
+Si su faceta tiene puntos, use corchetes alrededor de la faceta, por ejemplo:
```text
{{ [@network.client.ip].name }}
@@ -315,24 +315,24 @@ Si tu faceta tiene puntos, utiliza corchetes alrededor de la faceta, por ejemplo
{{% /tab %}}
{{< /tabs >}}
-#### Personalización de las notificaciones en función del grupo
+#### Personalice la notificación según el grupo {#customize-the-notification-based-on-the-group}
-Cuando tu consulta está agrupada por dimensiones específicas, puedes mejorar las notificaciones con metadatos dinámicos asociados al grupo. Para ver una lista de variables de etiqueta basadas en tu selección de etiquetas, haz clic en **Use message template variables** (Utilizar variables de plantilla de mensaje) en la sección **Configure notifications & automations** (Configurar notificaciones y automatizaciones). Consulta los siguientes ejemplos:
+Cuando su consulta está agrupada por dimensiones específicas, puede enriquecer las notificaciones con metadatos dinámicos asociados con el grupo. Para ver una lista de variables de etiqueta según su selección de etiquetas, haga clic en **Usar variables de plantilla de mensaje** en la sección **Configurar notificaciones y automatizaciones**. Vea los siguientes ejemplos:
-{{% collapse-content title="Grupo de consulta por host" level="h5" %}}
+{{% collapse-content title="Consulta agrupada por servidor" level="h5" %}}
-Si tu monitor activa una alerta para cada `host`, entonces las variables de etiqueta `{{host.name}}` y `{{host.ip}}` están disponibles, así como cualquier etiqueta de host que esté disponible en este host.
+Si su monitor activa una alerta para cada `host`, entonces las variables de etiqueta `{{host.name}}` and `{{host.ip}}` están disponibles, así como cualquier etiqueta de servidor que esté disponible en este servidor.
-Variables de metadatos específicas de host:
+Variables de metadatos específicos del servidor:
-- Versión del Agent: `{{host.metadata_agent_version}}`
+- Versión del agente: `{{host.metadata_agent_version}}`
- Máquina: `{{host.metadata_machine}}`
- Plataforma: `{{host.metadata_platform}}`
- Procesador: `{{host.metadata_processor}}`
{{% /collapse-content %}}
-{{% collapse-content title="Grupo de consulta por kube_namespace y kube_cluster_name" level="h5" %}}
-Si tu monitor activa una alerta para cada `kube_namespace` y `kube_cluster_name`, entonces puedes acceder a cualquier atributo del espacio de nombres.
+{{% collapse-content title="Consulta agrupada por kube_namespace y kube_cluster_name" level="h5" %}}
+Si su monitor activa una alerta para cada `kube_namespace` y `kube_cluster_name`, entonces puede acceder a cualquier atributo del espacio de nombres.
Variables de metadatos del espacio de nombres:
@@ -343,13 +343,13 @@ Variables de metadatos del espacio de nombres:
La siguiente tabla contiene todos los atributos disponibles:
-| Sintaxis de la variable | Atributos de primer nivel |
+| Sintaxis de variable | Atributos de primer nivel |
|-------------------|------------------------|
| `{{kube_namespace.key}}` | `k8s_namespace_key`, `tags`, `annotations`, `cluster_id`, `cluster_name`, `creation_timestamp`, `deletion_timestamp`, `display_name`, `external_id`, `finalizers`, `first_seen_at`, `group_size`, `labels`, `name`, `namespace`, `status`, `uid`|
{{% /collapse-content %}}
-{{% collapse-content title="Grupo de consulta por pod_name y kube_namespace y kube_cluster_name" level="h5" %}}
-Si tu monitor activa una alerta para cada `pod_name` y `kube_namespace` y `kube_cluster_name`, entonces puedes acceder a cualquier atributo del pod.
+{{% collapse-content title="Consulta agrupada por pod_name y kube_namespace y kube_cluster_name" level="h5" %}}
+Si su monitor activa una alerta para cada `pod_name` y `kube_namespace` y `kube_cluster_name`, entonces puede acceder a cualquier atributo del pod.
Variables de metadatos del pod:
- Nombre del clúster: `{{pod_name.cluster_name}}`
@@ -358,51 +358,51 @@ Variables de metadatos del pod:
La siguiente tabla contiene todos los atributos disponibles:
-| Sintaxis de la variable | Atributos de primer nivel |
+| Sintaxis de variable | Atributos de primer nivel |
|-------------------|------------------------|
-| `{{pod_name.key}}` | `k8s_pod_key`, `tags`, `annotations`, `cluster_id`, `cluster_name`, `conditions`, `container_statuses`, `creation_timestamp`, `deletion_timestamp`, `display_name`, `external_id`, `finalizers`, `first_seen_at`, `host_id`, `host_key`, `hostname`, `init_container_statuses`, `ip`, `labels`, `name`, `namespace`, `node_name`, `nominated_node_name`, `phase`, `pod_scheduled_timestamp`, `priority_class_name`, `qosclass`, `resource_requirements`, `uid`|
+| `{{pod_name.key}}` | `k8s_pod_key`, `etiquetas`, `anotaciones`, `id_del_cluster`, `nombre_del_cluster`, `condiciones`, `estados_de_contenedor`, `marca_de_tiempo_de_creación`, `marca_de_tiempo_de_eliminación`, `nombre_de_visualización`, `id_externo`, `finalizadores`, `primera_vez_visto_en`, `tamaño_del_grupo`, `etiquetas`, `nombre`, `espacio_de_nombres`, `nombre_del_nodo`, `nombre_del_nodo_nominado`, `fase`, `marca_de_tiempo_de_programación_del_pod`, `nombre_de_clase_de_prioridad`, `clase_qos`, `requisitos_de_recursos`, `uid`|
{{% /collapse-content %}}
-{{% collapse-content title="Grupo de consulta por servicio" level="h5" %}}
+{{% collapse-content title="Consulta agrupada por servicio" level="h5" %}}
-Si tu monitor activa una alerta para cada `service`, entonces puedes acceder a algún atributo del servicio, tal y como se define en el [Software Catalog][10].
+Si su monitor activa una alerta para cada `service`, entonces puede acceder a algún atributo del servicio, como se define en el [Software Catalog][10].
-Variables de metadatos de servicio:
+Variables de metadatos del servicio:
- Nombre del servicio: `{{service.name}}`
- Nombre del equipo: `{{service.team}}`
- Documentos: `{{service.docs}}`
- Enlaces: `{{service.links}}`
-Para documentos y enlaces también puedes acceder a un elemento específico con la siguiente sintaxis `[]`. Por ejemplo, para los servicios que tienen un esquema de definición como el definido en este [ejemplo][11], puedes acceder al enlace "Runbook" utilizando la siguiente sintaxis
+Para Documentos y Enlaces también puede acceder a un elemento específico con la siguiente sintaxis `[]`. Por ejemplo, para servicios que tienen un esquema de definición como el definido en este [ejemplo][11], puede acceder al enlace "Runbook" utilizando la siguiente sintaxis
```text
{{service.links[Runbook]}}
```
{{% /collapse-content %}}
-### Unión de variables de atributo/etiqueta
+### Variables de atributo/etiqueta coincidentes {#matching-attributetag-variables}
-Puedes incluir cualquier atributo o etiqueta de un log, tramo de traza, evento RUM, CI pipeline, o evento de CI test que coincida con la consulta de monitor. La siguiente tabla muestra ejemplos de atributos y variables que puedes añadir de diferentes tipos de monitor.
+Puede incluir cualquier atributo o etiqueta de un registro, traza, evento RUM, canalización CI o evento de prueba CI que coincida con la consulta del monitor. La siguiente tabla muestra ejemplos de atributos y variables que puede agregar de diferentes tipos de monitores.
-
Para ver la lista completa de variables disponibles para tu monitor, en la parte inferior de la configuración de notificaciones, haz clic en Add Variable (Añadir variable) y selecciona una de las opciones del menú desplegado.
+
Para ver la lista completa de variables disponibles para su monitor, en la parte inferior de la configuración de notificación haga clic en {{ Agregue Variable y seleccione de las opciones del menú expandido.
-| Tipo de monitor | Sintaxis de la variable |
+| Tipo de monitor | Sintaxis de variable |
|--------------------------|--------------------------------------------------------|
-| [Audit Trail][16] | `{{audit.attributes.key}}` o `{{audit.message}}` |
+| [Audit Trail][16] | `{{audit.attributes.key}}` or `{{audit.message}}` |
| [CI Pipeline][17] | `{{cipipeline.attributes.key}}` |
| [CI Test][18] | `{{citest.attributes.key}}` |
| [Database Monitoring][19]| `{{databasemonitoring.attributes.key}}` |
| [Error Tracking][14] | `{{issue.attributes.key}}` |
-| [Log][12] | `{{log.attributes.key}}` o `{{log.tags.key}}` |
-| [RUM][15] | `{{rum.attributes.key}}` o `{{rum.tags.key}}` |
+| [Log][12] | `{{log.attributes.key}}` or `{{log.tags.key}}` |
+| [RUM][15] | `{{rum.attributes.key}}` or `{{rum.tags.key}}` |
| [Synthetic Monitoring][20]| `{{synthetics.attributes.key}}` |
-| [Trace Analytics][13] | `{{span.attributes.key}}` o `{{span.tags.key}}` |
+| [Trace Analytics][13] | `{{span.attributes.key}}` or `{{span.tags.key}}` |
{{% collapse-content title="Ejemplo de uso de sintaxis" level="h4" %}}
-- Para cualquier par `key:value`, la variable `{{log.tags.key}}` se convierte en `value` en el mensaje de alerta.
-- No se incluye el `@` que precede a todos los atributos. Por ejemplo, si un monitor de logs está agrupado por `@http.status_code`, puedes incluir el mensaje de error o las etiquetas de infraestructura en el mensaje de notificación utilizando las variables:
+- Para cualquier par `key:value`, la variable `{{log.tags.key}}` renders `valor` en el mensaje de alerta.
+- El `@` que precede a todos los atributos no está incluido. Por ejemplo, si un monitor de registros está agrupado por `@http.status_code`, puedes incluir el mensaje de error o las etiquetas de infraestructura en el mensaje de notificación utilizando las variables:
```text
{{ log.attributes.[error.message] }}
@@ -410,8 +410,8 @@ Puedes incluir cualquier atributo o etiqueta de un log, tramo de traza, evento R
...
```
- {{< img src="monitors/notifications/tag_attribute_variables.png" alt="Unir la sintaxis de variable de atributo" style="width:90%;">}}
-- El mensaje muestra el atributo `error.message` de un log elegido que coincide con la consulta, **si el atributo existe**.
+ {{< img src="monitors/notifications/tag_attribute_variables.png" alt="Sintaxis de variable de atributo coincidente" style="width:90%;">}}
+- El mensaje muestra el atributo `error.message` de un registro elegido que coincide con la consulta, **si el atributo existe**.
- Si la etiqueta está en un evento, utiliza la siguiente sintaxis:
```text
@@ -420,46 +420,46 @@ Puedes incluir cualquier atributo o etiqueta de un log, tramo de traza, evento R
{{% /collapse-content %}}
-#### Notas importantes
+#### Notas importantes {#important-notes}
-- Si el evento seleccionado no incluye la clave de atributo o etiqueta, la variable aparece vacía en el mensaje de notificación. Para evitar que se pierdan notificaciones, evita utilizar estas variables para enrutar notificaciones con indicadores `{{#is_match}}`.
-- Para los monitores que utilizan fórmulas y funciones en las consultas, los valores se resuelven en función de los eventos extraídos de la primera consulta.
+- Si el evento seleccionado no incluye el atributo o la clave de etiqueta, la variable se muestra vacía en el mensaje de notificación. Para evitar notificaciones perdidas, evita usar estas variables para enrutar notificaciones con `{{#is_match}}` manejadores.
+- Para monitores que utilizan Fórmulas y Funciones en consultas, los valores se resuelven en función de los eventos extraídos de la primera consulta.
-#### Atributos reservados
+#### Atributos reservados {#reserved-attributes}
-Los eventos de logs, Event Management, tramos, RUM, CI Pipeline y CI Test tienen atributos reservados genéricos, que puedes usar en variables con la siguiente sintaxis:
+Los registros, Event Management, spans, RUM, CI Pipeline y eventos de prueba CI tienen atributos reservados genéricos, que puedes usar en variables con la siguiente sintaxis:
-| Tipo de monitor | Sintaxis de la variable | Atributos de primer nivel |
+| Tipo de monitor | Sintaxis de variable | Atributos de primer nivel |
|-----------------|-------------------|------------------------|
-| Log | `{{log.key}}` | `message`, `service`, `status`, `source`, `span_id`, `timestamp`, `trace_id`, `link`, `host` |
-| Trace Analytics | `{{span.key}}` | `env`, `operation_name`, `resource_name`, `service`, `status`, `span_id`, `timestamp`, `trace_id`, `type`, `link` |
-| RUM | `{{rum.key}}` | `service`, `status`, `timestamp`, `link` |
-| Evento | `{{event.key}}` | `attributes`, `host.name`, `id`, `link`, `title`, `text`, `tags` |
-| CI Pipeline | `{{cipipeline.key}}` | `service`, `env`, `resource_name`, `ci_level`, `trace_id`, `span_id`, `pipeline_fingerprint`, `operation_name`, `ci_partial_array`, `status`, `timestamp`, `link` |
-| CI Test | `{{citest.key}}` | `service`, `env`, `resource_name`, `trace_id`, `span_id`, `operation_name`, `status`, `timestamp`, `link` |
+| Registro | `{{log.key}}` | `mensaje`, `servicio`, `estado`, `fuente`, `ID de tramo`, `marca de tiempo`, `ID de traza`, `enlace`, `servidor` |
+| Trace Analytics | `{{span.key}}` | `entorno`, `nombre de operación`, `nombre de recurso`, `servicio`, `estado`, `ID de tramo`, `marca de tiempo`, `ID de traza`, `tipo`, `enlace` |
+| RUM | `{{rum.key}}` | `servicio`, `estado`, `marca de tiempo`, `enlace` |
+| Event | `{{event.key}}` | `atributos`, `nombre.del.servidor`, `id`, `enlace`, `título`, `texto`, `etiquetas` |
+| CI Pipeline | `{{cipipeline.key}}` | `servicio`, `entorno`, `nombre de recurso`, `nivel_ci`, `ID de traza`, `ID de tramo`, `huella_dactilar_de_canalización`, `nombre de operación`, `arreglo_parcial_ci`, `estado`, `marca de tiempo`, `enlace` |
+| CI Test | `{{citest.key}}` | `servicio`, `entorno`, `nombre_de_recurso`, `id_de_traza`, `id_de_tramo`, `nombre_de_operación`, `estado`, `marca_de_tiempo`, `enlace` |
-Si el evento coincidente no contiene el atributo en su definición, la variable se muestra vacía.
+Si el evento coincidente no contiene el atributo en su definición, la variable se renderiza vacía.
-#### Enlace de explorador
+#### Enlace del explorador {#explorer-link}
-Utiliza `{{log.link}}`, `{{span.link}}`, `{{rum.link}}` y `{{issue.link}}` para fortalecer la notificación con un enlace a Log Explorer, Trace Explorer, RUM Explorer o Error Tracking, en el contexto de eventos que coincida con la consulta.
+Usar `{{log.link}}`, `{{span.link}}`, `{{rum.link}}`, and `{{issue.link}}` para enriquecer la notificación con un enlace al Explorador de Registros, Explorador de Trazas, Explorador RUM o Error Tracking, limitado a los eventos que coinciden con la consulta.
-### Comprobar variables de monitor
+### Verificar variables de monitor {#check-monitor-variables}
-Para comprobar las variables de monitor (check personalizado y check de integración), la variable `{{check_message}}` está disponible y muestra el mensaje especificado en el check personalizado o el check de integración.
+Para verificar variables de monitor (verificación personalizada y verificación de integración), la variable `{{check_message}}` está disponible y renderiza el mensaje especificado en la verificación personalizada o la verificación de integración.
-### Variables compuestas de monitor
+### Variables de monitor compuesto {#composite-monitor-variables}
-Los monitores compuestos pueden acceder al valor y al estado asociados a los submonitores en el momento en que se activa la alerta.
+Los monitores compuestos pueden acceder al valor y estado asociados con los sub-monitores en el momento en que se activa la alerta.
-Por ejemplo, si tu monitor compuesto tiene el submonitor `a`, puedes incluir el valor de `a` con:
+Por ejemplo, si tu monitor compuesto tiene un sub-monitor `a`, puedes incluir el valor de `a` con:
```text
{{ a.value }}
```
-Para recuperar el estado del submonitor `a`, utiliza:
+Para recuperar el estado del sub-monitor `a`, use:
```text
{{ a.status }}
@@ -467,46 +467,66 @@ Para recuperar el estado del submonitor `a`, utiliza:
Los valores posibles para el estado son: `OK`, `Alert`, `Warn` y `No Data`.
-Los monitores compuestos también admiten variables de etiqueta del mismo modo que sus monitores subyacentes. Siguen el mismo formato que otros monitores, siempre que los monitores subyacentes estén agrupados por la misma etiqueta o faceta.
+Los monitores compuestos también admiten variables de etiqueta de la misma manera que sus monitores subyacentes. Siguen el mismo formato que otros monitores, siempre que los monitores subyacentes estén agrupados por la misma etiqueta o faceta.
-Por ejemplo, supón que tu monitor compuesto tiene un submonitor `a` , que es un monitor de logs. Puedes incluir el valor de cualquier etiqueta o faceta de `a` con:
+Por ejemplo, suponga que su monitor compuesto tiene un sub-monitor `a`, que es un monitor de registros. Puede incluir el valor de cualquier etiqueta o faceta de `a` con:
```text
-{{ a.log.message }} o {{ a.log.my_facet }}
+{{ a.log.message }} or {{ a.log.my_facet }}
```
-### Fuga de caracteres
+### Escape de caracteres {#character-escape}
+
+El contenido variable está codificado en HTML por defecto. Para mostrar contenido sin codificar, use tres llaves en lugar de dos llaves.
+
+Por ejemplo, cuando el valor de una variable contiene una URL con parámetros de consulta, el `&` se trata de manera diferente dependiendo de si se utilizan llaves dobles o triples:
+
+| Sintaxis | Ejemplo de salida |
+--------|----------------|
+| `{{template_variable}}` (double braces) | `https://status.example.com/check?service=web®ion=us-east` |
+| `{{{template_variable}}}` (triple braces) | `https://status.example.com/check?service=web®ion=us-east` |
+
+| Sintaxis | Salida |
+|--------|--------|
+| `{{variable}}` | HTML-encoded (default) |
+| `{{{variable}}}` | Sin codificar |
+
+Por ejemplo, para mostrar el mensaje de verificación sin codificación HTML:
+
+```text
+{{{check_message}}}
+```
-El contenido de las variables se fuga por defecto. Para evitar que se fugue contenido como JSON o código, utiliza llaves triples en lugar de dobles, por ejemplo: `{{{event.text}}}`.
+Esto es particularmente relevante cuando `{{check_message}}` contains auto-generated URLs with query parameters (for example, on HTTP Check monitors). The `&` characters in those URLs are HTML-encoded by default, which can break clickable links in notifications. Use `{{{check_message}}}` para preservar las URL tal como están.
-## Variables de plantilla
+## Variables de plantilla {#template-variables}
-Utiliza variables de plantilla para personalizar tus notificaciones de monitor. Las variables incorporadas son:
+Utiliza variables de plantilla para personalizar las notificaciones de tu monitor. Las variables integradas son:
| Variable | Descripción |
|----------------------------------- |-------------------------------------------------------------------------------|
-| `{{value}}` | El valor que infringió la alerta para los monitores de consulta basados en métricas. |
-| `{{threshold}}` | El valor del umbral de alerta establecido en las condiciones de alerta del monitor. |
-| `{{warn_threshold}}` | Valor del umbral de advertencia establecido en las condiciones de alerta del monitor. |
-| `{{alert_recovery_threshold}}` | El valor que recuperó el monitor de su estado `ALERT`. |
-| `{{warn_recovery_threshold}}` | El valor que recuperó el monitor de su estado `WARN`. |
-| `{{ok_threshold}}` | El valor que recuperó el monitor del check de servicio. |
-| `{{comparator}}` | El valor relacional establecido en las condiciones de alerta del monitor. |
-| `{{first_triggered_at}}` *Consulta la sección siguiente* | La fecha y hora UTC en que se activó el monitor por primera vez. |
-| `{{first_triggered_at_epoch}}` *Consulta la sección siguiente* | La fecha y hora UTC en que el monitor se activó por primera vez en milisegundos epoch. |
-| `{{last_triggered_at}}` *Consulta la sección siguiente* | La fecha y hora UTC en que se activó el monitor por última vez. |
-| `{{last_triggered_at_epoch}}` *Consulta la sección siguiente* | La fecha y hora UTC en que el monitor se activó por última vez en milisegundos epoch. |
-| `{{triggered_duration_sec}}` | El número de segundos que el monitor ha estado en estado activado. |
+| `{{value}}` | The value that breached the alert for metric based query monitors. |
+| `{{threshold}}` | The value of the alert threshold set in the monitor's alert conditions. |
+| `{{warn_threshold}}` | The value of the warning threshold set in the monitor's alert conditions. |
+| `{{alert_recovery_threshold}}` | The value that recovered the monitor from its `ALERTA` state. |
+| `{{warn_recovery_threshold}}` | The value that recovered the monitor from its `ADVERTENCIA` state. |
+| `{{ok_threshold}}` | The value that recovered the Service Check monitor. |
+| `{{comparator}}` | The relational value set in the monitor's alert conditions. |
+| `{{first_triggered_at}}` *See section below* | The UTC date and time when the monitor first triggered. |
+| `{{first_triggered_at_epoch}}` *See section below* | The UTC date and time when the monitor first triggered in epoch milliseconds. |
+| `{{last_triggered_at}}` *See section below* | The UTC date and time when the monitor last triggered. |
+| `{{last_triggered_at_epoch}}` *See section below* | The UTC date and time when the monitor last triggered in epoch milliseconds. |
+| `{{triggered_duration_sec}}` | El número de segundos que el monitor ha estado en un estado activado. |
-### Variables activadas
+### Variables activadas {#triggered-variables}
-Las variables de plantilla de monitor `{{first_triggered_at}}`, `{{first_triggered_at_epoch}}`, `{{last_triggered_at}}` y `{{last_triggered_at_epoch}}` reflejan los valores cuando un monitor cambia de estado, **NO** cuando se produce un nuevo evento de monitor. Los eventos de renotificación muestran la misma variable de plantilla si el estado del monitor no ha cambiado. Utiliza `{{triggered_duration_sec}}` para mostrar la duración en el momento del evento del monitor.
+ El `{{first_triggered_at}}`, `{{first_triggered_at_epoch}}`, `{{last_triggered_at}}`, and `{{last_triggered_at_epoch}}` monitor template variables reflect the values when a monitor changes state, **NOT** when a new monitor event occurs. Renotification events show the same template variable if the monitor state has not changed. Use `{{triggered_duration_sec}}` para mostrar la duración en el momento del evento del monitor.
- `{{first_triggered_at}}` se establece cuando el grupo de monitor pasa de `OK` a un estado distinto de `OK` o cuando aparece un nuevo grupo en un estado distinto de `OK`. `{{last_triggered_at}}` se establece cuando el grupo de monitor pasa a un estado distinto de `OK` independientemente de su estado anterior (incluido `WARN` → `ALERT`, `ALERT` → `WARN`). Además, `{{last_triggered_at}}` se establece cuando un nuevo grupo aparece en un estado distinto a `OK`. La diferencia es que `{{last_triggered_at}}` es independiente de su estado anterior.
+ `{{first_triggered_at}}` is set when the monitor group goes from `OK` to a non-`OK` state or when a new group appears in a non-`OK` state. `{{last_triggered_at}}` gets set when the monitor group goes to a non-`OK` state independently from its previous state (including `ADVERTENCIA` → `ALERTA`, `ALERTA` → `ADVERTENCIA`). Additionally, `{{last_triggered_at}}` is set when a new group appears in a non-`OK` state. The difference is that `{{last_triggered_at}}` es independiente de su estado anterior.
- {{< img src="monitors/notifications/triggered_variables.png" alt="Muestra cuatro transiciones con marcas temporales A: 1419 OK a WARN, B: 1427 WARN a ALERT, C: 1445 ALERT a NO DATA, D: 1449 NO DATA a OK" style="width:90%;">}}
+ {{< img src="monitors/notifications/triggered_variables.png" alt="Mostrando cuatro transiciones con marcas de tiempo A: 1419 OK a ADVERTENCIA, B: 1427 ADVERTENCIA a ALERTA, C: 1445 ALERTA a SIN DATOS, D: 1449 SIN DATOS a OK" style="width:90%;">}}
-**Ejemplo**: Cuando el monitor pasa de `OK` → `WARN`, los valores de `{{first_triggered_at}}` y `{{last_triggered_at}}` tienen ambos la marca temporal A. La tabla siguiente muestra los valores hasta que el monitor se recupere.
+**Ejemplo**: Cuando el monitor transita de `OK` → `WARN`, los valores de `{{first_triggered_at}}` and `{{last_triggered_at}}` ambos tienen la marca de tiempo A. La tabla a continuación muestra los valores hasta que el monitor se recupera.
| Transición | first_triggered_at | last_triggered_at | triggered_duration_sec |
|------------------ |-------------------------------- |-------------------------------- |-------------------------------- |
@@ -515,43 +535,43 @@ Las variables de plantilla de monitor `{{first_triggered_at}}`, `{{first_trigger
| `ALERT` → `NO DATA`| A | C | C - A |
| `NO DATA` → `OK` | A | C | D - A |
-### Evaluación
+### Evaluación {#evaluation}
-Las variables de plantilla que devuelven valores numéricos admiten operaciones y funciones, que permiten realizar operaciones matemáticas o cambios de formato en el valor. Para más detalles, consulta [Evaluación de variables de plantilla][7].
+Las variables de plantilla que devuelven valores numéricos admiten operaciones y funciones, lo que te permite realizar operaciones matemáticas o cambios de formato en el valor. Para más detalles, consulta [Evaluación de Variables de Plantilla][7].
-### Hora local
+### Hora local {#local-time}
-Utiliza la función `local_time` para añadir otra fecha en tu notificación en la zona horaria de elección. Esta función transforma una fecha en su hora local: `{{local_time 'time_variable' 'timezone'}}`.
-Por ejemplo, para añadir la última hora activada del monitor en la zona horaria de Tokio en tu notificación, incluye lo siguiente en el mensaje de notificación:
+Utiliza la función `local_time` para agregar otra fecha en tu notificación en la zona horaria de tu elección. Esta función transforma una fecha en su hora local: `{{local_time 'time_variable' 'timezone'}}`.
+Por ejemplo, para agregar la última hora activada del monitor en la zona horaria de Tokio en tu notificación, incluye lo siguiente en el mensaje de notificación:
```
{{local_time 'last_triggered_at' 'Asia/Tokyo'}}
```
El resultado se muestra en el formato ISO 8601: `yyyy-MM-dd HH:mm:ss±HH:mm`, por ejemplo `2021-05-31 23:43:27+09:00`.
-Consulta la [lista de zonas horarias de la base de datos tz][8], en particular la columna de nombre de la base de datos TZ, para ver la lista de valores de zonas horarias disponibles.
+Consulta la [lista de zonas horarias de la base de datos tz][8], particularmente la columna de nombre de la base de datos TZ, para ver la lista de valores de zona horaria disponibles.
-## Avanzado
+## Avanzado {#advanced}
-### Identificadores dinámicos
+### Manejadores dinámicos {#dynamic-handles}
-Utiliza [variables de etiqueta](#attribute-and-tag-variables) para crear dinámicamente identificadores de notificación y notificaciones de ruta al equipo o servicio correcto basado en el tipo de problema detectado por tu monitor.
+Utiliza [variables de etiqueta](#attribute-and-tag-variables) para construir dinámicamente manejadores de notificación y dirigir notificaciones al equipo o servicio correcto según el tipo de problema detectado por tu monitor.
-**Ejemplo**: Si tu monitor consulta una métrica y la agrupa por una etiqueta de `service`, puedes hacer que tus notificaciones se enruten a diferentes canales de Slack según el servicio que falle:
+**Ejemplo**: Si tu monitor consulta una métrica y la agrupa por una etiqueta `service`, puedes hacer que tus notificaciones se dirijan a diferentes canales de Slack dependiendo del servicio que esté fallando:
```text
-@slack-{{service.name}} Hay un problema en curso con {{service.name}}.
+@slack-{{service.name}} There is an ongoing issue with {{service.name}}.
```
-Si tu monitor empieza a fallar en el grupo `service:ad-server`, la notificación se envía al canal de Slack `#ad-server` con el siguiente contenido:
+Si tu monitor comienza a fallar en el grupo `service:ad-server`, la notificación se envía al canal de Slack `#ad-server` con el siguiente contenido:
```text
-@slack-ad-server Hay un problema en curso con ad-server.
+@slack-ad-server There is an ongoing issue with ad-server.
```
-Cuando se crean indicadores dinámicos con atributos que pueden no estar siempre presentes, pueden surgir problemas con la entrega de notificaciones. Si falta un atributo, la variable se muestra vacía en el mensaje de notificación, lo que da lugar a un indicador no válido.
+Al construir manejadores dinámicos con atributos que pueden no estar siempre presentes, puedes encontrar problemas con la entrega de notificaciones. Si falta un atributo, la variable se renderiza vacía en el mensaje de notificación, lo que resulta en un manejador inválido.
-Para evitar notificaciones perdidas al usar identificadores dinámicos con estas variables, asegúrate de agregar un identificador alternativo:
+Para evitar notificaciones perdidas al usar manejadores dinámicos con estas variables, asegúrate de agregar un manejador de respaldo:
```text
{{#is_exact_match "kube_namespace.owner" ""}}
@@ -561,101 +581,101 @@ Para evitar notificaciones perdidas al usar identificadores dinámicos con estas
```
-### Enlaces dinámicos
+### Enlaces dinámicos {#dynamic-links}
-Utiliza [variables de etiqueta](#attribute-and-tag-variables) para permitir la creación de URL dinámicas que enlacen a tu equipo con un recurso apropiado. Por ejemplo, puedes proporcionar enlaces a páginas dentro de Datadog como dashboards, mapa de host y monitores.
+Utiliza [variables de etiqueta](#attribute-and-tag-variables) para habilitar la construcción dinámica de URL que vincule a tu equipo a un recurso apropiado. Por ejemplo, puedes proporcionar enlaces a páginas dentro de Datadog, como dashboards, el mapa de servidores y monitores.
{{< tabs >}}
{{% tab "Dashboards" %}}
-Utiliza la [variable de etiqueta](#attribute-and-tag-variables) `{{host.name}}` para proporcionar un enlace a un dashboard de sistema:
+Utiliza el `{{host.name}}` [variable de etiqueta](#attribute-and-tag-variables) para proporcionar un enlace a un dashboard del sistema:
```text
https://app.datadoghq.com/dash/integration/system_overview?tpl_var_scope=host:{{host.name}}
```
-Utiliza la [variable de etiqueta](#attribute-and-tag-variables) `{{host.name}}` y `` para proporcionar un enlace a un dashboard de integración:
+Utiliza el `{{host.name}}` [tag variable](#attribute-and-tag-variables) and an `` para proporcionar un enlace a un dashboard de integración:
```text
https://app.datadoghq.com/dash/integration/?tpl_var_scope=host:{{host.name}}
```
-Utiliza la [variable de plantilla] `{{last_triggered_at_epoch}}` así como `` y ``para vincular a dashboards con rangos temporales relativos desde el momento de la alerta:
+Utiliza el `{{last_triggered_at_epoch}}` [template variable](#template-variables) as well as a `` and `` para enlazar a dashboards con rangos de tiempo relativos desde el momento de la alerta:
```text
https://app.datadoghq.com/dashboard//?from_ts={{eval "last_triggered_at_epoch-10*60*1000"}}&to_ts={{eval "last_triggered_at_epoch+10*60*1000"}}&live=false
```
{{% /tab %}}
-{{% tab "Mapa de host" %}}
+{{% tab "Mapa de servidores" %}}
-Utiliza una [variable de etiqueta](#attribute-and-tag-variables) como `{{service.name}}` para proporcionar un enlace al mapa de host:
+Utiliza una [variable de etiqueta](#attribute-and-tag-variables) como `{{service.name}}` para proporcionar un enlace al mapa de servidores:
```text
https://app.datadoghq.com/infrastructure/map?filter=service:{{service.name}}
```
-El enlace del mapa de host se puede personalizar con parámetros adicionales. Los más comunes son:
+El enlace del mapa de servidores es personalizable con parámetros adicionales. Los más comunes son:
| Parámetro | Definido con | Determina |
|-----------|----------------------------|--------------------------------------|
-| `fillby` | `fillby=avg:` | El color de relleno de los hexágonos de host. |
-| `groupby` | `groupby=` | Los grupos para hexágonos de host. |
-| `sizeby` | `sizeby=avg:` | El tamaño de los hexágonos de host. |
+| `fillby` | `fillby=avg:` | El color de relleno de los hexágonos de los hosts. |
+| `groupby` | `groupby=` | Los grupos para los hexágonos de los hosts. |
+| `sizeby` | `sizeby=avg:` | El tamaño de los hexágonos de los hosts. |
{{% /tab %}}
-{{% tab "Monitores" %}}
+{{% tab "Seguimientos" %}}
-Utiliza la [variable de etiqueta](#attribute-and-tag-variables) `{{host.name}}` para proporcionar un enlace a todos los monitores relacionados con un host específico:
+Utiliza el `{{host.name}}` [variable de etiqueta](#attribute-and-tag-variables) para proporcionar un enlace a todos los seguimientos relacionados con un host específico:
```text
https://app.datadoghq.com/monitors/manage?q=scope:host:{{host.name}}
```
-El enlace de monitores se puede personalizar con parámetros adicionales. Los más comunes son:
+El enlace de seguimiento es personalizable con parámetros adicionales. Los más comunes son:
| Parámetro | Ejemplo | Muestra |
|-----------|----------------|---------------------------------------------------------------------------------|
-| `status` | `status:Alert` | Monitores en estado de alerta (estados adicionales: `WARN`, `NO DATA` y `OK`) |
-| `muted` | `muted: true` | Monitores silenciados (utiliza `false` para monitores no silenciados) |
-| `type` | `type:log` | Monitores de logs (consulta otros [tipos de monitores][1]) |
+| `status` | `status:Alert` | Seguimientos en estado de alerta (estados adicionales: `WARN`, `NO DATA` y `OK`) |
+| `muted` | `muted: true` | Seguimientos silenciados (usa `false` para seguimientos no silenciados) |
+| `type` | `type:log` | Monitor de registros (ver otros [tipos de seguimientos][1]) |
[1]: /es/monitors/types
{{% /tab %}}
-{{% tab "Logs" %}}
+{{% tab "Registros" %}}
-Utiliza la [variable de plantilla] `{{last_triggered_at_epoch}}` (#template-variables) para proporcionar un enlace a todos los logs que estén ocurriendo en el momento de la alerta.
+Utiliza el `{{last_triggered_at_epoch}}` [variable de plantilla](#template-variables) para proporcionar un enlace a todos los registros que ocurren en el momento de la alerta.
```text
https://app.datadoghq.com/logs?from_ts={{eval "last_triggered_at_epoch-10*60*1000"}}&to_ts={{eval "last_triggered_at_epoch+10*60*1000"}}&live=false
```
-El enlace de logs se puede personalizar con parámetros adicionales. Los más comunes son:
+El enlace de registros es personalizable con parámetros adicionales. Los más comunes son:
| Parámetro | Definido con | Determina |
|-----------|----------------------------|----------------------------------------|
-| `service` | `service=` | Filtro en logs de un servicio específico. |
-| `host` | `host=` | Filtro en logs de un host específico |
-| `status` | `status=` | Estado de logs: Error, Warn, Info, etc. |
+| `service` | `service=` | Filtrar registros de un servicio específico. |
+| `host` | `host=` | Filtrar registros de un host específico |
+| `status` | `status=` | Estado de los registros: Error, Advertencia, Información, etc. |
{{% /tab %}}
{{< /tabs >}}
-### Comentarios
+### Comentarios {#comments}
-Para incluir un comentario en el mensaje de monitor, utiliza la sintaxis:
+Para incluir un comentario en el mensaje de seguimiento, utiliza la sintaxis:
```text
{{!-- this is a comment --}}
{{!-- this is a comment }}
```
-### Formato sin procesar
+### Formato sin procesar {#raw-format}
-Si tu mensaje de alerta necesita enviar llaves dobles, como `{{ }}`, utiliza el formato `{{{{raw}}}}`. Por ejemplo, el siguiente:
+Si tu mensaje de alerta necesita enviar llaves dobles, como `{{ }}`, use `{{{{raw}}}}` formato. Por ejemplo, lo siguiente:
```text
{{{{raw}}}}
@@ -669,7 +689,7 @@ Salidas:
{{ }} {{ }}
```
-Las ayudas `^|#` utilizadas en las [variables condicionales](#conditional-variables) no pueden utilizarse con el formato `{{{{raw}}}}` y deben eliminarse. Por ejemplo, para mostrar texto sin formato con la variable condicional `{{is_match}}`, utiliza la siguiente plantilla:
+Los `^|#` ayudantes utilizados en [variables condicionales](#conditional-variables) no pueden ser utilizados con `{{{{raw}}}}` formatting and must be removed. For instance, to output raw text with the `{{is_match}}` variable condicional utiliza la siguiente plantilla:
```text
{{{{is_match "host.name" ""}}}}
@@ -677,23 +697,23 @@ Las ayudas `^|#` utilizadas en las [variables condicionales](#conditional-variab
{{{{/is_match}}}}
```
-Si `host.name` coincide con ``, la plantilla muestra:
+Si `host.name` coincide con ``, la plantilla produce:
```text
{{ .matched }} the host name
```
-### Codificación URL
+### Codificar URL {#url-encode}
-Si tu mensaje de alerta incluye información que debe codificarse en una URL (por ejemplo, para redireccionamientos), utiliza la sintaxis `{{ urlencode ""}}`.
+Si tu mensaje de alerta incluye información que necesita ser codificada en una URL (por ejemplo, para redirecciones), use el `{{ urlencode ""}}` sintaxis.
-**Ejemplo**: Si tu mensaje de monitor incluye una URL al Software Catalog filtrada a un servicio específico, utiliza la [variable de etiqueta](#attribute-and-tag-variables) `service` y añade la sintaxis `{{ urlencode ""}}` a la URL:
+**Ejemplo**: Si tu mensaje de seguimiento incluye una URL al Software Catalog filtrada a un servicio específico, usa la `service` [variable de etiqueta](#attribute-and-tag-variables) y agrega el `{{ urlencode ""}}` sintaxis a la URL:
```
https://app.datadoghq.com/services/{{urlencode "service.name"}}
```
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/opentelemetry/_index.md b/content/es/opentelemetry/_index.md
index 1d7ddc814a9..10b1ab88575 100644
--- a/content/es/opentelemetry/_index.md
+++ b/content/es/opentelemetry/_index.md
@@ -13,134 +13,134 @@ cascade:
further_reading:
- link: /opentelemetry/compatibility/
tag: Documentación
- text: Compatibilidad de funciones
+ text: Compatibilidad de características
- link: /opentelemetry/instrument/
tag: Documentación
- text: Instrumenta tus solicitudes
+ text: Instrumenta tus aplicaciones
- link: /opentelemetry/setup/
tag: Documentación
text: Envía datos a Datadog
- link: https://www.datadoghq.com/blog/opentelemetry-instrumentation/
tag: Blog
- text: Asociación de Datadog con OpenTelemetry
+ text: La asociación de Datadog con OpenTelemetry
- link: https://www.datadoghq.com/blog/monitor-otel-with-w3c-trace-context/
tag: Blog
- text: Monitorizar aplicaciones instrumentadas con OpenTelemetry compatibles con
- el contexto de rastreo de W3C
+ text: Monitorea aplicaciones instrumentadas con OpenTelemetry con soporte para W3C
+ Trace Context
- link: https://www.datadoghq.com/blog/ingest-opentelemetry-traces-metrics-with-datadog-exporter/
tag: Blog
- text: Enviar métricas y trazas (traces) desde OpenTelemetry Collector a Datadog
- a través del Exportador Datadog
+ text: Envía métricas y trazas desde OpenTelemetry Collector a Datadog a través de
+ Datadog Exporter
- link: https://www.datadoghq.com/blog/opentelemetry-logs-datadog-exporter/
tag: Blog
- text: Reenviar logs desde OpenTelemetry Collector con el Exportador Datadog
+ text: Reenvía registros desde OpenTelemetry Collector con Datadog Exporter
- link: https://www.datadoghq.com/about/latest-news/press-releases/datadog-announces-opentelemetry-protocol-support/
tag: Blog
- text: Ingestión de OpenTelemetry Protocol en el Agent
+ text: Ingesta OTLP en el Agente
- link: https://www.datadoghq.com/blog/aws-opentelemetry-lambda-layer-datadog/
tag: Blog
- text: Más información sobre la capa Lambda gestionada de AWS para OpenTelemetry
+ text: Aprende más sobre la capa Lambda administrada de AWS para OpenTelemetry
- link: https://www.datadoghq.com/blog/correlate-traces-datadog-rum-otel/
tag: Blog
- text: Correlacionar eventos de Datadog RUM con trazas de aplicaciones instrumentadas
+ text: Correlaciona eventos RUM de Datadog con trazas de aplicaciones instrumentadas
con OpenTelemetry
- link: https://www.datadoghq.com/blog/opentelemetry-runtime-metrics-datadog/
tag: Blog
- text: Monitorizar métricas de tiempo de ejecución desde aplicaciones instrumentadas
- por OpenTelemetry con Datadog APM
+ text: Monitorea métricas de tiempo de ejecución de aplicaciones instrumentadas con
+ OTel con Datadog APM
- link: https://www.datadoghq.com/blog/otel-deployments/
tag: Blog
- text: Cómo seleccionar el despliegue de OpenTelemetry
+ text: Cómo seleccionar tu implementación de OpenTelemetry
- link: https://learn.datadoghq.com/courses/otel-with-datadog
- tag: Centro de aprendizaje
+ tag: Centro de Aprendizaje
text: Introducción a OpenTelemetry con Datadog
+- link: https://learn.datadoghq.com/courses/understanding-opentelemetry
+ tag: Centro de Aprendizaje
+ text: Entendiendo OpenTelemetry
title: OpenTelemetry en Datadog
---
-
-{{< learning-center-callout hide_image="true" header="Try \"Introduction to OTel with Datadog\" in the Learning Center" btn_title="Enroll Now" btn_url="https://learn.datadoghq.com/courses/otel-with-datadog">}}
- Aprende cómo configurar OpenTelemetry para exportar métricas, trace (trazas) y logs a Datadog y explorar los datos recopilados en la plataforma.
+{{< learning-center-callout hide_image="true" header="Prueba "Introducción a OTel con Datadog" en el Centro de Aprendizajeer" btn_title="Inscríbete ahora" btn_url="https://learn.datadoghq.com/courses/otel-with-datadog">}}
+ Aprende a configurar OpenTelemetry para exportar métricas, trazas y registros a Datadog, y explora los datos recopilados en la plataforma.
{{< /learning-center-callout >}}
-## Información general
+## Visión general {#overview}
-[OpenTelemetry][1] (OTel) proporciona protocolos estandarizados para recopilar y enrutar datos telemétricos. Datadog admite múltiples formas de recopilar y analizar datos telemétricos de aplicaciones instrumentadas con OpenTelemetry, tanto si utilizas la infraestructura de Datadog como si prefieres una configuración independiente del proveedor.
+[OpenTelemetry][1] (OTel) proporciona protocolos estandarizados para recopilar y enrutar datos de telemetría. Datadog admite múltiples formas de recopilar y analizar datos de telemetría de aplicaciones instrumentadas con OpenTelemetry, ya sea que esté utilizando la infraestructura existente de Datadog o prefiera una configuración neutral ante proveedores.
-### ¿Por qué OpenTelemetry con Datadog?
+### ¿Por qué OpenTelemetry con Datadog? {#why-opentelemetry-with-datadog}
-Datadog proporciona observabilidad avanzada para toda la telemetría de tu aplicación, independientemente de su source (fuente). Al ser compatible con OpenTelemetry, Datadog ofrece:
+Datadog proporciona observabilidad avanzada para toda tu telemetría de aplicaciones, independientemente de su origen. Al admitir OpenTelemetry, Datadog ofrece:
-- **Flexibilidad y capacidad de elección**: Utiliza la instrumentación estandarizada mientras mantienes la libertad de adaptarte a medida que evolucionen tus necesidades tecnológicas.
-- **Compatibilidad con todos los lenguajes**: Consistentemente aplicaciones de monitorización en todo tu stack tecnológico.
-- **Instrumentación unificada**: Mantén un enfoque único de instrumentación en todos tus sistemas.
-- **Potentes análisis**: Combina la estandarización de OpenTelemetry con las sólidas funciones de análisis, visualización y alerta de Datadog.
+- **Flexibilidad y elección**: Usa instrumentación estandarizada mientras mantienes la libertad de adaptarte a medida que evolucionan tus necesidades tecnológicas.
+- **Soporte integral de lenguajes**: Monitorea de manera consistente las aplicaciones en toda tu pila tecnológica.
+- **Instrumentación unificada**: Mantén un enfoque único para la instrumentación en tus sistemas.
+- **Análisis poderosos**: Combina la estandarización de OpenTelemetry con las robustas capacidades de análisis, visualización y alertas de Datadog.
-Tanto si ya utilizas OpenTelemetry como si estás considerando adoptarlo, Datadog ofrece opciones flexibles para satisfacer tus necesidades.
+Ya sea que ya estés utilizando OpenTelemetry o estés considerando su adopción, Datadog proporciona opciones flexibles para satisfacer tus necesidades.
-### Decisiones clave
+### Decisiones clave {#key-decisions}
-Hay dos decisiones clave que tomar cuando se utiliza OpenTelemetry con Datadog:
+Hay dos decisiones clave que tomar al usar OpenTelemetry con Datadog:
- [Cómo instrumentar tus aplicaciones](#instrument-your-applications)
-- [Cómo enviar tus datos a Datadog](#send-opentelemetry-data-to-Datadog)
+- [Cómo enviar tus datos a Datadog](#send-opentelemetry-data-to-datadog)
-Las funciones disponibles dependen de estas opciones. Por ejemplo, el uso de la API OpenTelemetry con el kit de desarrollo de software (SDK) de Datadog proporciona acceso a más funciones de Datadog que el uso del kit de desarrollo de software (SDK) de OpenTelemetry por sí solo.
+Las características disponibles para ti dependen de estas elecciones. Por ejemplo, usar la API de OpenTelemetry con el SDK de Datadog proporciona acceso a más características de Datadog que usar solo el SDK de OpenTelemetry.
-Para obtener más información, lee [Compatibilidad de funciones][9].
+Para más información, consulta [Compatibilidad de Características][9].
-## Instrumenta tus aplicaciones
+## Instrumenta tus aplicaciones {#instrument-your-applications}
-Hay varias maneras de instrumentar tus aplicaciones con OpenTelemetry y Datadog. Cada enfoque ofrece diferentes funciones y niveles de neutralidad del proveedor.
+Existen varias formas de instrumentar tus aplicaciones con OpenTelemetry y Datadog. Cada enfoque proporciona diferentes características y niveles de neutralidad del proveedor.
-- **OpenTelemetry completo**: Utiliza el kit de desarrollo de software (SDK) y la API de OpenTelemetry para una configuración independiente del proveedor.
-- **API de OpenTelemetry**: Utiliza la API de OpenTelemetry con la implementación del kit de desarrollo de software (SDK) de Datadog.
-- **Bibliotecas de instrumentación de OpenTelemetry**: Extiende la observabilidad de Datadog a marcos y tecnologías adicionaleslogies.
+- **OpenTelemetry Completo**: Usa el SDK y la API de OpenTelemetry para una configuración neutral ante proveedores.
+- **API de OpenTelemetry**: Usa la API de OpenTelemetry con la implementación del SDK de Datadog.
+- **Bibliotecas de instrumentación de OpenTelemetry**: Extiende la observabilidad de Datadog a marcos y tecnologías adicionales.
-Para obtener más información, consulta [Instrumenta tus aplicaciones][8].
+Para más información, consulta [Instrumenta Tus Aplicaciones][8].
-## Envía los datos de OpenTelemetry a Datadog
+## Envía datos de OpenTelemetry a Datadog {#send-opentelemetry-data-to-datadog}
-Si tus aplicaciones y servicios están instrumentadas con bibliotecas de OpenTelemetry, puedes elegir cómo obtener datos de traces (trazas), métricas y logs en Datadog.
+Si tus aplicaciones y servicios están instrumentados con bibliotecas de OpenTelemetry, puedes elegir cómo enviar trazas, métricas y datos de registros a Datadog.
-
¿No estás seguro de qué configuración te conviene? Consulta la tabla de compatibilidad de funciones para saber qué funciones de Datadog son compatibles.
+
¿No estás seguro de qué configuración es la adecuada para ti? Consulta la tabla de Compatibilidad de Características para entender qué características de Datadog son compatibles.
-### Opción 1: Utilizar OpenTelemetry Collector
+### Opción 1: Usa el Agente de Datadog con el Colector DDOT (Recomendado) {#option-1-use-the-datadog-agent-with-ddot-collector-recommended}
-{{< img src="/opentelemetry/setup/otel-collector.png" alt="Diagrama: El kit de desarrollo de software (SDK) de OpenTelemetry en código envía datos a través de OpenTelemetry Protocol al host que ejecuta OpenTelemetry Collector con el exportador de Datadog, que los reenvía a la plataforma de observabilidad de Datadog." style="width:100%;" >}}
+{{< img src="/opentelemetry/setup/ddot-collector-2.png" alt="Descripción general de la arquitectura para el Colector DDOT, que está integrado en el Agente de Datadog." style="width:100%;" >}}
-**Lo mejor para**: Usuarios nuevos o existentes de OpenTelemetry que deseen una configuración completamente independiente del proveedor.
+**Mejor para**: Usuarios que buscan obtener tanto neutralidad del proveedor OTel como innovaciones del ecosistema de Datadog, tales como:
-- Neutralidad total del proveedor para el envío de datos de OpenTelemetry a Datadog
-- Opciones flexibles de configuración, como el muestreo por colas y las transformaciones de datos.
+- Fleet Automation
+- Live Container Monitoring
+- Explorador de Kubernetes
+- Live Processes
+- Cloud Network Monitoring
+- Universal Service Monitoring
+- {{< translate key="integration_count" >}}+ Integraciones de Datadog
{{< whatsnext desc=" " >}}
- {{< nextlink href="/opentelemetry/setup/collector_exporter/" >}}Más información sobre el uso de OpenTelemetry Collector{{< /nextlink >}}
+ {{< nextlink href="/opentelemetry/setup/ddot_collector/" >}}Aprende más sobre el uso del Agente de Datadog con el Colector DDOT{{< /nextlink >}}
{{< /whatsnext >}}
-### Opción 2: Utilizar el Datadog Agent con Datadog distribution of OpenTelemetry (DDOT) Collector
+### Opción 2: Usa el Colector de OpenTelemetry {#option-2-use-the-opentelemetry-collector}
-{{< img src="/opentelemetry/setup/ddot-collector-2.png" alt="Información general de la arquitectura de Datadog distribution of OpenTelemetry (DDOT) Collector, que está integrada en el Datadog Agent." style="width:100%;" >}}
+{{< img src="/opentelemetry/setup/otel-collector.png" alt="Diagrama: El SDK de OpenTelemetry en el código envía datos a través de OTLP al host que ejecuta el Colector de OpenTelemetry con el Exportador de Datadog, que reenvía a la Plataforma de Observabilidad de Datadog." style="width:100%;" >}}
-**Lo mejor para**: Los usuarios existentes Datadog o equipos que requieren funciones basadas en el Agent como por ejemplo:
-
-- Automatización de flotas
-- Container Monitoring en tiempo real
-- Explorer de Kubernetes
-- Live Processes
-- Cloud Network Monitoring
-- Universal Service Monitoring
-- {{< translate key="integration_count" >}}+ Integraciones de Datadog
+**Mejor para**: Nuevos o existentes usuarios de OTel que desean una configuración completamente neutral ante proveedores.
-
Si deseas consultar una lista completa de las funciones basadas en el Agent, consulta OpenTelemetry al Datadog Agent (OpenTelemetry Protocol) en Compatibilidad de funciones.
+- Completa neutralidad ante proveedores para enviar datos de OpenTelemetry a Datadog
+- Opciones de configuración flexibles como muestreo basado en el seguimiento de las últimas líneas y transformaciones de datos
{{< whatsnext desc=" " >}}
- {{< nextlink href="/opentelemetry/setup/ddot_collector/" >}}Más información sobre el uso del Datadog Agent con Datadog distribution of OpenTelemetry (DDOT) Collector{{< /nextlink >}}
+ {{< nextlink href="/opentelemetry/setup/collector_exporter/" >}}Aprende más sobre el uso del Colector de OpenTelemetry{{< /nextlink >}}
{{< /whatsnext >}}
-### Opciones de configuración adicionales
+### Opciones de configuración adicionales {#additional-setup-options}
-Para conocer otras opciones de configuración, como el despliegue Agentless, consulta [Enviar datos a Datadog][7].
+Para otras opciones de configuración, incluyendo la ingestión directa de OTLP, consulte [Enviar datos a Datadog][7].
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/real_user_monitoring/_index.md b/content/es/real_user_monitoring/_index.md
index 1d2ee667926..92c497357db 100644
--- a/content/es/real_user_monitoring/_index.md
+++ b/content/es/real_user_monitoring/_index.md
@@ -13,219 +13,247 @@ description: Visualiza, observa y analiza el rendimiento de tus aplicaciones de
tal como las ven tus usuarios.
disable_sidebar: true
further_reading:
-- link: https://app.datadoghq.com/release-notes?category=Real%20User%20Monitoring
- tag: Notas de la versión
- text: Consulta las últimas versiones de Datadog RUM. (Es necesario iniciar sesión
- en la aplicación)
+- link: /real_user_monitoring/application_monitoring/browser/data_collected/
+ tag: Documentación
+ text: Datos del navegador RUM recopilados
- link: https://dtdg.co/fe
- tag: Habilitación de los fundamentos
- text: Participa en una sesión interactiva para obtener información a través de Real
- User Monitoring
+ tag: Habilitación de la fundación
+ text: Únete a una sesión interactiva para obtener información a través de RUM
- link: https://www.datadoghq.com/blog/real-user-monitoring-with-datadog/
tag: Blog
- text: Presentamos Datadog Real User Monitoring
+ text: Presentando RUM de Datadog
- link: https://www.datadoghq.com/blog/datadog-mobile-rum/
tag: Blog
- text: Mejora la experiencia móvil del usuario con Real User Monitoring móvil de
- Datadog
+ text: Mejora la experiencia del usuario móvil con Datadog Mobile Real User Monitoring
- link: https://www.datadoghq.com/blog/mobile-monitoring-best-practices/
tag: Blog
- text: Prácticas recomendadas para monitorizar el rendimiento de aplicaciones móviles
+ text: Mejores prácticas para monitorear el rendimiento de aplicaciones móviles
- link: https://www.datadoghq.com/blog/error-tracking/
tag: Blog
- text: Entiende los problemas de las aplicaciones con el seguimiento de errores de
- Datadog
+ text: Comprende los problemas de la aplicación con Error Tracking de Datadog
- link: https://www.datadoghq.com/blog/unify-apm-rum-datadog/
tag: Blog
- text: Unifica los datos de APM y RUM para una visibilidad completa del stack tecnológico
+ text: Unifica los datos de APM y RUM para lograr una visibilidad completa de toda
+ la pila.
- link: https://www.datadoghq.com/blog/datadog-geomaps/
tag: Blog
- text: Utiliza geomapas para ver los datos de tu aplicación por ubicación
+ text: Utiliza geomapas para visualizar los datos de tu aplicación por ubicación
- link: https://www.datadoghq.com/blog/datadog-rum-react-components/#tune-up-your-react-data-collection
tag: Blog
- text: Obtén datos de RUM mejorados con nuestros componentes de React personalizados
+ text: Obtén mejores datos de RUM con nuestros componentes personalizados de React
- link: https://www.datadoghq.com/blog/hybrid-app-monitoring/
tag: Blog
- text: Monitoriza tus aplicaciones móviles híbridas con Datadog
+ text: Monitorea tus aplicaciones móviles híbridas con Datadog
- link: https://www.datadoghq.com/blog/how-datadogs-tech-solutions-team-rum-session-replay/
tag: Blog
- text: Cómo el equipo de Soluciones técnicas de Datadog utiliza RUM, Session Replay
- y el seguimiento de errores para solucionar los problemas de los clientes
+ text: Cómo el equipo de Soluciones Técnicas de Datadog utiliza RUM, reproducción
+ de sesión y Error Tracking para resolver problemas de clientes
- link: https://www.datadoghq.com/blog/static-web-application-monitoring-best-practices/
tag: Blog
- text: Prácticas recomendadas para la monitorización de aplicaciones web estáticas
-- link: /real_user_monitoring/application_monitoring/browser/data_collected/
- tag: Documentación
- text: Datos del navegador de RUM recopilados
+ text: Mejores prácticas para monitorear aplicaciones web estáticas
- link: https://www.datadoghq.com/blog/progressive-web-application-monitoring/
tag: Blog
- text: Prácticas recomendadas para la monitorización de aplicaciones web progresivas
-title: RUM y Session Replay
+ text: Mejores prácticas para monitorear aplicaciones web progresivas
+- link: https://www.datadoghq.com/blog/datadog-executive-dashboards
+ tag: Blog
+ text: Diseña tableros ejecutivos efectivos con Datadog
+- link: https://www.datadoghq.com/blog/rum-product-analytics-bridging-teams
+ tag: Blog
+ text: 'Del rendimiento al impacto: Conectando equipos de frontend a través de un
+ contexto compartido'
+- link: https://app.datadoghq.com/release-notes?category=Real%20User%20Monitoring
+ tag: Notas de la versión
+ text: ¡Consulta las últimas versiones de Datadog RUM! (Se requiere inicio de sesión
+ en la aplicación)
+- link: https://learn.datadoghq.com/courses/intro-to-rum
+ tag: Centro de Aprendizaje
+ text: Introducción a RUM (Real User Monitoring)
+title: RUM y reproducción de sesión
---
+{{< learning-center-callout header="Únete a una sesión de seminario web de habilitación" hide_image="true" btn_title="Regístrate" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=RUM">}}
+ Descubre cómo crear acciones de usuario personalizadas adaptadas a necesidades comerciales específicas, lo que permite un seguimiento preciso del comportamiento del usuario.
+{{< /learning-center-callout >}}
+## ¿Qué es RUM? {#what-is-real-user-monitoring}
-{{< learning-center-callout header="Únete a una sesión de capacitación web" hide_image="true" btn_title="Inscríbete" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=RUM">}}
- Descubre cómo crear acciones de usuarios personalizadas que se adapten a necesidades empresariales específicas, lo que permite un seguimiento preciso del comportamiento de los usuarios.
-{{< /learning-center-callout >}}
+{{< img src="real_user_monitoring/performance-summary-browser.png" alt="Tablero de RUM" >}}
+
+La *RUM (Real User Monitoring)* de Datadog te brinda visibilidad de extremo a extremo sobre la actividad y experiencia en tiempo real de usuarios individuales. RUM resuelve cuatro tipos de casos de uso para la monitorización de aplicaciones web y móviles:
+
+* **Rendimiento**: Realiza un seguimiento del rendimiento de las páginas web, pantallas de aplicaciones móviles, acciones de usuario, solicitudes de red y tu código frontend.
+* **Gestión de Errores**: Monitorea los errores y problemas en curso y haz un seguimiento de ellos a lo largo del tiempo y las versiones.
+* **Analítica / Uso**: Comprende quién está utilizando tu aplicación (país, dispositivo, SO), monitorea los recorridos de usuarios individuales y analiza cómo los usuarios interactúan con tu aplicación (página más visitada, clics, interacciones y uso de funciones).
+* **Soporte**: Recupera toda la información relacionada con una sesión de usuario para solucionar un problema (duración de la sesión, páginas visitadas, interacciones, recursos cargados y errores).
+
+### Definición de sesión {#session-definition}
-## ¿Qué es Real User Monitoring?
+Una sesión de usuario es un recorrido de usuario en tu aplicación web o móvil. Una sesión incluye todos los eventos de navegación relacionados (Vistas RUM), acciones de usuario (Acciones RUM), solicitudes de red (Recursos RUM), fallos y errores (Errores RUM), y otros eventos y señales que producen colectivamente una representación fiel de la experiencia del usuario.
-{{< img src="real_user_monitoring/performance-summary-browser.png" alt="Dashboard de RUM" >}}
+Una sesión de RUM puede durar hasta 4 horas y expira después de 15 minutos de inactividad. Si el usuario interactúa con la aplicación después de cualquiera de los límites, se inicia automáticamente una nueva sesión.
-Con Datadog Real User Monitoring (RUM)*, disfrutarás de una visibilidad de extremo a extremo de la actividad y la experiencia en tiempo real de cada usuario. RUM resuelve cuatro tipos de casos de uso para la monitorización de aplicaciones web y móviles:
+### Limitaciones técnicas {#technical-limitations}
-* **Rendimiento**: Realiza un seguimiento del rendimiento de páginas web, pantallas de aplicaciones móviles, acciones de los usuarios, solicitudes de red y tu código frontend.
-* **Gestión de errores**: Monitoriza los errores y problemas en curso y haz un seguimiento a lo largo del tiempo en las diferentes versiones.
-* **Análisis/Uso**: Conoce quién utiliza tu aplicación (país, dispositivo, sistema operativo), controla los recorridos de cada usuario y analiza cómo interactúan los usuarios con tu aplicación (página que más suele visitarse, clics, interacciones y uso de funciones).
-* **Asistencia**: Obtén toda la información relacionada con una sesión de usuario para solucionar un problema (duración de la sesión, páginas visitadas, interacciones, recursos cargados y errores).
+| Propiedad | Limitación |
+| ------------------------------------------ | ------------------------ |
+| Duración máxima de una sesión | 4 horas |
+| Tiempo de espera de una sesión | 15 minutos de inactividad |
+| Número máximo de eventos por sesión | 10 millones |
+| Número máximo de atributos por evento | 1,000 |
+| Profundidad máxima de atributos por evento | 20 |
+| Tamaño máximo de evento | 1 MB |
+| Tamaño máximo de carga útil de entrada | 5 MB |
+| Tamaño máximo de mapas del código fuente y archivos de mapeo | 500 MB por archivo |
+| Tamaño máximo de archivos dSYM | 2 GB por archivo |
+| Retraso máximo en la ingestión | 24 horas |
-Una sesión de usuario es un recorrido del usuario en tu aplicación web o móvil que dura hasta cuatro horas. Una sesión suele incluir las páginas vistas y la telemetría asociada. Si un usuario no interactúa con una aplicación durante 15 minutos, la sesión se considera terminada. Una nueva sesión comienza cuando el usuario vuelve a interactuar con la aplicación.
+Si un evento supera cualquiera de las limitaciones técnicas mencionadas anteriormente, es rechazado por la ingesta de Datadog.
-## ¿Qué es Session Replay?
+## ¿Qué es la Reproducción de Sesión? {#what-is-session-replay}
-*Session Replay* de Datadog te permite detectar y reproducir visualmente la experiencia de navegación web de tus usuarios.
+La *Reproducción de sesión* de Datadog te permite capturar y reproducir visualmente la experiencia de navegación web de tus usuarios.
-Cuando se utiliza junto con los datos de rendimiento de RUM, Session Replay ayuda a identificar, reproducir y solucionar errores, además de ofrecer información sobre los patrones de uso de tu aplicación web y sus problemas de diseño.
+Combinada con los datos de rendimiento de RUM, la Reproducción de sesión es beneficiosa para la identificación, reproducción y resolución de errores, y proporciona información sobre los patrones de uso y las fallas de diseño de tu aplicación web.
-## Para empezar
+## Comienza {#get-started}
-Selecciona un tipo de aplicación para empezar a recopilar datos de RUM:
+Selecciona un tipo de aplicación para comenzar a recopilar datos de RUM:
{{< partial name="rum/rum-getting-started.html" >}}
-### Funcionalidades y plataformas compatibles
+### Capacidades y soporte de plataforma {#capabilities-and-platform-support}
-**Nota**: El SDK de Datadog Flutter no es compatible con MacOS, Windows o Linux.
+**Nota**: El SDK de Datadog para Flutter no es compatible con MacOS, Windows o Linux.
-La siguiente tabla muestra las funcionalidades de RUM compatibles con cada plataforma:
+La siguiente tabla muestra qué capacidades de RUM son compatibles en cada plataforma:
-| Función | Navegador | Android | iOS | Flutter | React Native | Roku | KMP | Unidad | Notas |
+| Característica | Navegador | Android | iOS | Flutter | React Native | Roku | KMP | Unity | Notas |
| ------------------------------------- | --------|---------|---------|---------|--------------|------|-----|-------|--------|
-| Enviar logs a Datadog | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | |
-| Rastreo distribuido de solicitudes de red | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | - **Roku** solo puede rastrear algunos tipos de solicitudes HTTP. - **Unity** utiliza una envoltura alrededor de `UnityWebRequest` para realizar el seguimiento de las solicitudes. |
-| Rastrear vistas y acciones (RUM) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | - Todas las acciones seguidas en **Flutter Web** se registran como `custom`. - **Roku** y **Unity** solo admiten el seguimiento manual de acciones. |
-| Seguimiento de marcadores de funciones y seguimiento de versiones | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | {{< X >}} | |
-| Seguimiento de errores y asignación de orígenes | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | Solo parcialmente compatible con **React Native**. |
+| Envía registros a Datadog | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | |
+| Trazado distribuido de solicitudes de red | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | - **Roku** solo puede rastrear algunos tipos de solicitudes HTTP. - **Unity** utiliza un envoltorio alrededor de `UnityWebRequest` para realizar el rastreo de solicitudes. |
+| Rastrear Vistas y Acciones (RUM) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | - Todas las acciones rastreadas en **Flutter Web** se registran como `custom`. - **Roku** y **Unity** solo admiten el rastreo manual de acciones. |
+| Seguimiento de Feature Flags y rastreo de lanzamientos | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | {{< X >}} | |
+| Seguimiento de errores y mapa del código fuente | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | Solo parcialmente compatible con **React Native**. |
| Seguimiento de fallos, simbolización y desofuscación | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | |
-| Detener sesiones (monitorización de quioscos) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | {{< X >}} | |
-| Rastrear eventos en vistas web | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | | |
-| Monitorizar indicadores vitales específicos de plataformas | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | | |
-| Seguimiento global de contexto/atributo en logs | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | {{< X >}} | |
-| Rastreo del lado del cliente | | {{< X >}} | {{< X >}}| | | | | | | |
-| Session Replay | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | | Session Replay de **Flutter** está en vista previa. |
+| Detener sesiones (Monitoreo de Kioscos) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | {{< X >}} | |
+| Rastrear eventos en WebViews | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | | |
+| Monitorear métricas específicas de la plataforma | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | | |
+| Seguimiento global de contexto/atributos en los registros | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | {{< X >}} | |
+| Trazado del lado del cliente | | {{< X >}} | {{< X >}}| | | | | | | |
+| Reproducción de sesión | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | {{< X >}} | | La reproducción de sesión de **Flutter** está en vista previa. |
| Señales de frustración | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | Solo parcialmente compatible con todos los dispositivos **móviles** y **Roku**. |
-## Endpoints compatibles para dominios de SDK
+## Puntos de conexión compatibles para dominios de SDK {#supported-endpoints-for-sdk-domains}
-El tráfico de todos los SDK de Datadog se transmite a través de SSL (443 por defecto) a los siguientes dominios:
+Todo el tráfico de los SDK de Datadog se transmite a través de SSL (puerto 443 por defecto) a los siguientes dominios:
-| Sitio | URL del sitio |
+| Sitio | URL del sitio |
|------|-----------------------------------------------|
| US1 | `https://browser-intake-datadoghq.com` |
| US3 | `https://browser-intake-us3-datadoghq.com` |
| US5 | `https://browser-intake-us5-datadoghq.com` |
-| UE1 | `https://browser-intake-datadoghq.eu` |
+| EU1 | `https://browser-intake-datadoghq.eu` |
| US1-FED | `https://browser-intake-ddog-gov.com` |
+| US2-FED | `https://browser-intake-us2-ddog-gov.com` |
| AP1 | `https://browser-intake-ap1-datadoghq.com` |
| AP2 | `https://browser-intake-ap2-datadoghq.com` |
-## Explorar RUM de Datadog
+## Explorar Datadog RUM {#explore-datadog-rum}
-Accede a RUM yendo a [**Digital Experience > Performance Summary** (Experiencia digital > Resumen del rendimiento)][1].
+Acceda a RUM navegando a [**Experiencia Digital > Resumen de Rendimiento**][1].
-Selecciona una aplicación en la barra de navegación superior o sigue las instrucciones de configuración de [navegador][15] o [móvil][16] para añadir tu primera aplicación.
+Seleccione una aplicación desde la navegación superior, o siga las instrucciones de configuración para [navegador][15] o [móvil][16] para agregar su primera aplicación.
-{{< img src="real_user_monitoring/rum-performance-application-selector.png" alt="Selecciona una aplicación RUM" >}}
+{{< img src="real_user_monitoring/rum-performance-application-selector.png" alt="Seleccione una aplicación RUM" >}}
-**Consejo**: Para abrir RUM a partir de la búsqueda global de Datadog, pulsa Cmd/Ctrl + K y busca `real user monitoring`.
+**Consejo**: Para abrir RUM desde la búsqueda global de Datadog, presione Cmd/Ctrl + K y busque `real user monitoring`.
-## Resumen de la monitorización del rendimiento
+## Resumen de monitoreo de rendimiento {#performance-monitoring-summary}
-| Resumen del rendimiento del navegador | Resumen del rendimiento de los móviles |
+| Resumen de Rendimiento del Navegador | Resumen de Rendimiento Móvil |
|---------|---------|
-| {{< img src="real_user_monitoring/performance-summary-browser.png" alt="Página de resumen de la Monitorización de rendimiento de RUM para una aplicación de navegador" >}} | {{< img src="real_user_monitoring/performance-summary-mobile-2.png" alt="Página de resumen de la Monitorización de rendimiento de RUM para una aplicación móvil" >}} |
+| {{< img src="real_user_monitoring/performance-summary-browser.png" alt="Página de resumen de monitoreo de rendimiento RUM para una aplicación de navegador" >}} | {{< img src="real_user_monitoring/performance-summary-mobile-2.png" alt="Página de resumen de monitoreo de rendimiento RUM para una aplicación móvil" >}} |
-La página [Resumen de monitorización del rendimiento de RUM][1] proporciona información relevante y procesable para aplicaciones web y móviles. Obtén una experiencia personalizada para cada plataforma que te ayudará a:
+La página de [Resumen de Monitoreo de Rendimiento RUM][1] proporciona información relevante y procesable para aplicaciones web y móviles. Tienes una experiencia personalizada para cada plataforma que te ayuda a:
-- **Centrarte en datos clave** por plataforma, como la latencia de la interfaz de usuario para fallos web o móviles.
-- **Monitorizar el estado de las aplicaciones** a través de KPIs conocidos, como Core Web Vitals para aplicaciones web o la tasa de cuelgues para iOS, para evaluar la fiabilidad de las aplicaciones.
-- **Analizar en detalle las investigaciones directamente** desde los widgets interactivos sin salir de la página
+- **Enfócate en puntos de datos clave** por plataforma, como la latencia de la interfaz de usuario para web o los fallos móviles
+- **Monitorea la salud de la aplicación** a través de KPIs familiares, como los Core Web Vitals para aplicaciones web o la tasa de bloqueos para iOS, para evaluar la confiabilidad de la aplicación.
+- **Sumérgete en los análisis directamente** desde widgets interactivos sin salir de la página
-Para **aplicaciones web**, utiliza la barra de búsqueda para filtrar los datos, identificar las páginas lentas y seguir la interfaz de usuario hasta la página [RUM Optimization Inspect][17].
+Para **aplicaciones web**, utiliza la barra de búsqueda para filtrar datos, identificar páginas lentas y seguir la interfaz de usuario hasta la página de [Inspección de Optimización de RUM][17].
-Para **aplicaciones móviles**, revisa los fallos recientes en la parte inferior de la página y utiliza el panel lateral [Error Tracking][6] para solucionar problemas.
+Para **aplicaciones móviles**, revisa los recientes fallos en la parte inferior de la página y utiliza el panel lateral de [Error Tracking][6] para solucionar problemas.
-### Dashboards predefinidos
+### Tableros listos para usar {#out-of-the-box-dashboards}
-Analiza la información sobre tus sesiones de usuario, rendimiento, aplicaciones móviles, señales de frustración, recursos de red y errores recopilados automáticamente utilizando [dashboards de RUM predefinidos][2].
+Analiza información sobre tus sesiones de usuario, rendimiento, aplicaciones móviles, señales de frustración, recursos de red y errores recopilados automáticamente con [tableros RUM listos para usar][2].
-{{< img src="real_user_monitoring/rum-out-of-the-box-dashboard.png" alt="Dashboard de RUM" >}}
+{{< img src="real_user_monitoring/rum-out-of-the-box-dashboard.png" alt="Tablero RUM" >}}
-### Explorador de RUM y visualizaciones
+### Explorador RUM y visualizaciones {#rum-explorer-and-visualizations}
-Consulta sesiones de usuario en segmentos, como por ejemplo para verificar cuándo afecta la latencia a tus clientes prémium, utilizando [visualizaciones][3]. Explora datos, guarda vistas y crea [monitores][4] en tus búsquedas personalizadas.
+Visualiza sesiones de usuario en segmentos, como verificar cuándo la latencia impacta a tus clientes premium, con [visualizaciones][3]. Explora datos, guarda vistas y crea [monitores][4] en tus búsquedas personalizadas.
-{{< img src="real_user_monitoring/explorer/analytics/rum_analytics.mp4" alt="Análisis de RUM" video=true >}}
+{{< img src="real_user_monitoring/explorer/analytics/rum_analytics.mp4" alt="Analítica RUM" video=true >}}
-### Integración con logs, APM y generador de perfiles
+### Integración con registros, APM y perfilador {#integration-with-logs-apm-and-profiler}
-Consulta tus [trazas (traces) de back-end, logs y métricas de infraestructura][5] hasta llegar a la línea de código exacta que afecta al rendimiento de la aplicación, que se corresponde con las experiencias del usuario y los problemas notificados.
+Visualiza tus [trazas de backend, registros y métricas de infraestructura][5] hasta la línea exacta de código que impacta el rendimiento de tu aplicación, correspondiente a las experiencias de los usuarios y problemas reportados.
{{< img src="real_user_monitoring/connect_rum_and_traces/rum_apm_logs-2.png" alt="RUM y APM" >}}
-### Seguimiento de errores e informes de fallos
+### Error Tracking e informes de fallos {#error-tracking-and-crash-reporting}
-Obtén alertas automatizadas sobre outliers y grupos de errores, tiempos de espera y fallos para reducir significativamente tu MTTR utilizando el [seguimiento de errores][6].
+Recibe alertas automáticas sobre valores anómalos y grupos de errores, tiempos de espera y fallos para reducir significativamente tu MTTR con [Error Tracking][6].
-{{< img src="real_user_monitoring/error_tracking/errors_rum.mp4" alt="Seguimiento de errores de RUM" video=true >}}
+{{< img src="real_user_monitoring/error_tracking/errors_rum.mp4" alt="Error Tracking RUM" video=true >}}
-### Indicadores fundamentales web y móviles
+### Vitals web y móviles {#web-and-mobile-vitals}
-Consulta las puntuaciones de rendimiento y la telemetría de [aplicaciones de navegador][7] como Core Web Vitals y Mobile Vitals para [iOS y tvOS][8] o [aplicaciones de Android y Android TV][9].
+Visualiza puntajes de rendimiento y telemetría para [aplicaciones de navegador][7] como Core Web Vitals y Mobile Vitals para [iOS y tvOS][8] o [aplicaciones de Android y Android TV][9].
-### Seguimiento de vistas web
+### Web View Tracking {#web-view-tracking}
-Recopila información de tus aplicaciones web nativas y explora vistas híbridas haciendo un seguimiento de vistas web para [iOS y tvOS][10] o [Android y Android TV][11].
+Recopila información de tus aplicaciones web nativas y explora vistas híbridas con Web View Tracking para [iOS y tvOS][10] o [Android y Android TV][11].
-{{< img src="real_user_monitoring/webview_tracking/webview_tracking_light.png" alt="Vistas web capturadas en una sesión de usuario en el Explorador de RUM" >}}
+{{< img src="real_user_monitoring/webview_tracking/webview_tracking_light.png" alt="Vistas web capturadas en una sesión de usuario en el Explorador RUM" >}}
-## Explorar Datadog Session Replay
+## Explora la reproducción de sesión de Datadog {#explore-datadog-session-replay}
-### Reproducciones de sesiones
+### Reproducción de sesión {#session-replays}
-Ve [grabaciones de navegador][12] de usuarios reales que interactúan con tu sitio web y define [controles de privacidad][13] para tu organización.
+Mira [grabaciones de navegador][12] de usuarios reales interactuando con tu sitio web y establece [controles de privacidad][13] para tu organización.
-### Herramientas de desarrollador
+### Herramientas para desarrolladores {#developer-tools}
-Accede a información sobre logs activados, errores y rendimiento cuando soluciones problemas de aplicaciones con [herramientas de desarrollador de navegador[14].
+Accede a registros activados, errores e información de rendimiento al solucionar problemas de aplicaciones utilizando [Browser Dev Tools][14].
-## Permisos
+## Permisos {#permissions}
Por defecto, todos los usuarios pueden cambiar la configuración RUM de una aplicación.
Utiliza controles de acceso granulares para limitar los [roles][18] que pueden editar la configuración RUM de una aplicación en particular:
-1. Mientras visualizas la configuración RUM de una aplicación, haz clic en el botón **Edit application** (Editar aplicación) situado en la parte superior de la pantalla. Aparece un menú desplegable.
-1. Selecciona **Manage App Permissions** (Gestionar permisos de aplicaciones).
-1. Haz clic en **Restrict Access** (Restringir el acceso).
-1. El cuadro de diálogo se actualiza para mostrar que los miembros de tu organización tienen por omisión el permiso de acceso **Viewer** (Visualización).
-1. Utiliza el menú desplegable para seleccionar uno o varios roles, equipos o usuarios que pueden modificar el notebook.
-1. Haz clic en **Add** (Añadir).
-1. El cuadro de diálogo se actualiza para indicar que el rol que has seleccionado tiene el permiso **Editor** (Edición).
-1. Haz clic en **Save** (Guardar).
+1. Mientras visualizas la configuración RUM de una aplicación, haz clic en el botón **Editar aplicación** en la parte superior de la pantalla. Aparece un menú desplegable.
+1. Selecciona **Manage App Permissions**.
+1. Haz clic en **Restrict Access**.
+1. El cuadro de diálogo se actualiza para mostrar que los miembros de tu organización tienen acceso de **Viewer** por defecto.
+1. Utiliza el menú desplegable para seleccionar uno o más roles, equipos o usuarios que puedan editar el notebook.
+1. Haz clic en **Add**.
+1. El cuadro de diálogo se actualiza para mostrar que el rol que seleccionó tiene el permiso de **Editor**.
+1. Haz clic en **Save**.
-**Nota:** Para mantener tu acceso de edición a la aplicación, el sistema requiere que incluyas al menos un rol del que seas miembro antes de guardar.
+**Nota:** Para mantener tu acceso de edición a la aplicación, el sistema requiere que incluyas al menos un rol del cual seas miembro antes de guardar.
-Debes tener acceso de edición para restaurar el acceso general a una aplicación restringida. Realiza los pasos siguientes:
-1. Mientras visualizas la configuración RUM de una aplicación, haz clic en el botón **Edit application** (Editar aplicación) situado en la parte superior de la pantalla. Aparece un menú desplegable.
-1. Selecciona **Manage App Permissions** (Gestionar permisos de aplicaciones).
-1. Haz clic en **Restore Full Access** (Restablecer acceso completo).
-1. Haz clic en **Save** (Guardar).
+Debes tener acceso de edición para restaurar el acceso general a una aplicación restringida. Completa los siguientes pasos:
+1. Mientras visualizas la configuración RUM de una aplicación, haz clic en el botón **Edit application** en la parte superior de la pantalla. Aparece un menú desplegable.
+1. Seleccione **Manage App Permissions**.
+1. Haga clic en **Restore Full Access**.
+1. Haga clic en **Save**.
-## Referencias adicionales
+## Lectura adicional {#further-reading}.
{{< partial name="whats-next/whats-next.html" >}}
@@ -236,13 +264,13 @@ Debes tener acceso de edición para restaurar el acceso general a una aplicació
[5]: /es/real_user_monitoring/correlate_with_other_telemetry/apm/
[6]: /es/real_user_monitoring/error_tracking/
[7]: /es/real_user_monitoring/application_monitoring/browser/monitoring_page_performance/#event-timings-and-core-web-vitals
-[8]: /es/real_user_monitoring/ios/mobile_vitals/
-[9]: /es/real_user_monitoring/android/mobile_vitals/
-[10]: /es/real_user_monitoring/ios/web_view_tracking/
-[11]: /es/real_user_monitoring/android/web_view_tracking/
-[12]: /es/real_user_monitoring/session_replay/browser/
-[13]: /es/real_user_monitoring/session_replay/browser/privacy_options/
-[14]: /es/real_user_monitoring/session_replay/browser/developer_tools/
+[8]: /es/real_user_monitoring/application_monitoring/ios/mobile_vitals/
+[9]: /es/real_user_monitoring/application_monitoring/android/mobile_vitals/
+[10]: /es/real_user_monitoring/application_monitoring/ios/web_view_tracking/
+[11]: /es/real_user_monitoring/application_monitoring/android/web_view_tracking/
+[12]: /es/session_replay/browser/
+[13]: /es/session_replay/browser/privacy_options/
+[14]: /es/session_replay/browser/dev_tools/
[15]: /es/real_user_monitoring/application_monitoring/browser/setup/
[16]: /es/real_user_monitoring/application_monitoring/
[17]: https://app.datadoghq.com/rum/optimization/inspect
diff --git a/content/es/real_user_monitoring/application_monitoring/browser/advanced_configuration.mdoc.md b/content/es/real_user_monitoring/application_monitoring/browser/advanced_configuration.mdoc.md
new file mode 100644
index 00000000000..5f06668d951
--- /dev/null
+++ b/content/es/real_user_monitoring/application_monitoring/browser/advanced_configuration.mdoc.md
@@ -0,0 +1,1894 @@
+---
+aliases:
+- /es/real_user_monitoring/installation/advanced_configuration/
+- /es/real_user_monitoring/browser/modifying_data_and_context/
+- /es/real_user_monitoring/browser/advanced_configuration/
+content_filters:
+- option_group_id: rum_browser_sdk_source_options
+ trait_id: lib_src
+- option_group_id: rum_browser_sdk_version_for_advanced_config_options
+ trait_id: rum_browser_sdk_version
+description: Configura el SDK del navegador RUM para modificar la recolección de datos,
+ sobrescribir nombres de vistas, gestionar sesiones de usuario y controlar el muestreo
+ según las necesidades de tu aplicación.
+further_reading:
+- link: /real_user_monitoring/application_monitoring/browser/tracking_user_actions
+ tag: Documentación
+ text: Seguimiento de acciones de usuario
+- link: https://www.datadoghq.com/blog/real-user-monitoring-with-datadog/
+ tag: Blog
+ text: Real User Monitoring
+- link: /real_user_monitoring/application_monitoring/browser/data_collected/
+ tag: Documentación
+ text: Datos del navegador RUM recolectados
+- link: /real_user_monitoring/explorer/
+ tag: Documentación
+ text: Explora tus vistas dentro de Datadog
+- link: /real_user_monitoring/explorer/visualize/
+ tag: Documentación
+ text: Aplica visualizaciones a tus eventos
+- link: /logs/log_configuration/attributes_naming_convention
+ tag: Documentación
+ text: Atributos estándar de Datadog
+- link: https://learn.datadoghq.com/courses/configure-rum-javascript
+ tag: Centro de aprendizaje
+ text: Configura Real User Monitoring (RUM) para aplicaciones web en JavaScript
+title: Configuración avanzada
+---
+## Resumen {% #overview %}
+
+Existen varias formas en las que puedes modificar los [datos y contexto recolectados][1] por RUM, para apoyar tus necesidades de:
+
+- Proteger datos sensibles como información personal identificable.
+- Conectar una sesión de usuario con tu identificación interna de ese usuario, para ayudar con el soporte.
+- Reducir la cantidad de datos RUM que estás recolectando, a través del muestreo de datos.
+- Proporcionando más contexto que el que los atributos estándar ofrecen sobre el origen de los datos.
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "2.17.0") %}
+
+## Sobrescribir los nombres de vista RUM predeterminados {% #override-default-rum-view-names %}
+
+A partir de [versión 2.17.0][3], puedes agregar nombres de vista y asignarlos a un servicio dedicado que es propiedad de un equipo, rastreando eventos de vista manualmente con la opción `trackViewsManually`.
+
+El SDK del navegador RUM genera automáticamente un [evento de vista][2] para cada nueva página visitada por tus usuarios, o cuando se cambia la URL de la página (para aplicaciones de una sola página). Un nombre de vista se calcula a partir de la URL de la página actual, donde los IDs variables se eliminan automáticamente. Un segmento de ruta que contiene al menos un número se considera un ID variable. Por ejemplo, `/dashboard/1234` y `/dashboard/9a` se convierten en `/dashboard/?`.
+
+Para sobrescribir los nombres de vista RUM predeterminados:
+
+1. Establece `trackViewsManually` en verdadero al inicializar el SDK del navegador RUM.
+
+
+ {% if equals($lib_src, "npm") %}
+ ```javascript
+ import { datadogRum } from '@datadog/browser-rum';
+
+ datadogRum.init({
+ ...,
+ trackViewsManually: true,
+ ...
+ });
+ ```
+ {% /if %}
+
+
+
+ {% if equals($lib_src, "cdn_async") %}
+ ```javascript
+ window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ ...,
+ trackViewsManually: true,
+ ...
+ })
+ })
+ ```
+ {% /if %}
+
+
+
+ {% if equals($lib_src, "cdn_sync") %}
+ ```javascript
+ window.DD_RUM &&
+ window.DD_RUM.init({
+ ...,
+ trackViewsManually: true,
+ ...
+ });
+ ```
+ {% /if %}
+
+2. Debes iniciar vistas para cada nueva página o cambio de ruta (para aplicaciones de una sola página). Los datos RUM se recopilan cuando la vista comienza.
+{% /if %}
+
+
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "4.13.0") %}
+
+### Define el nombre del servicio y la versión {% #define-service-name-and-version %}
+
+A partir de [versión 4.13.0][16], también puedes definir opcionalmente el nombre del servicio asociado y la versión.
+
+- **Nombre de Vista**: Por defecto, se establece en la ruta de la URL de la página.
+- **Servicio**: Por defecto, se establece en el servicio predeterminado especificado al crear tu aplicación RUM.
+- **Versión**: Por defecto, se establece en la versión predeterminada especificada al crear tu aplicación RUM.
+{% /if %}
+
+
+
+
+
+{% if includes($rum_browser_sdk_version, ["lt_2_13_0", "gte_2_13_0", "gte_2_17_0"]) %}
+
+## Realizar el seguimiento manual de las vistas de página {% #manually-track-pageviews %}
+
+El siguiente ejemplo realiza el seguimiento manual de las vistas de página en la página `checkout` en una aplicación RUM. No se puede especificar ningún servicio o versión.
+
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.startView('checkout')
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.startView('checkout')
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.startView('checkout')
+```
+{% /if %}
+{% /if %}
+
+
+
+{% if includes($rum_browser_sdk_version, ["gte_4_13_0", "gte_4_49_0", "gte_5_22_0"]) %}
+
+El siguiente ejemplo realiza el seguimiento manual de las vistas de página en la página `checkout` en una aplicación RUM. Utiliza `checkout` para el nombre de la vista y asocia el servicio `purchase` con la versión `1.2.3`.
+
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.startView({
+ name: 'checkout',
+ service: 'purchase',
+ version: '1.2.3'
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.startView({
+ name: 'checkout',
+ service: 'purchase',
+ version: '1.2.3'
+ })
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.startView({
+ name: 'checkout',
+ service: 'purchase',
+ version: '1.2.3'
+})
+```
+{% /if %}
+{% /if %}
+
+
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "5.28.0") %}
+
+- **Contexto**: A partir de [versión 5.28.0][19], puedes agregar contexto a las vistas y los eventos secundarios de las vistas.
+
+El siguiente ejemplo realiza el seguimiento manual de las vistas de página en la página `checkout` en una aplicación RUM. Usa `checkout` para el nombre de la vista y asocia el servicio `purchase` con la versión `1.2.3`.
+
+
+ {% if equals($lib_src, "npm") %}
+ ```javascript
+ datadogRum.startView({
+ name: 'checkout',
+ service: 'purchase',
+ version: '1.2.3',
+ context: {
+ payment: 'Done'
+ },
+ })
+ ```
+ {% /if %}
+
+
+
+ {% if equals($lib_src, "cdn_async") %}
+ ```javascript
+ window.DD_RUM.onReady(function() {
+ window.DD_RUM.startView({
+ name: 'checkout',
+ service: 'purchase',
+ version: '1.2.3',
+ context: {
+ payment: 'Done'
+ },
+ })
+ })
+ ```
+ {% /if %}
+
+
+
+ {% if equals($lib_src, "cdn_sync") %}
+ ```javascript
+ window.DD_RUM && window.DD_RUM.startView({
+ name: 'checkout',
+ service: 'purchase',
+ version: '1.2.3',
+ context: {
+ payment: 'Done'
+ },
+ })
+ ```
+ {% /if %}
+
+{% /if %}
+
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "2.17.0") %}
+
+### Instrumentación del enrutador de React {% #react-router-instrumentation %}
+
+Si estás utilizando React, Angular, Vue o cualquier otro marco de frontend, Datadog recomienda implementar la lógica de `startView` a nivel del enrutador del marco.
+
+Para anular los nombres de vista RUM predeterminados para que se alineen con cómo los has definido en tu aplicación React, necesitas seguir los pasos a continuación.
+
+**Nota**: Estas instrucciones son específicas para la biblioteca **React Router v6**.
+
+1. Establece `trackViewsManually` en `true` al inicializar el SDK del navegador RUM como se describe [arriba](#override-default-rum-view-names).
+
+2. Inicia vistas para cada cambio de ruta.
+
+ {% if equals($lib_src, "npm") %}
+ ```javascript
+ import { matchRoutes, useLocation } from 'react-router-dom';
+ import { routes } from 'path/to/routes';
+ import { datadogRum } from "@datadog/browser-rum";
+
+ export default function App() {
+ // Track every route change with useLocation API
+ let location = useLocation();
+
+ useEffect(() => {
+ const routeMatches = matchRoutes(routes, location.pathname);
+ const viewName = routeMatches && computeViewName(routeMatches);
+ if (viewName) {
+ datadogRum.startView({name: viewName});
+ }
+ }, [location.pathname]);
+
+ ...
+ }
+
+ // Compute view name out of routeMatches
+ function computeViewName(routeMatches) {
+ let viewName = "";
+ for (let index = 0; index < routeMatches.length; index++) {
+ const routeMatch = routeMatches[index];
+ const path = routeMatch.route.path;
+ // Skip pathless routes
+ if (!path) {
+ continue;
+ }
+
+ if (path.startsWith("/")) {
+ // Handle absolute child route paths
+ viewName = path;
+ } else {
+ // Handle route paths ending with "/"
+ viewName += viewName.endsWith("/") ? path : `/${path}`;
+ }
+ }
+
+ return viewName || '/';
+ }
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_async") %}
+ ```javascript
+ import { matchRoutes, useLocation } from 'react-router-dom';
+ import { routes } from 'path/to/routes';
+
+ export default function App() {
+ // Track every route change with useLocation API
+ let location = useLocation();
+
+ useEffect(() => {
+ const routeMatches = matchRoutes(routes, location.pathname);
+ const viewName = routeMatches && computeViewName(routeMatches);
+ if (viewName) {
+ DD_RUM.onReady(function() {
+ DD_RUM.startView({name: viewName});
+ });
+ }
+ }, [location.pathname]);
+
+ ...
+ }
+
+ // Compute view name out of routeMatches
+ function computeViewName(routeMatches) {
+ let viewName = "";
+ for (let index = 0; index < routeMatches.length; index++) {
+ const routeMatch = routeMatches[index];
+ const path = routeMatch.route.path;
+ // Skip pathless routes
+ if (!path) {
+ continue;
+ }
+
+ if (path.startsWith("/")) {
+ // Handle absolute child route paths
+ viewName = path;
+ } else {
+ // Handle route paths ending with "/"
+ viewName += viewName.endsWith("/") ? path : `/${path}`;
+ }
+ }
+
+ return viewName || '/';
+ }
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_sync") %}
+ ```javascript
+ import { matchRoutes, useLocation } from 'react-router-dom';
+ import { routes } from 'path/to/routes';
+
+ export default function App() {
+ // Track every route change with useLocation API
+ let location = useLocation();
+
+ useEffect(() => {
+ const routeMatches = matchRoutes(routes, location.pathname);
+ const viewName = routeMatches && computeViewName(routeMatches);
+ if (viewName) {
+ window.DD_RUM &&
+ window.DD_RUM.startView({name: viewName});
+ }
+ }, [location.pathname]);
+
+ ...
+ }
+
+ // Compute view name out of routeMatches
+ function computeViewName(routeMatches) {
+ let viewName = "";
+ for (let index = 0; index < routeMatches.length; index++) {
+ const routeMatch = routeMatches[index];
+ const path = routeMatch.route.path;
+ // Skip pathless routes
+ if (!path) {
+ continue;
+ }
+
+ if (path.startsWith("/")) {
+ // Handle absolute child route paths
+ viewName = path;
+ } else {
+ // Handle route paths ending with "/"
+ viewName += viewName.endsWith("/") ? path : `/${path}`;
+ }
+ }
+
+ return viewName || '/';
+ }
+ ```
+ {% /if %}
+{% /if %}
+
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "2.17.0") %}
+### Establecer nombre de vista {% #set-view-name %}
+
+Usa `setViewName(name: string)` para actualizar el nombre de la vista actual. Esto te permite cambiar el nombre de la vista durante la vista sin iniciar una nueva.
+
+ {% if equals($lib_src, "npm") %}
+ ```javascript
+ import { datadogRum } from '@datadog/browser-rum';
+
+ datadogRum.setViewName('');
+
+ // Code example
+ datadogRum.setViewName('Checkout');
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_async") %}
+ ```javascript
+ window.DD_RUM.onReady(function() {
+ window.DD_RUM.setViewName('');
+ })
+
+ // Code example
+ window.DD_RUM.onReady(function() {
+ window.DD_RUM.setViewName('Checkout');
+ })
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_sync") %}
+ ```javascript
+ window.DD_RUM && window.DD_RUM.setViewName('');
+
+ // Code example
+ window.DD_RUM && window.DD_RUM.setViewName('Checkout');
+ ```
+ {% /if %}
+
+**Nota**: Cambiar el nombre de la vista afecta a la vista y sus eventos secundarios desde el momento en que se llama al método.
+{% /if %}
+
+
+Para más información, consulta [Configuración de Monitoreo del Navegador][4].
+
+
+## Enriquece y controla los datos RUM {% #enrich-and-control-rum-data %}
+
+El SDK del navegador RUM captura eventos RUM y completa sus atributos principales. La función de callback `beforeSend` te da acceso a cada evento recopilado por el SDK del navegador RUM antes de que se envíe a Datadog.
+
+Interceptar los eventos RUM te permite:
+
+- Enriquece tus eventos RUM con atributos de contexto adicionales
+- Modifica tus eventos RUM para alterar su contenido o redactar secuencias sensibles (ver [lista de propiedades editables](#modify-the-content-of-a-rum-event))
+- Descarta eventos RUM seleccionados
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "2.13.0") %}
+A partir de [versión 2.13.0][5], `beforeSend` toma dos argumentos: el `event` generado por el SDK del navegador RUM, y el `context` que activó la creación del evento RUM.
+
+```javascript
+function beforeSend(event, context)
+```
+
+Los valores potenciales `context` son:
+
+| Tipo de evento RUM | Contexto |
+|------------------|---------------------------|
+| Vista | [Location][6] |
+| Acción | [Evento][7] y pila de manejo |
+| Recurso (XHR) | [XMLHttpRequest][8], [PerformanceResourceTiming][9], y pila de manejo |
+| Recurso (Fetch) | [Solicitud][10], [Respuesta][11], [PerformanceResourceTiming][9], y pila de manejo |
+| Recurso (Otro) | [PerformanceResourceTiming][9] |
+| Error | [Error][12] |
+| Tarea Larga | [PerformanceLongTaskTiming][13] |
+
+Para más información, consulta la [guía de enriquecimiento y control de datos RUM][14].
+{% /if %}
+
+
+### Enriquece eventos RUM {% #enrich-rum-events %}
+
+Junto con los atributos añadidos con el [Global Context API](#global-context) o la [recolección de datos Feature Flag](#enrich-rum-events-with-feature-flags), puedes añadir atributos de contexto adicionales al evento. Por ejemplo, etiqueta tus eventos de recurso RUM con datos extraídos de un objeto de respuesta de fetch:
+
+ {% if equals($lib_src, "npm") %}
+ ```javascript
+ import { datadogRum } from '@datadog/browser-rum';
+
+ datadogRum.init({
+ ...,
+ beforeSend: (event, context) => {
+ // collect a RUM resource's response headers
+ if (event.type === 'resource' && event.resource.type === 'fetch') {
+ event.context.responseHeaders = Object.fromEntries(context.response.headers)
+ }
+ return true
+ },
+ ...
+ });
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_async") %}
+ ```javascript
+ window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ ...,
+ beforeSend: (event, context) => {
+ // collect a RUM resource's response headers
+ if (event.type === 'resource' && event.resource.type === 'fetch') {
+ event.context.responseHeaders = Object.fromEntries(context.response.headers)
+ }
+ return true
+ },
+ ...
+ })
+ })
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_sync") %}
+ ```javascript
+ window.DD_RUM &&
+ window.DD_RUM.init({
+ ...,
+ beforeSend: (event, context) => {
+ // collect a RUM resource's response headers
+ if (event.type === 'resource' && event.resource.type === 'fetch') {
+ event.context.responseHeaders = Object.fromEntries(context.response.headers)
+ }
+ return true
+ },
+ ...
+ });
+ ```
+ {% /if %}
+
+Si un usuario pertenece a múltiples equipos, agrega pares clave-valor adicionales en tus llamadas a la Global Context API.
+
+El SDK del navegador RUM ignora los atributos añadidos fuera de `event.context`.
+
+### Enriquece los eventos RUM con Feature Flags {% #enrich-rum-events-with-feature-flags %}.
+
+Puedes [enriquecer los datos de eventos RUM con Feature Flags][14] para obtener contexto adicional y visibilidad en el seguimiento del rendimiento. Esto te permite determinar qué usuarios ven una experiencia de usuario específica y si está afectando negativamente el rendimiento del usuario.
+
+### Modifica el contenido de un evento RUM {% #modify-the-content-of-a-rum-event %}
+
+Por ejemplo, para redactar direcciones de correo electrónico de las URL de tu aplicación web:
+
+ {% if equals($lib_src, "npm") %}
+ ```javascript
+ import { datadogRum } from '@datadog/browser-rum';
+
+ datadogRum.init({
+ ...,
+ beforeSend: (event) => {
+ // remove email from view url
+ event.view.url = event.view.url.replace(/email=[^&]*/, "email=REDACTED")
+ },
+ ...
+ });
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_async") %}
+ ```javascript
+ window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ ...,
+ beforeSend: (event) => {
+ // remove email from view url
+ event.view.url = event.view.url.replace(/email=[^&]*/, "email=REDACTED")
+ },
+ ...
+ })
+ })
+ ```
+ {% /if %}
+
+
+ {% if equals($lib_src, "cdn_sync") %}
+ ```javascript
+ window.DD_RUM &&
+ window.DD_RUM.init({
+ ...,
+ beforeSend: (event) => {
+ // remove email from view url
+ event.view.url = event.view.url.replace(/email=[^&]*/, "email=REDACTED")
+ },
+ ...
+ });
+ ```
+ {% /if %}
+
+Puedes actualizar las siguientes propiedades del evento:
+
+| Atributo | Tipo | Descripción |
+| ------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `view.url` | Cadena | La URL de la página web activa. |
+| `view.referrer` | Cadena | La URL de la página web anterior desde la cual se siguió un enlace a la página actualmente solicitada. |
+| `view.name` | Cadena | El nombre de la vista actual. |
+| `view.performance.lcp.resource_url` | Cadena | La URL del recurso para el Largest Contentful Paint. |
+| `service` | Cadena | El nombre del servicio para tu aplicación. |
+| `version` | Cadena | La versión de la aplicación. Por ejemplo: 1.2.3, 6c44da20, o 2020.02.13. |
+| `action.target.name` | Cadena | El elemento con el que el usuario interactuó. Solo para acciones recolectadas automáticamente. |
+| `error.message` | Cadena | Un mensaje conciso, legible por humanos, de una línea que explica el error. |
+| `error.stack` | Cadena | La traza de pila o información complementaria sobre el error. |
+| `error.resource.url` | Cadena | La URL del recurso que provocó el error. |
+| `resource.url` | Cadena | La URL del recurso. |
+| `long_task.scripts.source_url` | Cadena | La URL del recurso del script |
+| `long_task.scripts.invoker` | Cadena | Un nombre significativo que indica cómo se llamó al script |
+| `context` | Objeto | Atributos añadidos con la [API de Contexto Global](#global-context), la [API de Contexto de Vista](#view-context), o al generar eventos manualmente (por ejemplo, `addError` y **`addAction`**). |
+
+El SDK del Navegador RUM ignora las modificaciones realizadas a las propiedades de eventos no listadas anteriormente. Para más información sobre las propiedades de eventos, consulte el [repositorio de GitHub del SDK del Navegador RUM][15].
+
+**Nota**: A diferencia de otros eventos, los eventos de visualización se envían múltiples veces a Datadog para reflejar las actualizaciones que ocurren durante su ciclo de vida. Una actualización de un evento de visualización anterior aún puede enviarse mientras una nueva visualización está activa. Datadog recomienda tener en cuenta este comportamiento al modificar el contenido de un evento de visualización.
+
+```javascript
+beforeSend: (event) => {
+ // discouraged, as the current view name could be applied to both the active view and the previous views
+ event.view.name = getCurrentViewName()
+
+ // recommended
+ event.view.name = getViewNameForUrl(event.view.url)
+}
+```
+
+### Descarta un evento RUM {% #discard-a-rum-event %}
+
+Con la `beforeSend` API, descarta un evento RUM devolviendo `false`:
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+datadogRum.init({
+ ...,
+ beforeSend: (event) => {
+ if (shouldDiscard(event)) {
+ return false
+ }
+ ...
+ },
+ ...
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ ...,
+ beforeSend: (event) => {
+ if (shouldDiscard(event)) {
+ return false
+ },
+ ...
+ },
+ ...
+ })
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM &&
+ window.DD_RUM.init({
+ ...,
+ beforeSend: (event) => {
+ if (shouldDiscard(event)) {
+ return false
+ }
+ ...
+ },
+ ...
+ });
+```
+{% /if %}
+
+**Nota**: Los eventos de visualización no se pueden descartar.
+
+## Sesión de usuario {% #user-session %}
+
+Agregar información del usuario a tus sesiones RUM te ayuda a:
+
+- Seguir el recorrido de un usuario dado
+- Saber qué usuarios son los más afectados por errores
+- Monitorear el rendimiento de tus usuarios más importantes
+
+{% img src="real_user_monitoring/browser/advanced_configuration/user-api.png" alt=" API de usuario en la interfaz de usuario de RUM" /%}
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "6.4.0") %}
+En versiones 6.4.0 y superiores, los siguientes atributos están disponibles:
+
+| Atributo | Tipo | Requerido | Descripción |
+|------------|------|------|----------------------------------------------------------------------------------------------------|
+| `usr.id` | Cadena | Sí | Identificador único del usuario. |
+| `usr.name` | Cadena | No | Nombre amigable del usuario, mostrado por defecto en la interfaz de usuario de RUM. |
+| `usr.email` | Cadena | No | Correo electrónico del usuario, mostrado en la interfaz de usuario de RUM si el nombre del usuario no está presente. También se utiliza para obtener Gravatars. |
+{% /if %}
+
+
+
+{% if not(semverIsAtLeast($rum_browser_sdk_version, "6.4.0")) %}
+Los atributos a continuación son opcionales en versiones anteriores a 6.4.0, pero Datadog recomienda encarecidamente proporcionar al menos uno de ellos. Por ejemplo, debes establecer el ID del usuario en tus sesiones para ver datos relevantes en algunos paneles de RUM predeterminados, que dependen de `usr.id` como parte de la consulta.
+
+| Atributo | Tipo | Descripción |
+|------------|------|----------------------------------------------------------------------------------------------------|
+| `usr.id` | Cadena | Identificador único del usuario. |
+| `usr.name` | Cadena | Nombre amigable del usuario, mostrado por defecto en la interfaz de usuario de RUM. |
+| `usr.email` | Cadena | Correo electrónico del usuario, mostrado en la interfaz de usuario de RUM si el nombre del usuario no está presente. También se utiliza para obtener Gravatars. |
+
+**Nota**: 'Usuario Público' se muestra en la interfaz de usuario de RUM cuando `usr.name` no está configurado, incluso si `usr.email` y `usr.id` están definidos.
+
+Aumenta tus capacidades de filtrado añadiendo atributos adicionales además de los recomendados. Por ejemplo, añade información sobre el plan del usuario, o a qué grupo de usuarios pertenece.
+
+Al realizar cambios en el objeto de sesión del usuario, todos los eventos de RUM recopilados después del cambio contienen la información actualizada.
+
+**Nota**: Eliminar la información de la sesión del usuario, como en un cierre de sesión, retiene la información del usuario en la última vista antes del cierre de sesión, pero no en vistas posteriores o a nivel de sesión, ya que los datos de la sesión utilizan los valores de la última vista.
+{% /if %}
+
+
+### Identificar sesión de usuario {% #identify-user-session %}
+
+`datadogRum.setUser()`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.setUser({
+ id: '1234',
+ name: 'John Doe',
+ email: 'john@doe.com',
+ plan: 'premium',
+ ...
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setUser({
+ id: '1234',
+ name: 'John Doe',
+ email: 'john@doe.com',
+ plan: 'premium',
+ ...
+ })
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.setUser({
+ id: '1234',
+ name: 'John Doe',
+ email: 'john@doe.com',
+ plan: 'premium',
+ ...
+})
+```
+{% /if %}
+
+### Acceder a la sesión de usuario {% #access-user-session %}
+
+`datadogRum.getUser()`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.getUser()
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.getUser()
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.getUser()
+```
+{% /if %}
+
+### Añadir/Sobrescribir propiedad de sesión de usuario {% #addoverride-user-session-property %}
+
+`datadogRum.setUserProperty('', )`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.setUserProperty('name', 'John Doe')
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setUserProperty('name', 'John Doe')
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.setUserProperty('name', 'John Doe')
+```
+{% /if %}
+
+### Eliminar propiedad de sesión de usuario {% #remove-user-session-property %}
+
+`datadogRum.removeUserProperty('')`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.removeUserProperty('name')
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.removeUserProperty('name')
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.removeUserProperty('name')
+```
+{% /if %}
+
+### Limpiar propiedad de sesión de usuario {% #clear-user-session-property %}
+
+`datadogRum.clearUser()`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.clearUser()
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.clearUser()
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.clearUser()
+```
+{% /if %}
+
+## Cuenta {% #account %}
+
+Para agrupar usuarios en diferentes conjuntos, utiliza el concepto de cuenta.
+
+Los siguientes atributos están disponibles:
+
+| Atributo | Tipo | Requerido | Descripción |
+|----------------|--------|----------|------------------------------------------------------------|
+| `account.id` | Cadena | Sí | Identificador único de cuenta. |
+| `account.name` | Cadena | No Nombre amigable de la cuenta, mostrado por defecto en la interfaz de usuario de RUM. |
+
+### Identificar cuenta {% #identify-account %}
+
+`datadogRum.setAccount()`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.setAccount({
+ id: '1234',
+ name: 'My Company Name',
+ ...
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setAccount({
+ id: '1234',
+ name: 'My Company Name',
+ ...
+ })
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.setAccount({
+ id: '1234',
+ name: 'My Company Name',
+ ...
+})
+```
+{% /if %}
+
+### Acceder a la cuenta {% #access-account %}
+
+`datadogRum.getAccount()`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.getAccount()
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.getAccount()
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.getAccount()
+```
+{% /if %}
+
+### Añadir/Sobrescribir propiedad de la cuenta {% #addoverride-account-property %}
+
+`datadogRum.setAccountProperty('', )`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.setAccountProperty('name', 'My Company Name')
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setAccountProperty('name', 'My Company Name')
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.setAccountProperty('name', 'My Company Name')
+```
+{% /if %}
+
+### Eliminar propiedad de la cuenta {% #remove-account-property %}
+
+`datadogRum.removeAccountProperty('')`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.removeAccountProperty('name')
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.removeAccountProperty('name')
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.removeAccountProperty('name')
+```
+{% /if %}
+
+### Limpiar propiedades de la cuenta {% #clear-account-properties %}
+
+`datadogRum.clearAccount()`
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+datadogRum.clearAccount()
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.clearAccount()
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.clearAccount()
+```
+{% /if %}
+
+## Muestreo {% #sampling %}
+
+Por defecto, no se aplica muestreo en el número de sesiones recolectadas. Para aplicar un muestreo relativo (en porcentaje) al número de sesiones recolectadas, utiliza el parámetro `sessionSampleRate` al inicializar RUM.
+
+El siguiente ejemplo recolecta solo el 90% de todas las sesiones en una aplicación RUM dada:
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+datadogRum.init({
+ applicationId: '',
+ clientToken: '',
+ site: '',
+ sessionSampleRate: 90,
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ clientToken: '',
+ applicationId: '',
+ site: '',
+ sessionSampleRate: 90,
+ })
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM &&
+ window.DD_RUM.init({
+ clientToken: '',
+ applicationId: '',
+ site: '',
+ sessionSampleRate: 90,
+ });
+```
+{% /if %}
+
+Para una sesión excluida por muestreo, no se recolectan las vistas de página ni la telemetría asociada a esa sesión.
+
+## Consentimiento de seguimiento del usuario {% #user-tracking-consent %}
+
+Para cumplir con el GDPR, CCPA y regulaciones similares, el SDK del navegador RUM te permite proporcionar el valor de consentimiento de seguimiento en la inicialización. Para más información sobre el consentimiento de seguimiento, consulta [Seguridad de Datos][17].
+
+El parámetro de inicialización `trackingConsent` puede ser uno de los siguientes valores:
+
+1. `"granted"` (por defecto): El SDK del navegador RUM comienza a recopilar datos y los envía a Datadog.
+2. `"not-granted"`: El SDK del navegador RUM no recopila ningún dato.
+
+Para cambiar el valor de consentimiento de seguimiento después de que el SDK del navegador RUM esté inicializado, utiliza la llamada a la API `setTrackingConsent()`. El SDK del navegador RUM cambia su comportamiento de acuerdo con el nuevo valor:
+
+- cuando se cambia de `"granted"` a `"not-granted"`, la sesión RUM se detiene, y los datos ya no se envían a Datadog.
+- cuando se cambia de `"not-granted"` a `"granted"`, se crea una nueva sesión RUM si no hay una sesión anterior activa, y la recopilación de datos se reanuda.
+
+Este estado no se sincroniza entre pestañas ni se persiste entre navegaciones. Es tu responsabilidad proporcionar la decisión del usuario durante la inicialización del SDK del navegador RUM o utilizando `setTrackingConsent()`.
+
+Cuando se utiliza `setTrackingConsent()` antes de `init()`, el valor proporcionado tiene prioridad sobre el parámetro de inicialización.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+datadogRum.init({
+ ...,
+ trackingConsent: 'not-granted'
+});
+
+acceptCookieBannerButton.addEventListener('click', function() {
+ datadogRum.setTrackingConsent('granted');
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ ...,
+ trackingConsent: 'not-granted'
+ });
+});
+
+acceptCookieBannerButton.addEventListener('click', () => {
+ window.DD_RUM.onReady(function() {
+ window.DD_RUM.setTrackingConsent('granted');
+ });
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.init({
+ ...,
+ trackingConsent: 'not-granted'
+});
+
+acceptCookieBannerButton.addEventListener('click', () => {
+ window.DD_RUM && window.DD_RUM.setTrackingConsent('granted');
+});
+```
+{% /if %}
+
+## Contexto de visualización {% #view-context %}
+
+
+A partir de [versión 5.28.0][20], el contexto de los eventos de visualización es modificable. El contexto solo se puede agregar a la visualización actual y se aplica a sus eventos secundarios (como `action`, `error` y `timing`) mediante las funciones `startView`, `setViewContext` y `setViewContextProperty`.
+
+### Iniciar visualización con contexto {% #start-view-with-context %}
+
+Opcionalmente, define el contexto al iniciar una visualización con las opciones [`startView`](#override-default-rum-view-names).
+
+### Agregar contexto de visualización {% #add-view-context %}
+
+Enriquecer o modificar el contexto de los eventos de visualización RUM y los eventos secundarios correspondientes con la API `setViewContextProperty(key: string, value: any)`.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+datadogRum.setViewContextProperty('', '');
+
+// Code example
+datadogRum.setViewContextProperty('activity', {
+ hasPaid: true,
+ amount: 23.42
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setViewContextProperty('', '');
+})
+
+// Code example
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setViewContextProperty('activity', {
+ hasPaid: true,
+ amount: 23.42
+ });
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.setViewContextProperty('', '');
+
+// Code example
+window.DD_RUM && window.DD_RUM.setViewContextProperty('activity', {
+ hasPaid: true,
+ amount: 23.42
+});
+```
+{% /if %}
+
+### Reemplazar contexto de visualización {% #replace-view-context %}
+
+Reemplazar el contexto de tus eventos de visualización RUM y los eventos secundarios correspondientes con la API `setViewContext(context: Context)`.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+datadogRum.setViewContext({ '': '' });
+
+// Code example
+datadogRum.setViewContext({
+ originalUrl: 'shopist.io/department/chairs',
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setViewContext({ '': '' });
+})
+
+// Code example
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setViewContext({
+ originalUrl: 'shopist.io/department/chairs',
+ })
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM &&
+ window.DD_RUM.setViewContext({ '': '' });
+
+// Code example
+window.DD_RUM &&
+ window.DD_RUM.setViewContext({
+ originalUrl: 'shopist.io/department/chairs',
+ });
+```
+{% /if %}
+
+## Contexto de error {% #error-context %}
+
+### Adjuntando contexto de error local con dd_context {% #attaching-local-error-context-with-dd-context %}
+
+Al capturar errores, se puede proporcionar contexto adicional en el momento en que se genera un error. En lugar de pasar información adicional a través de la `addError()` API, puede adjuntar una propiedad `dd_context` directamente a la instancia de error. El SDK de RUM para navegadores detecta automáticamente esta propiedad y la integra en el contexto final del evento de error.
+
+```javascript
+const error = new Error('Something went wrong')
+error.dd_context = { component: 'Menu', param: 123, }
+throw error
+```
+
+## Contexto global {% #global-context %}
+
+### Agregar propiedad de contexto global {% #add-global-context-property %}
+
+Después de que RUM esté inicializado, agregue contexto adicional a todos los eventos de RUM recopilados de su aplicación con la `setGlobalContextProperty(key: string, value: any)` API:
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+datadogRum.setGlobalContextProperty('', );
+
+// Code example
+datadogRum.setGlobalContextProperty('activity', {
+ hasPaid: true,
+ amount: 23.42
+});
+```
+
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setGlobalContextProperty('', '');
+})
+
+// Code example
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setGlobalContextProperty('activity', {
+ hasPaid: true,
+ amount: 23.42
+ });
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.setGlobalContextProperty('', '');
+
+// Code example
+window.DD_RUM && window.DD_RUM.setGlobalContextProperty('activity', {
+ hasPaid: true,
+ amount: 23.42
+});
+```
+{% /if %}
+
+### Eliminar propiedad de contexto global {% #remove-global-context-property %}
+
+Puede eliminar una propiedad de contexto global definida previamente.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+datadogRum.removeGlobalContextProperty('');
+
+// Code example
+datadogRum.removeGlobalContextProperty('codeVersion');
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.removeGlobalContextProperty('');
+})
+
+// Code example
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.removeGlobalContextProperty('codeVersion');
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM &&
+ window.DD_RUM.removeGlobalContextProperty('');
+
+// Code example
+window.DD_RUM &&
+ window.DD_RUM.removeGlobalContextProperty('codeVersion');
+```
+{% /if %}
+
+### Reemplazar contexto global {% #replace-global-context %}
+
+Reemplace el contexto predeterminado para todos sus eventos de RUM con la `setGlobalContext(context: Context)` API.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+datadogRum.setGlobalContext({ '': '' });
+
+// Code example
+datadogRum.setGlobalContext({
+ codeVersion: 34,
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setGlobalContext({ '': '' });
+})
+
+// Code example
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.setGlobalContext({
+ codeVersion: 34,
+ })
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM &&
+ window.DD_RUM.setGlobalContext({ '': '' });
+
+// Code example
+window.DD_RUM &&
+ window.DD_RUM.setGlobalContext({
+ codeVersion: 34,
+ });
+```
+{% /if %}
+
+### Limpiar contexto global {% #clear-global-context %}
+
+Puede limpiar el contexto global utilizando `clearGlobalContext`.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+datadogRum.clearGlobalContext();
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.clearGlobalContext();
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.clearGlobalContext();
+```
+{% /if %}
+
+### Leer contexto global {% #read-global-context %}
+
+Una vez que RUM esté inicializado, lea el contexto global con la `getGlobalContext()` API.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+const context = datadogRum.getGlobalContext();
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ const context = window.DD_RUM.getGlobalContext();
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+const context = window.DD_RUM && window.DD_RUM.getGlobalContext();
+```
+{% /if %}
+
+## Ciclo de vida de los contextos {% #contexts-life-cycle %}
+
+Por defecto, el contexto global y el contexto del usuario se almacenan en la memoria de la página actual, lo que significa que no están:
+
+- guardados después de una recarga completa de la página
+- compartidos entre diferentes pestañas o ventanas de la misma sesión
+
+Para agregarlos a todos los eventos de la sesión, deben ser adjuntados a cada página.
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "4.49.0") %}
+Con la introducción de la opción de configuración `storeContextsAcrossPages` en la versión 4.49.0, esos contextos pueden ser almacenados en [`localStorage`][18], permitiendo los siguientes comportamientos:
+
+- Los contextos se preservan después de una recarga completa
+- Los contextos están sincronizados entre las pestañas abiertas en el mismo origen
+
+Sin embargo, esta función tiene algunas **limitaciones**:
+
+- No se recomienda establecer Información Personal Identificable (PII) en esos contextos, ya que los datos almacenados en `localStorage` sobreviven a la sesión del usuario
+- La función es incompatible con las `trackSessionAcrossSubdomains` opciones porque `localStorage` los datos solo se comparten entre el mismo origen (login.site.com ≠ app.site.com)
+- `localStorage` está limitado a 5 MiB por origen, por lo que los datos específicos de la aplicación, los contextos de Datadog y otros datos de terceros almacenados en el almacenamiento local deben estar dentro de este límite para evitar problemas
+
+{% /if %}
+
+
+## Contexto interno {% #internal-context %}
+
+Después de que se inicializa el SDK de RUM para navegadores de Datadog, puede acceder al contexto interno del SDK. Esto proporciona identificadores y metadatos centrales que el SDK utiliza internamente, como IDs de sesión y detalles de la aplicación.
+
+Puedes explorar los siguientes atributos:
+
+| Atributo | Descripción |
+| -------------- | ----------------------------------------------------------------- |
+| application_id | ID de la aplicación. |
+| session_id | ID de la sesión. |
+| user_action | Objeto que contiene el ID de acción (o indefinido si no se encuentra ninguna acción). |
+| view | Objeto que contiene detalles sobre el evento de visualización actual. |
+
+Para más información, consulta [Datos recopilados por RUM Browser][2].
+
+### Ejemplo {% #example %}
+
+```json
+{
+ application_id : "xxx",
+ session_id : "xxx",
+ user_action: { id: "xxx" },
+ view : {
+ id : "xxx",
+ referrer : "",
+ url: "http://localhost:8080/",
+ name: "homepage"
+ }
+}
+```
+
+Opcionalmente, puedes usar el parámetro `startTime` para obtener el contexto de un momento específico. Si se omite el parámetro, se devuelve el contexto actual.
+
+```typescript
+getInternalContext (startTime?: 'number' | undefined)
+```
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum'
+
+datadogRum.getInternalContext() // { session_id: "xxxx", application_id: "xxxx" ... }
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function () {
+ window.DD_RUM.getInternalContext() // { session_id: "xxxx", application_id: "xxxx" ... }
+})
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM && window.DD_RUM.getInternalContext() // { session_id: "xxxx", application_id: "xxxx" ... }
+```
+{% /if %}
+
+
+## Micro frontend {% #micro-frontend %}
+
+El SDK de RUM Browser admite arquitecturas de micro frontends al atribuir eventos a micro frontends específicos utilizando los atributos `service` y `version`. Una única instancia del SDK de RUM se ejecuta a nivel de shell. Los eventos se segmentan por `service` y `version` para que los equipos puedan filtrar tableros, establecer alertas y rastrear el rendimiento por micro frontend.
+
+Datadog proporciona dos enfoques para atribuir eventos de RUM a micro frontends:
+
+1. **Atribución automática**: Utiliza un complemento de construcción que inyecta contexto de código fuente, eliminando el análisis manual de trazas de pila.
+2. **Atribución manual**: Utiliza el callback `beforeSend` para analizar trazas de pila y extraer información del servicio.
+
+
+### Atribución automática de servicio y versión {% #automatic-service-and-version-attribution %}
+
+Este enfoque utiliza un complemento de construcción para inyectar contexto de código fuente en sus paquetes, que el SDK de RUM lee automáticamente para enriquecer eventos con los `service` y `version` correctos.
+
+#### Requisitos previos y configuraciones soportadas {% #prerequisites-and-supported-setups %}
+
+- **Paquetes separados**: Cada micro frontend tiene su propio paquete con rutas de archivo distintas, por ejemplo, utilizando [federación de módulos][21].
+- **Agrupador soportado**: Utilice un agrupador [soportado por los complementos de construcción de Datadog][22].
+- **SDK de navegador**: Versión del SDK de navegador v6.30.1 o superior.
+
+#### Guía de configuración {% #setup-guide %}
+
+**Paso 1 - Configura el [plugin de construcción][23] para cada micro frontend**
+
+En la configuración de construcción de cada micro frontend, habilita la inyección de contexto del código fuente:
+
+{% tabs %}
+{% tab label="Webpack" %}
+
+```javascript
+const { datadogWebpackPlugin } = require('@datadog/webpack-plugin');
+
+module.exports = {
+ plugins: [
+ new datadogWebpackPlugin({
+ rum: {
+ enable: true,
+ sourceCodeContext: {
+ service: 'foo-microfrontend',
+ version: process.env.APP_VERSION || '1.0.0'
+ }
+ }
+ })
+ ]
+};
+```
+{% /tab %}
+
+{% tab label="Vite" %}
+
+```javascript
+import { datadogVitePlugin } from '@datadog/vite-plugin';
+
+export default {
+ plugins: [
+ datadogVitePlugin({
+ rum: {
+ enable: true,
+ sourceCodeContext: {
+ service: 'foo-microfrontend',
+ version: process.env.APP_VERSION || '1.0.0'
+ }
+ }
+ })
+ ]
+};
+```
+{% /tab %}
+
+{% tab label="esbuild" %}
+
+```javascript
+const { datadogEsbuildPlugin } = require('@datadog/esbuild-plugin');
+
+require('esbuild').build({
+ plugins: [
+ datadogEsbuildPlugin({
+ rum: {
+ enable: true,
+ sourceCodeContext: {
+ service: 'foo-microfrontend',
+ version: process.env.APP_VERSION || '1.0.0'
+ }
+ }
+ })
+ ]
+});
+```
+{% /tab %}
+
+{% tab label="Rollup" %}
+
+```javascript
+import { datadogRollupPlugin } from '@datadog/rollup-plugin';
+
+export default {
+ plugins: [
+ datadogRollupPlugin({
+ rum: {
+ enable: true,
+ sourceCodeContext: {
+ service: 'foo-microfrontend',
+ version: process.env.APP_VERSION || '1.0.0'
+ }
+ }
+ })
+ ]
+};
+```
+{% /tab %}
+
+{% tab label="Rspack" %}
+
+```javascript
+const { datadogRspackPlugin } = require('@datadog/rspack-plugin');
+
+module.exports = {
+ plugins: [
+ new datadogRspackPlugin({
+ rum: {
+ enable: true,
+ sourceCodeContext: {
+ service: 'foo-microfrontend',
+ version: process.env.APP_VERSION || '1.0.0'
+ }
+ }
+ })
+ ]
+};
+```
+{% /tab %}
+{% /tabs %}
+
+**Paso 2 - Configura el SDK del navegador a nivel de shell**
+
+[Configura Browser Monitoring][4] en tu aplicación shell (punto de entrada principal). El SDK del navegador enriquece automáticamente los eventos RUM (errores, acciones personalizadas, recursos XHR/Fetch, tareas largas, vitales) con `service` y `version` del mapa de contexto.
+
+{% alert level="warning" %}
+Los eventos que no coinciden con ningún micro frontend se asignan por defecto al servicio y a la versión a nivel de shell.
+{% /alert %}
+
+**Paso 3 - [Explora los datos del micro frontend en Datadog](#explore-micro-frontend-data-in-datadog)**
+
+
+
+{% if semverIsAtLeast($rum_browser_sdk_version, "5.22") %}
+
+### Atribución manual de servicio y versión {% #manual-service-and-version-attribution %}
+
+En la propiedad `beforeSend`, puedes sobrescribir las propiedades de servicio y versión. Para ayudarte a identificar de dónde se originó el evento, utiliza la propiedad `context.handlingStack`.
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { datadogRum } from '@datadog/browser-rum';
+
+const SERVICE_REGEX = /some-pathname\/(?\w+)\/(?\w+)\//;
+
+datadogRum.init({
+ ...,
+ beforeSend: (event, context) => {
+ const stack = context?.handlingStack || event?.error?.stack;
+ const { service, version } = stack?.match(SERVICE_REGEX)?.groups;
+
+ if (service && version) {
+ event.service = service;
+ event.version = version;
+ }
+
+ return true;
+ },
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+const SERVICE_REGEX = /some-pathname\/(?\w+)\/(?\w+)\//;
+
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ ...,
+ beforeSend: (event, context) => {
+ const stack = context?.handlingStack || event?.error?.stack;
+ const { service, version } = stack?.match(SERVICE_REGEX)?.groups;
+
+ if (service && version) {
+ event.service = service;
+ event.version = version;
+ }
+
+ return true;
+ },
+ });
+});
+```
+{% /if %}
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+const SERVICE_REGEX = /some-pathname\/(?\w+)\/(?\w+)\//;
+
+window.DD_RUM && window.DD_RUM.init({
+ ...,
+ beforeSend: (event, context) => {
+ const stack = context?.handlingStack || event?.error?.stack;
+ const { service, version } = stack?.match(SERVICE_REGEX)?.groups;
+
+ if (service && version) {
+ event.service = service;
+ event.version = version;
+ }
+
+ return true;
+ },
+});
+```
+{% /if %}
+
+La expresión regular debe coincidir con la estructura de la ruta de archivo de tu aplicación. Ajusta el patrón para extraer el servicio y la versión de tus URL de paquete. Cualquier consulta en el Explorador RUM puede usar el atributo de servicio para filtrar eventos.
+
+
+{% /if %}
+
+### Limitaciones {% #limitations %}
+
+#### Eventos sin un origen atribuido {% #events-without-an-attributed-origin %}
+
+Algunos eventos no pueden ser atribuidos a un origen porque no tienen una pila de manejo asociada:
+
+- Eventos de acción recolectados automáticamente
+- Eventos de recursos distintos a XHR y Fetch
+- Eventos de visualización recolectados automáticamente
+- Violaciones de CORS y CSP
+
+#### Resolución de mapas del código fuente a través de micro frontends {% #source-map-resolution-across-micro-frontends %}
+
+Cuando una traza de pila contiene marcos de múltiples micro frontends, el evento recibe un solo `service` y `version` del marco más alto (donde se lanzó el error). Los mapas del código fuente se resuelven para el evento bajo ese único servicio, por lo que los marcos de otros micro frontends permanecen minificados, incluso cuando sus mapas del código fuente fueron correctamente subidos bajo su propio `service`.
+
+Para controlar qué mapas del código fuente de micro frontend se utilizan, utiliza el enfoque de [atribución manual](#manual-service-and-version-attribution) con `beforeSend` para establecer `event.service` y `event.version`. Solo los marcos que pertenecen al micro frontend elegido son desminificados.
+
+### Explora los datos de micro frontend en Datadog {% #explore-micro-frontend-data-in-datadog %}
+
+Después de la configuración, el `service` y `version` en los eventos RUM identifican qué micro frontend generó cada evento. Utiliza estos atributos en varios lugares en Datadog:
+
+- **Paneles laterales**: Los atributos `service` y `version` aparecen en la sesión, visualización, error, recurso, acción y paneles de tareas largas en el Explorador RUM.
+- **Tablero de resumen de RUM**: Utiliza el `service` y el `version` para filtrar en el tablero de resumen de RUM y contextualizar las métricas de rendimiento en un micro frontend específico.
+- **Tableros personalizados**: Crea tableros utilizando el `service` y el `version` para hacer seguimiento de cada micro frontend de manera independiente.
+
+[1]: /es/real_user_monitoring/application_monitoring/browser/data_collected/
+[2]: /es/real_user_monitoring/application_monitoring/browser/monitoring_page_performance/
+[3]: https://github.com/DataDog/browser-sdk/blob/main/CHANGELOG.md#v2170
+[4]: /es/real_user_monitoring/application_monitoring/browser/setup/
+[5]: https://github.com/DataDog/browser-sdk/blob/main/CHANGELOG.md#v2130
+[6]: https://developer.mozilla.org/en-US/docs/Web/API/Location
+[7]: https://developer.mozilla.org/en-US/docs/Web/API/Event
+[8]: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest
+[9]: https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming
+[10]: https://developer.mozilla.org/en-US/docs/Web/API/Request
+[11]: https://developer.mozilla.org/en-US/docs/Web/API/Response
+[12]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error
+[13]: https://developer.mozilla.org/en-US/docs/Web/API/PerformanceLongTaskTiming
+[14]: /es/real_user_monitoring/guide/enrich-and-control-rum-data
+[15]: https://github.com/DataDog/browser-sdk/blob/main/packages/rum-core/src/rumEvent.types.ts
+[16]: https://github.com/DataDog/browser-sdk/blob/main/CHANGELOG.md#v4130
+[17]: /es/data_security/real_user_monitoring/#browser-rum-use-of-cookies
+[18]: https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage
+[19]: https://github.com/DataDog/browser-sdk/blob/main/CHANGELOG.md#v5280
+[20]: /es/real_user_monitoring/application_monitoring/browser/advanced_configuration#override-default-rum-view-names
+[21]: https://module-federation.io/
+[22]: https://github.com/DataDog/build-plugins?tab=readme-ov-file#usage
+[23]: https://github.com/DataDog/build-plugins
\ No newline at end of file
diff --git a/content/es/real_user_monitoring/guide/proxy-rum-data.mdoc.md b/content/es/real_user_monitoring/guide/proxy-rum-data.mdoc.md
new file mode 100644
index 00000000000..27615bedecd
--- /dev/null
+++ b/content/es/real_user_monitoring/guide/proxy-rum-data.mdoc.md
@@ -0,0 +1,234 @@
+---
+aliases:
+- /es/real_user_monitoring/faq/proxy_rum_data/
+content_filters:
+- label: SDK source
+ option_group_id: rum_browser_sdk_source_options
+ trait_id: lib_src
+- option_group_id: rum_browser_sdk_version_for_proxying_options
+ trait_id: rum_browser_sdk_version
+description: Configura el proxy de datos RUM del navegador con opciones de origen
+ del SDK y configuraciones específicas de versión para el enrutamiento de red personalizado.
+further_reading:
+- link: /real_user_monitoring/
+ tag: Documentación
+ text: Aprende sobre RUM
+title: Redirige tus datos RUM del navegador a través de un proxy
+---
+{% if equals($rum_browser_sdk_version, "lt_4_34_0") %}
+{% alert level="danger" %}
+Actualiza al SDK del navegador `4.34.0` o posterior para evitar vulnerabilidades de seguridad en la configuración de tu proxy.
+{% /alert %}
+{% /if %}
+
+## Resumen {% #overview %}
+
+El SDK del navegador RUM se puede configurar para enviar solicitudes a través de un proxy. Cuando configuras el `proxy` [parámetro de inicialización][1] del SDK a una URL como `https://www.example-proxy.com/any-endpoint`, todos los datos RUM se envían a esa URL utilizando el método POST. Los datos RUM aún necesitan ser reenviados a Datadog desde el proxy.
+
+## Configuración previa del proxy {% #prerequisite-proxy-setup %}
+
+Para reenviar una solicitud a Datadog con éxito, tu proxy debe
+
+1. [Construir la URL de recepción de Datadog](#build-the-datadog-intake-url).
+2. Agrega un `X-Forwarded-For` encabezado que contenga la dirección IP del cliente de la solicitud para una geoIP precisa.
+3. Reenvía la solicitud a la URL de ingesta de Datadog utilizando el método POST.
+4. Deja el cuerpo de la solicitud sin cambios.
+
+{% alert level="warning" %}
+- Por razones de seguridad, elimina cualquier encabezado HTTP que potencialmente contenga información sensible, como el encabezado `cookie`.
+- El cuerpo de la solicitud puede contener datos binarios y no debe ser convertido a una cadena. Asegúrate de que tu implementación de proxy reenvíe el cuerpo sin conversión.
+- Asegúrate de que tu implementación de proxy no permita que un actor malicioso envíe solicitudes a un servidor diferente. Por ejemplo: `https://browser-intake-datadoghq.com.malicious.com`.
+{% /alert %}
+
+### Construye la URL de ingesta de Datadog {% #build-the-datadog-intake-url %}
+
+Tu URL de ingesta de Datadog debe tener el formato `/` (por ejemplo, `https://browser-intake-datadoghq.eu/api/v2/rum?ddsource=browser&...`).
+
+{% table %}
+---
+* origen de ingesta
+*
+ El origen de ingesta de Datadog corresponde a su `site` [parámetro de inicialización][1]. El origen de ingesta de Datadog correspondiente a su parámetro de sitio debe definirse en la implementación de su proxy.
+
+ {% site-region region="us" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-datadoghq.com`.
+ {% /site-region %}
+
+ {% site-region region="us3" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-us3-datadoghq.com`.
+ {% /site-region %}
+
+ {% site-region region="us5" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-us5-datadoghq.com`.
+ {% /site-region %}
+
+ {% site-region region="eu" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-datadoghq.eu`.
+ {% /site-region %}
+
+ {% site-region region="ap1" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-ap1-datadoghq.com`.
+ {% /site-region %}
+
+ {% site-region region="ap2" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-ap2-datadoghq.com`.
+ {% /site-region %}
+
+ {% site-region region="gov" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-ddog-gov.com`.
+ {% /site-region %}
+
+ {% site-region region="gov2" %}
+ El origen de ingesta para su sitio de Datadog es `https://browser-intake-us2-ddog-gov.com`.
+ {% /site-region %}
+---
+* ruta
+*
+ La ruta contiene la versión de la API y el producto (por ejemplo, `/api/v2/rum` para datos de RUM o `/api/v2/replay` para datos de reproducción de sesión).
+
+ La ruta para cada solicitud se puede acceder en el parámetro `ddforward` de la solicitud (por ejemplo, `https://www.example-proxy.com/any-endpoint?ddforward=%2Fapi%2Fv2%2Frum%3Fddsource%3Dbrowser`).
+---
+* parámetros
+*
+ Los parámetros de la solicitud (por ejemplo, `ddsource=browser&...`) se pueden acceder en el parámetro `ddforward` de la solicitud (por ejemplo, `https://www.example-proxy.com/any-endpoint?ddforward=%2Fapi%2Fv2%2Frum%3Fddsource%3Dbrowser`).
+
+{% /table %}
+
+## Configuración del SDK {% #sdk-setup %}
+
+
+{% if includes($rum_browser_sdk_version, ["gte_5_4_0", "gte_4_34_0"]) %}
+
+Configura la URL del proxy en el parámetro de inicialización `proxy`:
+
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { Datacenter, datadogRum } from '@datadog/browser-rum';
+
+datadogRum.init({
+ applicationId: '',
+ clientToken: '',
+ site: '{% region-param key="dd_site" /%}',
+ proxy: '',
+});
+```
+{% /if %}
+
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ clientToken: '',
+ applicationId: '',
+ proxy: '',
+ });
+});
+```
+
+{% /if %}
+
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM &&
+ window.DD_RUM.init({
+ clientToken: '',
+ applicationId: '',
+ proxy: ''
+ });
+```
+{% /if %}
+
+
+El SDK del navegador RUM agrega un parámetro de consulta `ddforward` a todas las solicitudes a tu proxy. Este parámetro de consulta contiene la ruta de la URL y los parámetros a los que se debe reenviar todos los datos.
+
+Por ejemplo, con un `site` configurado en `datadoghq.eu` y un `proxy` configurado en `https://example.org/datadog-intake-proxy`, el SDK del navegador RUM envía solicitudes a una URL como esta: `https://example.org/datadog-intake-proxy?ddforward=%2Fapi%2Fv2%2Frum%3Fddsource%3Dbrowser`. El proxy reenvía la solicitud a `https://browser-intake-datadoghq.eu/api/v2/rum?ddsource=browser`.
+
+
+{% if equals($rum_browser_sdk_version, "gte_5_4_0") %}
+### Pasando una función al parámetro de inicialización `proxy` {% #passing-a-function-to-the-proxy-initialization-parameter %}
+
+El parámetro de inicialización `proxy` también admite una entrada de función. Esta función te permite tener más control sobre cómo se agregan la ruta y los parámetros a la URL del proxy.
+
+Esta función recibe un objeto con las siguientes propiedades:
+
+- `path`: la ruta para las solicitudes de Datadog (ejemplo: `/api/v2/rum`)
+- `parameters`: los parámetros de las solicitudes de Datadog (ejemplo: `ddsource=browser&...`)
+
+
+{% if equals($lib_src, "npm") %}
+
+```javascript
+import { Datacenter, datadogRum } from '@datadog/browser-rum';
+
+datadogRum.init({
+ applicationId: '',
+ clientToken: '',
+ site: '{% region-param key="dd_site" /%}',
+ proxy: (options) => `https://www.proxy.com/foo${options.path}/bar?${options.parameters}`,
+});
+```
+{% /if %}
+
+
+
+{% if equals($lib_src, "cdn_async") %}
+
+```javascript
+window.DD_RUM.onReady(function() {
+ window.DD_RUM.init({
+ clientToken: '',
+ applicationId: '',
+ proxy: (options) => `https://www.proxy.com/foo${options.path}/bar?${options.parameters}`,
+ })
+})
+```
+{% /if %}
+
+
+
+{% if equals($lib_src, "cdn_sync") %}
+
+```javascript
+window.DD_RUM &&
+ window.DD_RUM.init({
+ clientToken: '',
+ applicationId: '',
+ proxy: (options) => `https://www.proxy.com/foo${options.path}/bar?${options.parameters}`
+ });
+```
+{% /if %}
+
+
+**Nota:**
+- Algunos bloqueadores de privacidad ya apuntan a los patrones de URL de entrada [URL patterns][2], así que puede que desees tener eso en cuenta al construir tu URL de proxy.
+- La función `proxy` se llama para cada solicitud, por lo que debe evitar cualquier cálculo pesado.
+- **Las aplicaciones web JSP** necesitan usar el carácter de escape `\` para propagar correctamente estos parámetros al navegador. Por ejemplo:
+ ```javascript
+ proxy: (options) => 'http://proxyURL:proxyPort\${options.path}?\${options.parameters}',
+ ```
+{% /if %}
+
+
+{% /if %}
+
+
+
+{% if equals($rum_browser_sdk_version, "lt_4_34_0") %}
+Antes de la versión 4.34.0 del SDK del navegador, se utilizaba el parámetro de inicialización `proxyUrl`, y el origen de ingesta de Datadog se incluía en el atributo `ddforward`. La implementación del proxy se encargaba de validar este servidor, y no hacerlo resultaba en diversas vulnerabilidades.
+
+El origen de ingesta de Datadog debe definirse en su implementación de proxy para garantizar la seguridad.
+
+**Para evitar vulnerabilidades de seguridad, debe actualizar a Browser SDK `4.34.0` o posterior.**
+{% /if %}
+
+
+[1]: /es/real_user_monitoring/application_monitoring/browser/setup/client/?tab=rum#initialization-parameters
+[2]: https://github.com/easylist/easylist/blob/997fb6533c719a015c21723b34e0cedefcc0d83d/easyprivacy/easyprivacy_general.txt#L3840
\ No newline at end of file
diff --git a/content/es/security/code_security/static_analysis/static_analysis_rules/_index.md b/content/es/security/code_security/static_analysis/static_analysis_rules/_index.md
index a2fb222db89..c2489212a5e 100644
--- a/content/es/security/code_security/static_analysis/static_analysis_rules/_index.md
+++ b/content/es/security/code_security/static_analysis/static_analysis_rules/_index.md
@@ -1,232 +1,381 @@
---
-title: Reglas de SAST
-description: Consulta las reglas de Static Code Analysis para múltiples lenguajes.
aliases:
-- /continuous_integration/static_analysis/rules
-- /static_analysis/rules
-- /code_analysis/static_analysis_rules
-- /security/code_security/static_analysis_rules
+- /es/continuous_integration/static_analysis/rules
+- /es/static_analysis/rules
+- /es/code_analysis/static_analysis_rules
+- /es/security/code_security/static_analysis_rules
+cascade:
+ banner:
+ link:
+ name: Seguridad de Código de Datadog
+ url: https://www.datadoghq.com/product/code-security/
+ title: Integraciones fluidas. Prueba la Seguridad de Código de Datadog
+ modal:
+ bottom_boxes:
+ - cta_title: Descargar Extensión
+ cta_url: https://marketplace.visualstudio.com/items?itemName=Datadog.datadog-vscode
+ icon: vscode
+ subtitle: Identifica vulnerabilidades de código directamente en tueditor
+ de VS Code
+ title: Extensión de VS Code
+ - cta_title: Descargar Plugin
+ cta_url: https://plugins.jetbrains.com/plugin/19495-datadog
+ icon: jetbrains
+ subtitle: Identifica vulnerabilidades de código directamente enproductos
+ de JetBrains
+ title: Plugin de JetBrains
+ footer:
+ link:
+ name: Seguridad de Código de Datadog
+ url: https://www.datadoghq.com/product/code-security/
+ text: Utiliza la Seguridad de Código de Datadog para detectar problemas de código
+ en cada etapa de tu proceso de desarrollo
+ title: Prueba esta regla y analiza tu código con la Seguridad de Código de Datadog
+ top_box:
+ footer: Para más información, por favor lee la documentación
+ de Seguridad de Código
+ steps:
+ - Crea un archivo static-analysis.datadog.yml con el contenido anterior en la
+ raíz de tu repositorio
+ - Utiliza nuestros IDE Plugins gratuitos o añade escaneos de Seguridad de Código
+ a tus canalizaciones de CI
+ - Obtén retroalimentación sobre tu código
+ title: Cómo utilizar esta regla
+description: Consulta reglas para múltiples lenguajes para Análisis Estático de Código.
+further_reading:
+- link: /security/code_security/
+ tag: Documentación
+ text: Conoce sobre la Seguridad de Código de Datadog
is_beta: false
-type: static-analysis
rulesets:
apex-code-style:
+ description: 'Reglas de Seguridad de Código para escribir reglas Apex que sigan
+ estándares de codificación establecidos.
+
+ '
title: Reglas para hacer cumplir el estilo de código Apex y las mejores prácticas.
- description: Code Security para escribir reglas Apex que sigan los estándares de codificación establecidos.
apex-security:
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ Apex.
+
+ '
title: Reglas de seguridad para Apex
- description: Reglas enfocadas a encontrar problemas de seguridad en tu código Apex.
+ bash-code-quality:
+ description: 'Reglas para hacer cumplir la calidad del código en scripts de Bash.
+
+ '
+ title: Reglas de calidad del código para scripts de Bash.
+ bash-security:
+ description: 'Reglas para hacer cumplir las mejores prácticas de seguridad en
+ scripts de Bash.
+
+ '
+ title: Reglas de seguridad para scripts de Bash
csharp-best-practices:
- title: "Prácticas recomendadas para C#"
- description: Reglas para aplicar las prácticas recomendadas de C#.
+ description: 'Reglas para hacer cumplir las mejores prácticas de C#.
+
+ '
+ title: Mejores prácticas para C#
csharp-code-style:
- title: "Seguir los patrones del estilo de código de C#"
- description: Reglas para aplicar el código de estilo de C#.
+ description: 'Reglas para hacer cumplir el estilo de código de C#.
+
+ '
+ title: Sigue los patrones de estilo de código de C#
csharp-inclusive:
- title: "Usar lenguaje inclusivo en C#"
- description: Reglas para que tu código de C# sea más inclusivo.
+ description: 'Reglas para hacer tu código C# más inclusivo.
+
+ '
+ title: Utiliza un lenguaje inclusivo en C#
csharp-security:
- title: "Escribir código de C# seguro y protegido"
- description: Reglas centradas en encontrar problemas de seguridad en tu código de C#.
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ C#.
+
+ '
+ title: Escribe código C# seguro y protegido
docker-best-practices:
- title: Seguir las prácticas recomendadas con el uso de Docker
- description: Prácticas recomendadas para el uso de Docker.
+ description: 'Mejores prácticas para usar Docker.
+
+ '
+ title: Sigue las mejores prácticas al usar Docker
github-actions:
- title: Proteger las GitHub Actions
- description: Reglas para verificar tus GitHub Actions y detectar patrones inseguros, como permisos o fijación de versiones.
+ description: 'Reglas para revisar tus GitHub Actions y detectar patrones inseguros,
+ como permisos o fijación de versiones.
+
+ '
+ title: Asegura tus GitHub Actions
go-best-practices:
- title: Prácticas recomendadas para Go
- description: Reglas para que sea más rápido y sencillo escribir código de Go. Desde el estilo de código hasta la prevención de errores, este conjunto de reglas ayuda a los desarrolladores a escribir código de Go eficiente, fácil de mantener y de alto rendimiento.
+ description: 'Reglas para hacer que escribir código Go sea más rápido y fácil.
+ Desde el estilo de código hasta la prevención de errores, este conjunto de reglas
+ ayuda a los desarrolladores a escribir código Go eficiente, mantenible y de
+ alto rendimiento.
+
+ '
+ title: Mejores prácticas para Go
go-inclusive:
- title: Usar lenguaje inclusivo en Go
- description: Verifica el código de Go para detectar problemas de redacción.
+ description: 'Revisa el código de Go en busca de problemas de redacción.
+
+ '
+ title: Utiliza un lenguaje inclusivo en Go
go-security:
- title: Garantizar que el código de Go esté protegido y seguro
- description: Detecta problemas de seguridad comunes (como la inyección de SQL, XSS o inyección de shell) en tu base de código de Go.
+ description: 'Detecta problemas de seguridad comunes (como inyección SQL, XSS
+ o inyección de shell) en tu base de código de Go.
+
+ '
+ title: Asegúrate de que tu código de Go sea seguro
java-best-practices:
- title: Seguir las prácticas recomendadas en Java
- description: Reglas para aplicar las prácticas recomendadas de Java.
+ description: 'Reglas para hacer cumplir las mejores prácticas de Java.
+
+ '
+ title: Sigue las mejores prácticas en Java
java-code-style:
- title: Seguir los patrones del estilo de código de Java
- description: Reglas para aplicar el código de estilo de Java.
+ description: 'Reglas para hacer cumplir el estilo de código de Java.
+
+ '
+ title: Sigue los patrones de estilo de código de Java
java-inclusive:
- title: Usar lenguaje inclusivo en Java
- description: Reglas de Java para evitar redactar textos inadecuados en el código y los comentarios.
+ description: 'Reglas para Java para evitar redacciones inapropiadas en el código
+ y los comentarios.
+
+ '
+ title: Utiliza un lenguaje inclusivo en Java
java-security:
- title: Garantizar que el código de Java sea seguro
- description: Reglas centradas en encontrar problemas de seguridad en código de Java.
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en el código
+ de Java.
+
+ '
+ title: Asegúrate de que tu código de Java sea seguro
javascript-best-practices:
- title: Seguir las mejores prácticas para escribir código de JavaScript
- description: Reglas para aplicar las prácticas recomendadas de JavaScript.
+ description: 'Reglas para hacer cumplir las mejores prácticas de JavaScript.
+
+ '
+ title: Sigue las mejores prácticas para escribir código JavaScript
javascript-browser-security:
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tus aplicaciones
+ web de JavaScript.
+
+ '
title: Reglas de seguridad para aplicaciones web de JavaScript
- description: Reglas centradas en encontrar problemas de seguridad en tus aplicaciones web de JavaScript.
javascript-code-style:
- title: Aplicar el estilo de código de JavaScript
- description: Reglas para aplicar el código de estilo de JavaScript.
+ description: 'Reglas para hacer cumplir el estilo de código de JavaScript.
+
+ '
+ title: Haz cumplir el estilo de código de JavaScript
javascript-common-security:
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ de JavaScript.
+
+ '
title: Reglas de seguridad comunes para JavaScript
- description: Reglas centradas en encontrar problemas de seguridad en tu código de JavaScript.
javascript-express:
- title: Consultar las prácticas recomendadas y seguridad de Express.js
- description: Reglas específicas para las prácticas recomendadas y seguridad de Express.js.
+ description: 'Reglas específicamente para las mejores prácticas y seguridad de
+ Express.js.
+
+ '
+ title: Verifica las mejores prácticas y la seguridad de Express.js
javascript-inclusive:
- title: Verifica el código de JavaScript para detectar problemas de redacción.
- description: Reglas de JavaScript para evitar redactar textos inadecuados en el código y los comentarios.
+ description: 'Reglas para JavaScript para evitar un lenguaje inapropiado en el
+ código y los comentarios.
+
+ '
+ title: Verifica el código de JavaScript en busca de problemas de redacción
javascript-node-security:
+ description: 'Reglas para identificar posibles puntos críticos de seguridad en
+ Node. Esto puede incluir falsos positivos que requieren una mayor evaluación.
+
+ '
title: Identificar posibles puntos críticos de seguridad en Node
- description: Reglas para identificar posibles puntos críticos de seguridad en Node. Esto puede incluir falsos positivos que requieren una evaluación más exhaustiva.
jsx-react:
- title: Reglas de linting específicas de React
- description: Este complemento exporta una configuración `recommended` que aplica las prácticas recomendadas de React.
+ description: 'Este complemento exporta una configuración `recomendada` que hace
+ cumplir las buenas prácticas de React.
+
+ '
+ title: Reglas de linting específicas para React
kotlin-best-practices:
- title: Seguir las mejores prácticas para escribir código de Kotlin
- description: Reglas para aplicar las prácticas recomendadas de Kotlin.
+ description: 'Reglas para hacer cumplir las mejores prácticas de Kotlin.
+
+ '
+ title: Sigue las mejores prácticas para escribir código en Kotlin
kotlin-code-style:
- title: Aplicar el estilo de código de Kotlin
- description: Reglas para aplicar el código de estilo de Kotlin.
+ description: 'Reglas para hacer cumplir el estilo de código de Kotlin.
+
+ '
+ title: Haz cumplir el estilo de código de Kotlin
kotlin-security:
- title: Aplicar la codificación segura de Kotlin
- description: Reglas enfocadas a encontrar problemas de seguridad en tu código Kotlin.
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ de Kotlin.
+
+ '
+ title: Haz cumplir la codificación segura en Kotlin
php-best-practices:
- title: Seguir las mejores prácticas para escribir código de PHP
- description: Reglas para aplicar las prácticas recomendadas de PHP, mejorar el estilo de código, prevenir errores, y promover un código de PHP de alto rendimiento, fácil de mantener y eficiente.
+ description: 'Reglas para hacer cumplir las mejores prácticas de PHP, mejorando
+ el estilo de código, previniendo errores y promoviendo un código PHP eficiente,
+ mantenible y de alto rendimiento.
+
+ '
+ title: Sigue las mejores prácticas para escribir código en PHP
php-code-style:
- title: Aplicar el estilo de código de PHP
- description: Reglas para aplicar el código de estilo de PHP.
+ description: 'Reglas para hacer cumplir el estilo de código de PHP.
+
+ '
+ title: Haz cumplir el estilo de código de PHP
php-security:
- title: Reglas de seguridad para PHP
- description: Reglas centradas en encontrar problemas de seguridad en tu código de PHP.
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ PHP.
+
+ '
+ title: Reglas de seguridad para PHP.
python-best-practices:
- title: Seguir las mejores prácticas para escribir código de Python
- description: Prácticas recomendadas de Python para escribir código eficiente y sin errores.
+ description: 'Mejores prácticas para Python para escribir código eficiente y libre
+ de errores.
+
+ '
+ title: Sigue las mejores prácticas para escribir código en Python.
python-code-style:
- title: Aplicar el estilo de código de Python
- description: Reglas para aplicar el código de estilo de Python.
+ description: 'Reglas para hacer cumplir el estilo de código en Python.
+
+ '
+ title: Haz cumplir el estilo de código en Python
python-design:
- title: Verificar la estructura de programa de Python
- description: Reglas para verificar la estructura de programa de Python, incluido cosas como bucles anidados.
+ description: 'Reglas para verificar la estructura de tu programa en Python, incluyendo
+ aspectos como bucles anidados.
+
+ '
+ title: Verifica la estructura del programa en Python.
python-django:
- title: Consultar las prácticas recomendadas y seguridad de Django
- description: Reglas específicas para las prácticas recomendadas y seguridad de Django.
+ description: 'Reglas específicamente para las mejores prácticas y seguridad en
+ Django.
+
+ '
+ title: Verifica las mejores prácticas y la seguridad en Django.
python-flask:
- title: Consultar las prácticas recomendadas y seguridad de Flask
- description: Reglas específicas para las prácticas recomendadas y seguridad de Flask.
+ description: 'Reglas específicamente para las mejores prácticas y seguridad en
+ Flask.
+
+ '
+ title: Verifica las mejores prácticas y la seguridad en Flask.
python-inclusive:
- title: Verifica el código de Python para detectar problemas de redacción.
- description: Reglas de Python para evitar redactar textos inadecuados en el código y los comentarios.
- python-pandas:
- title: Prácticas recomendadas para la ciencia de datos con pandas
- description: Un conjunto de reglas para verificar que el código de pandas se use de forma adecuada.
+ description: 'Reglas para Python para evitar un lenguaje inapropiado en el código
+ y los comentarios.
- - Garantiza que las declaraciones `import` sigan las pautas de codificación.
- - Evita códigos y métodos obsoletos.
- - Evita el código ineficiente siempre que sea posible.
+ '
+ title: Verifica el código de Python en busca de problemas de redacción.
+ python-pandas:
+ description: "Un conjunto de reglas para verificar que el código de pandas se\
+ \ utilice adecuadamente.\n\n - Asegura que las declaraciones de `import` sigan\
+ \ las pautas de codificación.\n - Evita código y métodos obsoletos.\n - Evita\
+ \ código ineficiente siempre que sea posible.\n"
+ title: Buenas prácticas para la ciencia de datos con pandas.
python-security:
- title: Garantizar que el código de Python esté protegido y seguro
- description: Reglas centradas en encontrar problemas de seguridad y vulnerabilidad en tu código de Python, incluidos aquellos que se encuentran en OWASP10 y SANS25.
-
- - Uso de protocolos de cifrado y hash incorrectos
- - Falta de control de acceso
- - Configuración errónea de seguridad
- - Inyecciones de SQL
- - Credenciales codificadas
- - Inyección de shell
- - Deserialización insegura
+ description: "Reglas enfocadas en encontrar problemas de seguridad y vulnerabilidad\
+ \ en tu código Python, incluyendo aquellos encontrados en OWASP10 y SANS25.\n\
+ \n - Uso de protocolos de cifrado y hash deficientes\n - Falta de control de\
+ \ acceso\n - Configuración de seguridad incorrecta\n - Inyecciones SQL\n - Credenciales\
+ \ codificadas de forma rígida\n - Inyección de shell\n - Deserialización insegura\n"
+ title: Asegúrate de que tu código en Python sea seguro y protegido
rails-best-practices:
+ description: 'Mejores prácticas para escribir código en Ruby on Rails.
+
+ '
title: Patrones ampliamente adoptados por la comunidad de Ruby on Rails
- description: Prácticas recomendadas para escribir código de Ruby on Rails.
ruby-best-practices:
- title: Seguir las prácticas recomendadas en Ruby
- description: Reglas para aplicar las prácticas recomendadas de Ruby.
+ description: 'Reglas para hacer cumplir las mejores prácticas de Ruby.
+
+ '
+ title: Sigue las mejores prácticas en Ruby
ruby-code-style:
- title: Reglas para aplicar el código de estilo de Ruby.
- description: Codifica las reglas de seguridad para escribir reglas de Ruby que sigan las normas de codificación establecidas.
+ description: 'Reglas de seguridad del código para escribir reglas en Ruby que
+ sigan los estándares de codificación establecidos.
+
+ '
+ title: Reglas para hacer cumplir el estilo de Ruby.
ruby-inclusive:
- title: Reglas para código de Ruby inclusivo
- description: Escribir código de Ruby inclusivo
+ description: 'Escribe código Ruby inclusivo
+
+ '
+ title: Reglas para código Ruby inclusivo
ruby-security:
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ Ruby.
+
+ '
title: Reglas de seguridad para Ruby
- description: Reglas centradas en encontrar problemas de seguridad en tu código de Ruby.
swift-code-style:
- title: Reglas para imponer el estilo y las buenas prácticas del código Swift.
- description: Code Security para escribir reglas Swift que sigan los estándares de codificación establecidos.
+ description: 'Reglas de seguridad del código para escribir reglas en Swift que
+ sigan los estándares de codificación establecidos.
+
+ '
+ title: Reglas para hacer cumplir el estilo de código en Swift y mejores prácticas.
swift-security:
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ Swift.
+
+ '
title: Reglas de seguridad para Swift
- description: Reglas centradas en encontrar problemas de seguridad en tu código Swift.
terraform-aws:
+ description: 'Reglas para hacer cumplir las mejores prácticas de Terraform para
+ AWS.
+
+ '
title: Terraform AWS
- description: Reglas a fin de aplicar las prácticas recomendadas de Terraform para AWS.
tsx-react:
- title: Calidad del código de TypeScript con React
- description: Este complemento exporta una configuración `recommended` que aplica las prácticas recomendadas de React.
+ description: 'Este complemento exporta una configuración `recomendada` que hace
+ cumplir las buenas prácticas de React.
+
+ '
+ title: Calidad del código TypeScript React
typescript-best-practices:
- title: Seguir las mejores prácticas para escribir código de TypeScript
- description: Reglas para aplicar las prácticas recomendadas de TypeScript.
+ description: 'Reglas para hacer cumplir las mejores prácticas de TypeScript.
+
+ '
+ title: Sigue las mejores prácticas para escribir código TypeScript
typescript-browser-security:
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tus aplicaciones
+ web de TypeScript.
+
+ '
title: Reglas de seguridad para aplicaciones web de TypeScript
- description: Reglas centradas en encontrar problemas de seguridad en tus aplicaciones web de TypeScript.
typescript-code-style:
- title: Patrones de código con opiniones de TypeScript
- description: Reglas que se consideran las prácticas recomendadas para las bases de código de TypeScript modernas, pero que no afectan la lógica del programa. Por lo general, estas reglas tienen como objetivo aplicar patrones de código más simples.
+ description: 'Reglas consideradas como mejores prácticas para bases de código
+ modernas de TypeScript, pero que no impactan la lógica del programa. Estas reglas
+ generalmente promueven la aplicación de patrones de código más simples.
+
+ '
+ title: Patrones de código en TypeScript con un enfoque definido.
typescript-common-security:
+ description: 'Reglas enfocadas en encontrar problemas de seguridad en tu código
+ TypeScript.
+
+ '
title: Reglas de seguridad comunes para TypeScript
- description: Reglas centradas en encontrar problemas de seguridad en tu código de TypeScript.
typescript-express:
- title: Consultar las prácticas recomendadas y seguridad de Express.js con TypeScript
- description: Reglas específicas para las prácticas recomendadas y seguridad de Express.js con TypeScript.
+ description: 'Reglas específicamente para las mejores prácticas y seguridad de
+ TypeScript en Express.js.
+
+ '
+ title: Verifica las mejores prácticas y seguridad de TypeScript en Express.js
typescript-inclusive:
- title: Verifica el código de TypeScript para detectar problemas de redacción.
- description: Reglas de TypeScript para evitar redactar textos inadecuados en el código y los comentarios.
- typescript-node-security:
- title: Identificar posibles puntos críticos de seguridad en Node
- description: Reglas para identificar posibles puntos críticos de seguridad en Node. Esto puede incluir falsos positivos que requieren una evaluación más exhaustiva.
-cascade:
- modal:
- title: Prueba esta regla y analiza tu código con Datadog Code Security
- top_box:
- title: Cómo usar esta regla
- steps:
- - Crea un static-analysis.datadog.yml con el contenido anterior en la raíz de tu repositorio
- - Utiliza nuestros complementos del IDE gratuitos o añade análisis de Code Security a tus pipelines de CI.
- - Recibe comentarios sobre tu código
- footer: Para más información, lee la documentación sobre Code Security
- bottom_boxes:
- - title: Extensión de VS Code
- icon: vscode
- subtitle: Identifica vulnerabilidades del código directamente en tu editor deVS Code
- cta_title: Descargar extensión
- cta_url: "https://marketplace.visualstudio.com/items?itemName=Datadog.datadog-vscode"
- - title: Complemento de JetBrains
- icon: jetbrains
- subtitle: Identifica vulnerabilidades del código directamente en los productos deJetBrains
- cta_title: Descargar complemento
- cta_url: "https://plugins.jetbrains.com/plugin/19495-datadog"
- footer:
- text: Utiliza Datadog Code Security para detectar problemas de código en cada paso del proceso de desarrollo
- link:
- name: Datadog Code Security
- url: "https://www.datadoghq.com/product/code-security/"
+ description: 'Reglas para TypeScript para evitar un lenguaje inapropiado en el
+ código y los comentarios.
- banner:
- title: Integraciones sin problemas. Prueba Datadog Code Security
- link:
- name: Datadog Code Security
- url: "https://www.datadoghq.com/product/code-security/"
+ '
+ title: Verifica el código TypeScript en busca de problemas de redacción
+ typescript-node-security:
+ description: 'Reglas para identificar posibles puntos críticos de seguridad en
+ Node. Esto puede incluir falsos positivos que requieren una mayor evaluación.
-further_reading:
- - link: /security/code_security/
- tag: Documentación
- text: Más información sobre Datadog Code Security
+ '
+ title: Identificar posibles puntos críticos de seguridad en Node
+title: Reglas SAST
+type: static-analysis
---
-
-{{% site-region region="gov" %}}
+{{% site-region region="gov,gov2" %}}
- Code Security no está disponible para el sitio {{< region-param key="dd_site_name" >}}.
+ La seguridad del código no está disponible para el {{< region-param key="dd_site_name" >}} sitio.
{{% /site-region %}}
-## Información general
+## Resumen {#overview}
-Datadog Static Code Analysis proporciona reglas predefinidas para ayudar a detectar vulnerabilidades de seguridad, errores y problemas de mantenimiento en tu código base. Para obtener más información, consulta la [Documentación de instalación][1].
+El análisis estático de código de Datadog proporciona reglas listas para usar que ayudan a detectar vulnerabilidades de seguridad, errores y problemas de mantenibilidad en tu base de código. Para más información, consulta la [documentación de configuración][1].
-[1]: /security/code_security/static_analysis/setup/
+[1]: /es/security/code_security/static_analysis/setup/
\ No newline at end of file
diff --git a/content/es/standard-attributes/_index.md b/content/es/standard-attributes/_index.md
index da85fad1063..ba8c90db4c3 100644
--- a/content/es/standard-attributes/_index.md
+++ b/content/es/standard-attributes/_index.md
@@ -1,17 +1,16 @@
---
attributes:
-- description: El nombre del host de origen tal y como se define en las métricas.
- Datadog recupera automáticamente las etiquetas de host correspondientes del host
- coincidente en Datadog y las aplica a tu telemetría. El Agent configura este valor
- automáticamente.
- domain: Reservado
+- description: El nombre del host de origen según se define en las métricas. Datadog
+ recupera automáticamente las etiquetas de host correspondientes del host coincidente
+ en Datadog y las aplica a su telemetría. El Agente establece este valor automáticamente.
+ domain: Reserved
name: host
product_source:
- icon-log
- icon-apm
- type: cadena
+ type: string
- description: El tipo de dispositivo de origen.
- domain: Reservado
+ domain: Reserved
name: device
product_source:
- icon-rum
@@ -19,34 +18,34 @@ attributes:
- ios
- browser
- roku
- type: cadena
-- description: Corresponde al nombre de la integración, la tecnología de la que proceden
- los datos. Cuando coincide con un nombre de integración, Datadog instala automáticamente
- los analizadores y las facetas correspondientes. Por ejemplo, `nginx`, `postgresql`,
- etc.
- domain: Reservado
+ type: string
+- description: Esto corresponde al nombre de la integración, la tecnología de la cual
+ se originaron los datos. Cuando coincide con un nombre de integración, Datadog
+ instala automáticamente los analizadores y facetas correspondientes. Por ejemplo,
+ `nginx`, `postgresql`, y así sucesivamente.
+ domain: Reserved
name: source
product_source:
- icon-log
- type: cadena
-- description: Esto corresponde al nivel o la severidad de los datos. En el caso de
- los logs, se utilizan para definir [patrones de logs](/logs/explorer/patterns/)
- y tiene un diseño dedicado en la interfaz de usuario de gestión de logs.
- domain: Reservado
+ type: string
+- description: Esto corresponde al nivel o severidad de los datos. Para los registros,
+ se utiliza para definir [patrones de registro](/logs/explorer/patterns/) y tiene
+ un diseño dedicado en la interfaz de usuario de Log Management.
+ domain: Reserved
name: status
product_source:
- icon-log
- icon-apm
- type: cadena
+ type: string
- description: El [nombre de servicio unificado](/getting_started/tagging/unified_service_tagging/)
- para la aplicación o el servicio que genera los datos, que se utiliza para correlacionar
- las sesiones de usuario. Se utiliza para cambiar de APM a otros productos, por
- lo que debes asegurarte de definir el mismo valor cuando utilices ambos productos.
- En el SDK del navegador RUM, un servicio denota un conjunto de páginas creadas
- por un equipo que ofrece una funcionalidad específica en tu aplicación de navegador.
- Puedes asignar páginas web a un servicio con [rastreo de vista manual](/real_user_monitoring/browser/advanced_configuration/?tab=npm#override-default-rum-view-names).
- domain: Reservado
- name: Servicio
+ para la aplicación o servicio que está generando los datos, utilizado para correlacionar
+ sesiones de usuario. Se utiliza para cambiar de APM a otros productos, así que
+ asegúrese de definir el mismo valor cuando use ambos productos. En el SDK del
+ Navegador RUM, un servicio denota un conjunto de páginas construidas por un equipo
+ que ofrece una funcionalidad específica en su aplicación de navegador. Puedes
+ asignar páginas web a un servicio con [seguimiento manual de visualizaciones](/real_user_monitoring/application_monitoring/browser/advanced_configuration/?tab=npm#override-default-rum-view-names).
+ domain: Reserved
+ name: service
product_source:
- icon-log
- icon-rum
@@ -55,216 +54,215 @@ attributes:
- ios
- browser
- roku
- type: cadena
-- description: El ID de traza (trace) que se utiliza para las trazas. Se utiliza para
- correlacionar las trazas con otros datos, incluidos los logs.
- domain: Reservado
+ type: string
+- description: El ID de traza utilizado para las trazas. Se utiliza para correlacionar
+ sus trazas con otros datos, incluidos los registros.
+ domain: Reserved
name: trace_id
product_source:
- icon-log
- icon-apm
- type: número
-- description: El cuerpo de una entrada de log, resaltado y mostrado en Logs Live
- Tail, donde está indexado para la búsqueda de texto completo.
- domain: Reservado
+ type: number
+- description: El cuerpo de una entrada de registro, resaltado y mostrado en Logs
+ Live Tail, donde se indexa para búsqueda de texto completo.
+ domain: Reserved
name: message
product_source:
- icon-log
- type: cadena
-- description: Número total de bytes transmitidos del cliente al servidor cuando se
- emite el log.
- domain: Comunicaciones de red
+ type: string
+- description: Número total de bytes transmitidos desde el cliente al servidor cuando
+ se emite el registro.
+ domain: Network communications
name: network.bytes_read
product_source:
- icon-log
- type: número
-- description: Número total de bytes transmitidos del servidor al cliente cuando se
- emite el log.
- domain: Comunicaciones de red
+ type: number
+- description: Número total de bytes transmitidos desde el servidor al cliente cuando
+ se emite el registro.
+ domain: Network communications
name: network.bytes_written
product_source:
- icon-log
- type: número
+ type: number
- description: Nombre del país.
- domain: Geolocalización
+ domain: Geolocation
name: network.client.geoip.country.name
product_source:
- icon-log
- type: cadena
+ type: string
- description: '[Código ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)
del país (por ejemplo, `US` para Estados Unidos, `FR` para Francia).'
- domain: Geolocalización
+ domain: Geolocation
name: network.client.geoip.country.iso_code
product_source:
- icon-log
- type: cadena
+ type: string
- description: Código ISO del continente (`EU`, `AS`, `NA`, `AF`, `AN`, `SA`, `OC`).
- domain: Geolocalización
+ domain: Geolocation
name: network.client.geoip.continent.code
product_source:
- icon-log
- type: cadena
-- description: Nombre del continente (`Europe`, `Australia`, `North America`, `Africa`,
- `Antartica`, `South America`, `Oceania`).
- domain: Geolocalización
+ type: string
+- description: Nombre del continente (`Europa`, `Australia`, `América del Norte`,
+ `África`, `Antártida`, `América del Sur`, `Oceanía`).
+ domain: Geolocation
name: network.client.geoip.continent.name
product_source:
- icon-log
- type: cadena
+ type: string
- description: Nombre del primer nivel de subdivisión del país (por ejemplo, `California`
- en Estados Unidos o el departamento `Sarthe` en Francia).
- domain: Geolocalización
+ en los Estados Unidos o el departamento de `Sarthe` en Francia).
+ domain: Geolocation
name: network.client.geoip.subdivision.name
product_source:
- icon-log
- type: cadena
-- description: '[Código ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)
- del primer nivel de subdivisión del país (por ejemplo, `CA` en Estados Unidos
- o el departamento `SA` en Francia).'
- domain: Geolocalización
+ type: string
+- description: Código ISO del primer nivel de subdivisión del país (por ejemplo, `CA`
+ en los Estados Unidos o el departamento de `SA` en Francia).
+ domain: Geolocation
name: network.client.geoip.subdivision.iso_code
product_source:
- icon-log
- type: cadena
-- description: El nombre de la ciudad (por ejemplo, `Paris`, `New York`).
- domain: Geolocalización
+ type: string
+- description: El nombre de la ciudad (por ejemplo, `París`, `Nueva York`).
+ domain: Geolocation
name: network.client.geoip.city.name
product_source:
- icon-log
- type: cadena
+ type: string
- description: Campo de encabezado HTTP que identifica la dirección de la página web
- vinculada al recurso solicitado.
+ que enlazó al recurso que se está solicitando.
domain: HTTP
name: http.referer
product_source:
- icon-log
- type: cadena
+ type: string
- description: El ID de la solicitud HTTP.
domain: HTTP
name: http.request_id
product_source:
- icon-log
- type: cadena
+ type: string
- description: La parte del host HTTP de la URL.
- domain: HTTP, detalles de la URL
+ domain: HTTP, URL Details
name: http.url_details.host
product_source:
- icon-log
- icon-apm
- type: cadena
+ type: string
- description: La parte del puerto HTTP de la URL.
- domain: HTTP, detalles de la URL
+ domain: HTTP, URL Details
name: http.url_details.port
product_source:
- icon-log
- icon-apm
- type: número
+ type: number
- description: La parte de la ruta HTTP de la URL.
- domain: HTTP, detalles de la URL
+ domain: HTTP, URL Details
name: http.url_details.path
product_source:
- icon-log
- icon-apm
- type: cadena
-- description: Las partes de la cadena de la consulta HTTP de la URL desglosadas como
- atributos de clave/valor de parámetros de consulta.
- domain: HTTP, detalles de la URL
+ type: string
+- description: Las partes de la cadena de consulta HTTP de la URL descompuestas como
+ atributos clave/valor de parámetros de consulta.
+ domain: HTTP, URL Details
name: http.url_details.queryString
product_source:
- icon-log
- icon-apm
- type: objecto
-- description: El nombre de protocolo de la URL (HTTP o HTTPS).
- domain: HTTP, detalles de la URL
+ type: object
+- description: El nombre del protocolo de la URL (HTTP o HTTPS).
+ domain: HTTP, URL Details
name: http.url_details.scheme
product_source:
- icon-log
- icon-apm
- type: cadena
-- description: La familia del SO informada por el User-Agent.
+ type: string
+- description: La familia de sistemas operativos reportada por el User-Agent.
domain: User-Agent
name: http.useragent_details.os.family
product_source:
- icon-log
- type: cadena
-- description: La familia de navegadores informada por el User-Agent.
+ type: string
+- description: La familia de navegadores reportada por el User-Agent.
domain: User-Agent
name: http.useragent_details.browser.family
product_source:
- icon-log
- type: cadena
-- description: La familia de dispositivos informada por el User-Agent.
+ type: string
+- description: La familia de dispositivos reportada por el User-Agent.
domain: User-Agent
name: http.useragent_details.device.family
product_source:
- icon-log
- type: cadena
-- description: El nombre del registrador.
- domain: Código de origen
+ type: string
+- description: El nombre del logger.
+ domain: Source code
name: logger.name
product_source:
- icon-log
- type: cadena
-- description: El nombre del subproceso actual cuando se activa el log.
- domain: Código de origen
+ type: string
+- description: El nombre del hilo actual cuando se genera el registro.
+ domain: Source code
name: logger.thread_name
product_source:
- icon-log
- type: cadena
-- description: El nombre del método de clase.
- domain: Código de origen
+ type: string
+- description: El nombre del método de la clase.
+ domain: Source code
name: logger.method_name
product_source:
- icon-log
- type: cadena
-- description: La versión del registrador.
- domain: Código de origen
+ type: string
+- description: La versión del logger.
+ domain: Source code
name: logger.version
product_source:
- icon-log
- type: cadena
-- description: El tipo o la clase de error (o código en algunos casos).
- domain: Código de origen
+ type: string
+- description: El tipo o clase de error (o código en algunos casos).
+ domain: Source code
name: error.kind
product_source:
- icon-log
- type: cadena
-- description: El nombre de la base de datos a la que te estás conectando. Por ejemplo,
- en Java, si `jdbc.url="jdbc:mysql://127.0.0.1:3306/customers"`, el nombre de instancia
- es `customers`.
- domain: Base de datos
+ type: string
+- description: El nombre de la base de datos a la que se está conectando. Por ejemplo,
+ en Java, si `jdbc.url="jdbc:mysql://127.0.0.1:3306/customers"`, el nombre de la
+ instancia es `customers`.
+ domain: Database
name: db.instance
product_source:
- icon-apm
- icon-log
- type: cadena
-- description: 'Una declaración de base de datos para el tipo de base de datos indicado.
- Por ejemplo, para MySQL: `''SELECT * FROM wuser_table'';`, y para Redis: `''SET
+ type: string
+- description: 'Una declaración de base de datos para el tipo de base de datos dado.
+ Por ejemplo, para mySQL: `''SELECT * FROM wuser_table'';` y para Redis: `''SET
mykey ''WuValue''''`.'
- domain: Base de datos
+ domain: Database
name: db.statement
product_source:
- icon-apm
- icon-log
- type: cadena
-- description: El usuario que realiza la operación.
- domain: Base de datos
+ type: string
+- description: Usuario que realiza la operación.
+ domain: Database
name: db.user
product_source:
- icon-apm
- icon-log
- type: cadena
+ type: string
- description: 'Una duración de cualquier tipo en **nanosegundos**: tiempo de respuesta
- HTTP, tiempo de consulta de base de datos, latencia, etc. [Reasigna](/logs/log_configuration/processors/#remapper)
- cualquier duración dentro de los logs a este atributo porque Datadog lo muestra
- y lo usa como una medida predeterminada para la búsqueda de trazas.'
- domain: Rendimiento
+ HTTP, tiempo de consulta de base de datos, latencia, etc. [Remapear](/logs/log_configuration/processors/remapper/)
+ cualquier duración dentro de los registros a este atributo porque Datadog lo muestra
+ y lo utiliza como medida predeterminada para la búsqueda de trazas.'
+ domain: Performance
name: duration
product_source:
- icon-log
- type: número
+ type: number
- description: El identificador del usuario.
- domain: Usuario
+ domain: User
name: usr.id
product_source:
- icon-log
@@ -273,9 +271,9 @@ attributes:
- ios
- browser
- roku
- type: cadena
-- description: El nombre descriptivo.
- domain: Usuario
+ type: string
+- description: El nombre amigable del usuario.
+ domain: User
name: usr.name
product_source:
- icon-log
@@ -284,9 +282,9 @@ attributes:
- ios
- browser
- roku
- type: cadena
+ type: string
- description: El correo electrónico del usuario.
- domain: Usuario
+ domain: User
name: usr.email
product_source:
- icon-log
@@ -295,138 +293,136 @@ attributes:
- ios
- browser
- roku
- type: cadena
-- description: El nombre de host.
- domain: Syslog y trasvasadores de logs
+ type: string
+- description: El nombre del host.
+ domain: Syslog and log shippers
name: syslog.hostname
product_source:
- icon-log
- type: cadena
-- description: El nombre de la aplicación. Generalmente reasignado al atributo reservado
+ type: string
+- description: El nombre de la aplicación. Generalmente remapeado al atributo reservado
`service`.
- domain: Syslog y trasvasadores de logs
+ domain: Syslog and log shippers
name: syslog.appname
product_source:
- icon-log
- type: cadena
-- description: La severidad del log. Generalmente reasignado al atributo reservado
+ type: string
+- description: La severidad del registro. Generalmente remapeado al atributo reservado
`status`.
- domain: Syslog y trasvasadores de logs
+ domain: Syslog and log shippers
name: syslog.severity
product_source:
- icon-log
- type: número
-- description: La marca de tiempo del log. Generalmente reasignado al atributo reservado
- `date`.
- domain: Syslog y trasvasadores de logs
+ type: number
+- description: La marca de tiempo del registro. Generalmente remapeado al atributo
+ reservado `date`.
+ domain: Syslog and log shippers
name: syslog.timestamp
product_source:
- icon-log
- type: cadena
-- description: El nombre del entorno de donde procede la fuente de los logs.
- domain: Syslog y trasvasadores de logs
+ type: string
+- description: El nombre del entorno de donde provienen los registros.
+ domain: Syslog and log shippers
name: syslog.env
product_source:
- icon-log
- type: cadena
+ type: string
- description: El identificador de la consulta DNS.
domain: DNS
name: dns.id
product_source:
- icon-log
- type: cadena
+ type: string
- description: El nombre de dominio consultado.
domain: DNS
name: dns.question.name
product_source:
- icon-log
- type: cadena
-- description: Un [código de dos octetos](https://en.wikipedia.org/wiki/List_of_DNS_record_types)
+ type: string
+- description: Un [código de dos octetos](https://es.wikipedia.org/wiki/Lista_de_tipos_de_registros_DNS)
que especifica el tipo de pregunta DNS.
domain: DNS
name: dns.question.type
product_source:
- icon-log
- type: cadena
-- description: La clase buscada por la pregunta DNS (como el IP cuando se utiliza
- Internet).
+ type: string
+- description: La clase buscada por la pregunta DNS (como IP al usar internet).
domain: DNS
name: dns.question.class
product_source:
- icon-log
- type: cadena
+ type: string
- description: El tamaño de la pregunta DNS en bytes.
domain: DNS
name: dns.question.size
product_source:
- icon-log
- type: número
+ type: number
- description: La dirección IP con la que responde el DNS.
domain: DNS
name: dns.answer.name
product_source:
- icon-log
- type: cadena
-- description: Un [código de dos octetos](https://en.wikipedia.org/wiki/List_of_DNS_record_types)
+ type: string
+- description: Un [código de dos octetos](https://es.wikipedia.org/wiki/Lista_de_tipos_de_registros_DNS)
que especifica el tipo de respuesta DNS.
domain: DNS
name: dns.answer.type
product_source:
- icon-log
- type: cadena
-- description: La clase contestada por el DNS.
+ type: string
+- description: La clase respondida por el DNS.
domain: DNS
name: dns.answer.class
product_source:
- icon-log
- type: cadena
+ type: string
- description: El tamaño de la respuesta DNS en bytes.
domain: DNS
name: dns.answer.size
product_source:
- icon-log
- type: número
-- description: El código de respuesta DNS.
+ type: number
+- description: El código de respuesta del DNS.
domain: DNS
name: dns.flags.rcode
product_source:
- icon-log
- type: cadena
-- description: El nombre compartido a través de eventos generado por la misma actividad
+ type: string
+- description: El nombre compartido entre eventos generados por la misma actividad
(por ejemplo, autenticación).
- domain: Eventos
+ domain: Events
name: evt.name
product_source:
- icon-log
- type: cadena
-- description: El resultado del evento (por ejemplo, `success`, `failure`).
- domain: Eventos
+ type: string
+- description: El resultado del evento (por ejemplo, `éxito`, `fallo`).
+ domain: Events
name: evt.outcome
product_source:
- icon-log
- type: cadena
+ type: string
- description: Inicio del evento en milisegundos desde la época.
- domain: Atributos básicos del RUM
+ domain: RUM core attributes
name: date
product_source:
- icon-rum
- android
- ios
- roku
- type: entero
-- description: El tipo de evento (por ejemplo, `view` o `resource`).
- domain: Atributos básicos del RUM
- name: tipo
+ type: integer
+- description: El tipo de evento (por ejemplo, `visualización` o `recurso`).
+ domain: RUM core attributes
+ name: type
product_source:
- icon-rum
- android
- browser
- ios
- roku
- type: cadena
-- description: El ID de aplicación de Datadog generado al crear una aplicación de
- RUM.
- domain: Atributos básicos del RUM
+ type: string
+- description: El ID de la aplicación Datadog generado al crear una aplicación RUM.
+ domain: RUM core attributes
name: application.id
product_source:
- icon-rum
@@ -434,118 +430,119 @@ attributes:
- browser
- ios
- roku
- type: cadena
+ type: string
- description: El nombre de la aplicación Datadog.
- domain: Atributos básicos del RUM
+ domain: RUM core attributes
name: application.name
product_source:
- icon-rum
- android
- browser
- ios
- type: cadena
-- description: El tipo de dispositivo notificado por el dispositivo (System User-Agent).
- domain: Dispositivo (Android, iOS, Roku)
+ type: string
+- description: El tipo de dispositivo reportado por el dispositivo (User-Agent del
+ sistema).
+ domain: Device (Android, iOS, Roku)
name: device.type
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: La marca del dispositivo notificada por el dispositivo (System User-Agent).
- domain: Dispositivo (Android, iOS, Roku)
+ type: string
+- description: La marca del dispositivo reportada por el dispositivo (System User-Agent).
+ domain: Device (Android, iOS, Roku)
name: device.brand
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: El modelo del dispositivo notificado por el dispositivo (System User-Agent).
- domain: Dispositivo (Android, iOS, Roku)
+ type: string
+- description: El modelo del dispositivo reportado por el dispositivo (System User-Agent).
+ domain: Device (Android, iOS, Roku)
name: device.model
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: El nombre del dispositivo notificado por el dispositivo (System User-Agent).
- domain: Dispositivo (Android, iOS, Roku)
+ type: string
+- description: El nombre del dispositivo reportado por el dispositivo (System User-Agent).
+ domain: Device (Android, iOS, Roku)
name: device.name
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: Estado de la accesibilidad a la red del dispositivo (`connected`, `not
- connected` o `maybe`).
- domain: Conectividad (Android, iOS)
+ type: string
+- description: Estado de la conexión de red del dispositivo (`connected`, `not connected`
+ o `maybe`).
+ domain: Connectivity (Android, iOS)
name: connectivity.status
product_source:
- icon-rum
- android
- ios
- type: cadena
+ type: string
- description: La lista de interfaces de red disponibles (por ejemplo, `bluetooth`,
- `cellular`, `ethernet` o `wifi`).
- domain: Conectividad (Android, iOS)
+ `celular`, `ethernet` o `wifi`).
+ domain: Connectivity (Android, iOS)
name: connectivity.interfaces
product_source:
- icon-rum
- android
- ios
- type: cadena
+ type: string
- description: El tipo de tecnología de radio utilizada para la conexión celular.
- domain: Conectividad (Android, iOS)
+ domain: Connectivity (Android, iOS)
name: connectivity.cellular.technology
product_source:
- icon-rum
- android
- ios
- type: cadena
+ type: string
- description: El nombre del operador de la SIM.
- domain: Conectividad (Android, iOS)
+ domain: Connectivity (Android, iOS)
name: connectivity.cellular.carrier_name
product_source:
- icon-rum
- android
- ios
- type: cadena
-- description: El nombre del sistema operativo notificado por el dispositivo (System
- User-Agent).
- domain: Sistema operativo (Android, iOS, Roku)
+ type: string
+- description: El nombre del sistema operativo según lo reportado por el dispositivo
+ (System User-Agent).
+ domain: Operating System (Android, iOS, Roku)
name: os.name
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: La versión del sistema operativo notificada por el dispositivo (System
- User-Agent).
- domain: Sistema operativo (Android, iOS, Roku)
+ type: string
+- description: La versión del sistema operativo según lo reportado por el dispositivo
+ (System User-Agent).
+ domain: Operating System (Android, iOS, Roku)
name: os.version
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: La versión principal del sistema operativo notificada por el dispositivo
- (System User-Agent).
- domain: Sistema operativo (Android, iOS, Roku)
+ type: string
+- description: La versión principal del sistema operativo según lo reportado por el
+ dispositivo (System User-Agent).
+ domain: Operating System (Android, iOS, Roku)
name: os.version_major
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: Nombre del país.
- domain: Geolocalización
+ domain: Geolocation
name: geo.country
product_source:
- icon-rum
@@ -553,10 +550,10 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: El [Código ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)
+ type: string
+- description: El [código ISO](https://es.wikipedia.org/wiki/Anexo:C%C3%B3digos_ISO_3166-1)
del país (por ejemplo, `US` para Estados Unidos o `FR` para Francia).
- domain: Geolocalización
+ domain: Geolocation
name: geo.country_iso_code
product_source:
- icon-rum
@@ -564,10 +561,10 @@ attributes:
- browser
- ios
- roku
- type: cadena
+ type: string
- description: Nombre del primer nivel de subdivisión del país (por ejemplo, `California`
- en Estados Unidos o el departamento `Sarthe` en Francia).
- domain: Geolocalización
+ en los Estados Unidos o el departamento de `Sarthe` en Francia).
+ domain: Geolocation
name: geo.country_subdivision
product_source:
- icon-rum
@@ -575,9 +572,9 @@ attributes:
- browser
- ios
- roku
- type: cadena
+ type: string
- description: Código ISO del continente (`EU`, `AS`, `NA`, `AF`, `AN`, `SA` o `OC`).
- domain: Geolocalización
+ domain: Geolocation
name: geo.continent_code
product_source:
- icon-rum
@@ -585,10 +582,10 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: Nombre del continente (`Europe`, `Australia`, `North America`, `Africa`,
- `Antarctica`, `South America` o `Oceania`).
- domain: Geolocalización
+ type: string
+- description: Nombre del continente (`Europa`, `Australia`, `América del Norte`,
+ `África`, `Antártida`, `América del Sur` o `Oceanía`).
+ domain: Geolocation
name: geo.continent
product_source:
- icon-rum
@@ -596,10 +593,10 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: El nombre de la ciudad (por ejemplo, `San Francisco`, `Paris` o `New
+ type: string
+- description: El nombre de la ciudad (por ejemplo, `San Francisco`, `París` o `Nueva
York`).
- domain: Geolocalización
+ domain: Geolocation
name: geo.city
product_source:
- icon-rum
@@ -607,230 +604,233 @@ attributes:
- browser
- ios
- roku
- type: cadena
+ type: string
- description: Identificador del usuario.
- domain: Atributos de usuario de RUM (Android, Roku)
+ domain: RUM user attributes (Android, Roku)
name: user.id
product_source:
- icon-rum
- android
- roku
- type: cadena
+ type: string
- description: Identificador del usuario.
- domain: Atributos de usuario de RUM (iOS)
+ domain: RUM user attributes (iOS, Browser)
name: usr.id
product_source:
- icon-rum
- ios
- type: cadena
+ - browser
+ type: string
- description: Nombre del usuario.
- domain: Atributos de usuario globales (Android, iOS, Roku)
+ domain: Global user attributes (Android, iOS, Browser, Roku)
name: usr.name
product_source:
- icon-rum
- android
- ios
+ - browser
- roku
- type: cadena
+ type: string
- description: Correo electrónico del usuario.
- domain: Atributos de usuario globales (Android, iOS, Roku)
+ domain: Global user attributes (Android, iOS, Browser, Roku)
name: usr.email
product_source:
- icon-rum
- android
- ios
+ - browser
- roku
- type: cadena
+ type: string
- description: ID único de la sesión.
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ domain: Session (Android events, iOS events, Roku events)
name: session.id
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: Tipo de sesión (`user`).
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Tipo de la sesión (`user`).
+ domain: Session (Android events, iOS events, Roku events)
name: session.type
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: Indica si la sesión está actualmente activa. La sesión finaliza si
- un usuario sale de la aplicación o cierra la ventana del navegador y expira tras
- 4 horas de actividad o 15 minutos de inactividad.
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Indica si la sesión está actualmente activa. La sesión termina si un
+ usuario navega fuera de la aplicación o cierra la ventana del navegador, y expira
+ después de 4 horas de actividad o 15 minutos de inactividad.
+ domain: Session (Android events, iOS events, Roku events)
name: session.is_active
product_source:
- icon-rum
- android
- ios
- roku
- type: booleano
-- description: URL de la vista inicial de la sesión.
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ type: boolean
+- description: URL de la visualización inicial de la sesión.
+ domain: Session (Android events, iOS events, Roku events)
name: session.initial_view.url
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: Nombre de la vista inicial de la sesión.
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Nombre de la visualización inicial de la sesión.
+ domain: Session (Android events, iOS events, Roku events)
name: session.initial_view.name
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: URL de la última vista de la sesión.
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: URL de la última visualización de la sesión.
+ domain: Session (Android events, iOS events, Roku events)
name: session.last_view.url
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: Nombre de la última vista de la sesión.
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Nombre de la última visualización de la sesión.
+ domain: Session (Android events, iOS events, Roku events)
name: session.last_view.name
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: Dirección IP de la sesión extraída de la conexión TCP de la entrada.
- Si deseas dejar de recopilar este atributo, cambia la configuración en tus [detalles
+ Si desea dejar de recopilar este atributo, cambie la configuración en los [detalles
de la aplicación](/data_security/real_user_monitoring/#ip-address).
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ domain: Session (Android events, iOS events, Roku events)
name: session.ip
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: Información del `User-Agent` del sistema para interpretar la información
del dispositivo.
- domain: Sesión (eventos Android, eventos iOS, eventos Roku)
+ domain: Session (Android events, iOS events, Roku events)
name: session.useragent
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: ID único de la vista inicial correspondiente al evento.
- domain: Vista (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: ID único de la visualización inicial correspondiente al evento.
+ domain: View (Android events, iOS events, Roku events)
name: view.id
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: Nombre canónico de la clase correspondiente al evento. Para iOS, la
URL de la clase `UIViewController` correspondiente al evento.
- domain: Vista (eventos Android, eventos iOS, eventos Roku)
+ domain: View (Android events, iOS events, Roku events)
name: view.url
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: Nombre personalizable de la vista correspondiente al evento.
- domain: Vista (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Nombre personalizable de la visualización correspondiente al evento.
+ domain: View (Android events, iOS events, Roku events)
name: view.name
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: Identificador único del recurso.
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.id
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: El tipo de recurso que se recopila (por ejemplo, `xhr`, `image`, `font`,
- `css` o `js`).
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: El tipo de recurso que se está recopilando (por ejemplo, `xhr`, `imagen`,
+ `fuente`, `css` o `js`).
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.type
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: El método HTTP (por ejemplo, `POST`, `GET`, `PATCH` o `DELETE`).
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.method
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: El código de estado de la respuesta.
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.status_code
product_source:
- icon-rum
- android
- ios
- roku
- type: número
+ type: number
- description: La URL del recurso.
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.url
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: El nombre del proveedor de recursos. De forma predeterminada es `unknown`.
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: El nombre del proveedor del recurso. Por defecto es `unknown`.
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.provider.name
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: El dominio del proveedor del recurso.
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.provider.domain
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: El tipo de proveedor del recurso (por ejemplo, `first-party`, `cdn`,
`ad` o `analytics`).
- domain: Recurso (eventos Android, eventos iOS, eventos Roku)
+ domain: Resource (Android events, iOS events, Roku events)
name: resource.provider.type
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: Procedencia del error (por ejemplo, `webview`, `logger` o `network`).
- domain: Error (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: De dónde proviene el error (por ejemplo, `webview`, `logger` o `red`).
+ domain: Error (Browser events, Android events, iOS events, Roku events)
name: error.source
product_source:
- icon-rum
@@ -838,9 +838,9 @@ attributes:
- browser
- ios
- roku
- type: cadena
+ type: string
- description: El tipo de error (o código de error en algunos casos).
- domain: Error (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ domain: Error (Browser events, Android events, iOS events, Roku events)
name: error.type
product_source:
- icon-apm
@@ -849,9 +849,10 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: Un mensaje conciso, legible, de una línea, que explique el evento.
- domain: Error (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Un mensaje conciso, legible por humanos, de una línea que explica el
+ evento.
+ domain: Error (Browser events, Android events, iOS events, Roku events)
name: error.message
product_source:
- icon-apm
@@ -861,9 +862,9 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: La stack trace o información complementaria sobre el error.
- domain: Error (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: La traza de pila o información complementaria sobre el error.
+ domain: Error (Browser events, Android events, iOS events, Roku events)
name: error.stack
product_source:
- icon-apm
@@ -873,73 +874,73 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: La stack trace o información complementaria sobre el error.
- domain: Error (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: La traza de pila o información complementaria sobre el error.
+ domain: Error (Android events, iOS events, Roku events)
name: error.issue_id
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: El código de estado de la respuesta.
- domain: Error de red (eventos Android, eventos iOS, eventos Roku)
+ domain: Network error (Android events, iOS events, Roku events)
name: error.resource.status_code
product_source:
- icon-rum
- android
- ios
- roku
- type: número
+ type: number
- description: El método HTTP (por ejemplo, `POST` o `GET`).
- domain: Error de red (eventos Android, eventos iOS, eventos Roku)
+ domain: Network error (Android events, iOS events, Roku events)
name: error.resource.method
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: La URL del recurso.
- domain: Error de red (eventos Android, eventos iOS, eventos Roku)
+ domain: Network error (Android events, iOS events, Roku events)
name: error.resource.url
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
-- description: El nombre del proveedor de recursos. De forma predeterminada es `unknown`.
- domain: Error de red (eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: El nombre del proveedor del recurso. Por defecto es `desconocido`.
+ domain: Network error (Android events, iOS events, Roku events)
name: error.resource.provider.name
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: El dominio del proveedor del recurso.
- domain: Error de red (eventos Android, eventos iOS, eventos Roku)
+ domain: Network error (Android events, iOS events, Roku events)
name: error.resource.provider.domain
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: El tipo de proveedor del recurso (por ejemplo, `first-party`, `cdn`,
`ad` o `analytics`).
- domain: Error de red (eventos Android, eventos iOS, eventos Roku)
+ domain: Network error (Android events, iOS events, Roku events)
name: error.resource.provider.type
product_source:
- icon-rum
- android
- ios
- roku
- type: cadena
+ type: string
- description: UUID de la acción del usuario.
- domain: Acción (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ domain: Action (Browser events, Android events, iOS events, Roku events)
name: action.id
product_source:
- icon-rum
@@ -947,11 +948,11 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: Tipo de la acción de usuario (por ejemplo, `tap` o `application_start`).
- Para [Acciones de usuario del navegador personalizadas](/real_user_monitoring/browser/tracking_user_actions/?tab=npm#custom-actions),
+ type: string
+- description: Tipo de la acción del usuario (por ejemplo, `tap` o `application_start`).
+ Para [Acciones de Usuario en Navegador Personalizadas](/real_user_monitoring/application_monitoring/browser/tracking_user_actions/?tab=npm#custom-actions),
se establece en `custom`.
- domain: Acción (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ domain: Action (Browser events, Android events, iOS events, Roku events)
name: action.type
product_source:
- icon-rum
@@ -959,11 +960,11 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: Un nombre descriptivo (por ejemplo, `Click on checkout`). Para [Acciones
- de usuario del navegador personalizadas](/real_user_monitoring/browser/tracking_user_actions/?tab=npm#custom-actions),
- el nombre de acción dado en la llamada a la API.
- domain: Acción (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Un nombre amigable para el usuario (por ejemplo, `Clic en finalizar
+ compra`). Para [Acciones de Usuario en Navegador Personalizadas](/real_user_monitoring/application_monitoring/browser/tracking_user_actions/?tab=npm#custom-actions),
+ el nombre de la acción dado en la llamada a la API.
+ domain: Action (Browser events, Android events, iOS events, Roku events)
name: action.name
product_source:
- icon-rum
@@ -971,10 +972,10 @@ attributes:
- browser
- ios
- roku
- type: cadena
-- description: Elemento con el que ha interactuado el usuario. Solo para acciones
- recopiladas automáticamente.
- domain: Acción (eventos de navegador, eventos Android, eventos iOS, eventos Roku)
+ type: string
+- description: Elemento con el que el usuario interactuó. Solo para acciones recolectadas
+ automáticamente.
+ domain: Action (Browser events, Android events, iOS events, Roku events)
name: action.target.name
product_source:
- icon-rum
@@ -982,729 +983,869 @@ attributes:
- browser
- ios
- roku
- type: cadena
+ type: string
- description: ID generado aleatoriamente para cada vista de página.
- domain: Vista (navegador)
+ domain: View (Browser)
name: view.id
product_source:
- icon-rum
- browser
- type: cadena
-- description: El tipo de carga de la página, `initial_load` o `route_change`. Para
- obtener más información, consulta los [documentos de soporte de aplicaciones de
- una sola página](/real_user_monitoring/browser/monitoring_page_performance/#monitoring-single-page-applications-spa).
- domain: Vista (navegador)
+ type: string
+- description: El tipo de carga de página, `initial_load` o `route_change`. Para más
+ información, consulte la [documentación de soporte para aplicaciones de una sola
+ página](/real_user_monitoring/application_monitoring/browser/monitoring_page_performance/#monitoring-single-page-applications-spa).
+ domain: View (Browser)
name: view.loading_type
product_source:
- icon-rum
- browser
- type: cadena
-- description: La URL de la página web anterior desde la que se siguió un enlace a
- la página solicitada actualmente.
- domain: Vista (navegador)
+ type: string
+- description: La URL de la página web anterior desde la cual se siguió un enlace
+ a la página actualmente solicitada.
+ domain: View (Browser)
name: view.referrer
product_source:
- icon-rum
- browser
- type: cadena
-- description: La URL de la vista.
- domain: Vista (navegador)
+ type: string
+- description: La URL de la visualización.
+ domain: View (Browser)
name: view.url
product_source:
- icon-rum
- browser
- type: cadena
-- description: La parte de hash de la URL.
- domain: Vista (navegador)
+ type: string
+- description: La parte hash de la URL.
+ domain: View (Browser)
name: view.url_hash
product_source:
- icon-rum
- browser
- type: cadena
-- description: La parte de host de la URL.
- domain: Vista (navegador)
+ type: string
+- description: La parte host de la URL.
+ domain: View (Browser)
name: view.url_host
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: La parte de ruta de la URL.
- domain: Vista (navegador)
+ domain: View (Browser)
name: view.url_path
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: El grupo de URL automático generado para URLs similares (por ejemplo,
`/dashboard/?` para `/dashboard/123` y `/dashboard/456`).
- domain: Vista (navegador)
+ domain: View (Browser)
name: view.url_path_group
product_source:
- icon-rum
- browser
- type: cadena
-- description: Las partes de la cadena de consulta de la URL desglosadas como atributos
+ type: string
+- description: Las partes de la cadena de consulta de la URL descompuestas como atributos
clave/valor de parámetros de consulta.
- domain: Vista (navegador)
+ domain: View (Browser)
name: view.url_query
product_source:
- icon-rum
- browser
- type: objecto
-- description: La parte de esquema de la URL.
- domain: Vista (navegador)
+ type: object
+- description: La parte del esquema de la URL.
+ domain: View (Browser)
name: view.url_scheme
product_source:
- icon-rum
- browser
- type: objecto
-- description: El tipo de dispositivo según lo que indica el dispositivo (cabecera
- HTTP User-Agent).
- domain: Dispositivo (navegador)
+ type: object
+- description: El tipo de dispositivo reportado por el dispositivo (encabezado HTTP
+ User-Agent).
+ domain: Device (Browser)
name: device.type
product_source:
- icon-rum
- browser
- type: cadena
-- description: La marca del dispositivo según lo que indica el dispositivo (cabecera
+ type: string
+- description: La marca del dispositivo según lo informado por el dispositivo (encabezado
HTTP User-Agent).
- domain: Dispositivo (navegador)
+ domain: Device (Browser)
name: device.brand
product_source:
- icon-rum
- browser
- type: cadena
-- description: El modelo del dispositivo según lo que indica el dispositivo (cabecera
+ type: string
+- description: El modelo del dispositivo según lo informado por el dispositivo (encabezado
HTTP User-Agent).
- domain: Dispositivo (navegador)
+ domain: Device (Browser)
name: device.model
product_source:
- icon-rum
- browser
- type: cadena
-- description: El nombre del dispositivo según lo que indica el dispositivo (cabecera
+ type: string
+- description: El nombre del dispositivo según lo informado por el dispositivo (encabezado
HTTP User-Agent).
- domain: Dispositivo (navegador)
+ domain: Device (Browser)
name: device.name
product_source:
- icon-rum
- browser
- type: cadena
-- description: El nombre del SO según lo que indica el dispositivo (cabecera HTTP
- User-Agent).
- domain: Sistema operativo (navegador)
+ type: string
+- description: El nombre del sistema operativo según lo informado por el dispositivo
+ (encabezado HTTP User-Agent).
+ domain: Operating system (Browser)
name: os.name
product_source:
- icon-rum
- browser
- type: cadena
-- description: La versión del SO según lo que indica el dispositivo (cabecera HTTP
- User-Agent).
- domain: Sistema operativo (navegador)
+ type: string
+- description: La versión del sistema operativo según lo informado por el dispositivo
+ (encabezado HTTP User-Agent).
+ domain: Operating system (Browser)
name: os.version
product_source:
- icon-rum
- browser
- type: cadena
-- description: La versión principal del SO según lo que indica el dispositivo (cabecera
- HTTP User-Agent).
- domain: Sistema operativo (navegador)
+ type: string
+- description: La versión principal del sistema operativo según lo informado por el
+ dispositivo (encabezado HTTP User-Agent).
+ domain: Operating system (Browser)
name: os.version_major
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: ID generado aleatoriamente para cada sesión.
- domain: Sesión (eventos del navegador)
+ domain: Session (Browser events)
name: session.id
product_source:
- icon-rum
- browser
- type: cadena
-- description: Dirección IP del cliente. Si deseas dejar de recopilar este atributo,
- cambia la configuración en tus [detalles de la aplicación](/data_security/real_user_monitoring/#ip-address).
- domain: Sesión (eventos del navegador)
+ type: string
+- description: Dirección IP del cliente. Si desea dejar de recopilar este atributo,
+ cambie la configuración en los [detalles de la aplicación](/data_security/real_user_monitoring/#ip-address).
+ domain: Session (Browser events)
name: session.ip
product_source:
- icon-rum
- browser
- type: cadena
-- description: Indica si la sesión se encuentra activa en estos momentos. La sesión
- termina después de 4 horas de actividad o 15 minutos de inactividad.
- domain: Sesión (eventos del navegador)
+ type: string
+- description: Indica si la sesión está actualmente activa. La sesión termina después
+ de 4 horas de actividad o 15 minutos de inactividad.
+ domain: Session (Browser events)
name: session.is_active
product_source:
- icon-rum
- browser
- type: booleano
-- description: El tipo de sesión, `user` o `synthetics`. Las sesiones de [Synthetic
- Browser Tests](/synthetics/browser_tests/) se excluyen de la facturación.
- domain: Sesión (eventos del navegador)
+ type: boolean
+- description: El tipo de sesión, `usuario` o `sintéticos`. Las sesiones de [Pruebas
+ de Navegador Sintéticas](/synthetics/browser_tests/) están excluidas de la facturación.
+ domain: Session (Browser events)
name: session.type
product_source:
- icon-rum
- browser
- type: cadena
-- description: La URL de la página web anterior desde la que se siguió un enlace a
- la página solicitada actualmente.
- domain: Sesión (eventos del navegador)
+ type: string
+- description: La URL de la página web anterior desde la cual se siguió un enlace
+ a la página actualmente solicitada.
+ domain: Session (Browser events)
name: session.referrer
product_source:
- icon-rum
- browser
- type: cadena
-- description: El ID de la primera vista de RUM generada por el usuario.
- domain: Sesión (eventos del navegador)
+ type: string
+- description: El ID de la primera visualización RUM generada por el usuario.
+ domain: Session (Browser events)
name: session.initial_view.id
product_source:
- icon-rum
- browser
- type: cadena
-- description: La parte de host de la URL.
- domain: Sesión (eventos del navegador)
+ type: string
+- description: La parte host de la URL.
+ domain: Session (Browser events)
name: session.initial_view.url_host
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: La parte de ruta de la URL.
- domain: Sesión (eventos del navegador)
+ domain: Session (Browser events)
name: session.initial_view.url_path
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: El grupo de URL automático generado para URLs similares (por ejemplo,
`/dashboard/?` para `/dashboard/123` y `/dashboard/456`).
- domain: Sesión (eventos del navegador)
+ domain: Session (Browser events)
name: session.initial_view.url_path_group
product_source:
- icon-rum
- browser
- type: cadena
-- description: Las partes de la cadena de consulta de la URL desglosadas como atributos
+ type: string
+- description: Las partes de la cadena de consulta de la URL descompuestas como atributos
clave/valor de parámetros de consulta.
- domain: Sesión (eventos del navegador)
+ domain: Session (Browser events)
name: session.initial_view.url_query
product_source:
- icon-rum
- browser
- type: objecto
-- description: La parte de esquema de la URL.
- domain: Sesión (eventos del navegador)
+ type: object
+- description: La parte del esquema de la URL.
+ domain: Session (Browser events)
name: session.initial_view.url_scheme
product_source:
- icon-rum
- browser
- type: objecto
-- description: El ID de la última vista de RUM generada por el usuario.
- domain: Sesión (eventos del navegador)
+ type: object
+- description: El ID de la última visualización RUM generada por el usuario.
+ domain: Session (Browser events)
name: session.last_view.id
product_source:
- icon-rum
- browser
- type: cadena
-- description: La parte de host de la URL.
- domain: Sesión (eventos del navegador)
+ type: string
+- description: La parte host de la URL.
+ domain: Session (Browser events)
name: session.last_view.url_host
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: La parte de ruta de la URL.
- domain: Sesión (eventos del navegador)
+ domain: Session (Browser events)
name: session.last_view.url_path
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: El grupo de URL automático generado para URLs similares (por ejemplo,
`/dashboard/?` para `/dashboard/123` y `/dashboard/456`).
- domain: Sesión (eventos del navegador)
+ domain: Session (Browser events)
name: session.last_view.url_path_group
product_source:
- icon-rum
- browser
- type: cadena
-- description: Las partes de la cadena de consulta de la URL desglosadas como atributos
+ type: string
+- description: Las partes de la cadena de consulta de la URL descompuestas como atributos
clave/valor de parámetros de consulta.
- domain: Sesión (eventos del navegador)
+ domain: Session (Browser events)
name: session.last_view.url_query
product_source:
- icon-rum
- browser
- type: objecto
-- description: La parte de esquema de la URL.
- domain: Sesión (eventos del navegador)
+ type: object
+- description: La parte del esquema de la URL.
+ domain: Session (Browser events)
name: session.last_view.url_scheme
product_source:
- icon-rum
- browser
- type: objecto
-- description: El tipo de recurso que se recopila (por ejemplo, `css`, `javascript`,
- `media`, `XHR` o `image`).
- domain: Recurso (eventos del navegador)
+ type: object
+- description: El tipo de recurso que se está recolectando (por ejemplo, `css`, `javascript`,
+ `media`, `XHR` o `imagen`).
+ domain: Resource (Browser events)
name: resource.type
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: El método HTTP (por ejemplo, `POST` o `GET`).
- domain: Recurso (eventos del navegador)
+ domain: Resource (Browser events)
name: resource.method
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: El código de estado de la respuesta.
- domain: Recurso (eventos del navegador)
+ domain: Resource (Browser events)
name: resource.status_code
product_source:
- icon-rum
- browser
- type: número
+ type: number
- description: La URL del recurso.
- domain: Recurso (eventos del navegador)
+ domain: Resource (Browser events)
name: resource.url
product_source:
- icon-rum
- browser
- type: cadena
-- description: La parte de host de la URL.
- domain: Recurso (eventos del navegador)
+ type: string
+- description: La parte host de la URL.
+ domain: Resource (Browser events)
name: resource.url_host
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: La parte de ruta de la URL.
- domain: Recurso (eventos del navegador)
+ domain: Resource (Browser events)
name: resource.url_path
product_source:
- icon-rum
- browser
- type: cadena
-- description: Las partes de la cadena de consulta de la URL desglosadas como atributos
+ type: string
+- description: Las partes de la cadena de consulta de la URL descompuestas como atributos
clave/valor de parámetros de consulta.
- domain: Recurso (eventos del navegador)
+ domain: Resource (Browser events)
name: resource.url_query
product_source:
- icon-rum
- browser
- type: objecto
-- description: El nombre de protocolo de la URL (HTTP o HTTPS).
- domain: Recurso (eventos del navegador)
+ type: object
+- description: El nombre del protocolo de la URL (HTTP o HTTPS).
+ domain: Resource (Browser events)
name: resource.url_scheme
product_source:
- icon-rum
- browser
- type: cadena
-- description: El nombre del proveedor de recursos. De forma predeterminada es `unknown`.
- domain: Recurso (eventos del navegador)
+ type: string
+- description: El nombre del proveedor del recurso. Por defecto es `desconocido`.
+ domain: Resource (Browser events)
name: resource.provider.name
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: El dominio del proveedor del recurso.
- domain: Recurso (eventos del navegador)
+ domain: Resource (Browser events)
name: resource.provider.domain
product_source:
- icon-rum
- browser
- type: cadena
+ type: string
- description: El tipo de proveedor del recurso (por ejemplo, `first-party`, `cdn`,
`ad` o `analytics`).
- domain: Recurso (eventos del navegador)
+ domain: Resource (Browser events)
name: resource.provider.type
product_source:
- icon-rum
- browser
- type: cadena
-- description: Los clics sin efecto detectados por el SDK de RUM Browser.
- domain: Señales de frustración (eventos del navegador)
+ type: string
+- description: Los clics muertos detectados por el SDK del Navegador RUM.
+ domain: Frustration signals (Browser events)
name: action.frustration.type:dead_click
product_source:
- icon-rum
- browser
- type: cadena
-- description: Los clics de frustración detectados por el SDK de RUM Browser.
- domain: Señales de frustración (eventos del navegador)
+ type: string
+- description: Los clics de ira detectados por el SDK del Navegador RUM.
+ domain: Frustration signals (Browser events)
name: action.frustration.type:rage_click
product_source:
- icon-rum
- browser
- type: cadena
-- description: Los clics de error detectados por el SDK RUM Browser.
- domain: Señales de frustración (eventos del navegador)
+ type: string
+- description: Los clics de error detectados por el SDK del Navegador RUM.
+ domain: Frustration signals (Browser events)
name: action.frustration.type:error_click
product_source:
- icon-rum
- browser
- type: cadena
-- description: El parámetro de la URL que rastrea la fuente de tráfico.
- domain: UTM (eventos del navegador)
+ type: string
+- description: El parámetro en la URL que rastrea la fuente del tráfico.
+ domain: UTM (Browser events)
name: view.url_query.utm_source
product_source:
- icon-rum
- browser
- type: cadena
-- description: El parámetro de la URL que rastrea el canal del que procede el tráfico.
- domain: UTM (eventos del navegador)
+ type: string
+- description: El parámetro en la URL que rastrea el canal de donde proviene el tráfico.
+ domain: UTM (Browser events)
name: view.url_query.utm_medium
product_source:
- icon-rum
- browser
- type: cadena
-- description: El parámetro de la URL que identifica la campaña de marketing específica
- vinculada a esa vista.
- domain: UTM (eventos del navegador)
+ type: string
+- description: El parámetro en la URL que identifica la campaña de marketing específica
+ asociada a esa visualización.
+ domain: UTM (Browser events)
name: view.url_query.utm_campaign
product_source:
- icon-rum
- browser
- type: cadena
-- description: El parámetro de la URL que identifica el elemento específico en el
- que un usuario ha hecho clic en una campaña de marketing.
- domain: UTM (eventos del navegador)
+ type: string
+- description: El parámetro en la URL que identifica el elemento específico en el
+ que un usuario hizo clic dentro de una campaña de marketing.
+ domain: UTM (Browser events)
name: view.url_query.utm_content
product_source:
- icon-rum
- browser
- type: cadena
-- description: El parámetro de la URL que rastrea la palabra clave que un usuario
+ type: string
+- description: El parámetro en la URL que rastrea la palabra clave que un usuario
buscó para activar una campaña determinada.
- domain: UTM (eventos del navegador)
+ domain: UTM (Browser events)
name: view.url_query.utm_term
product_source:
- icon-rum
- browser
- type: cadena
-- description: 'El idioma del SDK cliente utilizado para generar el tramo (span).
- Puede ser uno de los siguientes: `cpp`, `dotnet`, `go`, `jvm`, `javascript`, `php`,
- `python`, `ruby`.'
- domain: APM básico
+ type: string
+- description: El lenguaje del SDK del cliente utilizado para generar el tramo. Puede
+ ser uno de `cpp`, `dotnet`, `go`, `jvm`, `javascript`, `php`, `python`, `ruby`.
+ domain: APM core
name: language
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El valor de la variable de entorno `DD_ENV` o `env` definido por el
usuario para el proceso en ejecución.
- domain: APM básico (Reservado)
+ domain: APM core (Reserved)
name: env
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El valor de la variable de entorno `DD_VERSION` o `version` definido
por el usuario para el proceso en ejecución.
- domain: APM básico (Reservado)
+ domain: APM core (Reserved)
name: version
product_source:
- icon-apm
- type: cadena
+ type: string
- description: La cadena que representa el tipo de unidad de trabajo manejada por
- el tramo. Puede ser servidor, cliente, productor, consumidor o interno. Para obtener
- más información, consulta la [documentación de OpenTelemetry SpanKind](https://opentelemetry.io/docs/specs/otel/trace/api/#spankind).
- domain: APM básico
+ el tramo. Puede ser uno de servidor, cliente, productor, consumidor o interno.
+ Para más información, consulte la [documentación de OpenTelemetry SpanKind](https://opentelemetry.io/docs/specs/otel/trace/api/#spankind).
+ domain: APM core
name: span.kind
product_source:
- icon-apm
- type: cadena
-- description: El nombre de la librería o la integración que creó el tramo.
- domain: APM básico
+ type: string
+- description: El nombre de la biblioteca o integración que creó el tramo.
+ domain: APM core
name: component
product_source:
- icon-apm
- type: cadena
+ type: string
- description: La dirección IP del cliente que inició la conexión entrante.
- domain: Comunicaciones de red
+ domain: Network communications
name: network.client.ip
product_source:
- icon-apm
- icon-log
- type: cadena
-- description: La dirección IP donde se realiza la conexión saliente.
- domain: Comunicaciones de red
+ type: string
+- description: La dirección IP a la que se está realizando la conexión saliente.
+ domain: Network communications
name: network.destination.ip
product_source:
- icon-apm
- icon-log
- type: cadena
+ type: string
- description: La dirección IP del host local.
- domain: Comunicaciones de red
- name: red.host.ip
+ domain: Network communications
+ name: network.host.ip
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El puerto del cliente que inició la conexión.
- domain: Comunicaciones de red
+ domain: Network communications
name: network.client.port
product_source:
- icon-apm
- icon-log
- type: número
+ type: number
- description: El número de puerto remoto de la conexión saliente.
- domain: Comunicaciones de red
+ domain: Network communications
name: network.destination.port
product_source:
- icon-apm
- icon-log
- type: número
-- description: El nombre de host del cliente que inició la conexión entrante.
- domain: Comunicaciones de red
+ type: number
+- description: El nombre del host del cliente que inició la conexión entrante.
+ domain: Network communications
name: network.client.name
product_source:
- icon-apm
- type: cadena
-- description: El nombre de host local.
- domain: Comunicaciones de red
+ type: string
+- description: El nombre del host local.
+ domain: Network communications
name: network.host.name
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El protocolo de transporte utilizado para realizar la conexión entrante.
- domain: Comunicaciones de red
+ domain: Network communications
name: network.client.transport
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El protocolo de transporte utilizado para realizar la conexión saliente.
- domain: Comunicaciones de red
+ domain: Network communications
name: network.destination.transport
product_source:
- icon-apm
- type: cadena
-- description: El código de estado de la respuesta HTTP.
- domain: Solicitudes HTTP
+ type: string
+- description: El código de estado de respuesta HTTP.
+ domain: HTTP requests
name: http.status_code
product_source:
- icon-apm
- icon-log
- type: cadena
-- description: La URL de la solicitud HTTP, incluida la cadena de consulta enmascarada.
- Para obtener más información sobre el enmascaramiento, consulta [Configurar la
- seguridad de datos](https://docs.datadoghq.com/tracing/configure_data_security/).
- domain: Solicitudes HTTP
+ type: string
+- description: La URL de la solicitud HTTP, incluyendo la cadena de consulta ofuscada.
+ Para más información sobre ofuscación, consulte [Configurar la Seguridad de Datos](https://docs.datadoghq.com/tracing/configure_data_security/).
+ domain: HTTP requests
name: http.url
product_source:
- icon-apm
- icon-log
- type: cadena
+ type: string
- description: La versión de HTTP utilizada para la solicitud.
- domain: Solicitudes HTTP
+ domain: HTTP requests
name: http.version
product_source:
- icon-apm
- icon-log
- type: cadena
+ type: string
- description: El puerto del cliente que inició la conexión.
- domain: Solicitudes HTTP
+ domain: HTTP requests
name: http.method
product_source:
- icon-apm
- icon-log
- type: cadena
+ type: string
- description: La ruta coincidente (plantilla de ruta). Por ejemplo, `/users/:userID`.
- domain: Solicitudes HTTP
+ domain: HTTP requests
name: http.route
product_source:
- icon-apm
- type: cadena
-- description: La dirección IP del cliente original detrás de todos los servidores
- proxy, si se conoce. Se detecta a partir de encabezados como `X-Forwarded-For`.
- domain: Solicitudes HTTP
+ type: string
+- description: La dirección IP del cliente original detrás de todos los proxies, si
+ se conoce. Descubierto a partir de encabezados como `X-Forwarded-For`.
+ domain: HTTP requests
name: http.client_ip
product_source:
- icon-apm
- type: cadena
+ type: string
+- description: El tipo de dirección IP, como `pública`, `privada` o `reservada`.
+ domain: HTTP client IP details
+ name: http.client_ip_details.type
+ product_source:
+ - icon-apm
+ type: string
+- description: El nombre del país al que se resuelve la IP del cliente.
+ domain: HTTP client IP details
+ name: http.client_ip_details.country.name
+ product_source:
+ - icon-apm
+ type: string
+- description: Código [ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)
+ del país (por ejemplo, `US` para Estados Unidos, `FR` para Francia).
+ domain: HTTP client IP details
+ name: http.client_ip_details.country.iso_code
+ product_source:
+ - icon-apm
+ type: string
+- description: El código ISO del continente (`EU`, `AS`, `NA`, `AF`, `AN`, `SA`, `OC`).
+ domain: HTTP client IP details
+ name: http.client_ip_details.continent.code
+ product_source:
+ - icon-apm
+ type: string
+- description: El nombre del continente al que se resuelve la IP del cliente.
+ domain: HTTP client IP details
+ name: http.client_ip_details.continent.name
+ product_source:
+ - icon-apm
+ type: string
+- description: El nombre de la subdivisión de primer nivel (como un estado o región)
+ a la que se resuelve la IP del cliente.
+ domain: HTTP client IP details
+ name: http.client_ip_details.subdivision.name
+ product_source:
+ - icon-apm
+ type: string
+- description: El código [ISO](https://en.wikipedia.org/wiki/ISO_3166-2) de la subdivisión
+ de primer nivel (por ejemplo, `CA-ON` para Ontario, Canadá).
+ domain: HTTP client IP details
+ name: http.client_ip_details.subdivision.iso_code
+ product_source:
+ - icon-apm
+ type: string
+- description: Nombre de la ciudad a la que se resuelve la IP del cliente.
+ domain: HTTP client IP details
+ name: http.client_ip_details.city.name
+ product_source:
+ - icon-apm
+ type: string
+- description: La latitud de la ubicación a la que se resuelve la IP del cliente.
+ domain: HTTP client IP details
+ name: http.client_ip_details.location.latitude
+ product_source:
+ - icon-apm
+ type: number
+- description: La longitud de la ubicación a la que se resuelve la IP del cliente.
+ domain: HTTP client IP details
+ name: http.client_ip_details.location.longitude
+ product_source:
+ - icon-apm
+ type: number
+- description: El identificador de zona horaria de IANA (por ejemplo, `America/Toronto`)
+ asociado con la IP del cliente.
+ domain: HTTP client IP details
+ name: http.client_ip_details.timezone
+ product_source:
+ - icon-apm
+ type: string
+- description: El número de sistema autónomo (ASN) al que pertenece la IP del cliente
+ (por ejemplo, `AS577`).
+ domain: HTTP client IP details
+ name: http.client_ip_details.as.number
+ product_source:
+ - icon-apm
+ type: string
+- description: El nombre de la organización que opera el sistema autónomo (por ejemplo,
+ `Bell Canada`).
+ domain: HTTP client IP details
+ name: http.client_ip_details.as.name
+ product_source:
+ - icon-apm
+ type: string
+- description: El dominio principal asociado con el sistema autónomo (por ejemplo,
+ `bell.ca`).
+ domain: HTTP client IP details
+ name: http.client_ip_details.as.domain
+ product_source:
+ - icon-apm
+ type: string
+- description: El prefijo IP anunciado por el sistema autónomo (por ejemplo, `65.95.0.0/16`).
+ domain: HTTP client IP details
+ name: http.client_ip_details.as.route
+ product_source:
+ - icon-apm
+ type: string
+- description: La clasificación del sistema autónomo (por ejemplo, `isp`, `hosting`,
+ `business`, `education`).
+ domain: HTTP client IP details
+ name: http.client_ip_details.as.type
+ product_source:
+ - icon-apm
+ type: string
- description: El encabezado `User-Agent` recibido con la solicitud.
- domain: Solicitudes HTTP
+ domain: HTTP requests
name: http.useragent
product_source:
- icon-apm
- icon-log
- type: cadena
+ type: string
- description: El tamaño del cuerpo de la carga útil de la solicitud en bytes.
- domain: Solicitudes HTTP
+ domain: HTTP requests
name: http.request.content_length
product_source:
- icon-apm
- type: número
+ type: number
- description: El tamaño del cuerpo de la carga útil de la respuesta en bytes.
- domain: Solicitudes HTTP
+ domain: HTTP requests
name: http.response.content_length
product_source:
- icon-apm
- type: número
-- description: El tamaño del cuerpo de la carga útil de la solicitud sin comprimir
- tras la descodificación de transporte.
- domain: Solicitudes HTTP
+ type: number
+- description: El tamaño del cuerpo de la carga útil de la solicitud descomprimido
+ después de la decodificación del transporte.
+ domain: HTTP requests
name: http.request.content_length_uncompressed
product_source:
- icon-apm
- type: número
-- description: El tamaño del cuerpo de la carga útil de la respuesta sin comprimir
- tras la descodificación de transporte.
- domain: Solicitudes HTTP
+ type: number
+- description: El tamaño del cuerpo de la carga útil de la respuesta descomprimido
+ después de la decodificación del transporte.
+ domain: HTTP requests
name: http.response.content_length_uncompressed
product_source:
- icon-apm
- type: número
-- description: Los encabezados HTTP de la solicitud. No se recopila ninguno de forma
- predeterminada, pero se puede configurar opcionalmente con `DD_TRACE_HEADER_TAGS`.
- domain: Solicitudes HTTP
+ type: number
+- description: Los encabezados HTTP de la solicitud. Ninguno se recopila por defecto,
+ pero se puede configurar opcionalmente con `DD_TRACE_HEADER_TAGS`.
+ domain: HTTP requests
name: http.request.headers.*
product_source:
- icon-apm
- type: cadena
-- description: Identificador del producto de sistema de gestión de bases de datos
- (SGBD) utilizado.
- domain: Tramos de bases de datos
+ type: string
+- description: Identificador del producto del sistema de gestión de bases de datos
+ (DBMS) que se está utilizando.
+ domain: Database spans
name: db.system
product_source:
- icon-apm
- type: cadena
-- description: Los encabezados HTTP de la respuesta. No se recopila ninguno de forma
- predeterminada, pero se puede configurar opcionalmente con `DD_TRACE_HEADER_TAGS`.
- domain: Peticiones de HTTP
+ type: string
+- description: Los encabezados HTTP de la respuesta. Ninguno se recopila por defecto,
+ pero se puede configurar opcionalmente con `DD_TRACE_HEADER_TAGS`.
+ domain: HTTP requests
name: http.response.headers.*
product_source:
- icon-apm
- type: cadena
+ type: string
- description: La cadena de conexión utilizada para conectarse a la base de datos.
- domain: Tramos de bases de datos
+ domain: Database spans
name: db.connection_string
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El nombre de la operación que se está ejecutando. Por ejemplo, `SELECT`,
`findAndModify`, `HMSET`.
- domain: Tramos de bases de datos
+ domain: Database spans
name: db.operation
product_source:
- icon-apm
- icon-log
- type: cadena
-- description: El nombre de la tabla primaria sobre la que actúa la operación, incluido
- el nombre de la base de datos (si procede).
- domain: Tramos de bases de datos
+ type: string
+- description: El nombre de la tabla principal sobre la que actúa la operación, incluyendo
+ el nombre de la base de datos (si aplica).
+ domain: Database spans
name: db.sql.table
product_source:
- icon-apm
- type: cadena
-- description: El número de filas/resultados de la consulta u operación.
- domain: Tramos de bases de datos
+ type: string
+- description: El número de filas/resultados de la consulta o operación.
+ domain: Database spans
name: db.row_count
product_source:
- icon-apm
- type: número
+ type: number
- description: El identificador del sistema de mensajería.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.system
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El nombre del destino del mensaje.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.destination
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El tipo de destino del mensaje.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.destination_kind
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El nombre del protocolo de transporte.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.protocol
product_source:
- icon-apm
- type: cadena
+ type: string
- description: La versión del protocolo de transporte.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.protocol_version
product_source:
- icon-apm
- type: cadena
+ type: string
- description: La cadena de conexión al sistema de mensajería.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.url
product_source:
- icon-apm
- type: cadena
-- description: Valor utilizado por el sistema de mensajería como identificador del
- mensaje, representado como una cadena.
- domain: Tramos de colas de mensajes
+ type: string
+- description: Un valor utilizado por el sistema de mensajería como identificador
+ del mensaje, representado como una cadena.
+ domain: Message queue spans
name: messaging.message_id
product_source:
- icon-apm
- type: cadena
-- description: El ID de la conversación que identifica la conversación a la que pertenece
- el mensaje, representado como una cadena.
- domain: Tramos de colas de mensajes
+ type: string
+- description: El identificador de la conversación al que pertenece el mensaje, representado
+ como una cadena.
+ domain: Message queue spans
name: messaging.conversation_id
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El tamaño de la carga útil del mensaje sin comprimir en bytes.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.message_payload_size
product_source:
- icon-apm
- type: número
-- description: 'Cadena que identifica el tipo de consumo del mensaje. Por ejemplo:
+ type: number
+- description: Una cadena que identifica el tipo de consumo del mensaje. Por ejemplo,
`send` (un mensaje enviado a un productor), `receive` (un mensaje recibido por
- un consumidor), o `process` (un mensaje previamente recibido procesado por un
- consumidor).'
- domain: Tramos de colas de mensajes
+ un consumidor) o `process` (un mensaje previamente recibido que es procesado por
+ un consumidor).
+ domain: Message queue spans
name: messaging.operation
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El identificador del consumidor que recibe un mensaje.
- domain: Tramos de colas de mensajes
+ domain: Message queue spans
name: messaging.consumer_id
product_source:
- icon-apm
- type: cadena
+ type: string
- description: El identificador del sistema remoto.
- domain: Llamadas a procedimientos remotos
+ domain: Remote procedure calls
name: rpc.system
product_source:
- icon-apm
- type: cadena
-- description: El nombre del servicio al que se llama.
- domain: Llamadas a procedimientos remotos
+ type: string
+- description: El nombre del servicio que se está llamando.
+ domain: Remote procedure calls
name: rpc.service
product_source:
- icon-apm
- type: cadena
-- description: El nombre del método al que se llama.
- domain: Llamadas a procedimientos remotos
+ type: string
+- description: El nombre del método que se está llamando.
+ domain: Remote procedure calls
name: rpc.method
product_source:
- icon-apm
- type: cadena
-content: En la siguiente tabla se enumeran los atributos que el Agent aplica automáticamente
- a los datos que envía a Datadog cada uno de los productos RUM, Logs y APM, según
- corresponda al dominio de datos. Opcionalmente, filtra la lista por producto o busca
- por palabra clave o texto de descripción para encontrar los atributos que te interesan.
+ type: string
+- description: El tipo de actividad de seguridad detectada en la solicitud, expresada
+ como `.` (por ejemplo, `attack_attempt.sql_injection`, `business_logic.users.login.failure`).
+ Un tramo puede tener más de un valor cuando múltiples reglas coinciden.
+ domain: Application & API Protection (AAP)
+ name: appsec.security_activity
+ product_source:
+ - icon-apm
+ type: string
+- description: La clasificación de nivel superior de la actividad de seguridad detectada
+ (por ejemplo, `attack_attempt`, `business_logic`).
+ domain: Application & API Protection (AAP)
+ name: appsec.category
+ product_source:
+ - icon-apm
+ type: string
+- description: El tipo de amenaza o evento específico dentro de la categoría (por
+ ejemplo, `sql_injection`, `xss`, `users.login.failure`).
+ domain: Application & API Protection (AAP)
+ name: appsec.type
+ product_source:
+ - icon-apm
+ type: string
+- description: El identificador de la regla AAP que coincidió con la solicitud (por
+ ejemplo, `crs-942-100`). Un tramo puede tener múltiples valores cuando más de
+ una regla se activa.
+ domain: Application & API Protection (AAP)
+ name: appsec.rule_id
+ product_source:
+ - icon-apm
+ type: string
+- description: Si la solicitud fue bloqueada por AAP. `true` si la solicitud fue bloqueada,
+ `false` de lo contrario.
+ domain: Application & API Protection (AAP)
+ name: appsec.blocked
+ product_source:
+ - icon-apm
+ type: string
+content: La siguiente tabla enumera los atributos aplicados automáticamente a los
+ datos enviados a Datadog por el Agente de cada uno de los productos RUM, Logs y
+ APM, según corresponda al dominio de datos. Opcionalmente, filtre la lista por producto
+ o busque por palabra clave o texto de descripción para encontrar los atributos que
+ le interesan.
+description: Una tabla de los atributos aplicados automáticamente a los datos enviados
+ a Datadog por el Agente de cada uno de los productos RUM, Logs y APM, según corresponda
+ al dominio de datos.
disable_sidebar: true
-filter_all: Todas
+filter_all: All
further_reading:
- link: /data_security/
tag: Documentación
- text: Garantizar la seguridad de los datos enviados a Datadog
+ text: Asegurando la seguridad de los datos enviados a Datadog
- link: /tracing/trace_collection/tracing_naming_convention/
tag: Documentación
- text: Semántica de span tags
-title: Atributos estándar por defecto
+ text: Semántica de la etiqueta de tramo
+title: Atributos estándar predeterminados
---
+## Lectura adicional {#further-reading}
-
-
-## Referencias adicionales
-
-{{< partial name="whats-next/whats-next.html" >}}
+{{< partial name="whats-next/whats-next.html" >}}
\ No newline at end of file
diff --git a/content/es/synthetics/_index.md b/content/es/synthetics/_index.md
index e753e3c0c1f..0d6f6d54a90 100644
--- a/content/es/synthetics/_index.md
+++ b/content/es/synthetics/_index.md
@@ -7,146 +7,154 @@ aliases:
cascade:
algolia:
rank: 70
-description: Utiliza tests automatizados para asegurarte de que las zonas más críticas
- de tus sistemas y aplicaciones funcionan en distintos lugares del mundo.
+description: Utilice pruebas automatizadas para garantizar que las partes más críticas
+ de sus sistemas y aplicaciones estén funcionando desde diversas ubicaciones alrededor
+ del mundo.
further_reading:
-- link: https://app.datadoghq.com/release-notes?category=Synthetic%20Monitoring
- tag: Notas de la versión
- text: Echa un vistazo a las últimas versiones de la monitorización Synthetic en
- Datadog. (Es necesario iniciar sesión en la aplicación)
-- link: https://learn.datadoghq.com/courses/getting-started-with-synthetic-browser-testing
- tag: Centro de aprendizaje
- text: 'Centro de aprendizaje de Datadog: Empezando con los tests de navegador Synthetic'
- link: /synthetics/guide/
tag: Documentación
- text: Guías para la monitorización Synthetic
+ text: Guías de Monitoreo Sintético
+- link: https://learn.datadoghq.com/courses/getting-started-with-synthetic-browser-testing
+ tag: Centro de Aprendizaje
+ text: 'Centro de Aprendizaje de Datadog: Comenzando con Pruebas de Navegador Sintético'
- link: https://dtdg.co/fe
- tag: Habilitación de los fundamentos
- text: Participa en una sesión interactiva para mejorar tus capacidades de ejecutar
- tests synthetic
+ tag: Habilitación de Fundación
+ text: Únase a una sesión interactiva para mejorar sus capacidades de pruebas sintéticas
- link: https://www.datadoghq.com/blog/http-security-headers-synthetic-tests/
tag: Blog
- text: Proteger las cabeceras HTTP con tests Synthetic
+ text: Cómo asegurar los encabezados HTTP con pruebas sintéticas
- link: https://www.datadoghq.com/blog/synthetic-monitoring-updates/
tag: Blog
- text: Obtener información clave sobre las experiencias de los usuarios más rápidamente
- con la monitorización Synthetic en Datadog
+ text: Obtenga información clave sobre las experiencias de los usuarios más rápido
+ con el Monitoreo Sintético de Datadog
- link: https://www.datadoghq.com/blog/smoke-testing-synthetic-monitoring/
tag: Blog
- text: Crear tests de humo UX eficaces con la monitorización Synthetic
+ text: Cómo crear pruebas de humo de UX eficientes con Monitoreo Sintético
- link: https://www.datadoghq.com/blog/slo-synthetic-monitoring/
tag: Blog
- text: Mejorar la precisión y el rendimiento de los SLOs con la monitorización Synthetic
- en Datadog
+ text: Mejore la precisión y el rendimiento de SLO con el Monitoreo Sintético de
+ Datadog
- link: https://www.datadoghq.com/blog/mobile-apps-synthetic-tests/
tag: Blog
- text: Creación de tests Synthetic fiables y precisos para tus aplicaciones móviles
+ text: Cómo construir pruebas sintéticas confiables y precisas para sus aplicaciones
+ móviles
- link: https://www.datadoghq.com/blog/ambassador-browser-tests/
tag: Blog
- text: Cómo ayudé a mi cliente a ampliar sus tests de navegador con Datadog
+ text: Cómo ayudé a mi cliente a escalar sus pruebas de navegador con Datadog
- link: https://www.datadoghq.com/blog/datadog-terraform-synthetic-testing/
tag: Blog
- text: Automatización de tu infraestructura de synthetic tests con Datadog Synthetic
- Monitoring y Terraform
-title: Tests y monitorización Synthetic
+ text: Automatizando su infraestructura de pruebas sintéticas con el Monitoreo Sintético
+ de Datadog y Terraform
+- link: https://www.datadoghq.com/blog/simplifying-troubleshooting-with-synthetic-monitoring
+ tag: Blog
+ text: Simplificando la solución de problemas a lo largo del viaje del usuario con
+ el Monitoreo Sintético de Datadog
+- link: https://www.datadoghq.com/blog/rum-product-analytics-bridging-teams
+ tag: Blog
+ text: 'De rendimiento a impacto: Conectando equipos de frontend a través de un contexto
+ compartido'
+- link: https://app.datadoghq.com/release-notes?category=Synthetic%20Monitoring
+ tag: Notas de la versión
+ text: ¡Consulte los últimos lanzamientos del Monitoreo Sintético de Datadog! (Se
+ requiere inicio de sesión en la aplicación)
+title: Pruebas y Monitoreo Sintético
---
-
-{{< learning-center-callout header="Unirse a una sesión de un seminario web de habilitación" hide_image="true" btn_title="Sign Up" btn_url="https://www.datadoghq.com/technical-enablement/session/synthetics/">}}
-Explora e inscríbete en las sesiones de habilitación de los fundamentos. Aprende cómo la Monitorización Synthetic en Datadog es una solución de monitorización proactiva que te permite crear una API sin código, un navegador y tests móviles para simular automáticamente flujos y solicitudes de usuarios en tu aplicación, endpoints clave y capas de red.
+{{< learning-center-callout header="Únase a una sesión de seminario web de habilitación" hide_image="true" btn_title="Regístrese" btn_url="https://www.datadoghq.com/technical-enablement/session/synthetics/">}}
+ Explore y regístrese para las sesiones de Habilitación de Fundación. Aprenda cómo el Monitoreo Sintético de Datadog es una solución de monitoreo proactiva que le permite crear pruebas de API, navegador y móvil sin código para simular automáticamente flujos de usuarios y solicitudes a sus aplicaciones, puntos de conexión clave y capas de red.
{{< /learning-center-callout >}}
-Los tests Synthetic te permiten observar el rendimiento de tus sistemas y aplicaciones utilizando **simulaciones de peticiones y acciones procedentes de todo el mundo**. Datadog rastrea el rendimiento de tus páginas web y APIs desde el backend hasta el frontend, y en varios niveles de red (`HTTP`,`SSL`,`DNS`,`WebSocket`,`TCP`,`UDP`,`ICMP` y `gRPC`) de forma controlada y estable, alertándote sobre comportamientos defectuosos tales como regresiones, funciones rotas, tiempos de respuesta elevados y códigos de estado inesperados.
+Las pruebas sintéticas le permiten observar cómo están funcionando sus sistemas y aplicaciones utilizando **solicitudes y acciones simuladas de todo el mundo**. Datadog rastrea el rendimiento de sus páginas web y APIs desde el backend hasta el frontend y en varios niveles de red (`HTTP`, `SSL`, `DNS`, `WebSocket`, `TCP`, `UDP`, `ICMP` y `gRPC`) de manera controlada y estable, alertándole sobre comportamientos defectuosos como regresiones, funcionalidades rotas, tiempos de respuesta elevados y códigos de estado inesperados.
-**Computar los SLO** en tus endpoints y recorridos de usuario más importantes facilita el cumplimiento de los objetivos de rendimiento de tu aplicación y, en última instancia, proporciona una experiencia de cliente coherente.
+**Calcular SLOs** en sus puntos de conexión clave y flujos de usuario facilita cumplir con sus objetivos de rendimiento de la aplicación y, en última instancia, proporcionar una experiencia coherente al cliente.
-Puedes crear tests Synthetic en la [aplicación Datadog][1], con la [API][2], o con [Terraform][3].
+Puede crear pruebas sintéticas en la [aplicación de Datadog][1], con la [API][2] o con [Terraform][3].
-## Configurar tests de API y tests de API multupaso
+## Configure pruebas de API y pruebas de API en varios pasos {#set-up-api-tests-and-multistep-api-tests}
-Los tests de la API te permiten lanzar solicitudes [únicas][4] o [encadenadas][5] para realizar verificaciones en tus sistemas principales en varios niveles de red: [test HTTP][6], [test SSL][7], [test DNS][8], [test WebSocket][9], [test TCP][10], [test UDP][11], [test ICMP][12] y [test gRPC][13].
+Las pruebas de API le permiten lanzar [solicitudes individuales][4] o [encadenadas][5] para realizar verificaciones en sus sistemas clave en varios niveles de red: [prueba HTTP][6], [prueba SSL][7], [prueba DNS][8], [prueba WebSocket][9], [prueba TCP][10], [prueba UDP][11], [prueba ICMP][12] y [prueba gRPC][13].
-{{< img src="synthetics/api_test.png" alt="API tests" style="width:100%;">}}
+{{< img src="synthetics/api_test.png" alt="Pruebas de API" style="width:100%;">}}
-## Grabar tests de navegación
+## Grabe pruebas de navegador {#record-browser-tests}
-Utiliza [tests de navegador Synthetic][14] para monitorizar las experiencias de tus clientes con tus páginas web de extremo a extremo desde cualquier lugar del mundo.
+Utilice [pruebas de navegador sintéticas][14] para monitorear cómo sus clientes experimentan sus páginas web de principio a fin desde todo el mundo.
-{{< img src="synthetics/browser_test.mp4" alt="Browser tests" video=true style="width:100%;">}}
+{{< img src="synthetics/browser_test.mp4" alt="Pruebas de navegador" video=true style="width:100%;">}}
-## Grabar tests de aplicaciones móviles
+## Grabe pruebas de aplicaciones móviles {#record-mobile-application-tests}
-Utiliza [tests de aplicaciones móviles Synthetic][21] para monitorizar las experiencias de tus clientes con tus aplicaciones iOS y Android de extremo a extremo desde distintos tipos de dispositivos.
+Utilice [pruebas de aplicaciones móviles sintéticas][21] para monitorear cómo sus clientes experimentan sus aplicaciones iOS y Android de principio a fin desde diferentes tipos de dispositivos.
-{{< img src="synthetics/mobile_app_tests.png" alt="Ejemplos de grabaciones de flujos de trabajo de un test móvil Synthetic" style="width:100%;">}}
+{{< img src="synthetics/mobile_app_tests.png" alt="Ejemplos del flujo de trabajo de grabación para una prueba móvil sintética" style="width:100%;">}}
-## Crear tests de ruta de red
+## Cree pruebas de ruta de red {#create-network-path-tests}
-Crea [tests de ruta de red de Synthetic Monitoring][25] desde ubicaciones gestionadas para realizar checks TCP, UDP e ICMP y visualizar rutas de paquetes a través de endpoints globales.
+Cree [pruebas de ruta de red Synthetic][25] desde ubicaciones administradas para realizar verificaciones TCP, UDP e ICMP y visualizar rutas de paquetes a través de puntos de conexión globales.
-{{< img src="synthetics/network_tests/syn_network_path.png" alt="Ejemplos de un test de red TCP de Synthetic" style="width:100%;">}}
-## Conjuntos de tests
+{{< img src="synthetics/network_tests/syn_network_path.png" alt="Ejemplos de una prueba de red TCP sintética" style="width:100%;">}}
+## Conjuntos de pruebas {#test-suites}
-Utiliza [conjuntos de tests de Synthetic Monitoring][25] para organizar múltiples tests en colecciones lógicas agrupadas por recorrido del usuario, entorno, ubicación, servicio o equipo para una gestión y resolución de problemas racionalizados.
+Utilice [Conjuntos de Pruebas Sintéticas][26] para organizar múltiples pruebas en colecciones lógicas agrupadas por recorrido del usuario, entorno, ubicación, servicio o equipo para una gestión y solución de problemas más eficientes.
-{{< img src="synthetics/test_suites/test_suite_summary.png" alt="Página de resumen del conjunto de tests de Synthetic Monitoring" style="width:100%;">}}
+{{< img src="synthetics/test_suites/test_suite_summary.png" alt="Página de resumen del Conjunto de Pruebas de Monitoreo Sintético" style="width:100%;">}}
-## Lanzar localizaciones privadas
+## Inicie ubicaciones privadas {#launch-private-locations}
-Utiliza [Localizaciones privadas sintéticas][15] para monitorizar APIs y sitios web internos, o crea localizaciones personalizadas en áreas críticas para tu negocio.
+Utilice [ubicaciones privadas sintéticas][15] para monitorear APIs y sitios web internos o crear ubicaciones personalizadas en áreas que son críticas para su negocio.
-{{< img src="synthetics/private_locations.png" alt="Private locations" style="width:100%;">}}
+{{< img src="synthetics/private_locations.png" alt="Ubicaciones privadas" style="width:100%;">}}
-## Conectar datos y trazas (traces)
+## Conecte datos y trazas {#connect-data-and-traces}
-Utiliza la [integración entre tests sintéticos y trazas de APM][16] para encontrar la causa raíz de los fallos en las peticiones de frontend, red y backend.
+Utilice la [integración entre pruebas sintéticas y trazas APM][16] para encontrar la causa raíz de fallas en solicitudes de frontend, red y backend.
-{{< img src="synthetics/synthetics_traces.mp4" alt="Synthetic Monitoring" video=true style="width:100%;">}}
+{{< img src="synthetics/synthetics_traces.mp4" alt="Monitoreo Sintético" video=true style="width:100%;">}}
-## Accede a dashboards preconfigurados
+## Acceda a los tableros listos para usar {#access-out-of-the-box-dashboards}
-Analiza la información de rendimiento de tus tests de API, tests de API multipaso, tests de navegador y localizaciones privadas, así como los eventos de Datadog, con [dashboards sintéticos listos para usar][17].
+Analice la información de rendimiento sobre sus pruebas de API, pruebas de API en varios pasos, pruebas de navegador y ubicaciones privadas, así como eventos de Datadog, con [tableros Synthetic listos para usar][17].
-{{< img src="synthetics/dashboards/test_dashboard.png" alt="Dashboard de monitorización Synthetic y del resumen de tests continuos" style="width:100%;">}}
+{{< img src="synthetics/dashboards/test_dashboard.png" alt="Panel de Resumen de Monitoreo Sintético y Pruebas Continuas" style="width:100%;">}}
-## Utiliza la monitorización Synthetic y el Explorador de resultados de tests
+## Utilice el Explorador de Resultados de Monitoreo y Pruebas Sintéticas {#use-the-synthetic-monitoring-testing-results-explorer}
-Crea [buscar consultas y visualizaciones][20] para tus ejecuciones de test sintético o lotes de tests que se ejecutan en pipelines CI/CD.
+Cree [consultas de búsqueda y visualizaciones][20] para sus ejecuciones de prueba sintéticas o lotes de pruebas que se ejecutan en pipelines de CI/CD.
-{{< img src="continuous_testing/explorer_ci_batches_1.png" alt="Explorador de tests continuos" style="width:100%;">}}
+{{< img src="continuous_testing/explorer_ci_batches_1.png" alt="Explorador de Pruebas Continuas" style="width:100%;">}}
-## Seguimiento de la cobertura de los tests
+## Rastree la cobertura de pruebas {#track-testing-coverage}
-Optimiza tu conjunto de tests [asegurándote de que se prueban los flujos de trabajo más críticos de tu aplicación][22].
+Optimice su conjunto de pruebas [asegurándose de que los flujos de trabajo más críticos de su aplicación estén siendo probados][22].
-{{< img src="synthetics/test_coverage/test_coverage.png" alt="Explorador de tests continuos" style="width:100%;">}}
+{{< img src="synthetics/test_coverage/test_coverage.png" alt="Explorador de Pruebas Continuas" style="width:100%;">}}
-## Notificaciones de Synthetic Monitoring
+## Notificaciones de Synthetic Monitoring {#synthetic-monitoring-notifications}
-Utiliza y enriquece los monitores de monitorización Synthetic para enviar notificaciones cuando un test de monitorización Synthetic está fallando. Están disponibles las siguientes funciones:
+Utilice y enriquezca los monitores Synthetic para enviar notificaciones cuando una prueba de Synthetic Monitoring esté fallando. Las siguientes características están disponibles:
-Mensajes de monitor prerellenados
-: los mensajes de monitor prerellenados proporcionan un punto de partida estructurado para las alertas de Synthetic test. Cada mensaje incluye un título normalizado, un resumen y un pie de página con metadatos de test, lo que facilita la comprensión de la alerta de un vistazo.
+Mensajes de monitor prellenados
+: Los mensajes de monitor Synthetic prellenados proporcionan un punto de partida estructurado para las alertas de pruebas Synthetic. Cada mensaje incluye un título estandarizado, un resumen y un pie de página que contiene metadatos de la prueba, lo que facilita la comprensión de la alerta de un vistazo.
Variables de plantilla
-: las variables de plantilla permiten inyectar datos específicos de test en las notificaciones de monitor de forma dinámica. Estas variables se extraen del objeto `synthetics.attributes`.
+: Las variables de plantilla le permiten inyectar datos específicos de la prueba en las notificaciones de los monitores de manera dinámica. Estas variables extraen datos del objeto `synthetics.attributes`.
Uso avanzado
-: el uso avanzado incluye técnicas para profundizar en el test o estructurar mensajes complejos utilizando plantillas de identificadores.
+: El uso avanzado incluye técnicas para resaltar información más profunda de las pruebas o estructurar mensajes complejos utilizando plantillas de handlebars.
-Alerta condicional
-: las alertas condicionales te permiten cambiar el contenido de una notificación de monitor en función de resultados específicos de test o de condiciones de fallo.
+Alertas condicionales
+: Las alertas condicionales le permiten cambiar el contenido de una notificación de monitor según resultados específicos de la prueba o condiciones de falla.
-Para obtener más información, consulta las [notificaciones de monitorización Synthetic][24].
+Para más información, consulte [notificaciones de Synthetic Monitoring][24].
-## Historial de versiones
+## Historial de versiones {#version-history}
-Utiliza el [historial de versiones en la monitorización Synthetic][23] para ejecutar una versión anterior de un test, restaurar tu test a cualquier versión guardada o clonar una versión para crear un nuevo test de Synthetic Monitoring.
+Utilice [Historial de versiones en Synthetic Monitoring][23] para ejecutar una versión anterior de una prueba, restaurar su prueba a cualquier versión guardada o clonar una versión para crear una nueva prueba de Synthetic Monitoring.
-## ¿Estás listo para comenzar?
+## ¿Listo para comenzar? {#ready-to-start}
-Consulta el apartado [Empezando con la monitorización Synthetic][18] para obtener instrucciones sobre cómo crear tu primer test Synthetic y la monitorización tus aplicaciones web. A continuación, explora [Empezando con localizaciones privadas][19] para obtener instrucciones sobre cómo crear tu localización privada y ejecutar tests Synthetic con tu localización privada.
+Consulte [Introducción a Synthetic Monitoring][18] para obtener instrucciones sobre cómo crear su primera prueba sintética y monitorear sus aplicaciones web. Luego, consulte [Comenzando con Ubicaciones Privadas][19] para obtener instrucciones sobre cómo crear su ubicación privada y ejecutar pruebas sintéticas con su ubicación privada.
-## Referencias adicionales
+## Lectura Adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -176,4 +184,4 @@ Consulta el apartado [Empezando con la monitorización Synthetic][18] para obten
[23]: /es/synthetics/guide/version_history/
[24]: /es/synthetics/notifications/
[25]: /es/synthetics/network_path_tests/
-[25]: /es/synthetics/test_suites/
\ No newline at end of file
+[26]: /es/synthetics/test_suites/
\ No newline at end of file
diff --git a/content/es/tracing/_index.md b/content/es/tracing/_index.md
index 031a6aa0f45..f644421d89f 100644
--- a/content/es/tracing/_index.md
+++ b/content/es/tracing/_index.md
@@ -2,10 +2,10 @@
algolia:
tags:
- apm
- - monitorización del rendimiento de las aplicaciones
- - rastreo distribuido
- - traza
- - rastreo
+ - application performance monitoring
+ - distributed tracing
+ - trace
+ - tracing
aliases:
- /es/tracing/faq/terminology
- /es/tracing/guide/terminology
@@ -16,113 +16,125 @@ aliases:
cascade:
algolia:
rank: 70
-description: Instrumentar el código para mejorar el rendimiento
+description: Instrumenta tu código para mejorar el rendimiento
further_reading:
- link: https://app.datadoghq.com/release-notes?category=APM
tag: Notas de la versión
- text: ¡Conoce las últimas novedades de Datadog APM! (Es necesario iniciar sesión
- en la aplicación)
+ text: ¡Consulta los últimos lanzamientos de Datadog APM! (Se requiere inicio de
+ sesión en la aplicación)
+- link: https://learn.datadoghq.com/courses/getting-started-apm
+ tag: Centro de Aprendizaje
+ text: Comenzando con métricas y trazas de APM
- link: https://www.datadoghq.com/blog/monitor-rust-otel/
tag: Blog
- text: Monitorizar tus aplicaciones Rust con OpenTelemetry
+ text: Cómo monitorear tus aplicaciones de Rust con OpenTelemetry
- link: https://www.datadoghq.com/blog/span-based-metrics/
tag: Blog
- text: Genera métricas basadas en tramos (spans) para seguir las tendencias históricas
- en el rendimiento de las aplicaciones
+ text: Genera métricas basadas en tramos para rastrear tendencias históricas en el
+ rendimiento de la aplicación
- link: https://www.datadoghq.com/blog/apm-security-view/
tag: Blog
- text: Obtén visibilidad de los riesgos, las vulnerabilidades y los ataques con APM
- Security View
+ text: Obtén visibilidad sobre riesgos, vulnerabilidades y ataques con la Vista de
+ Seguridad de APM
- link: https://www.datadoghq.com/blog/monitor-azure-app-service-linux/
tag: Blog
- text: Monitoriza las aplicaciones web Linux en Azure App Service con Datadog
+ text: Monitorea tus aplicaciones web en Linux en Azure App Service con Datadog
- link: https://www.datadoghq.com/blog/monitor-apis-datadog-api-catalog/
tag: Blog
- text: Gestiona el rendimiento, la seguridad y la propiedad de las API con Datadog
- API Catalog
+ text: Gestiona el rendimiento, la seguridad y la propiedad de la API con el Catálogo
+ de API de Datadog
- link: https://www.datadoghq.com/blog/software-catalog/
tag: Blog
- text: Mejorar la experiencia y la colaboración de los desarrolladores con el Catálogo
- de software
+ text: Mejora la experiencia del desarrollador y la colaboración con el Catálogo
+ de Software
- link: https://www.datadoghq.com/blog/datadog-csi-driver/
tag: Blog
- text: Lleva la observabilidad de alto rendimiento a entornos seguros de Kubernetes
+ text: Aporta observabilidad de alto rendimiento a entornos de Kubernetes seguros
con el controlador CSI de Datadog
- link: https://dtdg.co/fe
- tag: Establecer las bases
- text: Participa en una sesión interactiva para mejorar tu comprensión de APM
+ tag: Habilitación de la Fundación
+ text: Únete a una sesión interactiva para mejorar tu comprensión de APM
+- link: https://www.datadoghq.com/blog/gitlab-source-code-integration
+ tag: Blog
+ text: Resuelve problemas más rápido con la integración de Código Fuente de GitLab
+ en Datadog
+- link: https://www.datadoghq.com/blog/pubsub-cloud-run-tracing
+ tag: Blog
+ text: Rastrea cargas de trabajo de Google Pub/Sub en Cloud Run con Datadog
+- link: https://www.datadoghq.com/blog/analyzing-roundtrip-query-latency
+ tag: Blog
+ text: Analizando la latencia de consulta de ida y vuelta
title: APM
---
-
{{< vimeo url="https://player.vimeo.com/progressive_redirect/playback/381554158/rendition/1080p/file.mp4?loc=external&signature=e19b4e64632c3b1a42b11cb27fca2682dfadecd4690774c005ba2f5079b6a416" poster="/images/poster/tracing.png" >}}
-{{< learning-center-callout header="Join an enablement webinar session" hide_image="true" btn_title="Inscribirse" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=APM">}}
- Únete a una sesión introductoria o intermedia de habilitación para obtener más información sobre cómo Datadog Application Performance Monitoring (APM) proporciona un rastreo distribuido a nivel de código y con tecnología IA, desde navegadores y aplicaciones móviles a servicios y bases de datos backend.
+{{< learning-center-callout header="Únete a una sesión de seminario web de habilitación" hide_image="true" btn_title="Regístrate" btn_url="https://www.datadoghq.com/technical-enablement/sessions/?tags.topics-0=APM">}}
+ Únete a una sesión de habilitación introductoria o intermedia para aprender más sobre cómo Datadog Application Performance Monitoring (APM) proporciona trazado distribuido a nivel de código impulsado por IA desde aplicaciones de navegador y móviles hasta servicios de backend y bases de datos.
{{< /learning-center-callout >}}
-## Información general
+## Resumen {#overview}
-Datadog Application Performance Monitoring (APM) proporciona una visibilidad profunda de las aplicaciones, lo que permite identificar cuellos de botella en el rendimiento, solucionar problemas y optimizar los servicios. Con un rastreo distribuido, dashboards listos para usar y una correlación perfecta con otros datos de telemetría, Datadog APM ayuda a garantizar el mejor rendimiento posible y la mejor experiencia de usuario para las aplicaciones.
+Datadog Application Performance Monitoring (APM) proporciona una profunda visibilidad en tus aplicaciones, permitiéndote identificar cuellos de botella en el rendimiento, solucionar problemas y optimizar tus servicios. Con trazado distribuido, paneles de control listos para usar y correlación sin problemas con otros datos de telemetría, Datadog APM ayuda a garantizar el mejor rendimiento y experiencia de usuario posible para tus aplicaciones.
-Para obtener una introducción a la terminología utilizada en Datadog APM, consulta [Términos y conceptos de APM][1].
+Para una introducción a la terminología utilizada en Datadog APM, consulta [Términos y conceptos de APM][1].
-## Empezando
+## Comenzando {#getting-started}
-La forma más sencilla de comenzar con Datadog APM es con la Instrumentación en un solo paso. Este enfoque instala el Datadog Agent e instrumenta la aplicación en un solo paso, sin necesidad de pasos adicionales de configuración. Para obtener más información, consulta [Instrumentación en un solo paso][27].
+La forma más sencilla de comenzar con Datadog APM es con Instrumentación de Un Solo Paso. Este enfoque instala el Agente de Datadog e instrumenta tu aplicación en un solo paso, sin requerir pasos de configuración adicionales. Para aprender más, lee [Instrumentación de Un Solo Paso][27].
-Para configuraciones que requieran más personalización, Datadog admite la instrumentación personalizada con las bibliotecas de rastreo de Datadog y [Dynamic Instrumentation][30] en la interfaz de usuario de Datadog. Para obtener referencias adicionales, lee [Instrumentación de aplicaciones][2].
+Para configuraciones que requieren más personalización, Datadog admite instrumentación personalizada con los SDK de Datadog y [Instrumentación Dinámica][30] en la interfaz de usuario de Datadog. Para aprender más, lee [Instrumentación de Aplicaciones][2].
-
Si recién empiezas con Datadog APM , lee Empezando con APM para aprender cómo enviar tu primera traza (trace) a Datadog.
+
Si eres nuevo en Datadog APM, lee Comenzando con APM para aprender cómo enviar tu primera traza a Datadog.
-## Casos prácticos
+## Casos de uso {#use-cases}
-Descubre algunas formas en que Datadog APM puede apoyar tus casos de uso:
+Descubre algunas formas en que Datadog APM puede ayudar a respaldar tus casos de uso:
-| Quieres...| Cómo puede ayudar Datadog APM |
+| Quieres...| Cómo Datadog APM puede ayudar |
| ----------- | ----------- |
-| Comprende cómo fluyen las solicitudes a través del sistema. | Utiliza [Trace Explorer][21] para consultar y visualizar trazas de extremo a extremo a través de servicios distribuidos. |
-| Monitoriza el estado y el rendimiento de servicios individuales. | Utiliza el [servicio][26] y las [páginas de recursos][28] para evaluar el estado del servicio analizando métricas de rendimiento, realizando un seguimiento de las implementaciones e identificando los recursos problemáticos. |
-| Correlaciona trazas con DBM, RUM, logs, sintéticos y perfiles. | [Correlaciona los datos de APM con otros datos de telemetría][20] para contextualizar los datos y realizar un análisis más exhaustivo. |
-| Controla el flujo de datos en Datadog. | Utiliza los [controles de ingesta][6] para ajustar la configuración de la ingesta y las frecuencias de muestreo por servicio y recurso. Utiliza los [filtros de retención][7] para elegir qué tramos se retendrán durante 15 días. |
+| Comprende cómo fluyen las solicitudes a través de tu sistema. | Utilice el [Explorador de Trazas][21] para consultar y visualizar trazas de extremo a extremo a través de servicios distribuidos. |
+| Monitoree la salud y el rendimiento de los servicios individuales. | Utilice las [páginas de servicio][26] y [páginas de recursos][28] para evaluar la salud del servicio analizando métricas de rendimiento, rastreando implementaciones e identificando recursos problemáticos. |
+| Correlacione trazas con DBM, RUM, registros, sintéticos y perfiles. | [Correlacione los datos de APM con otra telemetría][20] para dar contexto a sus datos para un análisis más completo. |
+| Controle cómo fluye la información hacia Datadog. | Utilice [Controles de Ingesta][6] para ajustar la configuración de ingesta y las tasas de muestreo por servicio y recurso. Utilice [filtros de retención][7] para elegir qué spans retener durante 15 días. |
-### Trace Explorer
+### Explorador de Trazas {#trace-explorer}
-[Trace Explorer][21] te permite buscar y analizar tus trazas en tiempo real. Identifica cuellos de botella en el rendimiento, soluciona errores y consulta logs y métricas para comprender el contexto completo de cualquier problema.
+El [Explorador de Trazas][21] le permite buscar y analizar sus trazas en tiempo real. Identifique cuellos de botella en el rendimiento, solucione errores y pivotee hacia registros y métricas relacionadas para comprender el contexto completo de cualquier problema.
-{{< img src="/tracing/trace_explorer/trace_explorer.png" alt="Vista de Trace Explorer." style="width:100%;" >}}
+{{< img src="/tracing/trace_explorer/trace_explorer.png" alt="Vista del explorador de trazas." style="width:100%;" >}}
-### Página de servicios
+### Página de servicio {#service-page}
-La [página de servicios][26] ayuda a monitorizar el rendimiento del servicio y a [comparar versiones durante las implementaciones][15].
+La [página de servicio][26] le ayuda a monitorear el rendimiento del servicio y [comparar entre versiones durante las implementaciones][15].
-{{< img src="tracing/deployment_tracking/VersionComparison.png" alt="Versiones en la página de servicios" style="width:100%;">}}
+{{< img src="tracing/deployment_tracking/VersionComparison.png" alt="Versiones en la Página de Servicio" style="width:100%;">}}
-### Correlación de trazas con otros datos de telemetría
+### Correlacionando trazas con otra telemetría {#correlating-traces-with-other-telemetry}
-Datadog APM se integra perfectamente con logs, Real User Monitoring (RUM), monitorización de sintéticos y más:
+Datadog APM se integra sin problemas con registros, monitoreo de usuarios reales (RUM), monitoreo sintético y más:
-- [Visualiza los logs de la aplicación junto con las trazas][9] a fin de encontrar logs para solicitudes, versiones o servicios específicos.
-- [Asocia sesiones de RUM con trazas de backend][10] para comprender cómo afecta el rendimiento del backend a la experiencia del usuario.
-- [Asocia las pruebas de sintéticos con trazas][11] para solucionar fallos en las solicitudes de frontend y backend.
+- [Mira los registros de tu aplicación lado a lado con las trazas][9] para encontrar registros de solicitudes, servicios o versiones específicas.
+- [Asocia sesiones de RUM con trazas de backend][10] para entender cómo el rendimiento del backend afecta la experiencia del usuario.
+- [Asocia pruebas sintéticas con trazas][11] para solucionar fallas en solicitudes de frontend y backend.
-{{< img src="tracing/index/ConnectLogsWithTraces.png" alt="Conectar logs y trazas" style="width:100%;">}}
+{{< img src="tracing/index/ConnectLogsWithTraces.png" alt="Conectar Registros y Trazas" style="width:100%;">}}
-### Controles de ingesta y filtros de retención
+### Controles de ingestión y filtros de retención {#ingestion-controls-and-retention-filters}
-Las trazas comienzan en las aplicaciones instrumentadas y fluyen hacia Datadog.
+Las trazas comienzan en tus aplicaciones instrumentadas y fluyen hacia Datadog.
-Datadog APM te proporciona herramientas para gestionar el volumen y la retención de tus datos de rastreo. Utiliza [controles de ingesta][6] para ajustar las frecuencias de muestreo y [filtros de retención][7] para controlar qué tramos se almacenan.
+Datadog APM proporciona herramientas para gestionar el volumen y la retención de tus datos de trazas. Utiliza [Ingestion Controls][6] para ajustar las tasas de muestreo y [retention filters][7] para controlar qué tramos se almacenan.
{{< img src="/tracing/apm_lifecycle/apm_lifecycle_0.png" alt="Flujo de datos a través de Datadog APM." style="width:100%;" >}}
-## Solucionar problemas
+## Solución de problemas {#troubleshooting}
-Para obtener ayuda con la resolución de problemas, consulta la guía [Solucionar problemas de APM][29].
+Para asistencia en la solución de problemas, lee la guía de [Solución de Problemas de APM][29].
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/tracing/trace_collection/custom_instrumentation/server-side/_index.mdoc.md b/content/es/tracing/trace_collection/custom_instrumentation/server-side/_index.mdoc.md
new file mode 100644
index 00000000000..1b10bb107f8
--- /dev/null
+++ b/content/es/tracing/trace_collection/custom_instrumentation/server-side/_index.mdoc.md
@@ -0,0 +1,239 @@
+---
+aliases:
+- /es/tracing/opentracing/java
+- /es/tracing/manual_instrumentation/java
+- /es/tracing/custom_instrumentation/java
+- /es/tracing/setup_overview/custom_instrumentation/java
+- /es/tracing/trace_collection/custom_instrumentation/java
+- /es/tracing/trace_collection/custom_instrumentation/java/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/java/otel
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/java
+- /es/tracing/trace_collection/otel_instrumentation/java/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/java
+- /es/tracing/opentracing/python
+- /es/tracing/manual_instrumentation/python
+- /es/tracing/custom_instrumentation/python
+- /es/tracing/setup_overview/custom_instrumentation/python
+- /es/tracing/trace_collection/custom_instrumentation/python
+- /es/tracing/trace_collection/custom_instrumentation/python/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/python/otel
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/python
+- /es/tracing/trace_collection/otel_instrumentation/python/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/python
+- /es/tracing/opentracing/nodejs
+- /es/tracing/manual_instrumentation/nodejs
+- /es/tracing/custom_instrumentation/nodejs
+- /es/tracing/setup_overview/custom_instrumentation/nodejs
+- /es/tracing/trace_collection/custom_instrumentation/nodejs
+- /es/tracing/trace_collection/custom_instrumentation/nodejs/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/nodejs/otel
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/nodejs
+- /es/tracing/trace_collection/otel_instrumentation/nodejs/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/nodejs
+- /es/tracing/opentracing/go
+- /es/tracing/manual_instrumentation/go
+- /es/tracing/custom_instrumentation/go
+- /es/tracing/setup_overview/custom_instrumentation/go
+- /es/tracing/trace_collection/custom_instrumentation/go
+- /es/tracing/trace_collection/custom_instrumentation/go/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/go/otel
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/go
+- /es/tracing/trace_collection/otel_instrumentation/go/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/go
+- /es/tracing/opentracing/ruby
+- /es/tracing/manual_instrumentation/ruby
+- /es/tracing/custom_instrumentation/ruby
+- /es/tracing/setup_overview/custom_instrumentation/ruby
+- /es/tracing/trace_collection/custom_instrumentation/ruby
+- /es/tracing/trace_collection/custom_instrumentation/ruby/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/ruby/otel
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/ruby
+- /es/tracing/trace_collection/otel_instrumentation/ruby/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/ruby
+- /es/tracing/opentracing/dotnet
+- /es/tracing/manual_instrumentation/dotnet
+- /es/tracing/custom_instrumentation/dotnet
+- /es/tracing/setup_overview/custom_instrumentation/dotnet
+- /es/tracing/trace_collection/custom_instrumentation/dotnet
+- /es/tracing/trace_collection/custom_instrumentation/dotnet/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/dotnet/otel
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/dotnet
+- /es/tracing/trace_collection/otel_instrumentation/dotnet/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/dotnet
+- /es/tracing/opentracing/php
+- /es/tracing/manual_instrumentation/php
+- /es/tracing/custom_instrumentation/php
+- /es/tracing/setup_overview/custom_instrumentation/php
+- /es/tracing/trace_collection/custom_instrumentation/php
+- /es/tracing/trace_collection/custom_instrumentation/php/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/php/otel
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/php
+- /es/tracing/trace_collection/otel_instrumentation/php/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/php
+- /es/tracing/manual_instrumentation/cpp
+- /es/tracing/custom_instrumentation/cpp
+- /es/tracing/setup_overview/custom_instrumentation/cpp
+- /es/tracing/trace_collection/custom_instrumentation/cpp
+- /es/tracing/trace_collection/custom_instrumentation/cpp/dd-api
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/cpp
+- /es/tracing/trace_collection/custom_instrumentation/rust
+- /es/tracing/trace_collection/custom_instrumentation/elixir
+- /es/tracing/trace_collection/custom_instrumentation/swift
+- /es/tracing/trace_collection/custom_instrumentation/dd_libraries/
+- /es/tracing/trace_collection/custom_instrumentation/otel_instrumentation/
+content_filters:
+- label: Language
+ option_group_id: custom_instrumentation_language_options
+ trait_id: prog_lang
+- label: API
+ option_group_id: custom_instrumentation_api_options
+ trait_id: api_type
+description: Agrega tramos, etiquetas e instrumentación personalizados para capturar
+ datos de observabilidad específicos de la aplicación utilizando las APIs de Datadog
+ y OpenTelemetry.
+further_reading:
+- link: tracing/guide/instrument_custom_method
+ text: Instrumenta un método personalizado para obtener visibilidad profunda en tu
+ lógica de negocio.
+- link: tracing/connect_logs_and_traces
+ text: Conecta tus registros y trazas.
+- link: tracing/visualization/
+ text: Explora tus servicios, recursos y trazas.
+- link: https://www.datadoghq.com/blog/opentelemetry-instrumentation/
+ text: Aprende más sobre Datadog y la iniciativa de OpenTelemetry.
+title: Instrumentación personalizada del lado del servidor.
+---
+
+
+
+
+
+{% if equals($prog_lang, "cpp") %}
+{% if equals($api_type, "otel_api") %}
+{% alert level="danger" %}
+C++ no soporta la API de OpenTelemetry. Selecciona **Datadog** del menú desplegable de API para ver la documentación de instrumentación personalizada de C++.
+{% /alert %}
+{% /if %}
+{% /if %}
+
+
+{% if equals($prog_lang, "rust") %}
+{% if equals($api_type, "dd_api") %}
+{% alert level="danger" %}
+Rust no soporta la API de Datadog. Selecciona **OpenTelemetry** del menú desplegable de API para ver la documentación de instrumentación personalizada de Rust.
+{% /alert %}
+{% /if %}
+{% /if %}
+
+
+{% if equals($prog_lang, "elixir") %}
+{% if equals($api_type, "dd_api") %}
+{% alert level="danger" %}
+Elixir no soporta la API de Datadog. Selecciona **OpenTelemetry** del menú desplegable de API para ver la documentación de instrumentación personalizada de Elixir.
+{% /alert %}
+{% /if %}
+{% /if %}
+
+
+
+
+
+{% if equals($api_type, "otel_api") %}
+
+
+{% if equals($prog_lang, "elixir") %}
+Datadog no proporciona un SDK para Elixir. Para enviar trazas a Datadog, utiliza el [SDK de OpenTelemetry para Elixir][8].
+{% /if %}
+
+
+{% if not(includes($prog_lang, ["cpp", "elixir"])) %}
+
+## Resumen {% #overview %}
+
+{% partial file="opentelemetry/traces/otel-custom-instrumentation-overview.mdoc.md" /%}
+
+{% if equals($prog_lang, "java") %}
+{% partial file="opentelemetry/traces/java.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "python") %}
+{% partial file="opentelemetry/traces/python.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "node_js") %}
+{% partial file="opentelemetry/traces/nodejs.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "go") %}
+{% partial file="opentelemetry/traces/go.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "ruby") %}
+{% partial file="opentelemetry/traces/ruby.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "dot_net") %}
+{% partial file="opentelemetry/traces/dotnet.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "php") %}
+{% partial file="opentelemetry/traces/php.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "rust") %}
+{% partial file="opentelemetry/traces/rust.mdoc.md" /%}
+{% /if %}
+
+{% /if %}
+{% /if %}
+
+
+
+
+
+
+
+{% if equals($api_type, "dd_api") %}
+{% if not(includes($prog_lang, ["rust", "elixir"])) %}
+
+## Resumen {% #overview-1 %}
+
+Utiliza la API de Datadog para crear, modificar o eliminar trazas de manera programática para enviarlas a Datadog. Esto es útil para rastrear código interno que no es capturado por la instrumentación automática, eliminar tramos no deseados de las trazas y proporcionar una visibilidad y contexto más profundos sobre los tramos, incluyendo la adición de etiquetas de tramo.
+
+{% if equals($prog_lang, "java") %}
+{% partial file="tracing/custom_instrumentation/dd_api/java.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "python") %}
+{% partial file="tracing/custom_instrumentation/dd_api/python.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "node_js") %}
+{% partial file="tracing/custom_instrumentation/dd_api/nodejs.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "go") %}
+{% partial file="tracing/custom_instrumentation/dd_api/go.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "ruby") %}
+{% partial file="tracing/custom_instrumentation/dd_api/ruby.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "dot_net") %}
+{% partial file="tracing/custom_instrumentation/dd_api/dotnet.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "php") %}
+{% partial file="tracing/custom_instrumentation/dd_api/php.mdoc.md" /%}
+{% /if %}
+
+{% if equals($prog_lang, "cpp") %}
+{% partial file="tracing/custom_instrumentation/dd_api/cpp.mdoc.md" /%}
+{% /if %}
+
+{% /if %}
+{% /if %}
+
+
+[8]: https://opentelemetry.io/docs/languages/beam/
\ No newline at end of file
diff --git a/content/es/tracing/trace_collection/dd_libraries/nodejs.md b/content/es/tracing/trace_collection/dd_libraries/nodejs.md
index 008f381cb07..93cb7ff7682 100644
--- a/content/es/tracing/trace_collection/dd_libraries/nodejs.md
+++ b/content/es/tracing/trace_collection/dd_libraries/nodejs.md
@@ -13,143 +13,151 @@ code_lang: nodejs
code_lang_weight: 30
further_reading:
- link: https://github.com/DataDog/dd-trace-js
- tag: Código fuente
- text: Código de origen
+ tag: Código Fuente
+ text: Código Fuente
- link: https://datadog.github.io/dd-trace-js
tag: Documentación
- text: Documentación de API
+ text: Documentación de la API
- link: tracing/glossary/
tag: Documentación
- text: Explorar tus servicios, recursos y trazas (traces)
+ text: Explora tus servicios, recursos y trazas
- link: tracing/
tag: Documentación
text: Uso avanzado
-title: Rastreo de aplicaciones Node.js
+title: Trazando aplicaciones de Node.js
type: multi-code-lang
---
-## Requisitos de compatibilidad
+## Requisitos de compatibilidad {#compatibility-requirements}
-La última versión del rastreador Node.js es compatible con las versiones de Node.js `>=18`. Para ver la lista completa de versiones de Node.js y de compatibilidad de frameworks de Datadog (incluidas las versiones heredadas y de mantenimiento), consulta la página de [requisitos de compatibilidad][1].
+El último rastreador de Node.js es compatible con las versiones de Node.js `>=18`. Para una lista completa del soporte de versiones y marcos de Node.js de Datadog (incluyendo versiones heredadas y de mantenimiento), consulta la página de [Requisitos de compatibilidad][1].
-## Empezando
+## Comenzando {#getting-started}
-Antes de empezar, asegúrate de haber [instalado y configurado el Agent][13]. A continuación, sigue los siguientes pasos para añadir la biblioteca de rastreo de Datadog a tu aplicación Node.js para instrumentarla.
+Antes de comenzar, asegúrate de haber [instalado y configurado el Agente][13]. Luego, completa los siguientes pasos para agregar el SDK de Datadog a tu aplicación de Node.js para instrumentarla.
-### Instalación de la biblioteca de rastreo de Datadog
+### Instala el SDK de Datadog {#install-the-datadog-sdk}
-Para instalar la biblioteca de rastreo de Datadog utilizando npm para Node.js v18 y superiores, ejecuta:
+Para instalar el SDK de Datadog usando npm para Node.js 18+, ejecuta:
```shell
- npm install dd-trace --save
+ npm install dd-trace
```
-Para instalar la biblioteca de rastreo de Datadog (v4. y superiores de `dd-trace`) para la versión 16 de Node.js, ejecuta:
+Para instalar el SDK de Datadog (versión 4.x de `dd-trace`) para la versión de Node.js 16 que ha llegado al final de su vida útil, ejecuta:
```shell
npm install dd-trace@latest-node16
```
-Para obtener más información sobre las etiquetas (tags) de distribución y la compatibilidad con las versiones de tiempos de ejecución Node.js de Datadog, consulta la página de [requisitos de compatibilidad][1].
-Si estás actualizando desde una versión principal anterior de biblioteca (0.x, 1.x, 2.x, 3.x o 4.x) a otra versión principal, consulta la [guía para migraciones][5], para evaluar cualquier cambio de última hora.
+Para más información sobre las etiquetas de distribución de Datadog y el soporte de versiones del runtime de Node.js, consulta la página de [Requisitos de compatibilidad][1].
+Si estás actualizando desde una versión principal anterior de la biblioteca (0.x, 1.x, 2.x, 3.x o 4.x) a otra versión principal, lee la [Guía de Migración][5] para evaluar cualquier cambio que rompa la compatibilidad.
-### Para importar e inicializar el rastreador
+
En entornos Serverless o al usar Instrumentación de Un Solo Paso, la biblioteca ya está preinstalada, por lo que no necesita agregarla como una dependencia. En su lugar, agréguela como una dependencia de desarrollo para obtener trazas localmente:
+
+
+ npm install dd-trace -D # en lugar de `npm install dd-trace`
+
+
+
+
+
+
-Importa e inicializa el rastreador ya sea en código o con argumentos de línea de comandos. La biblioteca de rastreo de Node.js debe importarse e inicializarse **antes** que cualquier otro módulo.
+### Instale la API pública de Datadog (opcional) {#install-the-datadog-public-api-optional}
-
Con frameworks como Next.js y Nest.js debes proporcionar una variable de entorno o añadir una marca de Node.js adicional. Consulta Uso de frameworks complejos para obtener más información.
+Este paso solo es necesario al realizar instrumentación personalizada en Serverless o con Instrumentación de Un Solo Paso. Para otros casos de uso de instrumentación personalizada, es opcional. Para información sobre cuándo usar la API pública de Datadog, consulte [Instrumentación Personalizada usando la API de Datadog][14].
-Una vez que hayas completado la configuración, si no estás recibiendo trazas (traces) completas, incluyendo rutas URL faltantes para solicitudes web, o tramos (spans) desconectados o faltantes, **confirma que el rastreador ha sido importado e inicializado correctamente**. La biblioteca de rastreo que se inicializa en primer lugar es necesaria para que el rastreador corrija correctamente a través de parches todas los bibliotecas requeridas para la instrumentación automática.
+ ```shell
+ npm install dd-trace-api
+ ```
-Cuando utilices un transpilador como TypeScript, Webpack, Babel u otros, importa e inicializa la biblioteca de rastreo en un archivo externo y luego importa ese archivo como un todo cuando crees tu aplicación.
+Luego puede importar `dd-trace-api` en lugar de `dd-trace` en cualquier código que realice instrumentación personalizada.
-#### Opción 1: Añadir el rastreador en el código
+### Importe e inicialice el rastreador {#import-and-initialize-the-tracer}
-##### JavaScript
+Importe e inicialice el rastreador ya sea en el código o con argumentos de línea de comandos. El SDK de Node.js necesita ser importado e inicializado **antes** de cualquier otro módulo.
-```javascript
-// This line must come before importing any instrumented module.
-const tracer = require('dd-trace').init();
-```
+
Con frameworks como Next.js y Nest.js, debes proporcionar una variable de entorno o agregar un flag adicional de Node.js. Consulta Uso complejo de frameworks para más información.
-**Nota**: `DD_TRACE_ENABLED` es `true` en forma predeterminada, lo que significa que algo de instrumentación ocurre en el momento de la importación, antes de la inicialización. Para desactivar completamente la instrumentación, puedes realizar una de las siguientes acciones:
-- importar el módulo condicionalmente
-- configurar `DD_TRACE_ENABLED=false` (si, por ejemplo, las importaciones estáticas o ESM de nivel superior impiden la carga condicional)
+Después de completar la configuración, si no estás recibiendo trazas completas, incluyendo rutas URL faltantes para solicitudes web, o tramos desconectados o faltantes, **confirma que el SDK ha sido importado e inicializado correctamente**. Es necesario inicializar primero el SDK para que pueda parchear correctamente todas las bibliotecas requeridas para la instrumentación automática.
-##### TypeScript y bundlers (empaquetadores)
+Al usar un transpiler como TypeScript, Webpack, Babel u otros, importa e inicializa el SDK en un archivo externo y luego importa ese archivo completo al construir tu aplicación.
-Para TypeScript y bundlers que admitan la sintaxis de ECMAScript Module, inicializa el rastreador en un archivo separado para mantener el orden de carga correcto.
+#### Agrega el SDK con argumentos de línea de comandos {#add-the-sdk-with-command-line-arguments}
-```typescript
-// server.ts
-import './tracer'; // must come before importing any instrumented module.
+Usa la opción `--require` de Node.js para cargar e inicializar el SDK en un solo paso.
-// tracer.ts
-import tracer from 'dd-trace';
-tracer.init(); // initialized in a different file to avoid hoisting.
-export default tracer;
+```sh
+node --require dd-trace/init app.js
```
-Si la configuración por defecto es suficiente o si toda la configuración se realiza
-a través de variables de entorno, también puedes utilizar `dd-trace/init`, que se carga e
-inicializa en un solo paso.
+El enfoque anterior requiere el uso de variables de entorno para toda la configuración del SDK. Si necesitas usar una configuración programática, inicializa `dd-trace` en un archivo dedicado y requiérelo en su lugar:
-```typescript
-import 'dd-trace/init';
+```sh
+node --require ./dd-trace.js app.js
```
-#### Opción 2: Añadir el rastreador con argumentos de línea de comandos
+El archivo debe contener esto:
-Utiliza la opción `--require` de Node.js para cargar e inicializar el rastreador en un solo paso.
-
-```sh
-node --require dd-trace/init app.js
+```js
+// ./dd-trace.js
+require('dd-trace').init({
+ // programmatic config
+})
```
-**Nota:** Esta estrategia requiere el uso de variables de entorno para todas las configuraciones del rastreador.
+Para casos donde no es posible controlar los argumentos de la CLI, puedes usar una variable de entorno en su lugar:
-#### Sólo aplicaciones ESM: Importar el cargador
+
DD_TRACE_ENABLED es true por defecto, lo que significa que alguna instrumentación ocurre en el momento de la importación, antes de la inicialización. Para deshabilitar completamente la instrumentación, puedes hacer una de las siguientes acciones:
+
+
Importa el módulo condicionalmente
+
Establece DD_TRACE_ENABLED=false (si, por ejemplo, las importaciones estáticas o de nivel superior de ESM impiden la carga condicional)
+
+
-Las aplicaciones ECMAScript Modules (ESM) requieren un argumento _adicional_ de la línea de comandos. Añade este argumento independientemente de cómo se importe e inicialice el rastreador:
+#### Aplicaciones ESM solamente: Importa el cargador {#esm-applications-only-import-the-loader}
+
+Las aplicaciones ECMAScript Modules (ESM) requieren un _argumento_ adicional de línea de comandos. Agrega este argumento sin importar cómo se importe e inicialice el SDK de otra manera:
- **Node.js < v20.6:** `--loader dd-trace/loader-hook.mjs`
- **Node.js >= v20.6:** `--import dd-trace/register.js`
-Por ejemplo, en Node.js 22, si inicializas el rastreador utilizando la opción uno de las anteriores, lo iniciarías así:
+Por ejemplo, en Node.js 22, si inicializas el SDK usando la opción uno de arriba, lo iniciarías así:
```sh
node --import dd-trace/register.js app.js
```
-También puede combinarse con el argumento de línea de comandos `--require dd-trace/init` (opción dos):
+Esto también se puede combinar con el argumento de línea de comandos `--require dd-trace/init`:
```sh
node --import dd-trace/register.js --require dd-trace/init app.js
```
-Existe una forma abreviada de combinar ambos argumentos de línea de comandos en Node.js v20.6 y superiores:
+Existe una forma abreviada para combinar ambos argumentos de línea de comandos en Node.js v20.6 y versiones superiores:
```sh
node --import dd-trace/initialize.mjs app.js
```
-### Empaquetado
+### Empaquetado {#bundling}
-`dd-trace` funciona interceptando las llamadas `require()` que una aplicación Node.js realiza al cargar módulos. Esto incluye módulos que están integrados en Node.js, como el módulo `fs` para acceder al sistema de archivos, así como módulos instalados desde el registro NPM, como el módulo de base de datos `pg`.
+`dd-trace` funciona interceptando las llamadas `require()` que una aplicación de Node.js realiza al cargar módulos. Esto incluye módulos que están integrados en Node.js, como el módulo `fs` para acceder al sistema de archivos, así como módulos instalados desde el registro de NPM, como el módulo de base de datos `pg`.
-Los bundlers rastrean todas las llamadas `require()` que una aplicación realiza a los archivos del disco. Sustituye las llamadas `require()` por código personalizado y combina todos los JavaScript resultantes en un archivo "empaquetado". Cuando se carga un módulo incorporado, como `require('fs')`, esa llamada puede seguir siendo la misma en el paquete resultante.
+Los agrupadores rastrean todas las llamadas `require()` que una aplicación realiza a archivos en el disco. Reemplaza las llamadas `require()` con código personalizado y combina todo el JavaScript resultante en un solo archivo "empaquetado". Cuando se carga un módulo integrado, como `require('fs')`, esa llamada puede permanecer igual en el paquete resultante.
-Las herramientas APM como `dd-trace` dejan de funcionar en este punto. Pueden seguir interceptando las llamadas a módulos incorporados, pero no interceptan las llamadas a bibliotecas de terceros. Esto significa que cuando empaquetas una aplicación `dd-trace` utilizando un bundler, es probable que capture información sobre el acceso al disco (a través de `fs`) y las solicitudes HTTP salientes (a través de `http`), pero que omita las llamadas a bibliotecas de terceros. Por ejemplo:
-- Extracción de información entrante de rutas de solicitudes para el framework `express`.
-- Muestra qué consulta se ejecuta para el cliente de base de datos `mysql`.
+Las herramientas APM como `dd-trace` dejan de funcionar en este punto. Pueden continuar interceptando las llamadas para módulos integrados, pero no interceptan llamadas a bibliotecas de terceros. Esto significa que cuando empaquetas una aplicación `dd-trace` con un empaquetador, es probable que capture información sobre el acceso al disco (a través de `fs`) y solicitudes HTTP salientes (a través de `http`), pero omita las llamadas a bibliotecas de terceros. Por ejemplo:
+- Extrayendo información de la ruta de la solicitud entrante para el framework `express`.
+- Mostrando qué consulta se ejecuta para el cliente de base de datos `mysql`.
-Una solución común es tratar como "externos" al bundler todos los módulos de terceros que APM necesita para la instrumentación. Con esta configuración, los módulos instrumentados permanecen en el disco y continúan siendo cargados con `require()`, mientras que los módulos no instrumentados se empaquetan. Sin embargo, esto resulta en una compilación con muchos archivos extraños y comienza a hacer fracasar el propósito de la agrupación.
+Una solución común es tratar todos los módulos de terceros que el APM necesita instrumentar como "externos" al empaquetador. Con esta configuración, los módulos instrumentados permanecen en el disco y continúan cargándose con `require()` mientras que los módulos no instrumentados se empaquetan. Sin embargo, esto resulta en una compilación con muchos archivos superfluos y comienza a ir en contra del propósito del empaquetado.
-Datadog recomienda disponer de complementos de bundler personalizados. Estos complementos son capaces de dar instrucciones al bundler sobre cómo comportarse, inyectar código intermediario e interceptar las llamadas "traducidas" a `require()`. Como resultado, se incluyen más paquetes en el archivo empaquetado JavaScript.
+Datadog recomienda usar complementos personalizados para el empaquetador. Estos complementos pueden instruir al empaquetador sobre cómo comportarse, inyectar código intermedio e interceptar las llamadas "traducidas" `require()`. Como resultado, se incluyen más paquetes en el archivo JavaScript empaquetado.
-**Nota**: Algunas aplicaciones pueden tener el 100 % de los módulos empaquetados, sin embargo los módulos nativos deben permanecer externos al paquete.
+**Nota**: Algunas aplicaciones pueden tener el 100% de los módulos empaquetados, sin embargo, los módulos nativos aún deben permanecer externos al paquete.
-#### Integración con esbuild
+#### Empaquetando con esbuild {#bundling-with-esbuild}
-Esta biblioteca proporciona compatibilidad esbuild experimental en forma de un complemento esbuild y requiere al menos Node.js v16.17 o v18.7. Para utilizar el complemento, asegúrate de tener instalado `dd-trace@3+` y luego solicita el módulo `dd-trace/esbuild` al compilar el paquete.
+Esta biblioteca proporciona soporte experimental para esbuild en forma de un plugin de esbuild, y requiere al menos Node.js v16.17 o v18.7. Para usar el plugin, asegúrate de tener `dd-trace@3+` instalado, y luego requiere el módulo `dd-trace/esbuild` al construir tu paquete.
-El siguiente es un ejemplo de cómo se puede utilizar `dd-trace` con esbuild:
+Aquí hay un ejemplo de cómo se podría usar `dd-trace` con esbuild:
```javascript
const ddPlugin = require('dd-trace/esbuild')
@@ -173,11 +181,6 @@ esbuild.build({
'@datadog/native-appsec',
'@datadog/native-iast-taint-tracking',
'@datadog/native-iast-rewriter',
-
- // required if you encounter graphql errors during the build step
- 'graphql/language/visitor',
- 'graphql/language/printer',
- 'graphql/utilities'
]
}).catch((err) => {
console.error(err)
@@ -185,10 +188,10 @@ esbuild.build({
})
```
-#### Integración con Next.js
+#### Empaquetando con Next.js {#bundling-with-nextjs}
-Si estás utilizando Next.js u otro framework que dependa de webpack para empaquetar tu aplicación, añade una declaración
-similar a la de webpack en el archivo de configuración `next.config.js`:
+Si estás usando Next.js u otro framework que dependa de webpack para empaquetar tu aplicación, agrega una declaración
+similar a la de webpack dentro de tu archivo de configuración `next.config.js`:
```javascript
/** @type {import('next').NextConfig} */
@@ -211,11 +214,6 @@ const nextConfig = {
'@datadog/native-appsec',
'@datadog/native-iast-taint-tracking',
'@datadog/native-iast-rewriter',
-
- // required if you encounter graphql errors during the build step
- 'graphql/language/visitor',
- 'graphql/language/printer',
- 'graphql/utilities'
];
config.externals.push(...externals);
return config;
@@ -225,17 +223,17 @@ const nextConfig = {
export default nextConfig;
```
-#### Funciones no compatibles de Datadog
+#### Características no soportadas de Datadog {#unsupported-datadog-features}
-Las siguientes funciones están desactivadas en forma predeterminada en el rastreador Node.js. No son compatibles con la agrupación y no se pueden utilizar si la aplicación está agrupada.
+Las siguientes características están desactivadas por defecto en el rastreador de Node.js. No soportan el empaquetado y no pueden ser utilizadas si tu aplicación está empaquetada.
-- APM: Dynamic Instrumentation
+- APM: Instrumentación Dinámica
-#### Observaciones generales sobre la agrupación
+#### Observaciones generales sobre el empaquetado {#general-bundling-remarks}
-**Nota**: Debido al uso de módulos nativos en el rastreador, que son código C++ compilado, (normalmente terminan con una extensión de archivo `.node`), necesitas añadir entradas a tu lista `external`. Actualmente los módulos nativos utilizados en el rastreador Node.js viven dentro de paquetes prefijados `@datadog`. Esto también requerirá que envíes un directorio `node_modules/` junto con tu aplicación empaquetada. No necesitas enviar tu directorio `node_modules/` completo, ya que contendría muchos paquetes innecesarios que deberían estar contenidos en tu paquete.
+**Nota**: Debido al uso de módulos nativos en el SDK, que son código C++ compilado, (generalmente terminando con una extensión de archivo `.node`), necesitas agregar entradas a tu lista `external`. Actualmente, los módulos nativos utilizados en el rastreador de Node.js viven dentro de paquetes con prefijo `@datadog`. Esto también requerirá que envíes un directorio `node_modules/` junto con tu aplicación empaquetada. No necesitas enviar todo tu directorio `node_modules/` ya que contendría muchos paquetes superfluos que deberían estar contenidos en tu paquete.
-Para generar un directorio `node_modules/` más pequeño con sólo los módulos nativos requeridos, (y sus dependencias), puedes determinar primero las versiones de los paquetes que necesitas, luego crear un directorio temporal para instalarlos y copiar el directorio `node_modules/` resultante a partir de aquel. Por ejemplo:
+Para generar un directorio más pequeño `node_modules/` con solo los módulos nativos requeridos, (y sus dependencias) primero puedes determinar las versiones de los paquetes que necesitas, luego crear un directorio temporal para instalarlos, y copiar el directorio resultante `node_modules/` desde allí. Por ejemplo:
```sh
cd path/to/project
@@ -251,17 +249,17 @@ npm install @datadog/native-metrics@2.0.0 @datadog/pprof@5.0.0
cp -R ./node_modules path/to/bundle
```
-**Nota**: En el caso de Next.js el `path/to/bundle` suele ser el directorio `.next/standalone` de tu aplicación.
+**Nota**: En el caso de Next.js, el `path/to/bundle` suele ser el directorio `.next/standalone` de tu aplicación.
-En esta etapa, debes ser capaz de desplegar tu paquete (que es el código de la aplicación y la mayoría de tus dependencias) con el directorio `node_modules/` que contiene los módulos nativos y sus dependencias.
+En esta etapa, deberías poder desplegar tu paquete, (que es tu código de aplicación y la mayoría de tus dependencias), con el `node_modules/` directorio, que contiene los módulos nativos y sus dependencias.
-## Configuración
+## Configuración {#configuration}
-Si es necesario, configura la biblioteca de rastreo para que envíe datos de telemetría sobre el rendimiento de la aplicación, según sea necesario, incluida la configuración del etiquetado unificado de servicios. Para ver más detalles, consulta la [configuración de bibliotecas][4].
+Si es necesario, configura el SDK para enviar datos de telemetría de rendimiento de la aplicación según lo requieras, incluyendo configurar unified service tagging. Lee [Configuración de la Biblioteca][4] para más detalles.
-Para ver lista de opciones de inicialización, lee los [parámetros del rastreador][3].
+Lee [configuración del rastreador][3] para obtener una lista de opciones de inicialización.
-## Referencias adicionales
+## Lectura Adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -272,4 +270,5 @@ Para ver lista de opciones de inicialización, lee los [parámetros del rastread
[5]: https://github.com/DataDog/dd-trace-js/blob/master/MIGRATING.md
[6]: /es/tracing/trace_collection/compatibility/nodejs/#complex-framework-usage
[11]: /es/tracing/trace_collection/library_injection_local/
-[13]: /es/tracing/trace_collection/automatic_instrumentation/?tab=datadoglibraries#install-and-configure-the-agent
\ No newline at end of file
+[13]: /es/tracing/trace_collection/automatic_instrumentation/?tab=datadoglibraries#install-and-configure-the-agent
+[14]: /es/tracing/trace_collection/custom_instrumentation/server-side/?api_type=dd_api&prog_lang=node_js
\ No newline at end of file
diff --git a/content/es/tracing/trace_collection/single-step-apm/kubernetes.md b/content/es/tracing/trace_collection/single-step-apm/kubernetes.md
index 5c8158d6cf5..2238b4344bc 100644
--- a/content/es/tracing/trace_collection/single-step-apm/kubernetes.md
+++ b/content/es/tracing/trace_collection/single-step-apm/kubernetes.md
@@ -6,74 +6,76 @@ code_lang_weight: 20
further_reading:
- link: /tracing/metrics/runtime_metrics/
tag: Documentación
- text: Habilitar métricas de tiempo de ejecución
+ text: Habilitar métricas en tiempo de ejecución
- link: /tracing/guide/init_resource_calc/
tag: Documentación
- text: Más información sobre el uso de los recursos del contenedor de inicialización
+ text: Aprender sobre el uso de recursos de contenedores init
- link: /tracing/guide/local_sdk_injection
tag: Documentación
- text: Instrumenta tus aplicaciones mediante la inserción del kit de desarrollo de
- software (SDK) local
-title: Instrumentación de un solo step (UI) / paso de APM en Kubernetes
+ text: Instrumente sus aplicaciones utilizando la inyección local del kit de desarrollo
+ de software (SDK).
+- link: https://learn.datadoghq.com/courses/configuring-ssi-k8s
+ tag: Centro de Aprendizaje
+ text: Configurando la instrumentación de un solo paso en Kubernetes
+title: Instrumentación APM de un solo paso en Kubernetes
type: multi-code-lang
---
+## Resumen {#overview}
-## Información general
+En un entorno de Kubernetes, utilice la instrumentación de un solo paso (SSI) para APM para instalar el Agente de Datadog e [instrumentar][3] sus aplicaciones con los SDK de Datadog en un solo paso.
-En un entorno de Kubernetes, utiliza la instrumentación de un solo step (UI) / paso (generic) (SSI) para APM para instalar el Datadog Agent e [instrumentar][3] tus aplicaciones con los kits de desarrollo de software (SDK) de APM de Datadog en un solo step (UI) / paso (generic).
-
-## Requisitos
+## Requisitos {#requirements}
- Kubernetes v1.20+.
-- [`Helm`][1] para desplegar el Datadog Operator.
-- [CLI `Kubectl`][2] para instalar el Datadog Agent.
-- Compatibilidad confirmada del entorno según la [Guía de compatibilidad de instrumentación de un solo step (UI) / paso (generic) ][36].
+- [`Helm`][1] para desplegar el Operador de Datadog.
+- [`Kubectl` CLI][2] para instalar el Agente de Datadog.
+- Compatibilidad del entorno confirmada según la [guía de compatibilidad de instrumentación de un solo paso][36].
-## Activa APM en tus aplicaciones
+## Habilitar APM en sus aplicaciones {#enable-apm-on-your-applications}
-
La instrumentación de un solo step (UI) / paso (generic) no instrumenta aplicaciones en el espacio de nombres donde está instalado el Datadog Agent. Instala el Agent en un espacio de nombres separado donde no ejecutes tus aplicaciones.
+
La instrumentación de un solo paso no instrumenta aplicaciones en el espacio de nombres donde se instala el Agente de Datadog. Instala el Agente en un espacio de nombres separado donde no ejecutes tus aplicaciones.
-Sigue estos steps (UI) / pasos (generic) para activar la instrumentación de un solo step (UI) / paso (generic) en todo tu clúster. Esto envía automáticamente las traces (trazas) de todas las aplicaciones escritas en los lenguajes compatibles.
+Sigue estos pasos para habilitar la Instrumentación de Paso Único en todo tu clúster. Esto envía automáticamente trazas de todas las aplicaciones escritas en lenguajes soportados.
-**Nota:** Para instrumentar solo espacios de nombres o pods específicos, consulta la orientación de la carga de trabajo en [Opciones avanzadas](#advanced-options).
+**Nota:** Para instrumentar solo espacios de nombres o pods específicos, consulta la segmentación de carga de trabajo en [Opciones avanzadas](#advanced-options).
-1. En Datadog, ve a la page (página) de [Instalación del Datadog Agent en Kubernetes][11].
-1. Sigue las instrucciones que aparecen en pantalla para seleccionar el método de instalación, seleccionar una clave API y configurar el repositorio de Operator o Helm.
-1. En la sección **Configurar `datadog-agent.yaml`**, ve a **Additional configuration** > **Application Observability** (Configuración adicional > Observabilidad de la aplicación) y activa **APM Instrumentation** (Instrumentación de APM).
+1. En Datadog, ve a la página de [Instalar el Agente de Datadog en Kubernetes][11].
+1. Sigue las instrucciones en pantalla para elegir tu método de instalación, seleccionar una clave de API y configurar el Operador o el repositorio de Helm.
+1. En la sección **Configurar `datadog-agent.yaml`**, ve a **Configuración adicional** > **Observabilidad de aplicaciones**, y activa **Instrumentación APM**.
- {{< img src="tracing/trace_collection/k8s-apm-instrumentation-toggle.jpg" alt="El bloque de configuración para instalar el Datadog Agent en Kubernetes a través de la aplicación de Datadog" style="width:100%;" >}}
+ {{< img src="tracing/trace_collection/k8s-apm-instrumentation-toggle.jpg" alt="El bloque de configuración para instalar el Agente de Datadog en Kubernetes a través de la aplicación de Datadog" style="width:100%;" >}}
-1. Despliega el Agent utilizando el archivo de configuración generado.
+1. Despliega el Agente utilizando el archivo de configuración generado.
1. Reinicia tus aplicaciones.
-
SSI añade una pequeña cantidad de tiempo de arranque a las aplicaciones instrumentadas. Si esta sobrecarga no es aceptable para tu case (incidencia) de uso, ponte en contacto con el servicio de asistencia de Datadog .
+
SSI agrega una pequeña cantidad de tiempo de inicio a las aplicaciones instrumentadas. Si este sobrecosto no es aceptable para tu caso de uso, contacta a Soporte de Datadog.
-## Configurar tags (etiquetas) de servicio unificadas
+## Configura etiquetas de servicio unificadas {#configure-unified-service-tags}
-Las tags (etiquetas) de servicio unificadas (UST) aplican tags (etiquetas) coherentes en todas las traces (trazas), métricas y logs, lo que facilita la navegación y la correlación de tus datos de observabilidad. Puedes configurar las UST mediante la extracción automática de etiquetas (recomendado), mediante la configuración explícita con `ddTraceConfigs` o en manifiestos de despliegue.
+Las etiquetas de servicio unificadas (USTs) aplican etiquetas consistentes a través de trazas, métricas y registros, facilitando la navegación y correlación de tus datos de observabilidad. Puedes configurar USTs a través de la extracción automática de etiquetas (recomendado), mediante configuración explícita con `ddTraceConfigs`, o en manifiestos de despliegue.
-### (Recomendado) Configurar las UST mediante la extracción automática de etiquetas
+### (Recomendado) Configure USTs a través de la extracción automática de etiquetas {#recommended-configure-usts-through-automatic-label-extraction}
-Con SSI, puedes extraer automáticamente los valores de las UST de las etiquetas y metadatos de los pods sin modificar las despliegues individuales. Para ello, configura `kubernetesResourcesLabelsAsTags` para asignar tus etiquetas de Kubernetes existentes a tags (etiquetas) de servicios de Datadog.
+Con SSI, puede extraer automáticamente los valores de UST de las etiquetas y metadatos de los pods sin modificar implementaciones individuales. Para hacer esto, configure `kubernetesResourcesLabelsAsTags` para mapear sus etiquetas de Kubernetes existentes a las etiquetas de servicio de Datadog.
-**Nota:** Este método no es compatible con la Configuración remota. Si utilizas la Configuración remota, consulta [Configurar UST explícitamente con ddTraceConfigs](#configure-usts-explicitly-with-ddtraceconfigs).
+**Nota:** Este método no es compatible con la Configuración Remota. Si está utilizando Configuración Remota, consulte [Configurar USTs explícitamente con ddTraceConfigs](#configure-usts-explicitly-with-ddtraceconfigs).
-#### Requisitos previos
+#### Requisitos previos {#prerequisites}
-| Componente | Versión mínima |
+| Componente | Versión mínima |
|-----------|------------------|
-| `datadog-agent` | 7.69 |
-| `datadog-operator` | 1.16.0 |
+| `datadog-agent` | 7.69 |
+| `datadog-operator` | 1.16.0 |
| `datadog-helm-chart` | 3.120.0 |
-#### Configuración
+#### Configuración {#configuration}
-Sustituye `app.kubernetes.io/name` en el siguiente ejemplo por cualquier etiqueta que contenga el nombre de tu servicio (por ejemplo, `service.kubernetes.io/name` o `component`). Puedes configurar varias etiquetas de esta forma.
+Reemplace `app.kubernetes.io/name` en el siguiente ejemplo con cualquier etiqueta que contenga el nombre de su servicio (por ejemplo, `service.kubernetes.io/name` o `component`). Puede configurar múltiples etiquetas de esta manera.
```yaml
datadog:
@@ -95,11 +97,11 @@ datadog:
enabled: true
```
-Con esta configuración, Datadog establece automáticamente la tag (etiqueta) `service` utilizando el valor de la etiqueta `app.kubernetes.io/name` para cualquier carga de trabajo instrumentada que incluya esta etiqueta.
+Con esta configuración, Datadog establece automáticamente la etiqueta `service` utilizando el valor de la etiqueta `app.kubernetes.io/name` para cualquier carga de trabajo instrumentada que incluya esta etiqueta.
-### Configurar UST explícitamente con ddTraceConfigs
+### Configure USTs explícitamente con ddTraceConfigs {#configure-usts-explicitly-with-ddtraceconfigs}
-En la mayoría de los casos, la configuración automática es suficiente. Sin embargo, si necesitas un control granular sobre las configuraciones para cargas de trabajo específicas, utiliza `ddTraceConfigs` para asignar explícitamente etiquetas a configuraciones de servicio:
+En la mayoría de los casos, la configuración automática es suficiente. Sin embargo, si necesita un control granular sobre la configuración de cargas de trabajo específicas, utilice `ddTraceConfigs` para mapear explícitamente las etiquetas a las configuraciones del servicio:
```yaml
datadog:
@@ -131,66 +133,127 @@ datadog:
```
-### Configurar UST en manifiestos de despliegue
+### Configura USTs en los manifiestos de implementación {#configure-usts-in-deployment-manifests}
+
+Si su configuración no utiliza etiquetas adecuadas para la extracción de UST, puede establecer USTs directamente en sus manifiestos de implementación utilizando variables de entorno. Este enfoque requiere modificar cada implementación individualmente, pero ofrece un control preciso.
-Si tu configuración no utiliza etiquetas adecuadas para la extracción de UST, puedes establecer UST directamente en tus manifiestos de despliegue utilizando variables de entorno. Este enfoque requiere modificar cada despliegue individualmente, pero ofrece un control preciso.
+Para instrucciones completas, consulta [configuración de USTs para servicios de Kubernetes][5].
-Para obtener instrucciones completas, consulta [configuración de UST para servicios de Kubernetes ][5].
+## Habilita productos y características dependientes del SDK {#enable-sdk-dependent-products-and-features}
-## Activar productos y funciones dependientes del kit de desarrollo de software (SDK)
+Después de que SSI cargue el SDK de Datadog en tus aplicaciones y habilite el rastreo distribuido, puedes configurar productos adicionales que dependen del SDK:
-Después de que SSI cargue el kit de desarrollo de software (SDK) de Datadog en tus aplicaciones y active el rastreo distribuido, puedes configurar productos adicionales que dependan del kit de desarrollo de software (SDK). Estos incluyen capacidades tales como [Continuous Profiler][37], [Monitorización de seguridad de las aplicaciones][38] y [controles de ingesta de traces (trazas)][39].
+{{< ssi-products >}}
Utiliza uno de los siguientes métodos de configuración:
-- **[Configuración con cargas de trabajo específicas (recomendado)](#target-specific-workloads)**:
+- **[Configura con orientación a cargas de trabajo (recomendado)](#target-specific-workloads)**:
+
+ Por defecto, la Instrumentación de Un Solo Paso instrumenta todos los servicios en todos los espacios de nombres. Utiliza la orientación a cargas de trabajo para limitar la instrumentación a espacios de nombres, pods o cargas de trabajo específicas, y aplica configuraciones personalizadas.
+
+- **[Establecer variables de entorno][7]**:
- Por defecto, Single Step Instrumentation instrumenta todos los servicios en todos los espacios de nombres. Utiliza la orientación a las cargas de trabajo para limitar la instrumentación a espacios de nombres, pods y cargas de trabajo específicos, y aplica configuraciones personalizadas.
+ Habilita productos estableciendo variables de entorno directamente en la configuración de tu aplicación.
-- **[Configurar variables de entorno][7]**:
+## Opciones avanzadas {#advanced-options}
- Activa productos definiendo variables de entorno directamente en la configuración de tu aplicación.
+Utilice las siguientes opciones avanzadas para personalizar cómo se comporta la instrumentación de paso único en su entorno. Estas configuraciones son opcionales y generalmente solo se necesitan en configuraciones especializadas.
-## Opciones avanzadas
+### Configure modos de inyección {#configure-injection-modes}
-Utiliza las siguientes opciones avanzadas para personalizar el comportamiento de la instrumentación de un solo step (UI) / paso (generic) en tu entorno. Estos ajustes son opcionales y normalmente solo se necesitan en configuraciones especializadas.
+SSI admite múltiples modos de inyección, que controlan cómo se entregan los archivos del inyector y de la biblioteca APM a tus contenedores de aplicación. Normalmente no necesita configurar esta opción manualmente. Considere ajustarla si nota retrasos significativos en el inicio del pod o un uso de recursos (CPU, memoria) más alto de lo esperado durante la inicialización del pod. Para más información sobre cómo funciona el inyector, consulte [Comportamiento del inyector con instrumentación de paso único][41].
-### Cargas de trabajo específicas
-Por defecto, SSI instrumenta todos los servicios en todos los espacios de nombres de tu clúster. Según cuál sea tu versión del Agent, utiliza uno de los siguientes métodos de configuración para refinar qué servicios se instrumentan y de qué manera.
+| Modo | Descripción | Requisitos |
+|------|-------------|--------------|
+| `init_container` | Utilice contenedores de inicialización para copiar archivos del inyector y de la biblioteca APM en los contenedores de la aplicación. | Agente desplegado con Helm Chart o Datadog Operator |
+| `csi` | **En vista previa.** Monta archivos del inyector y de la biblioteca APM utilizando el [controlador CSI de Datadog][37]. Reduce el tiempo de inicio del pod en comparación con el modo de contenedor de inicialización. | Agente 7.76.0+, controlador CSI 1.2.0+, Helm Chart 3.178.1+ o Datadog Operator 1.25.0+ |
+
+Antes de usar `csi` modo, instale y active el controlador CSI de Datadog. Si está desplegando con Helm, también configure `datadog.csi.enabled: true` en su `datadog-values.yaml`. Consulte la [documentación del controlador CSI][37] para los pasos de instalación y requisitos específicos del entorno, como GKE Autopilot.
+
+#### Configure el modo de inyección globalmente {#configure-injection-mode-globally}
{{< tabs >}}
+{{% tab "Helm" %}}
+
+Para establecer el modo de inyección a nivel de clúster, agregue `injectionMode` a su `datadog-values.yaml`:
+
+```yaml
+datadog:
+ apm:
+ instrumentation:
+ injectionMode:
+```
+
+Valores soportados: `init_container`, `csi`.
-{{% tab "Agent v7.64+ (Recomendado)" %}}
+{{% /tab %}}
+{{% tab "Datadog Operator" %}}
+
+Para establecer el modo de inyección a nivel de clúster, agregue `injectionMode` a su `datadog-agent.yaml`:
+
+```yaml
+features:
+ apm:
+ instrumentation:
+ injectionMode:
+```
-Crea bloques de destino con la etiqueta `targets` para especificar qué cargas de trabajo instrumentar y qué configuraciones aplicar.
+Valores soportados: `init_container`, `csi`.
+
+Si está utilizando Datadog Operator anterior a 1.25.0, use la [anotación de pod](#configure-injection-mode-per-pod) para anular el modo de inyección para pods específicos.
+
+{{% /tab %}}
+{{< /tabs >}}
+
+#### Configure el modo de inyección por pod {#configure-injection-mode-per-pod}
+
+Para anular el modo de inyección para un pod específico, agregue la siguiente anotación a la especificación del pod:
+
+```yaml
+metadata:
+ annotations:
+ admission.datadoghq.com/apm-inject.injection-mode: ""
+```
+
+Valores soportados: `init_container`, `csi`.
+
+### Dirija cargas de trabajo específicas {#target-specific-workloads}
+
+De forma predeterminada, SSI instrumenta todos los servicios en todos los espacios de nombres de su clúster. Dependiendo de la versión de su agente, utilice uno de los siguientes métodos de configuración para refinar qué servicios son instrumentados y cómo.
+
+{{< tabs >}}
+
+{{% tab "Agente v7.64+ (Recomendado)" %}}
+
+Cree bloques de destino con la etiqueta `targets` para especificar qué cargas de trabajo instrumentar y qué configuraciones aplicar.
Cada bloque de destino tiene las siguientes claves:
| Clave | Descripción |
|------------------|-------------|
-| `name` | El nombre del bloque de destino. No tiene ningún efecto sobre el estado de monitorización y solo se utiliza como metadatos. |
-| `namespaceSelector` | El espacio o espacios de nombres que se instrumentarán. Especifífcalo utilizando uno o más de: - `matchNames`: Una lista de uno o más nombres de espacios de nombres. - `matchLabels`: Una lista de una o más etiquetas definidas en pares `{key,value}`. - `matchExpressions`: Una lista de requisitos del selector de espacios de nombres.
Los espacios de nombres deben cumplir todos los criterios para coincidir. Para obtener más detalles, consulta la [documentación del selector de Kubernetes ][10].|
-| `podSelector` | El pod o pods que se instrumentarán. Especifícalo utilizando uno o más de: - `matchLabels`: Una lista de una o más etiquetas definidas en pares `{key,value}`. - `matchExpressions`: Una lista de requisitos del selector de pods.
Los pods deben cumplir todos los criterios para coincidir. Para obtener más detalles, consulta la [documentación del selector de Kubernetes ][10]. |
-| `ddTraceVersions` | La versión del [kit de desarrollo de software (SDK) de APM de Datadog][9] que se utilizará para cada lenguaje. |
-| `ddTraceConfigs` | Configuraciones del kit de desarrollo de software (SDK) de APM que permiten establecer tags (etiquetas) de servicio unificado, activar productos de Datadog más allá del rastreo y personalizar otros ajustes de APM. [Consulta la lista completa de opciones][8]. |
+| `name` | El nombre del bloque de destino. Esto no tiene efecto en el estado de seguimiento y se utiliza solo como metadatos. |
+| `namespaceSelector` | El(los) espacio(s) de nombres a instrumentar. Especifique utilizando uno o más de: - `matchNames`: Una lista de uno o más nombres de espacios de nombres. - `matchLabels`: Una lista de una o más etiquetas definidas en pares `{key,value}`. - `matchExpressions`: Una lista de requisitos de selección de espacios de nombres.
Los espacios de nombres deben cumplir todos los criterios para coincidir. Para más detalles, consulte la [documentación del selector de Kubernetes][10].|
+| `podSelector` | El(los) pod(s) a instrumentar. Especifique utilizando uno o más de: - `matchLabels`: Una lista de una o más etiqueta(s) definidas en pares `{key,value}`. - `matchExpressions`: Una lista de requisitos de selección de pod.
Los pods deben cumplir todos los criterios para coincidir. Para más detalles, consulte la [documentación del selector de Kubernetes][10]. |
+| `ddTraceVersions` | La versión del [SDK de APM de Datadog][9] a utilizar para cada lenguaje. |
+| `ddTraceConfigs` | Configuraciones del SDK de APM que permiten establecer [Etiquetas de Servicio Unificadas][8], habilitando [ productos dependientes del SDK](#enable-sdk-dependent-products-and-features) más allá del rastreo, y personalizando otras [configuraciones de APM][14]. |
-El archivo que necesitas configurar depende de la manera en que habilitaste la instrumentación de un solo step (UI) / paso (generic):
-- Si activaste SSI con Datadog Operator, edita `datadog-agent.yaml`.
-- Si activaste SSI con Helm, edita `datadog-values.yaml`.
+El archivo que necesitas configurar depende de cómo habilitaste la Instrumentación de Paso Único:
+- Si habilitaste SSI con Datadog Operator, edita `datadog-agent.yaml`.
+- Si habilitaste SSI con Helm, edita `datadog-values.yaml`.
-**Nota**: Los objetivos se evalúan en orden; la primera coincidencia tiene prioridad.
+**Nota**: Los bloques de destino se evalúan en orden; la primera coincidencia tiene prioridad.
-#### Ejemplos de configuraciones
+#### Ejemplos de configuraciones {#example-configurations}
Revisa los siguientes ejemplos que demuestran cómo seleccionar servicios específicos:
-{{< collapse-content title="Example 1: Enable all namespaces except one" level="h4" >}}
+{{< collapse-content title="Ejemplo 1: Habilitar todos los espacios de nombres excepto uno" level="h4" >}}
Esta configuración:
-- activa APM para todos los espacios de nombres, excepto el espacio de nombres `jenkins`.
- - **Nota**: utiliza `enabledNamespaces` para desactivar todos los espacios de nombres, excepto los enumerados.
-- indica a Datadog que instrumente las aplicaciones de Java con el kit de desarrollo de software (SDK) de APM de Java y las aplicaciones de Python predeterminadas con `v.3.1.0` del kit de desarrollo de software (SDK) de APM de Python.
+- habilita APM para todos los espacios de nombres excepto el espacio de nombres `jenkins`.
+ - **Nota**: usa `enabledNamespaces` para deshabilitar para todos los espacios de nombres excepto los listados.
+- indica a Datadog que instrumente las aplicaciones Java con el SDK de Java por defecto y las aplicaciones Python con `v.3.1.0` del SDK de Python.
{{< highlight yaml "hl_lines=4-10" >}}
apm:
@@ -207,17 +270,17 @@ Esta configuración:
{{< /collapse-content >}}
-{{< collapse-content title="Example 2: Instrument a subset of namespaces, matching on names and labels" level="h4" >}}
+{{< collapse-content title="Ejemplo 2: Instrumentar un subconjunto de espacios de nombres, coincidiendo con nombres y etiquetas" level="h4" >}}
Esta configuración crea dos bloques de destino:
-- El primer bloque (denominado `login-service_namespace`):
- - activa APM para los servicios del espacio de nombres `login-service`.
- - indica a Datadog que instrumente los servicios de este espacio de nombres con la versión predeterminada del kit de desarrollo de software (SDK) de APM de Java.
- - configura la variable de entorno `DD_PROFILING_ENABLED` para este grupo de destino
-- El segundo bloque (denominado `billing-service_apps`)
- - activa APM para los servicios del espacio o espacios de nombres con la etiqueta `app:billing-service`.
- - indica a Datadog que instrumente este conjunto de servicios con `v3.1.0` del kit de desarrollo de software (SDK) de APM de Python.
+- El primer bloque (nombrado `login-service_namespace`):
+ - habilita APM para servicios en el espacio de nombres `login-service`.
+ - instruye a Datadog para instrumentar servicios en este espacio de nombres con la versión predeterminada del SDK de Java.
+ - establece la variable de entorno `DD_PROFILING_ENABLED` para este grupo objetivo
+- El segundo bloque (nombrado `billing-service_apps`)
+ - habilita APM para servicios en el(los) espacio(s) de nombres con la etiqueta `app:billing-service`.
+ - instruye a Datadog para instrumentar este conjunto de servicios con `v3.1.0` del SDK de Python.
{{< highlight yaml "hl_lines=4-28" >}}
apm:
@@ -243,14 +306,14 @@ Esta configuración crea dos bloques de destino:
{{< /collapse-content >}}
-{{< collapse-content title="Example 3: Instrument different workloads with different tracers" level="h4" >}}
+{{< collapse-content title="Ejemplo 3: Instrumentar diferentes cargas de trabajo con diferentes rastreadores" level="h4" >}}
-Esta configuración hace lo siguiente:
-- activa APM para los pods con las siguientes etiquetas:
- - `app:db-user`que marca los pods que ejecutan la aplicación `db-user`.
- - `webserver:routing`que marca los pods que ejecutan la aplicación `request-router`.
-- indica a Datadog que utilice las versiones predeterminadas de los kits de desarrollo de software (SDK) de Datadog Tracer.
-- activa las variables de entorno de Datadog para aplicar a cada grupo de destino y configurar los kits de desarrollo de software (SDK).
+Esta configuración realiza lo siguiente:
+- habilita APM para pods con las siguientes etiquetas:
+ - `app:db-user`, que marca pods ejecutando la aplicación `db-user`.
+ - `webserver:routing`, que marca pods ejecutando la aplicación `request-router`.
+- instruye a Datadog para usar las versiones predeterminadas de los SDKs de Tracer de Datadog.
+- establece variables de entorno de Datadog que se aplican a cada grupo objetivo y configura los SDKs.
{{< highlight yaml "hl_lines=4-28" >}}
apm:
@@ -276,12 +339,12 @@ Esta configuración hace lo siguiente:
{{< /collapse-content >}}
-{{< collapse-content title="Example 4: Instrument a pod within a namespace" level="h4" >}}
+{{< collapse-content title="Ejemplo 4: Instrumentar un pod dentro de un espacio de nombres" level="h4" >}}
Esta configuración:
-- activa APM para los pods etiquetados como `app:password-resolver` en el espacio de nombres `login-service`.
-- indica a Datadog que utilice la versión predeterminada del kit de desarrollo de software (SDK) de Datadog Tracer.
-- configura las variables de entorno de Datadog que se aplicarán a este objetivo.
+- habilita APM para pods etiquetados `app:password-resolver` dentro del espacio de nombres `login-service`.
+- instruye a Datadog para usar la versión predeterminada del SDK de Tracer de Java de Datadog.
+- establece variables de entorno de Datadog que se aplican a este bloque de destino.
{{< highlight yaml "hl_lines=4-28" >}}
apm:
@@ -304,9 +367,9 @@ Esta configuración:
{{< /collapse-content >}}
-{{< collapse-content title="Example 5: Instrument a subset of pods using matchExpressions" level="h4" >}}
+{{< collapse-content title="Ejemplo 5: Instrumentar un subconjunto de pods usando matchExpressions" level="h4" >}}
-Esta configuración activa APM para todos los pods, excepto los que tienen alguna de las etiquetas `app=app1` o `app=app2`.
+Esta configuración habilita APM para todos los pods excepto aquellos que tienen cualquiera de las etiquetas `app=app1` o `app=app2`.
{{< highlight yaml "hl_lines=4-28" >}}
apm:
@@ -325,23 +388,53 @@ Esta configuración activa APM para todos los pods, excepto los que tienen algun
{{< /collapse-content >}}
+{{< collapse-content title="Ejemplo 6: Habilitar productos adicionales con ddTraceConfigs" level="h4" >}}
+
+Esta configuración habilita [App and API Protection (AAP)][12] y [Continuous Profiler][11] para los servicios en el espacio de nombres `web-apps`, utilizando `ddTraceConfigs` para establecer las variables de entorno requeridas:
+
+{{< highlight yaml "hl_lines=4-20" >}}
+ apm:
+ instrumentation:
+ enabled: true
+ targets:
+ - name: "web-apps-with-security"
+ namespaceSelector:
+ matchNames:
+ - "web-apps"
+ ddTraceVersions:
+ java: "default"
+ python: "default"
+ ddTraceConfigs:
+ - name: "DD_APPSEC_ENABLED"
+ value: "true"
+ - name: "DD_PROFILING_ENABLED"
+ value: "auto"
+{{< /highlight >}}
+
+Para una lista completa de productos que puedes habilitar a través de SSI, consulta [Habilitar productos y características dependientes del SDK](#enable-sdk-dependent-products-and-features).
+
+{{< /collapse-content >}}
+
[8]: /es/getting_started/tagging/unified_service_tagging/?tab=kubernetes
[9]: /es/tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility/#tracer-libraries
[10]: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#resources-that-support-set-based-requirements
+[11]: /es/profiler/
+[12]: /es/security/application_security/
+[14]: /es/tracing/trace_collection/library_config/
{{% /tab %}}
-{{% tab "Agent <=v7.63 (heredado)" %}}
+{{% tab "Agente <=v7.63 (Legado)" %}}
-#### Activar o desactivar la instrumentación de los espacios de nombres
+#### Habilitar o deshabilitar la instrumentación para los espacios de nombres {#enable-or-disable-instrumentation-for-namespaces}
-Puedes elegir activar o desactivar la instrumentación para aplicaciones en espacios de nombres específicos. Solo puedes definir espacios de nombres activados o espacios de nombres desactivados, no ambos.
+Puedes elegir habilitar o deshabilitar la instrumentación para aplicaciones en espacios de nombres específicos. Solo puedes establecer enabledNamespaces o disabledNamespaces, no ambos.
-El archivo que tienes que configurar depende de si has activado la instrumentación de un solo step (UI) / paso (generic) con el Datadog Operator o con Helm:
+El archivo que necesitas configurar depende de si habilitaste la Instrumentación de Paso Único con Datadog Operator o Helm:
{{< collapse-content title="Datadog Operator" level="h5" >}}
-Para habilitar la instrumentación para espacios de nombres específicos, añade la configuración `enabledNamespaces` a `datadog-agent.yaml`:
+Para habilitar la instrumentación para espacios de nombres específicos, agrega `enabledNamespaces` configuración a `datadog-agent.yaml`:
{{< highlight yaml "hl_lines=5-7" >}}
features:
@@ -353,7 +446,7 @@ Para habilitar la instrumentación para espacios de nombres específicos, añade
- applications
{{< /highlight >}}
-Para deshabilitar la instrumentación para determinados espacios de nombres, añade la configuración `disabledNamespaces` a `datadog-agent.yaml`:
+Para deshabilitar la instrumentación para espacios de nombres específicos, agrega `disabledNamespaces` configuración a `datadog-agent.yaml`:
{{< highlight yaml "hl_lines=5-7" >}}
features:
@@ -369,48 +462,48 @@ Para deshabilitar la instrumentación para determinados espacios de nombres, añ
{{< collapse-content title="Helm" level="h5" >}}
-Para habilitar la instrumentación para espacios de nombres específicos, añade la configuración `enabledNamespaces` a `datadog-values.yaml`:
+Para habilitar la instrumentación para espacios de nombres específicos, agrega `enabledNamespaces` configuración a `datadog-values.yaml`:
{{< highlight yaml "hl_lines=5-7" >}}
datadog:
apm:
instrumentation:
enabled: true
- enabledNamespaces: # Añadir espacios de nombres que se van a instrumentar
+ enabledNamespaces: # Add namespaces to instrument
- namespace_1
- namespace_2
{{< /highlight >}}
-Para deshabilitar la instrumentación para determinados espacios de nombres, añade la configuración `disabledNamespaces` a `datadog-values.yaml`:
+Para deshabilitar la instrumentación para espacios de nombres específicos, agrega `disabledNamespaces` configuración a `datadog-values.yaml`:
{{< highlight yaml "hl_lines=5-7" >}}
datadog:
apm:
instrumentation:
enabled: true
- disabledNamespaces: # Añadir espacios de nombres que no se van a instrumentar
+ disabledNamespaces: # Add namespaces to not instrument
- namespace_1
- namespace_2
{{< /highlight >}}
{{< /collapse-content >}}
-#### Especificar versiones de bibliotecas de rastreo
+#### Especificar versiones de SDK {#specify-sdk-versions}
-
A partir del Datadog Cluster Agent v7.52.0 o superior, puedes instrumentar automáticamente un subconjunto de tus aplicaciones, basándose en las bibliotecas de rastreo que especifiques.
+
A partir del Agente de Clúster de Datadog v7.52.0+, puedes instrumentar automáticamente un subconjunto de tus aplicaciones, basado en los SDK que especifiques.
-Especifica bibliotecas de rastreo de Datadog y sus versiones para instrumentar automáticamente las aplicaciones escritas en esos lenguajes. Puedes configurarlo de dos maneras, que se aplican en el siguiente orden de precedencia:
+Especifica los SDK de Datadog y sus versiones para instrumentar automáticamente aplicaciones escritas en esos lenguajes. Puedes configurar esto de dos maneras, que se aplican en el siguiente orden de precedencia:
-1. [Especificar al nivel del servicio](#specify-at-the-service-level) o bien
-2. [Especificar al nivel del clúster](#specify-at-the-cluster-level).
+1. [Especificar a nivel de servicio](#specify-at-the-service-level), o
+2. [Especificar a nivel de clúster](#specify-at-the-cluster-level).
-**Predeterminado**: Si no especificas ninguna versión de biblioteca, las aplicaciones escritas en lenguajes compatibles se instrumentan automáticamente utilizando las últimas versiones de bibliotecas de rastreo.
+**Predeterminado**: Si no especificas ninguna versión de biblioteca, las aplicaciones escritas en lenguajes soportados se instrumentan automáticamente utilizando las versiones más recientes de SDK.
-##### Especificar al nivel del servicio
+##### Especificar a nivel de servicio {#specify-at-the-service-level}
-Para instrumentar automáticamente aplicaciones en pods específicos, añade la anotación de lenguaje y la versión de biblioteca adecuadas para tu aplicación en la especificación de tu pod:
+Para instrumentar automáticamente aplicaciones en pods específicos, agrega la anotación de lenguaje apropiada y la versión de la biblioteca para tu aplicación en la especificación de tu pod:
-| Lenguaje | Anotación del pod |
+| Lenguaje | Anotación de pod |
|------------|-----------------------------------------------------------------------|
| Java | `admission.datadoghq.com/java-lib.version: ""` |
| Node.js | `admission.datadoghq.com/js-lib.version: ""` |
@@ -419,7 +512,7 @@ Para instrumentar automáticamente aplicaciones en pods específicos, añade la
| Ruby | `admission.datadoghq.com/ruby-lib.version: ""` |
| PHP | `admission.datadoghq.com/php-lib.version: ""` |
-Sustituye `` por la versión de la biblioteca deseada. Las versiones disponibles están enumeradas en los [registros de contenedores de Datadog](#change-the-default-image-registry) y en los repositorios de source (fuente) del rastreaedor para cada lenguaje:
+Reemplaza `` con la versión de biblioteca deseada. Las versiones disponibles se enumeran en los [registros de contenedores de Datadog](#change-the-default-image-registry) y en los repositorios de código fuente de trazadores para cada lenguaje:
- [Java][34]
- [Node.js][35]
@@ -428,9 +521,9 @@ Sustituye `` por la versión de la biblioteca deseada. Las
- [Ruby][38]
- [PHP][39]
-
Ten cuidado al utilizar la última tag (etiqueta), ya que las principales versiones de la biblioteca pueden introducir cambios de última hora.
+
Ten precaución al usar la etiqueta latest, ya que las versiones principales de la biblioteca pueden introducir cambios incompatibles.
-Por ejemplo, para instrumentar aplicaciones de Java automáticamente:
+Por ejemplo, para instrumentar automáticamente aplicaciones de Java:
{{< highlight yaml "hl_lines=10" >}}
apiVersion: apps/v1
@@ -448,15 +541,15 @@ spec:
- # ...
{{< /highlight >}}
-##### Especificar al nivel de clúster
+#####Especifica a nivel de clúster {#specify-at-the-cluster-level}
-Si no activas la instrumentación automática para pods específicos utilizando anotaciones, puedes especificar qué lenguajes instrumentar en todo el clúster utilizando la configuración de SSI. Cuando se configura `apm.instrumentation.libVersions`, solo se instrumentan las aplicaciones escritas en los lenguajes especificados, utilizando las versiones de biblioteca especificadas.
+Si no habilitas la instrumentación automática para pods específicos utilizando anotaciones, puedes especificar qué lenguajes instrumentar en todo el clúster utilizando la configuración de SSI. Cuando `apm.instrumentation.libVersions` está configurado, solo se instrumentan las aplicaciones escritas en los lenguajes especificados, utilizando las versiones de biblioteca especificadas.
-El archivo que tienes que configurar depende de si has habilitado la instrumentación de un solo paso con el Datadog Operator o con Helm:
+El archivo que necesitas configurar depende de si habilitaste la Instrumentación de Paso Único con Datadog Operator o Helm:
{{< collapse-content title="Datadog Operator" level="h5" >}}
-Por ejemplo, para instrumentar aplicaciones .NET, Python, y Node.js añade la siguiente configuración a tu archivo `datadog-agent.yaml`:
+Por ejemplo, para instrumentar aplicaciones de .NET, Python y Node.js, agrega la siguiente configuración a tu archivo `datadog-agent.yaml`:
{{< highlight yaml "hl_lines=5-8" >}}
features:
@@ -473,7 +566,7 @@ Por ejemplo, para instrumentar aplicaciones .NET, Python, y Node.js añade la si
{{< collapse-content title="Helm" level="h5" >}}
-Por ejemplo, para instrumentar aplicaciones .NET, Python, y Node.js añade la siguiente configuración a tu archivo `datadog-values.yaml`:
+Por ejemplo, para instrumentar aplicaciones de .NET, Python y Node.js, agrega la siguiente configuración a tu archivo `datadog-values.yaml`:
{{< highlight yaml "hl_lines=5-8" >}}
datadog:
@@ -500,11 +593,11 @@ Por ejemplo, para instrumentar aplicaciones .NET, Python, y Node.js añade la si
{{% /tab %}}
{{< /tabs >}}
-### Cambiar el registro de imágenes predeterminado
+### Cambiar el registro de imágenes predeterminado {#change-the-default-image-registry}
Datadog publica imágenes de bibliotecas de instrumentación en gcr.io, Docker Hub y Amazon ECR:
-| Lenguaje | gcr.io | hub.docker.com | gallery.ecr.aws |
+| Idioma | gcr.io | hub.docker.com | gallery.ecr.aws |
|------------|-------------------------------------|---------------------------------------------|-------------------------------------------|
| Java | [gcr.io/datadoghq/dd-lib-java-init][15] | [hub.docker.com/r/datadog/dd-lib-java-init][16] | [gallery.ecr.aws/datadog/dd-lib-java-init][17] |
| Node.js | [gcr.io/datadoghq/dd-lib-js-init][18] | [hub.docker.com/r/datadog/dd-lib-js-init][19] | [gallery.ecr.aws/datadog/dd-lib-js-init][20] |
@@ -513,21 +606,21 @@ Datadog publica imágenes de bibliotecas de instrumentación en gcr.io, Docker H
| Ruby | [gcr.io/datadoghq/dd-lib-ruby-init][27] | [hub.docker.com/r/datadog/dd-lib-ruby-init][28] | [gallery.ecr.aws/datadog/dd-lib-ruby-init][29] |
| PHP | [gcr.io/datadoghq/dd-lib-php-init][30] | [hub.docker.com/r/datadog/dd-lib-php-init][31] | [gallery.ecr.aws/datadog/dd-lib-php-init][32] |
-La variable de entorno `DD_ADMISSION_CONTROLLER_AUTO_INSTRUMENTATION_CONTAINER_REGISTRY` en la configuración del Datadog Agent del clúster especifica el registro utilizado por el controlador de admisión. El valor predeterminado es `gcr.io/datadoghq`.
+La `DD_ADMISSION_CONTROLLER_AUTO_INSTRUMENTATION_CONTAINER_REGISTRY` variable de entorno en la configuración del Agente de Clúster de Datadog especifica el registro utilizado por el Controlador de Admisión. El valor predeterminado es `gcr.io/datadoghq`.
-Puedes extraer la biblioteca de rastreo de un registro diferente cambiándolo por `docker.io/datadog`, `public.ecr.aws/datadog` u otra URL, si alojas las imágenes en un registro de contenedores local.
+Puede obtener el SDK de un registro diferente cambiándolo a `docker.io/datadog`, `public.ecr.aws/datadog` o a otra URL si está alojando las imágenes en un registro de contenedor local.
-Para obtener instrucciones sobre cómo cambiar el registro de contenedores, consulta [Cómo cambiar el registro de contenedores][33].
+Para obtener instrucciones sobre cómo cambiar su registro de contenedor, consulte [Cambiando su registro de contenedor][33].
-### Utilizar un registro privado de contenedores
+### Utilice un registro de contenedor privado {#use-a-private-container-registry}
-Si tu organización no permite extracciones directas de registros públicos (como `gcr.io`, `docker.io` o `public.ecr.aws`), puedes alojar internamente las imágenes necesarias de Datadog y configurar el controlador de admisión para que las utilice.
+Si su organización no permite descargas directas de registros públicos (como `gcr.io`, `docker.io` o `public.ecr.aws`), puede alojar las imágenes requeridas de Datadog internamente y configurar el Controlador de Admisión para usarlas.
-Para utilizar SSI con un registro privado de contenedores:
+Para usar SSI con un registro de contenedor privado:
-1. Sigue [estas instrucciones][34] para replicar las imágenes del contenedor de Datadog en tu registro privado.
+1. Siga [estas instrucciones][34] para reflejar las imágenes de contenedor de Datadog en su registro privado.
- Solo necesitas las imágenes para los lenguajes que estás instrumentando. Si no estás seguro de cuáles necesitas, esta es una referencia que cubre la mayoría de los cases (incidencias) de uso:
+ Solo necesita las imágenes para los lenguajes que está instrumentando. Si no está seguro de cuáles necesita, aquí hay una línea base que cubre la mayoría de los casos de uso:
- `apm-inject`
- `dd-lib-java-init`
@@ -537,15 +630,15 @@ Para utilizar SSI con un registro privado de contenedores:
- `dd-lib-ruby-init`
- `dd-lib-js-init`
- Puedes encontrar estas imágenes en [gcr.io][12], [Docker Hub][13] o [Amazon ECR Public Gallery][14].
+ Puede encontrar estas imágenes en [gcr.io][12], [Docker Hub][13] o [Amazon ECR Public Gallery][14].
-2. Etiqueta las imágenes según tu configuración.
+2. Etiquete las imágenes según su configuración.
- Las versiones que reflejes deben coincidir con las versiones configuradas en tus cargas de trabajo, que pueden establecerse de una de las siguientes maneras:
- - globalmente en la configuración del Agent con `ddTraceVersions` o
- - por cada pod mediante anotaciones como `admission.datadoghq.com/java-lib.version`.
+ Las versiones que refleje deben coincidir con las versiones configuradas en sus cargas de trabajo, que pueden establecerse de las siguientes opciones:
+ - globalmente en la configuración del Agente usando `ddTraceVersions`, o
+ - por pod usando anotaciones como `admission.datadoghq.com/java-lib.version`.
- Si no se configuras explícitamente ninguna versión, se utiliza la versión predeterminada (`0`).
+ Si no se configura explícitamente una versión, se utiliza la versión predeterminada (`0`).
Por ejemplo:
@@ -560,21 +653,21 @@ Para utilizar SSI con un registro privado de contenedores:
python: "3"
```
- Esta configuración requiere las siguientes tags (etiquetas) de imagen:
+ Esta configuración requiere las siguientes etiquetas de imagen:
- `apm-inject:0`
- `dd-lib-java-init:1`
- `dd-lib-python-init:3`
-3. Actualiza la configuración del Agent del clúster para utilizar tu registro privado.
+3. Actualice la configuración del Agente del Clúster para usar su registro privado.
- Configure la variable de entorno `DD_ADMISSION_CONTROLLER_AUTO_INSTRUMENTATION_CONTAINER_REGISTRY` en tu configuración del Agent del clúster para utilizar tu registro privado.
+ Establezca la variable de entorno `DD_ADMISSION_CONTROLLER_AUTO_INSTRUMENTATION_CONTAINER_REGISTRY` en la configuración de su Agente del Clúster para usar su registro privado.
-Para obtener más detalles sobre cómo cambiar el registro de contenedores, consulta [Cómo cambiar el registro de contenedores][33].
+Para más detalles sobre cómo cambiar su registro de contenedor, consulte [Cambiar su registro de contenedor][33].
-### Uso de una interfaz de red de contenedores en EKS
+### Usando una Interfaz de Red de Contenedores en EKS {#using-a-container-network-interface-on-eks}
-Cuando se utiliza un CNI como Calico, los nodos del plano de control no pueden iniciar connections (conexiones) de red con el controlador de admisión de Datadog e informan de un error "Dirección no admitida".
-Para utilizar la instrumentación de un solo step (UI) / paso (generic), modifica el Agent del clúster de Datadog con el parámetro `useHostNetwork: true`.
+Al usar un CNI como Calico, los nodos del plano de control no pueden iniciar conexiones de red al Controlador de Admisión de Datadog y reportan un error de "Dirección no permitida".
+Para usar la instrumentación de Paso Único, modifique el Agente del Clúster de Datadog con el parámetro `useHostNetwork: true`.
```
datadog:
@@ -587,25 +680,25 @@ clusterAgent:
...
```
-## Eliminación de la instrumentación de un solo step (UI) / paso (generic) de APM desde tu Agent
+## Elimine la instrumentación de APM de Paso Único de su Agente {#remove-single-step-apm-instrumentation-from-your-agent}
-Si no deseas recopilar datos de trazas de un determinado servicio, host, máquina virtual o contenedor, sigue los pasos que se indican a continuación:
+Si no desea recopilar datos de trazas para un servicio, host, VM o contenedor en particular, complete los siguientes pasos:
-### Eliminación de la instrumentación en servicios específicos
+### Elimine la instrumentación para servicios específicos {#remove-instrumentation-for-specific-services}
-Para eliminar la instrumentación de APM y dejar de enviar traces (trazas) desde un servicio específico, puedes realizar una de las siguientes acciones:
+Para eliminar la instrumentación de APM y dejar de enviar trazas de un servicio específico, puede hacer una de las siguientes acciones:
-#### Utilizar la selección de la carga de trabajo (recomendado)
+#### Utilice reglas de instrumentación para dirigir cargas de trabajo específicas (recomendado) {#use-instrumentation-rules-to-target-specific-workloads-recommended}
-Con la selección de la carga de trabajo (disponible para el Agent v7.64+), puedes activar y desactivar el rastreo para aplicaciones específicas. [Consulta los detalles de configuración aquí](#advanced-options).
+Con las reglas de instrumentación (disponibles para el Agente v7.64+), puede habilitar y deshabilitar el trazado para aplicaciones específicas. [ Consulte los detalles de configuración aquí](#advanced-options).
-#### Utilizar el controlador de admisión de Datadog
+#### Utilice el Controlador de Admisión de Datadog {#use-the-datadog-admission-controller}
-Como alternativa o para una versión del agente que no admita la selección de cargas de trabajo, también puedes desactivar la mutación de pods añadiendo una etiqueta a tu pod.
+Como alternativa, o para una versión del agente que no soporte reglas de instrumentación, también puede deshabilitar la mutación de pods agregando una etiqueta a su pod.
-
Además de desactivar SSI, los siguientes steps (UI) / pasos (generic) desactivan otros webhooks mutantes. Utilízalos con cuidado.
+
Además de deshabilitar SSI, los siguientes pasos deshabilitan otros webhooks de mutación. Utilice con precaución.
-1. Establece la etiqueta `admission.datadoghq.com/enabled:` en `"false"` para la especificación del pod:
+1. Establezca la etiqueta `admission.datadoghq.com/enabled:` en `"false"` para la especificación del pod:
```yaml
spec:
template:
@@ -613,22 +706,22 @@ Como alternativa o para una versión del agente que no admita la selección de c
labels:
admission.datadoghq.com/enabled: "false"
```
-2. Aplica la configuración:
+2. Aplique la configuración:
```shell
kubectl apply -f /path/to/your/deployment.yaml
```
-3. Reinicia los servicios de los que quieres eliminar la instrumentación.
+3. Reinicie los servicios para los que desee eliminar la instrumentación.
-### Eliminar APM para todos los servicios de la infraestructura
+### Elimine APM para todos los servicios en la infraestructura {#remove-apm-for-all-services-on-the-infrastructure}
-Para dejar de producir trazas, desinstala APM y reinicia la infraestructura:
+Para dejar de producir trazas, desinstale APM y reinicie la infraestructura:
-El archivo que tienes que configurar depende de si has habilitado la instrumentación de un solo paso con el Datadog Operator o con Helm:
+El archivo que necesita configurar depende de si habilitó la Instrumentación de Paso Único con Datadog Operator o Helm:
{{< tabs >}}
{{% tab "Datadog Operator" %}}
-1. Configura `instrumentation.enabled=false` en `datadog-agent.yaml`:
+1. Establezca `instrumentation.enabled=false` en `datadog-agent.yaml`:
```yaml
features:
apm:
@@ -636,7 +729,7 @@ El archivo que tienes que configurar depende de si has habilitado la instrumenta
enabled: false
```
-2. Despliega el Datadog Agent con el archivo de configuración actualizado:
+2. Despliegue el Datadog Agent con el archivo de configuración actualizado:
```shell
kubectl apply -f /path/to/your/datadog-agent.yaml
```
@@ -644,7 +737,7 @@ El archivo que tienes que configurar depende de si has habilitado la instrumenta
{{% tab "Helm" %}}
-1. Configura `instrumentation.enabled=false` en `datadog-values.yaml`:
+1. Establezca `instrumentation.enabled=false` en `datadog-values.yaml`:
```yaml
datadog:
apm:
@@ -652,30 +745,30 @@ El archivo que tienes que configurar depende de si has habilitado la instrumenta
enabled: false
```
-2. Ejecuta el siguiente comando:
+2. Ejecute el siguiente comando:
```shell
helm upgrade datadog-agent -f datadog-values.yaml datadog/datadog
```
{{% /tab %}}
{{< /tabs >}}
-## Prácticas recomendadas
+## Mejores prácticas {#best-practices}
-Tras activar SSI, todos los procesos compatibles del clúster se instrumentan automáticamente y comienzan a producir traces (trazas) en cuestión de minutos.
+Después de habilitar SSI, todos los procesos soportados en el clúster son instrumentados automáticamente y comienzan a producir trazas en minutos.
-Para controlar dónde se activa APM y reducir la sobrecarga, ten en cuenta las siguientes prácticas recomendadas.
+Para controlar dónde se activa APM y reducir la sobrecarga, considere las siguientes mejores prácticas.
-{{% collapse-content title="Use opt-in labels for controlled APM rollout" level="h3" expanded=false id="id-for-anchoring" %}}
+{{% collapse-content title="Utilice etiquetas de opt-in para un despliegue controlado de APM" level="h3" expanded=false id="id-for-anchoring" %}}
-#### Instrumentación predeterminada frente a instrumentación opcional
-| Modo | Comportamiento | Cuándo utilizarla |
+#### Instrumentación por defecto vs. opt-in {#default-vs-opt-in-instrumentation}
+| Modo | Comportamiento | Cuándo usar |
| --- | ----------- | ----------- |
-| Valor predeterminado | Todos los procesos compatibles del clúster están instrumentados. | Pequeños clústeres o prototipos. |
-| Optar por recibir | Utiliza la [selección de carga de trabajo][4] para restringir la instrumentación a espacios de nombres o pods específicos. | Clústeres de producción, lanzamientos escalonados o cases (incidencias) de uso sensibles a los costes. |
+| Por defecto | Todos los procesos soportados en el clúster son instrumentados. | Clústeres pequeños o prototipos. |
+| Opt-in | Utilice [reglas de instrumentación][4] para restringir la instrumentación a espacios de nombres o pods específicos. | Clústeres de producción, despliegues escalonados o casos de uso sensibles al costo. |
-#### Ejemplo: Activación de la instrumentación para pods específicos
+#### Ejemplo: Habilite la instrumentación para pods específicos {#example-enable-instrumentation-for-specific-pods}
-1. Añade una etiqueta significativa (por ejemplo, `datadoghq.com/apm-instrumentation: "enabled"`) tanto a los metadatos de despliegue como a la plantilla del pod.
+1. Agregue una etiqueta significativa (por ejemplo, `datadoghq.com/apm-instrumentation: "enabled"`) tanto a los metadatos de despliegue como a la plantilla del pod.
```
apiVersion: apps/v1
@@ -707,7 +800,7 @@ Para controlar dónde se activa APM y reducir la sobrecarga, ten en cuenta las s
- containerPort: 8080
```
-2. En tu configuración de Helm del Datadog Agent, activa SSI y utiliza `podSelector` para la inserción solo en pods con la etiqueta opt-in correspondiente.
+2. En la configuración de Helm de su Datadog Agent, habilite SSI y utilice `podSelector` para inyectar solo en pods con la etiqueta de opt-in correspondiente.
```
apm:
@@ -720,18 +813,18 @@ Para controlar dónde se activa APM y reducir la sobrecarga, ten en cuenta las s
datadoghq.com/apm-instrumentation: "enabled"
```
-Para obtener más ejemplos, consulta [selección de cargas de trabajo][4].
+Consulte [reglas de instrumentación][4] para ejemplos adicionales.
{{% /collapse-content %}}
-{{% collapse-content title="Control which APM SDKs are loaded" level="h3" expanded=false id="id-for-anchoring" %}}
+{{% collapse-content title="Controle qué SDKs de Datadog se cargan" level="h3" expanded=false id="id-for-anchoring" %}}
-Utiliza `ddTraceVersions` en tu configuración del Agent de Helm para controlar el lenguaje y la versión del kit de desarrollo de software (SDK) de APM. Esto evita que se descarguen kits de desarrollo de software (SDK) innecesarios, lo que minimiza la huella del contendor de inicialización, reduce el tamaño de la imagen y permite actualizaciones más deliberadas del rastreador (por ejemplo, para cumplir con los requisitos de conformidad o simplificar la depuración).
+Utilice `ddTraceVersions` en la configuración de Helm de su Datadog Agent para controlar tanto el idioma como la versión del SDK de Datadog. Esto evita que se descarguen SDKs innecesarios, lo que minimiza la huella del contenedor de inicialización, reduce el tamaño de la imagen y permite actualizaciones de trazadores más deliberadas (por ejemplo, para cumplir con requisitos de cumplimiento o simplificar la depuración).
-#### Ejemplo: Especificar un kit de desarrollo de software (SDK) de APM de Java para un espacio de nombres
+#### Ejemplo: Especifique un SDK de Java para un espacio de nombres {#example-specify-a-java-sdk-for-a-namespace}
-En el espacio de nombres `login-service` solo se ejecutan aplicaciones de Java. Para evitar la descarga de otros kit de desarrollo de software (SDK), configura el Agent para que se dirija a ese espacio de nombres e inserte únicamente la versión 1.48.2 del kit de desarrollo de software (SDK) de Java.
+Solo las aplicaciones de Java se ejecutan en el espacio de nombres `login-service`. Para evitar la descarga de otros SDKs, configura el agente para que apunte a ese espacio de nombres e inyecte solo la versión 1.48.2 del SDK de Java.
```
@@ -743,9 +836,9 @@ targets:
java: "1.48.2" # pin version
```
-#### Configuración predeterminada
+#### Configuración predeterminada {#default-configuration}
-Si un pod no coincide con ninguna regla de `ddTraceVersions`, se aplica el objetivo predeterminado.
+Si un pod no coincide con ninguna regla `ddTraceVersions`, se aplica el objetivo predeterminado.
```
targets:
@@ -760,11 +853,11 @@ targets:
{{% /collapse-content %}}
-## Solucionar problemas
+## Solución de problemas {#troubleshooting}
-Si tienes problemas para activar APM con SSI, consulta la [Guía de resolución de problemas de SSI][35].
+Si encuentras problemas al habilitar APM con SSI, consulta la [guía de solución de problemas de SSI][35].
-## Referencias adicionales
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -800,6 +893,5 @@ Si tienes problemas para activar APM con SSI, consulta la [Guía de resolución
[34]: /es/containers/guide/sync_container_images/#copy-an-image-to-another-registry-using-crane
[35]: /es/tracing/trace_collection/automatic_instrumentation/single-step-apm/troubleshooting
[36]: /es/tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility/
-[37]: /es/profiler/
-[38]: /es/security/application_security/
-[39]: /es/tracing/trace_pipeline/ingestion_controls/
\ No newline at end of file
+[37]: /es/containers/kubernetes/csi_driver/
+[41]: /es/tracing/guide/injectors/
\ No newline at end of file
diff --git a/content/es/tracing/trace_pipeline/ingestion_mechanisms.md b/content/es/tracing/trace_pipeline/ingestion_mechanisms.md
index adb81255039..9ae2052d7b2 100644
--- a/content/es/tracing/trace_pipeline/ingestion_mechanisms.md
+++ b/content/es/tracing/trace_pipeline/ingestion_mechanisms.md
@@ -1,58 +1,61 @@
---
aliases:
- /es/tracing/trace_ingestion/mechanisms
-description: Descripción general de los mecanismos en el trazador y el agente que
- controlan la ingestión de trazas.
+description: Descripción general de los mecanismos en el SDK y el Agente que controlan
+ la ingestión de trazas.
further_reading:
- link: /tracing/trace_pipeline/ingestion_controls/
- tag: Documentation
- text: Ingestion Control
+ tag: Documentación
+ text: Controles de Ingestión
- link: /tracing/trace_pipeline/trace_retention/
- tag: Documentation
- text: Retención de trazas
+ tag: Documentación
+ text: Retención de Trazas
- link: /tracing/trace_pipeline/metrics/
- tag: Documentation
- text: Métricas de uso
+ tag: Documentación
+ text: Métricas de Uso
- link: https://www.datadoghq.com/blog/zendesk-cost-optimization/#improving-tracing-efficiency-through-targeted-changes
tag: Blog
text: 'Optimizando Datadog a gran escala: Observabilidad rentable en Zendesk'
+- link: https://learn.datadoghq.com/courses/apm-rate-limit-retention
+ tag: Centro de Aprendizaje
+ text: Limitación de Tasa de APM y Retención
title: Mecanismos de Ingestión
---
{{< img src="tracing/apm_lifecycle/ingestion_sampling_rules.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Reglas de Muestreo de Ingestión" >}}
-Múltiples mecanismos son responsables de elegir si los tramos generados por sus aplicaciones son enviados a Datadog (_ingresados_). La lógica detrás de estos mecanismos radica en las [bibliotecas de trazado][1] y en el Agente de Datadog. Dependiendo de la configuración, todo o parte del tráfico generado por los servicios instrumentados es ingresado.
+Múltiples mecanismos determinan si los tramos generados por sus aplicaciones son enviados a Datadog (_ingresados_). La lógica detrás de estos mecanismos está en los [SDKs][1] y en el Agente de Datadog. Dependiendo de la configuración, todo o parte del tráfico generado por los servicios instrumentados es ingerido.
-A cada tramo ingresado se le adjunta una única **razón de ingestión** que se refiere a uno de los mecanismos descritos en esta página. [Métricas de uso][2] `datadog.estimated_usage.apm.ingested_bytes` y `datadog.estimated_usage.apm.ingested_spans` están etiquetadas por `ingestion_reason`.
+Cada tramo ingresado tiene una razón de **ingestión** única que se refiere a uno de los mecanismos descritos en esta página. Las [métricas de uso][2] `datadog.estimated_usage.apm.ingested_bytes` y `datadog.estimated_usage.apm.ingested_spans` están etiquetadas por `ingestion_reason`.
-Utilice el [tablero de razones de ingestión][3] para investigar en contexto cada una de estas razones de ingestión. Obtenga una descripción general del volumen atribuido a cada mecanismo, para saber rápidamente en qué opciones de configuración centrarse.
+Utilice el [tablero de Razones de Ingestión][3] para investigar cada razón de ingestión en contexto e identificar en qué opciones de configuración enfocarse.
-## Muestreo basado en la cabeza
+## Muestreo basado en cabeza {#head-based-sampling}
-El mecanismo de muestreo predeterminado se llama _muestreo basado en la cabeza_. La decisión de mantener o descartar una traza se toma al principio de la traza, al inicio del [tramo raíz][4]. Esta decisión se propaga a otros servicios como parte de su contexto de solicitud, por ejemplo, como un encabezado de solicitud HTTP.
+El mecanismo de muestreo predeterminado se llama _muestreo basado en cabeza_. La decisión de mantener o eliminar una traza se toma al inicio del [root span][4] y luego se propaga a otros servicios como parte de su contexto de solicitud (por ejemplo, como un encabezado de solicitud HTTP).
-Debido a que la decisión se toma al principio de la traza y luego se transmite a todas las partes de la traza, se garantiza que la traza se mantenga o se descarte en su totalidad.
+Debido a que la decisión se toma al principio de la traza y se comunica a todas las partes, la traza se mantiene o se elimina en su totalidad.
-{{< img src="/tracing/guide/ingestion_sampling_use_cases/head-based-sampling.png" alt="Muestreo basado en la cabeza" style="width:100%;" >}}
+{{< img src="/tracing/guide/ingestion_sampling_use_cases/head-based-sampling.png" alt="Muestreo basado en cabecera" style="width:100%;" >}}
-Puede establecer tasas de muestreo para el muestreo basado en la cabeza en dos lugares:
-- A nivel de **[Agente](#in-the-agent)** (predeterminado)
-- A nivel de **[biblioteca de trazado](#in-tracing-libraries-user-defined-rules)**: cualquier mecanismo de biblioteca de trazado anula la configuración del Agente.
+Puede establecer tasas de muestreo para el muestreo basado en cabecera en dos lugares:
+- En el nivel de **[Agente](#in-the-agent)** (predeterminado)
+- En el nivel de **[SDK](#in-sdks-user-defined-rules)**: cualquier mecanismo de SDK anula la configuración del Agente.
-### En el Agente
+### En el Agente {#in-the-agent}
`ingestion_reason: auto`
-El Agente de Datadog envía continuamente tasas de muestreo a las bibliotecas de trazado para aplicar en la raíz de las trazas. El Agente ajusta las tasas para lograr un objetivo de diez trazas por segundo en total, distribuidas a los servicios dependiendo del tráfico.
+El Agente de Datadog envía continuamente tasas de muestreo a los SDK para aplicar en la raíz de las trazas. El Agente ajusta las tasas para lograr un objetivo de diez trazas por segundo en total, distribuidas a los servicios dependiendo del tráfico.
Por ejemplo, si el servicio `A` tiene más tráfico que el servicio `B`, el Agente podría variar la tasa de muestreo para `A` de tal manera que `A` no mantenga más de siete trazas por segundo, y ajustar de manera similar la tasa de muestreo para `B` de tal manera que `B` no mantenga más de tres trazas por segundo, para un total de 10 trazas por segundo.
-#### Configuración remota
+#### Configuración remota {#remote-configuration}
-La configuración de la tasa de muestreo en el Agente se puede configurar de forma remota si estás utilizando la versión del Agente [7.42.0][20] o superior. Para comenzar, configura [Remote Configuration][21] y luego configura el parámetro `ingestion_reason` desde la [Ingestion Control page][5]. Remote Configuration te permite cambiar el parámetro sin tener que reiniciar el Agent. La configuración establecida de forma remota tiene prioridad sobre las configuraciones locales, incluidas las variables de entorno y configuraciones de `datadog.yaml`.
+La configuración de la tasa de muestreo en el Agente se puede configurar de forma remota si está utilizando la versión del Agente [7.42.0][20] o superior. Para comenzar, configure [Remote Configuration][21] y luego configure el `ingestion_reason` parámetro desde la [página de Ingestion Control][5]. Remote Configuration le permite cambiar el parámetro sin reiniciar el Agent. La Remote Configuration tiene prioridad sobre las configuraciones locales, incluidas las variables de entorno y la configuración de `datadog.yaml`.
-#### Configuración local
+#### Configuración local {#local-configuration}
-Establece el objetivo de trazas por segundo del Agent en su archivo de configuración principal (`datadog.yaml`) o como una variable de entorno:
+Establezca las trazas por segundo del Agent en su archivo de configuración principal (`datadog.yaml`) o como una variable de entorno:
```
@param target_traces_per_second - integer - optional - default: 10
@@ -60,17 +63,17 @@ Establece el objetivo de trazas por segundo del Agent en su archivo de configura
```
**Notas**:
-- La tasa de muestreo de trazos por segundo establecida en el Agente solo se aplica a las bibliotecas de trazado de Datadog. No tiene efecto en otras bibliotecas de trazado como los SDK de OpenTelemetry.
+- La tasa de muestreo de trazas por segundo establecida en el Agent solo se aplica a los SDK de Datadog. No tiene efecto en otros SDK como los SDK de OpenTelemetry.
- El objetivo no es un valor fijo. En realidad, fluctúa dependiendo de los picos de tráfico y otros factores.
-Todos los tramos de una traza muestreada utilizando el Datadog Agent [tasas de muestreo calculadas automáticamente](#in-the-agent) están etiquetados con la razón de ingestión `auto`. La etiqueta `ingestion_reason` también se establece en [métricas de uso][2]. Los servicios que utilizan el mecanismo predeterminado del Agent de Datadog están etiquetados como `Automatic` en la columna de Configuración de la [Ingestion Control Page][5].
+Los spans de las trazas muestreadas por las [tasas de muestreo automáticas](#in-the-agent) del Datadog Agent están etiquetados con la razón de ingestión `auto`. La etiqueta `ingestion_reason` también se establece en [métricas de uso][2]. Los servicios que utilizan este mecanismo predeterminado están etiquetados como `Automatic` en la columna de Configuración de la [Ingestion Control Page][5].
-### En bibliotecas de trazado: reglas definidas por el usuario
+### En SDKs: reglas definidas por el usuario {#in-sdks-user-defined-rules}
`ingestion_reason: rule`
-Para un control más granular, utilice las opciones de configuración de muestreo de la biblioteca de trazado:
-- Establezca una **tasa de muestreo específica** que se aplique a la raíz del trazado, por servicio y/o nombre de recurso, sobreescribiendo el [mecanismo predeterminado](#in-the-agent) del Agente.
-- Establece un **límite de tasa** en el número de trazas ingresadas por segundo. El límite de tasa predeterminado es de 100 trazas por segundo por instancia de servicio (cuando se utiliza el [mecanismo predeterminado](#in-the-agent) del Agente, se ignora el limitador de tasa).
+Para un control más granular, utilice las opciones de configuración de muestreo del SDK:
+- Establezca una **tasa de muestreo específica que se aplique a la raíz de la traza** por nombre de servicio o recurso, sobrescribiendo el [mecanismo predeterminado](#in-the-agent) del Agente.
+- Establezca un **límite de tasa** en el número de trazas ingeridas por segundo. El límite de tasa predeterminado es de 100 trazas por segundo por instancia de servicio. Al utilizar el [mecanismo predeterminado](#in-the-agent) del Agent, se ignora el limitador de tasa.
**Nota**: Las reglas de muestreo también son controles de muestreo basados en la cabeza. Si el tráfico para un servicio es mayor que el máximo configurado de trazas por segundo, entonces las trazas se descartan en la raíz. No crea trazas incompletas.
@@ -78,19 +81,19 @@ La configuración se puede establecer mediante variables de entorno o directamen
{{< tabs >}}
{{% tab "Java" %}}
-**Remote Configuration**
+**Configuración remota**
-A partir de la versión 1.34.0, para aplicaciones Java, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
+A partir de la versión 1.34.0, para aplicaciones Java, establezca las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
Lea más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en la [guía de muestreo basado en recursos][1].
-**Nota**: La configuración remota tiene prioridad sobre la configuración local.
+**Nota**: La configuración establecida de forma remota tiene prioridad sobre la configuración local.
**Configuración local**
-Para aplicaciones Java, configure las tasas de muestreo por servicio y por recurso (a partir de la versión [v1.26.0][3] para muestreo basado en recursos) con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
+Para aplicaciones Java, establezca las tasas de muestreo por servicio y por recurso (a partir de la versión [v1.26.0][3] para muestreo basado en recursos) con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
-Por ejemplo, para capturar el 100% de las trazas para el recurso `GET /checkout` del servicio `my-service`, y el 20% de las trazas de otros puntos de conexión, configure:
+Por ejemplo, para capturar el 100% de las trazas para el recurso `GET /checkout` del servicio `my-service`, y el 20% de las trazas de otros puntos de conexión, establezca:
```
# using system property
@@ -100,57 +103,57 @@ java -Ddd.trace.sampling.rules='[{"service": "my-service", "resource": "GET /che
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource":"GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'
```
-El valor del nombre del servicio es sensible a mayúsculas y debe coincidir con el caso del nombre real del servicio.
+El valor del nombre del servicio es sensible a mayúsculas y minúsculas y debe coincidir con el caso del nombre real del servicio.
-Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` a un número de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
+Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` al máximo de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
-**Nota**: El uso de `DD_TRACE_SAMPLE_RATE` está en desuso. Utilice `DD_TRACE_SAMPLING_RULES` en su lugar. Por ejemplo, si ya configuró `DD_TRACE_SAMPLE_RATE` a `0.1`, configure `DD_TRACE_SAMPLING_RULES` a `[{"sample_rate":0.1}]` en su lugar.
+**Nota**: El uso de `DD_TRACE_SAMPLE_RATE` está en desuso. Utilice `DD_TRACE_SAMPLING_RULES` en su lugar. Por ejemplo, si ya estableció `DD_TRACE_SAMPLE_RATE` a `0.1`, establezca `DD_TRACE_SAMPLING_RULES` a `[{"sample_rate":0.1}]` en su lugar.
-Lea más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de Java][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Java][2].
[1]: /es/tracing/guide/resource_based_sampling
[2]: /es/tracing/trace_collection/dd_libraries/java
[3]: https://github.com/DataDog/dd-trace-java/releases/tag/v1.26.0
{{% /tab %}}
{{% tab "Python" %}}
-**Remote Configuration**
+**Configuración remota**
-A partir de la versión 2.9.0, para aplicaciones Python, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
+A partir de la versión 2.9.0, para aplicaciones de Python, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Página de Control de Ingesta.
Lea más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en la [guía de muestreo basado en recursos][3].
-**Nota**: La configuración remota tiene prioridad sobre la configuración local.
+**Nota**: La configuración establecida de forma remota tiene prioridad sobre la configuración local.
**Configuración local**
-Para aplicaciones Python, configure las tasas de muestreo por servicio y por recurso (a partir de la versión [v2.8.0][1] para muestreo basado en recursos) con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
+Para aplicaciones de Python, configure las tasas de muestreo por servicio y por recurso (a partir de la versión [v2.8.0][1] para muestreo basado en recursos) con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
-Por ejemplo, para capturar el 100% de las trazas para el recurso `GET /checkout` del servicio `my-service`, y el 20% de las trazas de otros puntos de conexión, configure:
+Por ejemplo, para capturar el 100% de las trazas para el recurso `GET /checkout` del servicio `my-service`, y el 20% de las trazas de otros puntos de conexión, establezca:
```
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource": "GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'
```
-Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` a un número de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
+Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` al máximo de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
-**Nota**: El uso de `DD_TRACE_SAMPLE_RATE` está en desuso. Utilice `DD_TRACE_SAMPLING_RULES` en su lugar. Por ejemplo, si ya configuró `DD_TRACE_SAMPLE_RATE` a `0.1`, configure `DD_TRACE_SAMPLING_RULES` a `[{"sample_rate":0.1}]` en su lugar.
+**Nota**: El uso de `DD_TRACE_SAMPLE_RATE` está en desuso. Utilice `DD_TRACE_SAMPLING_RULES` en su lugar. Por ejemplo, si ya estableció `DD_TRACE_SAMPLE_RATE` a `0.1`, establezca `DD_TRACE_SAMPLING_RULES` a `[{"sample_rate":0.1}]` en su lugar.
-Lea más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de Python][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Python][2].
[1]: https://github.com/DataDog/dd-trace-py/releases/tag/v2.8.0
[2]: /es/tracing/trace_collection/dd_libraries/python
[3]: /es/tracing/guide/resource_based_sampling/
{{% /tab %}}
{{% tab "Ruby" %}}
-**Remote Configuration**
+**Configuración remota**
-A partir de la versión 2.0.0, para aplicaciones Ruby, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
+A partir de la versión 2.0.0, para aplicaciones de Ruby, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Página de Control de Ingesta.
Lea más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en la [guía de muestreo basado en recursos][1].
-**Nota**: La configuración remota tiene prioridad sobre la configuración local.
+**Nota**: La configuración establecida remotamente tiene prioridad sobre la configuración local.
**Configuración local**
-Para aplicaciones de Ruby, establece una tasa de muestreo global para la biblioteca utilizando la variable de entorno `DD_TRACE_SAMPLE_RATE`. Establece las tasas de muestreo por servicio con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
+Para aplicaciones de Ruby, configure una tasa de muestreo global para la biblioteca utilizando la variable de entorno `DD_TRACE_SAMPLE_RATE`. Configure las tasas de muestreo por servicio con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
Por ejemplo, para enviar el 50% de las trazas para el servicio llamado `my-service` y el 10% del resto de las trazas:
@@ -159,36 +162,36 @@ export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'
```
-Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` a un número de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
+Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` al máximo de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
-Lee más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de Ruby][1].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Ruby][1].
[1]: /es/tracing/trace_collection/dd_libraries/ruby#sampling
{{% /tab %}}
-{{% tab "Ve" %}}
-**Remote Configuration**
+{{% tab "Go" %}}
+**Configuración remota**
-A partir de la versión 1.64.0, para aplicaciones de Go, establezca las tasas de muestreo por servicio y por recurso desde la Ingestion Control Page UI.
+A partir de la versión 1.64.0, para aplicaciones de Go, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
-Lee más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en este [artículo][3].
+Lea más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en este [artículo][3].
-**Nota**: La configuración establecida de forma remota tiene prioridad sobre la configuración local.
+**Nota**: La configuración establecida remotamente tiene prioridad sobre la configuración local.
**Configuración local**
-Para aplicaciones de Go, establece las tasas de muestreo por servicio y por recurso (a partir de la versión [v1.60.0][2] para muestreo basado en recursos) con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
+Para aplicaciones de Go, configure las tasas de muestreo por servicio y por recurso (a partir de la versión [v1.60.0][2] para muestreo basado en recursos) con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
-Por ejemplo, para capturar el 100% de las trazas para el recurso `GET /checkout` del servicio `my-service`, y el 20% de las trazas de otros puntos de conexión, configure:
+Por ejemplo, para capturar el 100% de las trazas para el recurso `GET /checkout` del servicio `my-service`, y el 20% de las trazas de otros puntos de conexión, establezca:
```
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource": "GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'
```
-Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` a un número de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
+Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` al máximo de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
-**Nota**: El uso de `DD_TRACE_SAMPLE_RATE` está en desuso. Utilice `DD_TRACE_SAMPLING_RULES` en su lugar. Por ejemplo, si ya configuró `DD_TRACE_SAMPLE_RATE` a `0.1`, configure `DD_TRACE_SAMPLING_RULES` a `[{"sample_rate":0.1}]` en su lugar.
+**Nota**: El uso de `DD_TRACE_SAMPLE_RATE` está en desuso. Utilice `DD_TRACE_SAMPLING_RULES` en su lugar. Por ejemplo, si ya estableció `DD_TRACE_SAMPLE_RATE` a `0.1`, establezca `DD_TRACE_SAMPLING_RULES` a `[{"sample_rate":0.1}]` en su lugar.
-Lee más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de Go][1].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Go][1].
[1]: /es/tracing/trace_collection/dd_libraries/go
[2]: https://github.com/DataDog/dd-trace-go/releases/tag/v1.60.0
@@ -197,15 +200,15 @@ Lee más sobre los controles de muestreo en la [documentación de la biblioteca
{{% tab "Node.js" %}}
**Configuración remota**
-A partir de la versión 5.16.0, para aplicaciones de Node.js, establece las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Página de Control de Ingesta.
+A partir de la versión 5.16.0, para aplicaciones de Node.js, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
Lea más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en la [guía de muestreo basado en recursos][1].
-**Nota**: La configuración remota tiene prioridad sobre la configuración local.
+**Nota**: La configuración establecida remotamente tiene prioridad sobre la configuración local.
**Configuración local**
-Para aplicaciones de Node.js, establece una tasa de muestreo global en la biblioteca utilizando la variable de entorno `DD_TRACE_SAMPLE_RATE`.
+Para aplicaciones de Node.js, configure una tasa de muestreo global en la biblioteca utilizando la variable de entorno `DD_TRACE_SAMPLE_RATE`.
También puede establecer tasas de muestreo por servicio. Por ejemplo, para enviar el 50% de las trazas para el servicio llamado `my-service` y el 10% para el resto de las trazas:
@@ -222,44 +225,44 @@ tracer.init({
});
```
-Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` a un número de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
+Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` al máximo de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
-Lee más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de Node.js][1].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Node.js][1].
[1]: /es/tracing/trace_collection/dd_libraries/nodejs
{{% /tab %}}
{{% tab "PHP" %}}
**Configuración remota**
-A partir de la versión 1.4.0, para aplicaciones PHP, configure las tasas de muestreo por servicio y por recurso desde la Ingestion Control Page.
+A partir de la versión 1.4.0, para aplicaciones PHP, establezca las tasas de muestreo por servicio y por recurso desde la Ingestion Control Page.
Lea más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en la [guía de muestreo basado en recursos][1].
-**Nota**: La configuración establecida de forma remota tiene prioridad sobre la configuración local.
+**Nota**: La configuración establecida remotamente tiene prioridad sobre la configuración local.
**Configuración local**
-Para aplicaciones PHP, establezca una tasa de muestreo global para la biblioteca utilizando la `DD_TRACE_SAMPLE_RATE` variable de entorno. Establece las tasas de muestreo por servicio con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
+Para aplicaciones PHP, establezca una tasa de muestreo global para la biblioteca utilizando la variable de entorno `DD_TRACE_SAMPLE_RATE`. Configure las tasas de muestreo por servicio con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
-Por ejemplo, para enviar el 50% de las trazas para el servicio llamado `my-service`, el 20% de las trazas de otros puntos de conexión y el 10% para el resto de las trazas, configure:
+Por ejemplo, para enviar el 50% de las trazas para el servicio llamado `my-service`, el 20% de las trazas de otros puntos de conexión y el 10% para el resto de las trazas, establezca:
```
export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource":"GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'
```
-Lea más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de PHP][1].
+Lea más sobre los controles de muestreo en la [documentación del SDK de PHP][1].
[1]: /es/tracing/trace_collection/dd_libraries/php
{{% /tab %}}
{{% tab "C++" %}}
**Configuración remota**
-A partir de la versión 0.2.2, para aplicaciones C++, configure las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
+A partir de la versión 0.2.2, para aplicaciones C++, establezca las tasas de muestreo por servicio y por recurso desde la interfaz de usuario de la Ingestion Control Page.
Lea más sobre cómo configurar remotamente las tasas de muestreo por servicio y recurso en la [guía de muestreo basado en recursos][1].
-**Nota**: La configuración remota tiene prioridad sobre la configuración local.
+**Nota**: La configuración establecida remotamente tiene prioridad sobre la configuración local.
**Configuración local**
A partir de [v0.1.0][1], la biblioteca de C++ de Datadog admite las siguientes configuraciones:
@@ -274,13 +277,13 @@ export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'
```
-C++ no proporciona integraciones para instrumentación automática, pero se utiliza mediante el trazado por proxy como Envoy, Nginx o Istio. Lea más sobre cómo configurar el muestreo para proxies en [Tracing proxies][2].
+C++ no proporciona integraciones para instrumentación automática, pero se utiliza mediante el rastreo por proxy como Envoy, NGINX o Istio. Lea más sobre cómo configurar el muestreo para proxies en [Rastreo de proxies][2].
[1]: https://github.com/DataDog/dd-trace-cpp/releases/tag/v0.1.0
[2]: /es/tracing/trace_collection/proxy_setup
{{% /tab %}}
{{% tab ".NET" %}}
-Para aplicaciones .NET, establezca una tasa de muestreo global para la biblioteca utilizando la `DD_TRACE_SAMPLE_RATE` variable de entorno. Establezca las tasas de muestreo por servicio con la `DD_TRACE_SAMPLING_RULES` variable de entorno.
+Para aplicaciones .NET, configure una tasa de muestreo global para la biblioteca utilizando la variable de entorno `DD_TRACE_SAMPLE_RATE`. Para aplicaciones .NET, configure las tasas de muestreo por servicio con la variable de entorno `DD_TRACE_SAMPLING_RULES`.
Por ejemplo, para enviar el 50% de las trazas para el servicio llamado `my-service` y el 10% para el resto de las trazas:
@@ -296,78 +299,76 @@ $env:DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'
}
```
-
A partir de la versión 2.35.0, si Agent Remote Configuration está habilitada donde se ejecuta el servicio, puede establecer un DD_TRACE_SAMPLE_RATE por servicio en la interfaz de usuario del Software Catalog UI.
+
A partir de la versión 2.35.0, si Configuración Remota del Agente está habilitada donde se ejecuta el servicio, establezca un DD_TRACE_SAMPLE_RATE por servicio en la interfaz de usuario del Software Catalog.
-Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` a un número de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
+Configure un límite de tasa estableciendo la variable de entorno `DD_TRACE_RATE_LIMIT` al máximo de trazas por segundo por instancia de servicio. Si no se establece ningún valor `DD_TRACE_RATE_LIMIT`, se aplica un límite de 100 trazas por segundo.
-Lea más sobre los controles de muestreo en la [.NET tracing library documentation][1].\
-Lee más sobre [la configuración de variables de entorno para .NET][2].
+Lea más sobre los controles de muestreo en la [.NET SDK documentation][1].\
+Lea más sobre [configuración de variables de entorno para .NET][2].
[1]: /es/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core
[2]: /es/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core?tab=registryeditor#configuring-process-environment-variables
{{% /tab %}}
{{< /tabs >}}
-**Nota**: Todos los tramos de un rastro muestreado utilizando una configuración de biblioteca de trazado están etiquetados con la razón de ingestión `rule`. Los servicios configurados con reglas de muestreo definidas por el usuario están marcados como `Configured` en la columna Configuration de la [Ingestion Control Page][5].
+**Nota**: Todos los tramos de una traza muestreada utilizando una configuración de SDK están etiquetados con la razón de ingestión `rule`. Los servicios configurados con reglas de muestreo definidas por el usuario están marcados como `Configured` en la columna de Configuración de la [Ingestion Control Page][5].
-## Trazas de error y trazas raras
+## Errores y trazas raras {#error-and-rare-traces}
-Para las trazas que no son capturadas por el muestreo basado en la cabeza, dos mecanismos adicionales de muestreo del Agente de Datadog aseguran que las trazas críticas y diversas se mantengan e ingresen. Estos dos muestreadores mantienen un conjunto diverso de trazas locales (conjunto de tramos del mismo host) al capturar todas las combinaciones de un conjunto predeterminado de etiquetas:
+Para los trazos que no son capturados por el muestreo basado en la cabeza, dos mecanismos adicionales de muestreo del Agente de Datadog capturan trazos críticos y diversos que de otro modo serían descartados. Estos muestreadores mantienen un conjunto diverso de trazas locales (tramos del mismo servidor) al capturar todas las combinaciones de un conjunto predeterminado de etiquetas:
-- **Trazas de error**: Muestrear errores es importante para proporcionar visibilidad sobre posibles fallas del sistema.
-- **Trazas raras**: Muestrear trazas raras te permite mantener visibilidad sobre tu sistema en su totalidad, asegurando que los servicios y recursos de bajo tráfico aún sean monitoreados.
+- **Trazas de error**: El muestreo de errores proporciona visibilidad sobre posibles fallos del sistema.
+- **Trazas raras**: El muestreo de trazos raros mantiene visibilidad sobre servicios y recursos de bajo tráfico en tu sistema.
-**Nota**: Los muestreadores de errores y raras son ignorados para los servicios para los cuales estableciste [reglas de muestreo de biblioteca](#in-tracing-libraries-user-defined-rules).
+**Nota**: Los muestreadores de errores y raros son ignorados para los servicios para los cuales se han establecido [reglas de muestreo de biblioteca](#in-sdks-user-defined-rules).
-### Trazas de error
+### Trazas de error {#error-traces}
`ingestion_reason: error`
-El muestreador de errores captura partes de trazas que contienen tramos de error que no son capturados por el muestreo basado en la cabeza. Captura trazas de error hasta una tasa de 10 trazas por segundo (por Agente). Asegura una visibilidad completa sobre errores cuando la tasa de muestreo basada en la cabeza es baja.
+El muestreador de errores captura partes de trazas que contienen tramos de error no capturados por el muestreo basado en la cabeza, a una tasa de hasta 10 trazas por segundo por agente. Esto ayuda a mantener la visibilidad sobre los errores cuando la tasa de muestreo basada en la cabeza es baja.
-Con la versión 7.33 del Agente en adelante, puedes configurar el muestreador de errores en el archivo de configuración principal del Agente (`datadog.yaml`) o con variables de entorno:
+Con la versión 7.33 del Agente en adelante, configure el muestreador de errores en el archivo de configuración principal del Agente (`datadog.yaml`) o con variables de entorno:
```
@param errors_per_second - integer - optional - default: 10
@env DD_APM_ERROR_TPS - integer - optional - default: 10
```
-{{< img src="/tracing/guide/ingestion_sampling_use_cases/error-spans-sampling.png" alt="Muestreo de errores" style="width:100%;" >}}
+{{< img src="/tracing/guide/ingestion_sampling_use_cases/error-spans-sampling.png" alt="Muestreo de Errores" style="width:100%;" >}}
**Notas**:
-1. Establezca el parámetro en `0` para deshabilitar el muestreador de errores.
-2. El muestreador de errores captura trazas locales con tramos de error a nivel de Agente. Si la traza es distribuida, no hay garantía de que la traza completa se envíe a Datadog.
-3. Por defecto, las trazas descartadas por las reglas de la biblioteca de trazado o lógica personalizada como `manual.drop` están **excluidas** bajo el muestreador de errores.
-
-#### Datadog Agent 7.42.0 y superior
+1. Establece el parámetro en `0` para deshabilitar el muestreador de errores.
+2. El muestreador de errores captura trazas de errores locales a nivel del Agente. Si la traza es distribuida, la traza completa puede no ser enviada a Datadog.
+3. Por defecto, los tramos descartados por reglas del SDK o lógica personalizada como `manual.drop` están **excluidos** bajo el muestreador de errores.
-El muestreo de errores es configurable de forma remota si está utilizando la versión del Agente [7.42.0][20] o superior. Siga la [documentación][21] para habilitar la configuración remota en sus Agentes. Con la configuración remota, puede habilitar la recolección de tramos raros sin tener que reiniciar el Datadog Agent.
+#### Datadog Agent 7.42.0 y superior {#datadog-agent-7420-and-higher}
-#### Datadog Agent 6/7.41.0 y superior
+El muestreo de errores es configurable de forma remota si estás utilizando la versión del Agent [7.42.0][20] o superior. Sigue la [documentación][21] para habilitar la configuración remota en tus Agents. Con la configuración remota, puedes habilitar la recolección de tramos raros sin reiniciar el Agent de Datadog.
-Para anular el comportamiento predeterminado de modo que los tramos descartados por las reglas de la biblioteca de trazado o lógica personalizada como `manual.drop` estén **incluidos** por el muestreador de errores, habilite la función con: `DD_APM_FEATURES=error_rare_sample_tracer_drop` en el Datadog Agent (o el contenedor dedicado de Trace Agent dentro del pod de Datadog Agent en Kubernetes).
+#### Datadog Agent 6/7.41.0 y superior {#datadog-agent-67410-and-higher}
+Para anular el comportamiento predeterminado de manera que los tramos descartados por las reglas del SDK o lógica personalizada, como `manual.drop`, se incluyan **** por el muestreador de errores, habilita la función con: `DD_APM_FEATURES=error_rare_sample_tracer_drop` en el Datadog Agent (o en el contenedor dedicado del Trace Agent dentro del pod del Datadog Agent en Kubernetes).
-#### Datadog Agent 6/7.33 a 6/7.40.x
+#### Datadog Agent 6/7.33 a 6/7.40.x {#datadog-agent-6733-to-6740x}
-El comportamiento predeterminado del muestreo de errores no se puede cambiar para estas versiones de Agente. Actualice el Datadog Agent a Datadog Agent 6/7.41.0 y superior.
+El comportamiento predeterminado del muestreo de errores no puede ser cambiado para estas versiones del Agent. Actualiza el Datadog Agent a Datadog Agent 6/7.41.0 y superior.
-
-### Trazas raras
+### Trazas raras {#rare-traces}
`ingestion_reason: rare`
-El muestreador raro envía un conjunto de tramos raros a Datadog. Captura combinaciones de `env`, `service`, `name`, `resource`, `error.type` y `http.status` hasta 5 trazas por segundo (por Agente). Asegura visibilidad en recursos de bajo tráfico cuando la tasa de muestreo basada en la cabeza es baja.
+El muestreador raro envía un conjunto de tramos raros a Datadog. Captura combinaciones de `env`, `service`, `name`, `resource`, `error.type` y `http.status` a hasta 5 trazas por segundo por Agent. Esto ayuda a mantener la visibilidad en recursos de bajo tráfico cuando la tasa de muestreo basada en la cabeza es baja.
-**Nota**: El muestreador raro captura trazas locales a nivel de Agente. Si la traza está distribuida, no hay forma de garantizar que la traza completa se enviará a Datadog.
+**Nota**: El muestreador raro captura trazas locales a nivel de Agent. Si la traza está distribuida, no hay garantía de que la traza completa se envíe a Datadog.
-#### Datadog Agent 7.42.0 y superior
+#### Datadog Agent 7.42.0 y superior {#datadog-agent-7420-and-higher-1}
-La tasa de muestreo rara es configurable de forma remota si está utilizando la versión del Agente [7.42.0][20] o superior. Siga la [documentación][21] para habilitar la configuración remota en sus Agentes. Con la configuración remota, puede cambiar el valor del parámetro sin tener que reiniciar el Datadog Agent.
+El muestreo raro es configurable de forma remota si estás utilizando la versión del Agent [7.42.0][20] o superior. Sigue la [documentación][21] para habilitar la configuración remota en tus Agents. Con la configuración remota, puedes cambiar el valor del parámetro sin reiniciar el Datadog Agent.
-#### Datadog Agent 6/7.41.0 y superior
+#### Datadog Agent 6/7.41.0 y superior {#datadog-agent-67410-and-higher-1}
Por defecto, el muestreador raro **no está habilitado**.
-**Nota**: Cuando **está habilitado**, los tramos descartados por las reglas de la biblioteca de trazado o lógica personalizada como `manual.drop` son **excluidos** bajo este muestreador.
+**Nota**: Cuando **está habilitado**, los spans descartados por reglas de SDK o lógica personalizada como `manual.drop` son **excluidos** bajo este muestreador.
Para configurar el muestreador raro, actualice la `apm_config.enable_rare_sampler` configuración en el archivo de configuración principal del Datadog Agent (`datadog.yaml`) o con la variable de entorno `DD_APM_ENABLE_RARE_SAMPLER`:
@@ -376,15 +377,13 @@ Para configurar el muestreador raro, actualice la `apm_config.enable_rare_sample
@env DD_APM_ENABLE_RARE_SAMPLER - boolean - optional - default: false
```
-Para evaluar los tramos descartados por las reglas de la biblioteca de trazado o lógica personalizada como `manual.drop`,
- habilite la función con: `DD_APM_FEATURES=error_rare_sample_tracer_drop` en el Trace Agent.
-
+Para evaluar los tramos descartados por reglas del SDK o lógica personalizada, como `manual.drop`, habilite la función con: `DD_APM_FEATURES=error_rare_sample_tracer_drop` en el Trace Agent.
-#### Datadog Agent 6/7.33 a 6/7.40.x
+#### Datadog Agent 6/7.33 a 6/7.40.x {#datadog-agent-6733-to-6740x-1}
Por defecto, el muestreador raro está habilitado.
-**Nota**: Cuando **está habilitado**, los tramos descartados por las reglas de la biblioteca de trazado o lógica personalizada como `manual.drop` **son excluidos** bajo este muestreador. Para incluir estos tramos en esta lógica, actualice a Datadog Agent 6.41.0/7.41.0 o superior.
+**Nota**: Cuando **está habilitado**, los tramos descartados por reglas de SDK o lógica personalizada, como `manual.drop` **, son excluidos** bajo este muestreador. Para incluir estos tramos en esta lógica, actualice a Datadog Agent 6.41.0/7.41.0 o superior.
Para cambiar la configuración predeterminada del muestreador raro, actualice la `apm_config.disable_rare_sampler` configuración en el archivo de configuración principal del Datadog Agent (`datadog.yaml`) o con la variable de entorno `DD_APM_DISABLE_RARE_SAMPLER`:
@@ -393,14 +392,14 @@ Para cambiar la configuración predeterminada del muestreador raro, actualice la
@env DD_APM_DISABLE_RARE_SAMPLER - boolean - optional - default: false
```
-## Force keep and drop
+## Forzar mantener y descartar {#force-keep-and-drop}
`ingestion_reason: manual`
-El mecanismo de muestreo basado en la cabeza puede ser anulado a nivel de la biblioteca de trazado. Por ejemplo, si necesita monitorear una transacción crítica, puede forzar que la traza asociada se mantenga. Por otro lado, para información innecesaria o repetitiva como las verificaciones de salud, puede forzar que la traza se descarte.
+El mecanismo de muestreo basado en la cabeza puede ser anulado a nivel del SDK. Por ejemplo, si necesita monitorear una transacción crítica, puede forzar que se mantenga la traza asociada. Por otro lado, para información innecesaria o repetitiva como las verificaciones de salud, puede forzar que se descarte la traza.
-- Establezca Manual Keep en un tramo para indicar que este y todos los tramos hijos deben ser ingeridos. La traza resultante puede parecer incompleta en la interfaz de usuario si el tramo en cuestión no es el tramo raíz de la traza.
+- Establezca Manual Keep en un tramo para indicar que éste y todos los tramos hijos deben ser ingeridos. La traza resultante puede parecer incompleta en la interfaz de usuario si el tramo en cuestión no es el tramo raíz de la traza.
-- Establezca Manual Drop en un tramo para asegurarse de que **ningún** tramo hijo sea ingerido. [Los muestreadores de errores y los muestreadores raros](#error-and-rare-traces) serán ignorados en el Datadog Agent.
+- Establezca Manual Drop en un tramo para asegurarse de que **ningún** tramo hijo sea ingerido. Los [muestreadores de error y raros](#error-and-rare-traces) son ignorados en el Agente.
{{< programming-lang-wrapper langs="java,python,ruby,go,nodejs,.NET,php,cpp" >}}
{{< programming-lang lang="java" >}}
@@ -425,7 +424,7 @@ public class MyClass {
}
```
-Elimine manualmente una traza:
+Descartar una traza manualmente:
```java
import datadog.trace.api.DDTags;
@@ -462,7 +461,7 @@ def handler():
# method impl follows
```
-Elimine manualmente una traza:
+Descartar una traza manualmente:
```python
from ddtrace import tracer
@@ -488,7 +487,7 @@ Datadog::Tracing.trace(name, options) do |span, trace|
end
```
-Elimine manualmente una traza:
+Descartar una traza manualmente:
```ruby
Datadog::Tracing.trace(name, options) do |span, trace|
@@ -526,7 +525,7 @@ func handler(w http.ResponseWriter, r *http.Request) {
}
```
-Elimine manualmente una traza:
+Descartar una traza manualmente:
```Go
package main
@@ -567,7 +566,7 @@ span.setTag(tags.MANUAL_KEEP)
```
-Elimine manualmente una traza:
+Descartar una traza manualmente:
```js
const tracer = require('dd-trace')
@@ -599,7 +598,7 @@ using(var scope = Tracer.Instance.StartActive("my-operation"))
}
```
-Elimine manualmente una traza:
+Descartar una traza manualmente:
```cs
using Datadog.Trace;
@@ -632,7 +631,7 @@ Mantenga manualmente una traza:
?>
```
-Elimine manualmente una traza:
+Descartar una traza manualmente:
```php
}}
{{< /programming-lang-wrapper >}}
-La conservación manual de trazas debe realizarse antes de la propagación del contexto. Si se mantiene después de la propagación del contexto, el sistema no puede garantizar que se conserve toda la traza a través de los servicios. La conservación manual de trazas se establece en la ubicación del cliente de rastreo, por lo que la traza aún puede ser eliminada por el Datadog Agent o la ubicación del servidor según las reglas de muestreo.
+Establezca Manual Keep antes de la propagación del contexto. Si se establece después de la propagación del contexto, es posible que la traza completa no se mantenga a través de los servicios. Debido a que esta decisión se establece en el cliente de traza, la traza aún puede ser descartada por el Agent o el servidor según las reglas de muestreo.
-## Tramos individuales
+## Tramos individuales {#single-spans}
`ingestion_reason: single_span`
-Si necesita muestrear un tramo específico, pero no necesita que la traza completa esté disponible, las bibliotecas de rastreo le permiten establecer una tasa de muestreo que se puede configurar para un solo tramo.
+Si necesita muestrear un tramo específico pero no requiere la traza completa, los SDK permiten establecer una tasa de muestreo para un solo tramo.
-Por ejemplo, si está construyendo [métricas a partir de tramos][6] para el seguimiento de servicios específicos, puede configurar reglas de muestreo de tramos para garantizar que estas métricas se basen en el 100% del tráfico de la aplicación, sin tener que ingerir el 100% de las trazas de todas las solicitudes que fluyen a través del servicio.
+Por ejemplo, si está construyendo [métricas a partir de tramos][6] para monitorear servicios específicos, puede configurar reglas de muestreo de tramos para que estas métricas se basen en el 100% del tráfico de la aplicación, sin ingerir el 100% de las trazas de todas las solicitudes que fluyen a través del servicio.
Esta función está disponible para Datadog Agent v[7.40.0][19]+.
-**Nota**: Las reglas de muestreo de tramos individuales **no** se pueden usar para descartar tramos que son conservados por el muestreo basado en cabeza, solo para conservar tramos adicionales que son descartados por el muestreo basado en cabeza.
+**Nota**: Las reglas de muestreo de tramos individuales **no** pueden ser utilizadas para descartar tramos que son mantenidos por [muestreo basado en la cabeza](#head-based-sampling), solo para mantener tramos adicionales que son descartados por el muestreo basado en la cabeza.
{{< tabs >}}
{{% tab "Java" %}}
-A partir de la biblioteca de rastreo [versión 1.7.0][1], para aplicaciones Java, establezca las reglas de muestreo de **tramo** por servicio y por nombre de operación con la `DD_SPAN_SAMPLING_RULES` variable de entorno.
+A partir del SDK [versión 1.7.0][1], para aplicaciones Java, establezca reglas de muestreo de **tramo** por servicio y por nombre de operación con la `DD_SPAN_SAMPLING_RULES`variable de entorno.
-Por ejemplo, para recolectar el 100% de los tramos del servicio llamado `my-service`, para la operación `http.request`, hasta 50 tramos por segundo:
+Por ejemplo, para recopilar el 100% de los tramos del servicio llamado `my-service`, para la operación `http.request`, hasta 50 tramos por segundo:
```
@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]
```
-Lea más sobre los controles de muestreo en la [documentación de la biblioteca de traza de Java][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Java][2].
[1]: https://github.com/DataDog/dd-trace-java/releases/tag/v1.7.0
[2]: /es/tracing/trace_collection/dd_libraries/java
{{% /tab %}}
{{% tab "Python" %}}
-A partir de la versión [v1.4.0][1], para aplicaciones Python, establezca las reglas de muestreo de **tramo** por servicio y por nombre de operación con la `DD_SPAN_SAMPLING_RULES` variable de entorno.
+A partir de la versión [v1.4.0][1], para aplicaciones Python, establezca reglas de muestreo de **tramo** por servicio y por nombre de operación con la `DD_SPAN_SAMPLING_RULES`variable de entorno.
Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-service`, para la operación `http.request`, hasta `50` tramos por segundo:
@@ -728,8 +727,7 @@ Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-servi
@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]
```
-
-Lea más sobre los controles de muestreo en la [documentación de la biblioteca de traza de Python][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Python][2].
[1]: https://github.com/DataDog/dd-trace-py/releases/tag/v1.4.0
[2]: /es/tracing/trace_collection/dd_libraries/python
@@ -743,7 +741,7 @@ Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-servi
@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]
```
-Lea más sobre los controles de muestreo en la [documentación de la biblioteca de traza de Ruby][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Ruby][2].
[1]: https://github.com/DataDog/dd-trace-rb/releases/tag/v1.5.0
[2]: /es/tracing/trace_collection/dd_libraries/ruby#sampling
@@ -756,22 +754,22 @@ Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-servi
```
@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]
```
-A partir de la versión [v1.60.0][3], para aplicaciones Go, establezca las reglas de muestreo de tramos por recurso y por etiqueta con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
+A partir de la versión [v1.60.0][3], para aplicaciones Go, establezca las reglas de muestreo de **tramo** por recurso y por etiquetas con la `DD_SPAN_SAMPLING_RULES` variable de entorno.
-Por ejemplo, para recopilar `100%` de los tramos del servicio para el recurso `POST /api/create_issue`, para la etiqueta `priority` con valor `high`:
+Por ejemplo, para recolectar `100%` de los tramos del servicio para el recurso `POST /api/create_issue`, para la etiqueta `priority` con valor `high`:
```
@env DD_SPAN_SAMPLING_RULES=[{"resource": "POST /api/create_issue", "tags": { "priority":"high" }, "sample_rate":1.0}]
```
-Lee más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de Go][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Go][2].
[1]: https://github.com/DataDog/dd-trace-go/releases/tag/v1.41.0
[2]: /es/tracing/trace_collection/dd_libraries/go
[3]: https://github.com/DataDog/dd-trace-go/releases/tag/v1.60.0
{{% /tab %}}
{{% tab "Node.js" %}}
-Para aplicaciones de Node.js, establece las reglas de muestreo de **tramo** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
+Para aplicaciones de Node.js, establezca las reglas de muestreo de **span** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-service`, para la operación `http.request`, hasta `50` tramos por segundo:
@@ -779,12 +777,12 @@ Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-servi
@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]
```
-Lee más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de Node.js][1].
+Lea más sobre los controles de muestreo en la [documentación del SDK de Node.js][1].
[1]: /es/tracing/trace_collection/dd_libraries/nodejs
{{% /tab %}}
{{% tab "PHP" %}}
-A partir de la versión [v0.77.0][1], para aplicaciones de PHP, establece las reglas de muestreo de **tramo** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
+A partir de la versión [v0.77.0][1], para aplicaciones PHP, establezca las reglas de muestreo de **span** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-service`, para la operación `http.request`, hasta `50` tramos por segundo:
@@ -792,13 +790,13 @@ Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-servi
@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]
```
-Lee más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de PHP][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de PHP][2].
[1]: https://github.com/DataDog/dd-trace-php/releases/tag/0.77.0
[2]: /es/tracing/trace_collection/dd_libraries/php
{{% /tab %}}
{{% tab "C++" %}}
-A partir de la versión [v0.1.0][1], para aplicaciones de C++, establece las reglas de muestreo de **tramo** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
+A partir de la versión [v0.1.0][1], para aplicaciones C++, establezca las reglas de muestreo de **span** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-service`, para la operación `http.request`, hasta `50` tramos por segundo:
@@ -809,7 +807,7 @@ Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-servi
[1]: https://github.com/DataDog/dd-trace-cpp/releases/tag/v0.1.0
{{% /tab %}}
{{% tab ".NET" %}}
-A partir de la versión [v2.18.0][1], para aplicaciones de .NET, establece las reglas de muestreo de **tramo** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
+A partir de la versión [v2.18.0][1], para aplicaciones .NET, establezca las reglas de muestreo de **span** por servicio y por nombre de operación con la variable de entorno `DD_SPAN_SAMPLING_RULES`.
Por ejemplo, para recolectar `100%` de los tramos del servicio llamado `my-service`, para la operación `http.request`, hasta `50` tramos por segundo:
@@ -823,58 +821,58 @@ $env:DD_SPAN_SAMPLING_RULES='[{"service": "my-service", "name": "http.request",
}
```
-Lee más sobre los controles de muestreo en la [documentación de la biblioteca de trazado de .NET][2].
+Lea más sobre los controles de muestreo en la [documentación del SDK de .NET][2].
[1]: https://github.com/DataDog/dd-trace-dotnet/releases/tag/v2.18.0
[2]: /es/tracing/trace_collection/dd_libraries/dotnet-core
{{% /tab %}}
{{< /tabs >}}
-
El mecanismo de App Analytics está completamente obsoleto. Para ingerir tramos individuales sin la traza completa, utiliza la configuración de Muestreo de Tramo Único. Para ingerir trazas completas, utiliza configuraciones de Muestreo Basado en Cabeza.
+
El mecanismo legado de App Analytics está completamente descontinuado. Utilice muestreo de un solo tramo (descrito arriba) para ingerir tramos individuales, o muestreo basado en head para ingerir trazas completas.
-## Tramos de producto ingeridos
+## Tramos de producto ingeridos {#product-ingested-spans}
-### Trazas de RUM
+### Trazas RUM {#rum-traces}
`ingestion_reason:rum`
-Una solicitud de una aplicación web o móvil genera una traza cuando los servicios de backend están instrumentados. [La integración de APM con Real User Monitoring][7] vincula las solicitudes de aplicaciones web y móviles a sus trazas de backend correspondientes para que puedas ver tus datos completos de frontend y backend a través de una sola lente.
+Una solicitud de una aplicación web o móvil genera una traza cuando los servicios de backend están instrumentados. [La integración de APM con RUM][7] vincula las solicitudes de aplicaciones web y móviles a sus trazas de backend correspondientes para que pueda ver todos sus datos de frontend y backend a través de una sola lente.
-A partir de la versión `4.30.0` del SDK de RUM para navegador, puedes controlar los volúmenes ingeridos y mantener un muestreo de las trazas de backend configurando el parámetro de inicialización `traceSampleRate`. Establece `traceSampleRate` a un número entre `0` y `100`.
-Si no se establece ningún valor de `traceSampleRate`, se envía un 100% de las trazas provenientes de las solicitudes del navegador a Datadog por defecto.
+A partir de la versión `4.30.0` del SDK del navegador RUM, puede controlar los volúmenes ingeridos y mantener un muestreo de las trazas de backend configurando el parámetro de inicialización `traceSampleRate`. Establezca `traceSampleRate` en un número entre `0` y `100`.
+Si no se establece un valor de `traceSampleRate`, se utiliza un valor predeterminado del 100% de las trazas provenientes de las solicitudes del navegador que se envían a Datadog.
-De manera similar, controla la tasa de muestreo de trazas en otros SDK utilizando parámetros similares:
+También puede controlar la tasa de muestreo de trazas en otros SDKs:
| SDK | Parámetro | Versión mínima |
|-------------|-----------------------|--------------------|
| Navegador | `traceSampleRate` | [v4.30.0][8] |
-| iOS | `tracingSamplingRate` | [1.11.0][9] _La tasa de muestreo se informa en la página de Ingestion Control desde [1.13.0][16]_ |
-| Android | `traceSampleRate` | [1.13.0][10] _La tasa de muestreo se informa en la página de Ingestion Control desde [1.15.0][17]_ |
+| iOS | `tracingSamplingRate` | [1.11.0][9] _La tasa de muestreo se informa en la Página de Control de Ingesta desde [1.13.0][16]_ |
+| Android | `traceSampleRate` | [1.13.0][10] _La tasa de muestreo se informa en la Página de Control de Ingesta desde [1.15.0][17]_ |
| Flutter | `tracingSamplingRate` | [1.0.0][11] |
-| React Native | `tracingSamplingRate` | [1.0.0][12] _La tasa de muestreo se informa en la página de Ingestion Control desde [1.2.0][18]_ |
+| React Native | `tracingSamplingRate` | [1.0.0][12] _La tasa de muestreo se informa en la Página de Control de Ingesta desde [1.2.0][18]_ |
-### Trazas sintéticas
+### Trazas sintéticas {#synthetic-traces}
`ingestion_reason:synthetics` y `ingestion_reason:synthetics-browser`
-Las pruebas de HTTP y navegador generan trazas cuando los servicios de backend están instrumentados. [La integración de APM con Synthetic Testing][13] vincula tus pruebas sintéticas con las trazas de backend correspondientes. Navega desde una ejecución de prueba que falló hasta la causa raíz del problema observando la traza generada por esa ejecución de prueba.
+Las pruebas de HTTP y del navegador generan trazas cuando los servicios de backend están instrumentados. [La integración de APM con Synthetic Testing][13] vincula sus pruebas sintéticas con las trazas de backend correspondientes. Navegue desde una ejecución de prueba que falló hasta la causa raíz del problema observando la traza generada por esa ejecución de prueba.
-Por defecto, el 100% de las pruebas sintéticas de HTTP y navegador generan trazas de backend.
+Por defecto, el 100% de las pruebas sintéticas de HTTP y del navegador generan trazas de backend.
-### Otros productos
+### Otros productos {#other-products}
-Algunas razones adicionales de ingesta se atribuyen a tramos que son generados por productos específicos de Datadog:
+Algunas razones adicionales de ingesta se atribuyen a los tramos que son generados por productos específicos de Datadog:
| Producto | Razón de Ingesta | Descripción del Mecanismo de Ingesta |
|------------|-------------------------------------|---------------------------------|
-| Serverless | `lambda` y `xray` | Tus trazas recibidas de las [aplicaciones Serverless][14] trazadas con Datadog Tracing Libraries o la integración de AWS X-Ray. |
-| App and API Protection | `appsec` | Trazas ingeridas de Datadog Tracing Libraries y marcadas por [AAP][15] como una amenaza. |
-| Data Observability: Jobs Monitoring | `data_jobs` | Trazas ingeridas desde la integración de Datadog Java Tracer Spark o la integración de Databricks. |
+| Serverless | `lambda` y `xray` | Sus trazas recibidas de las [aplicaciones Serverless][14] trazadas con los SDK de Datadog o la integración de AWS X-Ray. |
+| App and API Protection | `appsec` | Trazas ingeridas de los SDKs de Datadog y marcadas por [AAP][15] como una amenaza. |
+| Data Observability: Jobs Monitoring | `data_jobs` | Trazas ingeridas de la integración de Datadog Java Tracer Spark o la integración de Databricks. |
-## Mecanismos de ingestión en OpenTelemetry
+## Mecanismos de ingestión en OpenTelemetry {#ingestion-mechanisms-in-opentelemetry}
`ingestion_reason:otel`
-Dependiendo de tu configuración con los SDK de OpenTelemetry (usando el OpenTelemetry Collector o el Datadog Agent), tienes múltiples formas de controlar el muestreo de ingestión. Consulta [Muestreo de Ingestión con OpenTelemetry][22] para obtener detalles sobre las opciones disponibles para el muestreo a nivel de SDK de OpenTelemetry, OpenTelemetry Collector y Datadog Agent en varias configuraciones de OpenTelemetry.
+Dependiendo de su configuración con los SDK de OpenTelemetry (usando el OpenTelemetry Collector o el Agente de Datadog), tiene múltiples formas de controlar el muestreo de ingestión. Consulte [Muestreo de ingestión con OpenTelemetry][22] para obtener detalles sobre las opciones disponibles para el muestreo a nivel de SDK de OpenTelemetry, OpenTelemetry Collector y Datadog Agent en varias configuraciones de OpenTelemetry.
-## Lectura adicional
+## Lectura adicional {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
diff --git a/content/es/universal_service_monitoring/_index.md b/content/es/universal_service_monitoring/_index.md
index e1f7338d6e7..a5c7633a117 100644
--- a/content/es/universal_service_monitoring/_index.md
+++ b/content/es/universal_service_monitoring/_index.md
@@ -4,75 +4,80 @@ aliases:
cascade:
algolia:
rank: 70
+description: Monitorea las métricas de salud del servicio en toda tu infraestructura
+ sin necesidad de instrumentación de código utilizando Universal Service Monitoring
+ y Datadog Agent.
further_reading:
- link: /universal_service_monitoring/setup/
tag: Documentación
- text: Configuración de Universal Service Monitoring
+ text: Setting Up Universal Service Monitoring
- link: https://www.datadoghq.com/blog/universal-service-monitoring-datadog/
tag: Blog
- text: Señales clave en segundos con Universal Service Monitoring
+ text: Señales doradas en segundos con Universal Service Monitoring
- link: /getting_started/tagging/unified_service_tagging/
tag: Documentación
- text: Etiquetado de servicios unificado
+ text: Unified Service Tagging
- link: /tracing/software_catalog/
tag: Documentación
- text: Descubrir y catalogar los servicios que informan a Datadog
+ text: Descubre y cataloga los servicios que reportan a Datadog
- link: /tracing/services/service_page/
tag: Documentación
- text: Más información sobre servicios en Datadog
+ text: Aprende más sobre los servicios en Datadog
- link: /tracing/services/services_map/
tag: Documentación
- text: Leer sobre el Mapa de servicios
+ text: Lee sobre el Mapa de Servicios
- link: https://www.datadoghq.com/blog/monitor-connection-churn-datadog/
tag: Blog
- text: Prácticas recomendadas para la monitorización y corrección del churn de conexiones
+ text: Mejores prácticas para monitorear y remediar la rotación de conexiones
- link: https://www.datadoghq.com/blog/software-catalog/
tag: Blog
- text: Mejorar la experiencia y la colaboración de los desarrolladores con Software
- Catalog
-title: Universal Service Monitoring
+ text: Mejora la experiencia del desarrollador y la colaboración con el Catálogo
+ de Software
+- link: https://learn.datadoghq.com/courses/getting-started-usm
+ tag: Centro de Aprendizaje
+ text: Comenzando con Monitoreo Universal de Servicios (USM)
+title: Monitoreo Universal de Servicios
---
+## Resumen {#overview}
-## Información general
+Universal Service Monitoring (USM) proporciona visibilidad en las métricas de salud de tu servicio de manera universal en toda tu infraestructura _sin tener que instrumentar tu código_. Se basa únicamente en la presencia de un Datadog Agent configurado y [Unified Service Tagging][1], y trae datos de rendimiento sobre tus servicios no instrumentados a vistas como el Software Catalog y Service Map. USM también funciona con [Deployment Tracking][2], Monitors, Dashboards y SLOs.
-Universal Service Monitoring (USM) proporciona visibilidad de las métricas de salud de tus servicios de forma universal en todo tu stack tecnológico _sin tener que instrumentar tu código_. Se basa únicamente en la presencia de un Datadog Agent configurado y el [etiquetado unificado de servicio][1], y aporta datos de rendimiento sobre tus servicios no instrumentados en vistas como Software Catalog y Mapa de servicios. USM también funciona con [Deployment Tracking][2], monitores, dashboards y SLO.
+{{< img src="universal_service_monitoring/usm-demo.mp4" alt="Video demostrativo de Universal Service Monitoring. Un resumen de un servicio se accede haciendo clic en un servicio en el Service Map y seleccionando Ver resumen del servicio." video="true" >}}
-{{< img src="universal_service_monitoring/usm-demo.mp4" alt="Vídeo que demuestra Universal Service Monitoring. Información general de un servicio al que se accede haciendo clic en un servicio en el Mapa de servicio y seleccionando Ver información general." video="true" >}}
+## Configuración {#setup}
-## Configurar
+Para obtener información sobre las plataformas y protocolos compatibles, así como instrucciones para comenzar, lea [Setting Up Universal Service Monitoring][7].
-Para obtener información sobre las plataformas y protocolos compatibles y para obtener instrucciones sobre cómo empezar, lee [Configuración de Universal Service Monitoring][7].
+
Vista previa: Protocolos adicionales y métodos de cifrado
USM está en Preview para descubrir cloud services y para decodificar protocolos adicionales y métodos de cifrado de tráfico. Para más información y para solicitar acceso, lea Cloud Service Discovery and Additional Protocols.
-
Vista previa: protocolos y métodos de cifrado adicionales
USM está en Vista previa para detectar servicios en la nube y para decodificar protocolos adicionales y métodos de encriptación de tráfico. Para obtener más información y solicitar acceso, lee Cloud Service Discovery and Additional Protocols.
+## Automatic service tagging {#automatic-service-tagging}
-## Etiquetado de servicios automático
+Universal Service Monitoring detecta automáticamente los servicios que se ejecutan en tu infraestructura. Si no encuentra [unified service tags][1], les asigna un nombre basado en una de las etiquetas: `app`, `short_image`, `kube_container_name`, `container_name`, `kube_deployment`, `kube_service`.
-Universal Service Monitoring detecta automáticamente servicios que se ejecutan en tu infraestructura. Si no encuentra [etiquetas de servicio unificado][1], les asigna un nombre basado en una de las etiquetas (tags): `app`, `short_image`, `kube_container_name`, `container_name`, `kube_deployment`, `kube_service`.
+Para actualizar el nombre del servicio, configura [Unified Service Tagging][1].
-Para actualizar el nombre del servicio, configura [Etiquetado de servicios unificado][1].
+{{< img src="universal_service_monitoring/automatic-service-tagging.png" alt="Cuando Datadog detecta automáticamente tus servicios, la etiqueta utilizada se muestra en la parte superior de la página del servicio." style="width:80%;" >}}
-{{< img src="universal_service_monitoring/automatic-service-tagging.png" alt="Cuando Datadog detecta automáticamente tus servicios, la etiqueta utilizada para mostrar esto está en la parte superior de la Página de servicios" style="width:80%;" >}}
+## Explorando tus servicios {#exploring-your-services}
-## Explorar tus servicios
+Después de configurar el Agent, espera aproximadamente cinco minutos para que tu servicio aparezca en el Software Catalog. Haz clic en el servicio para ver la página de detalles del servicio. Un nombre de operación de `universal.http.server` o `universal.http.client` en la esquina superior izquierda indica que la telemetría del servicio proviene de Universal Service Monitoring.
-Después de configurar el Agent, espera unos cinco minutos a que tu servicio aparezca en el Software Catalog. Haz clic en el servicio para ver la página de detalles del servicio. Un nombre de operación de `universal.http.server` o `universal.http.client` en la parte superior izquierda indica que la telemetría del servicio procede de Universal Service Monitoring.
+El nombre de operación `universal.http.server` captura métricas de salud para el tráfico entrante a su servicio. El nombre de operación correspondiente `universal.http.client` representa el tráfico saliente a otros destinos.
-El nombre de operación `universal.http.server` captura las métricas de estado para el tráfico entrante a tu servicio. El nombre de operación `universal.http.client` correspondiente representa el tráfico saliente hacia otros destinos.
+{{< img src="universal_service_monitoring/select_service_operation_cropped.png" alt="El menú desplegable de operaciones en la pestaña de Servicios muestra los nombres de operación disponibles." style="width:100%;" >}}
-{{< img src="universal_service_monitoring/select_service_operation_cropped.png" alt="El menú desplegable de la operación en la pestaña Services (Servicios) que muestra los nombres de operación disponibles" style="width:100%;" >}}
+Después de habilitar Universal Service Monitoring, puede:
-Después de activar Universal Service Monitoring, puedes:
+- Navega a **APM** > **Software Catalog** o **APM** > **Service Map** para [visualizar tus servicios y sus dependencias][3].
-- Navega a **APM** > **Software Catalog** o **APM** > **Service Map** (APM > Mapa de servicios) para [visualizar tus servicios y sus dependencias][3].
+- Haz clic en páginas de servicio específicas para ver métricas de señal dorada (solicitudes, errores y duración), y correlaciona estas con cambios recientes en el código mediante [Deployment Tracking][2].
-- Haz clic en páginas específicas de servicio para ver las métricas de señales clave (solicitudes, errores y duración) y correlacionarlas con los cambios de código recientes con [Rastreo de implementación][2].
+- Crea [Monitors][4], [Dashboards][5] y [SLOs][6] utilizando las métricas `universal.http.*`.
-- Crea [monitores][4], [dashboards][5] y [SLOs][6] utilizando las métricas `universal.http.*`.
-
-## Referencias adicionales
+## Lecturas adicionales {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
@@ -81,5 +86,5 @@ Después de activar Universal Service Monitoring, puedes:
[3]: /es/tracing/software_catalog/
[4]: /es/monitors/types/apm/?tab=apmmetrics
[5]: /es/dashboards/
-[6]: /es/service_management/service_level_objectives/metric/
+[6]: /es/service_level_objectives/metric/
[7]: /es/universal_service_monitoring/setup/
\ No newline at end of file
diff --git a/content/fr/account_management/_index.md b/content/fr/account_management/_index.md
index 62a2e080a7c..4585179a216 100644
--- a/content/fr/account_management/_index.md
+++ b/content/fr/account_management/_index.md
@@ -1,117 +1,158 @@
---
-title: Gestion de compte
-description: "Gérer votre organisation et votre compte Datadog"
aliases:
- - /guides/billing
- - /account_management/settings
+- /fr/guides/billing
+- /fr/account_management/settings
cascade:
- algolia:
- rank: 70
+ algolia:
+ rank: 70
+description: Gérez votre compte et votre organisation Datadog
further_reading:
- - link: "https://www.datadoghq.com/blog/volkswagen-organizations/"
- tag: "Blog"
- text: "Meilleures pratiques pour la gestion des organisations Datadog à grande échelle (en anglais)"
+- link: https://www.datadoghq.com/blog/volkswagen-organizations/
+ tag: GitHub
+ text: Meilleures pratiques pour gérer les organisations Datadog à grande échelle
+title: Gestion de compte
---
-{{< site-region region="gov" >}}
-
La plateforme Datadog for Government prend uniquement en charge l'authentification SAML ou l'authentification de base avec nom d'utilisateur/adresse e-mail et mot de passe. Avant de configurer l'authentification SAML, assurez-vous qu'au moins un compte avec nom d'utilisateur ou adresse e-mail et mot de passe est disponible afin de maintenir l'accès pendant le processus de configuration. Datadog recommande d'activer l'authentification multifacteur (MFA) pour les comptes avec mot de passe.
+{{< site-region region="gov,gov2" >}}
+
La plateforme Datadog pour le gouvernement ne prend en charge que l'authentification SAML ou l'authentification de base utilisant un nom d'utilisateur/email et un mot de passe. Avant de configurer l'authentification SAML, assurez-vous qu'au moins un compte avec nom d'utilisateur/email et mot de passe est établi pour maintenir l'accès pendant le processus de configuration. Datadog recommande d'activer l'authentification multi-facteurs (MFA) pour les comptes basés sur un mot de passe.
-Si vous avez besoin d'activer SAML pour un compte d'essai, contactez l'assistance Datadog.
+Si vous avez besoin que SAML soit activé pour un compte d'essai, contactez le support Datadog.
{{< /site-region >}}
-## Paramètres personnels
+## Paramètres personnels {#personal-settings}
Les pages des paramètres personnels Datadog vous permettent de contrôler les informations à votre sujet que les autres membres de votre organisation peuvent consulter, de changer d'organisation, de quitter une organisation et de gérer vos préférences de notification.
-### Profil
+### Profil {#profile}
-Votre profil permet aux autres membres de votre organisation de vous reconnaître dans Datadog. Vous pouvez définir ou modifier votre nom, votre adresse e-mail et votre poste depuis l'[onglet Profile][11] de la page **Personal Settings**.
+Votre profil est la façon dont les autres dans votre organisation vous reconnaissent dans Datadog. Définissez ou mettez à jour votre nom, votre adresse e-mail et votre titre depuis l'onglet [Profil][11] dans la page {{< ui >}}Personal Settings{{< /ui >}}.
Pour modifier votre photo, créez un compte sur [Gravatar][1] et associez-le à votre adresse e-mail.
-Si vous vous connectez à Datadog à l'aide de l'authentification Google, votre adresse e-mail est fournie par votre compte Google et n'est **pas** modifiable dans Datadog. Pour modifier votre adresse e-mail dans Google, consultez la [documentation Google][2].
+Si vous vous connectez à Datadog en utilisant l'authentification Google, votre adresse e-mail est fournie par votre compte Google et est **non** modifiable dans Datadog. Pour changer votre adresse e-mail dans Google, consultez la [documentation Google][2].
-### Préférences
+### Préférences {#preferences}
{{% site-region region="us,us3,us5,eu,ap1,ap2" %}}
-Vous pouvez gérer votre fuseau horaire, vos préférences d'accessibilité visuelle et vos abonnements par e-mail à partir de l'onglet [Preferences][3] de la page **Paramètres personnels**.
+Vous pouvez gérer votre fuseau horaire, votre format horaire, vos préférences d'accessibilité visuelle et vos abonnements par e-mail depuis l'onglet [Préférences][3] dans la page {{< ui >}}Personal Settings{{< /ui >}}.
-#### Abonnements aux services de messagerie
+#### Abonnements par e-mail {#email-subscriptions}
-Dans la section des abonnements par e-mail, vous avez accès aux rapports suivants :{{< site-region region="us3,us5,gov,ap1,ap2" >}}
-
Les résumés par e-mail ne sont pas disponibles dans le site sélectionné ({{< region-param key="dd_site_name" >}}).
+La section E-mail subscriptions vous donne accès aux rapports suivants :
+{{< site-region region="us3,us5,gov,gov2,ap1,ap2" >}}
+
Les résumés d'e-mails ne sont pas disponibles dans le site sélectionné ({{< region-param key="dd_site_name" >}}).
{{< /site-region >}}
-* Daily Digest (Synthèse quotidienne)
-* Weekly Digest (Synthèse hebdomadaire)
+* Résumé quotidien
+* Résumé hebdomadaire
-Pour savoir si un e-mail de synthèse est susceptible de vous intéresser, consultez un exemple en cliquant sur le lien **Example** en regard de chaque abonnement. Vous pouvez également utiliser le bouton **Unsubscribe From all** pour vous désabonner de toutes les synthèses.
+Si vous n'êtes pas sûr qu'un résumé d'e-mail vous concerne, vous pouvez voir un exemple en cliquant sur le {{< ui >}}Example{{< /ui >}} lien à côté de chaque abonnement par e-mail. Vous pouvez également utiliser le bouton {{< ui >}}Unsubscribe From All{{< /ui >}} pour vous désinscrire de tous les abonnements par e-mail.
{{% /site-region %}}
-{{% site-region region="gov" %}}
-Vous pouvez gérer votre fuseau horaire, vos préférences d'accessibilité visuelle et vos abonnements aux services de messagerie depuis l'onglet [**Preferences** tab][3] de la page **Personal Settings**.
+{{% site-region region="gov,gov2" %}}
+Vous pouvez gérer votre fuseau horaire, votre format horaire et votre préférence d'accessibilité visuelle depuis l'onglet [**Préférences**][3] dans la page {{< ui >}}Personal Settings{{< /ui >}}.
{{% /site-region %}}
-#### Accessibilité visuelle
+#### Format horaire {#time-format}
+
+Choisissez si les heures sont affichées au format 12 heures ou 24 heures dans Datadog (par exemple, "2:30 pm" ou "14:30"). Les nouveaux comptes sont par défaut au format 12 heures. Les graphiques et certaines données tabulaires s'affichent toujours au format 24 heures.
+
+#### Accessibilité visuelle {#visual-accessibility}
-Les préférences d'accessibilité visuelle offrent cinq paramètres différents conçus pour répondre aux besoins des personnes souffrant d'une anomalie de la vision des couleurs, de troubles de l'acuité visuelle ou d'une sensibilité aux couleurs vives. Si vous activez l'un de ces paramètres d'accessibilité, tous les graphiques qui utilisent la palette de couleurs classique seront convertis pour afficher des couleurs adaptées à vos besoins visuels.
+La préférence d'accessibilité visuelle a cinq paramètres différents pour répondre aux déficiences de la vision des couleurs, à une faible acuité visuelle et à la sensibilité aux couleurs vives. Si vous optez pour un paramètre de couleur accessible, Datadog traduit tous les graphiques utilisant la palette de couleurs classique en un ensemble de couleurs accessibles adaptées à vos besoins visuels.
-**Remarque** : vos préférences d'accessibilité visuelle sont enregistrées en local dans votre navigateur. Si vous changez de navigateur ou effacez votre cache, le paramètre par défaut sera rétabli.
+**Remarque** : Votre préférence d'accessibilité visuelle est enregistrée localement dans votre navigateur. Si vous utilisez un autre navigateur ou si vous videz votre cache, la préférence est réinitialisée à la valeur par défaut.
-### Organisations
+### Organisations {#organizations}
-L'[onglet Organizations][12] de la page **Personal Settings** répertorie toutes les organisations auxquelles vous êtes associé. Passez d'une organisation à une autre à partir de cette page ou en survolant le menu des comptes de la barre de navigation sur la gauche.
+L'onglet [Organisations][12] dans {{< ui >}}Personal Settings{{< /ui >}} répertorie toutes les organisations avec lesquelles vous êtes associé. Basculez entre ces organisations depuis cette page ou en survolant le menu du compte dans la navigation à gauche.
-**Remarque** : si vous quittez une organisation, vous ne pourrez pas la rejoindre à nouveau à moins d'être invité par un administrateur de cette organisation.
+**Remarque** : Si vous quittez une organisation, vous ne pouvez pas la rejoindre à nouveau à moins d'être invité par un administrateur de cette organisation.
-Pour rejoindre une organisation existante, un administrateur doit vous inviter. Vous recevrez alors un e-mail avec l'objet "You've been invited to join \". Cliquez sur le bouton **Join Account** de l'e-mail.
+Pour rejoindre une organisation existante, vous devez être invité par un administrateur. Après avoir été invité, vous recevez un e-mail avec l'objet : "Vous avez été invité à rejoindre \". Cliquez sur le bouton {{< ui >}}Join Account{{< /ui >}} dans l’e-mail.
Si vous êtes un administrateur d'organisation, consultez les ressources suivantes pour obtenir davantage d'informations :
-* [Gérer les utilisateurs de votre organisation][4]
-* [Configurer l'authentification unique avec SAML][5]
+* [Gérer les utilisateurs dans votre organisation][4]
+* [Configurer l’authentification unique avec SAML][5]
* [Renommer votre organisation][6]
-* [Gérer des comptes multi-organisations][7]
-* [Modifier votre formule Datadog et consulter l'historique d'utilisation et de facturation][8]
+* [Gérer les comptes multi-organisation][7]
+* [Changer votre plan Datadog et consulter l’historique d’utilisation et de facturation][8]
+* [Choisir la topologie de votre organisation (organisation unique vs. multi-organisation)][15]
-### Sécurité
+### Sécurité {#security}
-#### Clés d'application
+#### Clés d’application {#application-keys}
-Vous pouvez gérer vos clés d'application depuis l'[onglet Application Keys][13] de la page **Personal Settings**. Pour copier une clé, passez le curseur dessus jusqu'à ce que l'icône **Copy Key** s'affiche sur la droite, et cliquez sur cette icône. Vous pouvez également cliquer sur la clé de votre choix pour modifier son nom, consulter sa date de création, afficher le profil de son propriétaire ou la révoquer.
+L’onglet [Clés d’application][13] dans {{< ui >}}Personal Settings{{< /ui >}} vous permet de gérer vos clés d’application. Pour copier une clé, survolez-la jusqu’à ce que l’icône {{< ui >}}Copy Key{{< /ui >}} apparaisse à droite, puis cliquez dessus. Vous pouvez également cliquer sur une clé spécifique pour modifier son nom, voir quand elle a été créée, consulter le profil du propriétaire de la clé, la copier ou la révoquer.
-#### Apps
+#### Applications {#apps}
-L'[onglet Apps][14] de la page **Personal Settings** vous permet de gérer les apps qui ont été installées ou créées par des membres de votre organisation. Vous pouvez filtrer les apps en recherchant du texte, ou utiliser les cases à cocher pour afficher uniquement les apps activées ou désactivées.
+L’onglet [Applications][14] dans {{< ui >}}Personal Settings{{< /ui >}} vous permet de gérer les applications qui ont été installées ou créées par des membres de votre organisation. Vous pouvez filtrer les applications avec une chaîne de recherche, ou choisir de n’afficher que les applications activées ou désactivées à l’aide de cases à cocher.
Lorsque vous passez votre curseur sur une app, une option vous permettant de l'activer ou la désactiver apparaît à droite de son nom.
-## Apparence
+#### Vérification par e-mail {#email-verification}
+Vérifiez votre adresse e-mail pour renforcer la sécurité de votre compte et accéder à des fonctionnalités de gestion supplémentaires. Les utilisateurs vérifiés ont un meilleur contrôle sur la sécurité de leur compte et peuvent voir toutes les organisations auxquelles ils appartiennent.
+
+- **Les utilisateurs de connexion Google** sont automatiquement vérifiés lors de leur première connexion.
+- **Les utilisateurs basés sur un mot de passe** vérifient leur e-mail lors de la définition de leur mot de passe pour la première fois.
+- **Les utilisateurs SAML** doivent vérifier manuellement leur e-mail via Datadog.
+
+Après avoir été vérifié, vous accédez à :
+- La possibilité de **se déconnecter de toutes les sessions web actives** sur tous les appareils, garantissant la sécurité en cas de compromission des identifiants.
+- La possibilité de **voir et de passer d’une organisation à l’autre** en dehors de la hiérarchie de votre organisation actuelle.
+
+Les utilisateurs non vérifiés peuvent toujours accéder à Datadog, mais sont limités à la visualisation des organisations au sein de leur hiérarchie et ne peuvent pas révoquer les sessions actives.
+
+#### Vérifiez votre e-mail {#verify-your-email}
+
+Pour vérifier votre e-mail :
+1. Accédez à votre {{< ui >}}Profile Settings{{< /ui >}}.
+2. Cliquez sur {{< ui >}}Verify Account{{< /ui >}}.
+3. Entrez le **code de vérification** envoyé à votre e-mail enregistré.
+4. Cliquez {{< ui >}}Submit{{< /ui >}} pour compléter le processus de vérification.
+
+#### Déconnectez-vous de toutes les sessions web actives {#log-out-of-all-active-web-sessions}
+
+Pour vous déconnecter de toutes les sessions web actives :
+Se déconnecter de toutes les sessions web actives vous déconnecte de toutes les sessions en cours sur les appareils, y compris celui que vous utilisez.
+
+
+Pour vous déconnecter de toutes les sessions web actives :
+1. Allez à {{< ui >}}Personal Settings{{< /ui >}}.
+2. Cliquez {{< ui >}}Log Out of All Web Sessions{{< /ui >}}.
+3. Confirmez l'action.
+
+Après confirmation, vous êtes déconnecté de tous les appareils et devez vous reconnecter.
+
+## Apparence {#appearance}
-Pour activer le mode sombre dans Datadog, passez votre curseur sur votre avatar dans la barre latérale ou appuyez sur `Ctrl+Opt+D` / `Ctrl+Alt+D`.
+Affichez Datadog en mode sombre en survolant votre avatar dans la barre latérale, ou en appuyant sur `Ctrl+Opt+D` / `Ctrl+Alt+D`.
-Pour faire en sorte que l'apparence du site s'adapte automatiquement à celle de votre système, sélectionnez l'option *System*. Ainsi, le thème défini sur Datadog correspondra toujours au thème défini sur votre système.
+Pour s'adapter au paramètre d'apparence de votre ordinateur, sélectionnez l'option {{< ui >}}System{{< /ui >}}. Cela synchronise automatiquement l'apparence de Datadog avec le thème défini au niveau de votre système d'exploitation.
-## Connexion à GitHub
+## Connexion à GitHub {#connecting-to-github}
-Si vous avez installé l'[intégration GitHub][9] pour créer des événements dans Datadog, associez votre compte GitHub personnel à votre compte utilisateur Datadog. Ainsi, les commentaires que vous publierez dans les événements GitHub de Datadog seront automatiquement publiés dans l'issue ou la pull request correspondante dans GitHub.
+Si vous avez installé l'[intégration GitHub][9] pour créer des événements dans Datadog, liez votre compte GitHub personnel à votre compte utilisateur Datadog. En liant vos comptes, tous les commentaires que vous publiez sur les événements GitHub dans Datadog sont automatiquement publiés dans le ticket ou la pull request correspondante sur GitHub.
-## Désactivation du compte de votre organisation
+## Désactivation du compte de votre organisation {#disabling-your-organizations-account}
Pour désactiver le compte Datadog de votre organisation, contactez l'[assistance Datadog][10].
[1]: https://gravatar.com
[2]: https://support.google.com/accounts/answer/19870?hl=en
[3]: https://app.datadoghq.com/personal-settings/preferences
-[4]: /account_management/users/
-[5]: /account_management/saml/
-[6]: /account_management/org_settings/#change-your-organization-name
-[7]: /account_management/multi_organization/
-[8]: /account_management/org_settings/
-[9]: /integrations/github/
-[10]: /help/
+[4]: /fr/account_management/users/
+[5]: /fr/account_management/saml/
+[6]: /fr/account_management/org_settings/#change-your-organization-name
+[7]: /fr/account_management/multi_organization/
+[8]: /fr/account_management/org_settings/
+[9]: /fr/integrations/github/
+[10]: /fr/help/
[11]: https://app.datadoghq.com/personal-settings/profile
[12]: https://app.datadoghq.com/personal-settings/organizations
[13]: https://app.datadoghq.com/personal-settings/application-keys
[14]: https://app.datadoghq.com/personal-settings/apps
+[15]: /fr/getting_started/organization_topology/
\ No newline at end of file
diff --git a/content/fr/account_management/api-app-keys.md b/content/fr/account_management/api-app-keys.md
index 43673dd6b52..ea8f4aab1e1 100644
--- a/content/fr/account_management/api-app-keys.md
+++ b/content/fr/account_management/api-app-keys.md
@@ -6,155 +6,196 @@ aliases:
- /fr/account_management/faq/how-do-i-reset-my-application-keys/
- /fr/agent/faq/how-do-i-reset-my-datadog-api-keys/
- /fr/account_management/faq/api-app-key-management/
+description: Gérez les clés API, les clés d'application et les jetons clients pour
+ les applications web avec des fonctionnalités de sécurité.
title: Clés d'API et clés d'application
---
+## Clés API {#api-keys}
-## Clés d'API
+Les clés API sont uniques à votre organisation. Une [clé API][1] est requise par l'Agent Datadog pour soumettre des métriques et des événements à Datadog.
-Les clés d'API sont uniques à votre organisation. Une [clé d'API][1] est requise par l'Agent Datadog pour envoyer des métriques et des événements à Datadog.
+## Clés d'application {#application-keys}
-## Clés d'application
+[Les clés d'application][2], en conjonction avec la clé API de votre organisation, donnent aux utilisateurs accès à l'API programmatique de Datadog. Les clés d'application sont associées au compte utilisateur qui les a créées et, par défaut, ont les permissions de l'utilisateur qui les a créées.
-Les [clés d'application][2], associées à la clé API de votre organisation, permettent aux utilisateurs d'accéder à l'API programmatique de Datadog. Les clés d'application sont associées au compte utilisateur qui les a créées et disposent par défaut des autorisations de l'utilisateur qui les a créées.
+### Mode de lecture unique {#one-time-read-mode}
-### Portées
+Le mode de lecture unique (OTR) est une fonctionnalité de sécurité qui limite la visibilité des secrets de clé d'application uniquement au moment de la création. Lorsque le mode OTR est activé, les secrets de clé d'application ne sont affichés qu'une seule fois lors de la création et ne peuvent pas être récupérés ultérieurement pour des raisons de sécurité.
-Afin de mieux protéger et sécuriser vos applications, vous avez la possibilité d'appliquer des portées d'autorisation à vos clés d'application, de façon à définir des autorisations plus granulaires et à limiter les données auxquelles les applications ont accès. Vous pourrez ainsi contrôler les accès de vos applications avec plus de précision et réduire les failles de sécurité en limitant les accès superflus. Par exemple, une application qui se contente de lire des dashboards n'a pas besoin de pouvoir gérer les utilisateurs ou de supprimer les données de votre organisation.
+#### Pour les nouvelles organisations {#for-new-organizations}
-Lorsque vous appliquez des portées à des clés d'application, il est recommandé d'accorder uniquement les privilèges et les autorisations dont l'application a besoin pour fonctionner correctement. Seules les portées spécifiées par l'utilisateur sont appliquées à la clé d'application : aucune autre autorisation n'est accordée. Vous pouvez modifier la portée d'autorisation d'une clé d'application à tout moment, mais il est essentiel de réfléchir à l'impact que ces modifications auront sur le fonctionnement de votre application et les données auxquelles elle pourra accéder.
+Toutes les clés d'application pour les nouvelles organisations parentes (et leurs organisations enfants) créées après le 20 août 2025 ont le mode OTR activé par défaut. Ce paramètre est permanent et ne peut pas être modifié.
-**Remarques :**
+#### Pour les organisations existantes {#for-existing-organizations}
-- Les utilisateurs ou les comptes de service qui disposent des [autorisations][4] pour créer ou modifier des clés d'application peuvent également définir des portées de clés d'application. L'utilisateur doit disposer de l'autorisation `user_app_keys` pour appliquer une portée à ses propres clés d'application, ou de l'autorisation `org_app_keys_write` pour appliquer une portée aux clés d'application des autres utilisateurs de son organisation. L'utilisateur doit disposer de l'autorisation `service_account_write` pour appliquer une portée aux clés d'application des comptes de service.
+Les administrateurs d'organisation peuvent activer ou désactiver le mode OTR depuis [**Paramètres de l'organisation** > **Clés d'application**][2]. Après avoir activé le mode OTR :
+
+- Les secrets de clé d'application ne sont visibles qu'une seule fois, au moment de la création
+- Ils ne peuvent plus être récupérés via l'interface utilisateur ou l'API
+- Le paramètre peut être activé ou désactivé par les administrateurs d'organisation pendant 3 mois après l'activation
+- Après 3 mois d'activation continue, le mode OTR devient permanent et le commutateur est supprimé.
+
+**Permissions** : Les utilisateurs doivent avoir à la fois les permissions `org_app_keys_write` et `org_management` pour activer ou désactiver le mode OTR pour leur organisation.
+
+### Scopes {#scopes}
+
+Pour mieux protéger et sécuriser vos applications, vous pouvez spécifier des portées d'autorisation pour vos clés d'application afin de définir des permissions plus granulaires et de minimiser l'accès que les applications ont à vos données Datadog. Cela vous donne un contrôle d'accès granulaire sur vos applications et minimise les vulnérabilités de sécurité en limitant l'accès superflu. Par exemple, une application qui ne fait que lire des tableaux de bord n'a pas besoin de droits administratifs pour gérer les utilisateurs ou supprimer des données de votre organisation.
+
+La meilleure pratique recommandée pour définir les clés d'application consiste à accorder à vos clés les privilèges minimaux et les permissions minimales nécessaires pour qu'une application fonctionne comme prévu. Les clés d'application à portées spécifiques reçoivent uniquement les portées spécifiées par l'utilisateur, sans permission additionnelle. Bien que vous puissiez modifier les portées d'autorisation de vos clés d'application à tout moment, considérez comment ces changements peuvent affecter la fonctionnalité ou l'accès existant de votre application.
+
+**Notes :**
+
+-Les utilisateurs ou comptes de service disposant de [permissions][3] pour créer ou modifier des clés d'application peuvent attribuer des portées à ces clés. Un utilisateur doit détenir la permission `user_app_keys` pour attribuer des portées à ses propres clés d'application, ou la permission `org_app_keys_write` pour attribuer des portées aux clés d'application appartenant à tout utilisateur de son organisation. Un utilisateur doit avoir la permission `service_account_write` pour attribuer des portées aux clés d'application des comptes de service.
- Le propriétaire d'une application ne peut pas autoriser une application s'il ne dispose pas de l'ensemble des autorisations requises, même s'il applique une portée d'autorisation qu'il ne possède pas à une clé d'application.
-- En cas d'autorisation manquante lors de l'écriture d'une clé d'application ou de l'autorisation d'une application, une erreur `403 Forbidden` est renvoyée. Pour en savoir plus sur les différentes erreurs pouvant être renvoyées, consultez la documentation de l'[API Datadog][5].
+- Les erreurs dues à des permissions manquantes lors de l'écriture de clés d'application ou de l'autorisation d'applications affichent une erreur `403 Forbidden`. Plus d'informations sur les différentes réponses d'erreur peuvent être trouvées dans la documentation de l'[API Datadog][4].
- Si le rôle ou les autorisations d'un utilisateur changent, les portées d'autorisation pour ses clés d'application restent identiques.
-## Tokens client
+### Accès à l'API Actions {#actions-api-access}
-Pour des raisons de sécurité, vous ne pouvez pas utiliser de clés d'API pour envoyer des données depuis une application pour navigateur, mobile ou téléviseur : celles-ci seraient exposées côté client. Les applications conçues pour les utilisateurs finaux reposent donc sur des tokens client pour transmettre des données à Datadog.
+Les API d'actions incluent :
+- [App Builder][5]
+- [Actions Connections][6]
+- [Workflow Automation][7]
+
+Pour utiliser des clés d'application avec ces API, vous devez activer l'accès à l'API Actions sur la clé d'application. Cela peut être fait [via l'interface utilisateur][2] ou [API][21]. Par défaut, les clés d'application ne peuvent pas être utilisées avec ces API.
+
+{{< img src="account_management/click-enable-actions-api-access.png" alt="Cliquez sur Activer pour l'accès à l'API Actions" style="width:80%;" >}}
+
+**Remarque** : La section {{< ui >}}Last used{{< /ui >}} n'apparaît que si [le journal d'audit est activé][22] dans le compte et que vous avez la permission [`Audit Trail Read`][23].
+
+## Jetons clients {#client-tokens}
+
+Pour des raisons de sécurité, les clés API ne peuvent pas être utilisées pour envoyer des données depuis un navigateur, une application mobile ou une application TV, car elles seraient exposées côté client. Au lieu de cela, les applications destinées aux utilisateurs finaux utilisent des jetons clients pour envoyer des données à Datadog.
Plusieurs types de clients doivent utiliser un token client pour envoyer des données. Par exemple :
-- Les collecteurs de logs pour les [navigateurs Web][6], [Android][7], [iOS][8], [React Native][9], [Flutter][10], et [Roku][11], qui envoient des logs.
-- Les applications [Real User Monitoring][12], qui envoient des événements et des logs
+- Les collecteurs de journaux pour [navigateur web][8], [Android][9], [iOS][10], [React Native][11], [Flutter][12] et [Roku][13] soumettent des journaux.
+- Les applications [Surveillance des utilisateurs réels][14] soumettent des événements et des journaux.
-Les tokens client sont uniques à votre organisation. Pour les gérer, accédez à **Organization Settings**, puis cliquez sur l'onglet **Client Tokens**.
+Les jetons clients sont uniques à votre organisation. Pour gérer vos jetons clients, allez à {{< ui >}}Organization Settings{{< /ui >}}, puis cliquez sur l'onglet {{< ui >}}Client Tokens{{< /ui >}}.
-**Remarque** : lorsqu'un utilisateur ayant créé un token client est désactivé, le token client demeure valide.
+**Remarque** : Lorsqu'un utilisateur qui a créé un jeton client est désactivé, le jeton client reste actif.
-## Ajouter une clé d'API ou un token client
+## Ajoutez une clé API ou un jeton client {#add-an-api-key-or-client-token}
Pour ajouter une clé d'API Datadog ou un token client, procédez comme suit :
-1. Accédez aux paramètres d'organisation, puis cliquez sur l'onglet [**API keys**][1] ou [**Client Tokens**][13].
-2. Cliquez sur le bouton **New Key** ou **New Client Token**, en fonction de l'élément à créer.
+1. Accédez aux paramètres de l'organisation, puis cliquez sur l'onglet [**Clés API**][1] ou [**Jetons clients**][15].
+2. Cliquez sur le bouton {{< ui >}}New Key{{< /ui >}} ou {{< ui >}}New Client Token{{< /ui >}}, selon celui que vous créez.
3. Attribuez un nom à votre clé ou à votre token.
-4. Cliquez sur **Create API key** ou **Create Client Token**.
+4. Cliquez sur {{< ui >}}Create API key{{< /ui >}} ou {{< ui >}}Create Client Token{{< /ui >}}.
-{{< img src="account_management/api-key.png" alt="Accédez à la page des clés dʼAPI de votre organisation dans Datadog" style="width:80%;" >}}
+{{< img src="account_management/api-key.png" alt="Accédez à la page des clés API pour votre organisation dans Datadog" style="width:80%;" >}}
-**Remarques :**
+**Remarques :**
-- Votre organisation doit posséder entre une et 50 clés d'API.
+- Votre organisation doit avoir au moins une clé API et au maximum 50 clés API.
- Les noms de clé doivent être uniques au sein de votre organisation.
-## Supprimer des clés d'API ou des tokens client
+## Supprimez les clés API ou les jetons clients {#remove-api-keys-or-client-tokens}
-Pour supprimer une clé d'API ou un token client Datadog, accédez à la liste des clés ou tokens, puis cliquez sur l'icône en forme de **corbeille** de l'option **Revoke** en regard de la clé ou du token à supprimer.
+Pour supprimer une clé API ou un jeton client Datadog, accédez à la liste des clés ou des jetons, puis cliquez sur le {{< ui >}}Delete{{< /ui >}} {{< img src="icons/delete.png" inline="true" style="width:14px;">}} icône à côté de la clé ou du jeton que vous souhaitez supprimer.
-## Ajouter des clés d'application
+## Ajouter des clés d'application {#add-application-keys}
-Pour ajouter une clé d'application Datadog, accédez à [**Organization Settings** > **Application Keys**][2]. Cliquez ensuite sur **New Key**. Cette option s'affiche uniquement si vous disposez de l'[autorisation][4] requise pour créer des clés d'application.
+Pour ajouter une clé d'application Datadog, accédez à [**Paramètres de l'organisation** > **Clés d'application**][2]. Si vous avez la [permission][3] de créer des clés d'application, cliquez sur {{< ui >}}New Key{{< /ui >}}.
-{{< img src="account_management/app-key.png" alt="Accédez à la page des clés dʼapplication de votre organisation dans Datadog" style="width:80%;" >}}
+{{< img src="account_management/app-key.png" alt="Accédez à la page des clés d'application pour votre organisation dans Datadog." style="width:80%;" >}}
-{{< site-region region="ap2,gov" >}}
-
Assurez-vous de stocker votre clé d'application en toute sécurité dès sa création, car le secret de la clé ne peut pas être récupéré ultérieurement.
+{{< site-region region="ap2,gov,gov2" >}}
+
Assurez-vous de stocker en toute sécurité votre clé d'application immédiatement après sa création, car le secret de la clé ne peut pas être récupéré ultérieurement.
{{< /site-region >}}
-**Remarques :**
+
Si votre organisation a le mode Lecture Unique (OTR) activé, assurez-vous de stocker en toute sécurité votre clé d'application immédiatement après sa création, car le secret de la clé ne peut pas être récupéré ultérieurement.
+
+**Remarques:**
-- Les noms de clé d'application ne peuvent pas être vides.
+- Les noms des clés d'application ne peuvent pas être vides.
-## Supprimer des clés d'application
+## Supprimer des clés d'application {#remove-application-keys}
-Pour supprimer une clé d'application Datadog, accédez à [**Organization Settings** > **Application Keys**][2]. Vos clés d'application s'affichent alors. Cliquez ensuite sur l'option **Revoke** en regard de la clé à révoquer. Cette option s'affiche uniquement si vous disposez de l'[autorisation][4] requise pour créer et gérer des clés d'application. Si vous êtes autorisé à gérer toutes les clés d'application de votre organisation, vous pouvez rechercher la clé à révoquer, puis cliquer sur l'option **Revoke** correspondante.
+Pour supprimer une clé d'application Datadog, accédez à [**Paramètres de l'organisation** > **Clés d'application**][2]. Si vous avez la [permission][3] de créer et de gérer des clés d'application, vous pouvez voir vos propres clés et cliquer sur {{< ui >}}Revoke{{< /ui >}} à côté de la clé que vous souhaitez révoquer. Si vous avez la permission de gérer toutes les clés d'application de l'organisation, vous pouvez rechercher la clé que vous souhaitez révoquer et cliquer sur {{< ui >}}Revoke{{< /ui >}} à côté de celle-ci.
-## Propagation des clés et cohérence éventuelle
+## Délai de propagation des clés et cohérence éventuelle {#key-propagation-delay-and-eventual-consistency}
-Les clés API et les clés d'application de Datadog suivent un modèle de cohérence éventuelle. En raison de l'architecture distribuée du système, les mises à jour de clés, comme leur création ou révocation, peuvent prendre quelques secondes pour se propager complètement.
+Les clés API et d'application de Datadog suivent un modèle de cohérence éventuelle. En raison de la nature distribuée des systèmes de Datadog, les mises à jour des clés, telles que la création et la révocation, peuvent prendre quelques secondes pour se propager complètement.
En conséquence :
-- N'utilisez pas immédiatement une nouvelle clé API ou d'application dans des workflows critiques. Prévoyez quelques secondes pour sa propagation. Mettez en place une stratégie de nouvelle tentative avec backoff exponentiel court pour gérer les erreurs transitoires durant la propagation.
-- Pour vérifier si une clé API est active, utilisez l'endpoint [/api/v1/validate][18].
-- Pour vérifier si une clé d'application est active, utilisez l'endpoint `/api/v2/validate_keys` avec les bonnes paires de clés.
+- Ne pas utiliser de nouvelles clés API ou d'application immédiatement dans des workflows critiques. Prévoir une brève période (quelques secondes) pour la propagation. Vous pouvez mettre en œuvre une stratégie de réessai avec un court délai exponentiel pour gérer les erreurs transitoires pendant la fenêtre de propagation.
+- Pour valider si une clé API est active et utilisable, appelez le point de terminaison [/api/v1/validate][16].
+- Pour vérifier qu'une clé d'application est active, utilisez le point de terminaison `/api/v2/validate_keys` avec la paire de clés appropriée.
L'utilisation d'une clé nouvellement créée avant sa propagation complète peut entraîner des erreurs d'authentification temporaires, telles que 403 Forbidden ou 401 Unauthorized.
-## Définir le champ d'application d'une clé d'application
+## Définir la portée des clés d'application {#scope-application-keys}
-Pour appliquer des portées d'autorisation à des clés d'application, créez ou modifiez une clé d'application en [envoyant une requête sur l'API Datadog][5] ou lʼIU pour créer ou modifier une clé dʼapplication. Il est possible d'appliquer une portée aux clés d'application appartenant à [l'utilisateur actuel][14] ou à un [compte de service][15]. Si ce champ n'est pas spécifié, par défaut, la portée de la clé d'application correspondra aux autorisations de l'utilisateur qui l'a créée.
+Pour spécifier des portées d'autorisation pour les clés d'application, effectuez une requête à l'[API Datadog][4] ou utilisez l'interface utilisateur pour créer ou modifier une clé d'application. Les portées peuvent être spécifiées pour les clés d'application appartenant à [l'utilisateur actuel][17] ou à un [compte de service][18]. Si ce champ n'est pas spécifié, les clés d'application ont par défaut toutes les mêmes portées et permissions que l'utilisateur qui les a créées.
-**Remarques :**
+**Remarques:**
-- Les noms des portées sont sensibles à la casse.
+- Les noms de portée sont sensibles à la casse.
-## Utilisation de plusieurs clés d'API
+## Utilisation de plusieurs clés API {#using-multiple-api-keys}
-Pensez à configurer plusieurs clés d'API pour votre organisation. Par exemple, utilisez des clés d'API différentes pour chacune de vos méthodes de déploiement : une pour le déploiement d'un Agent sur Kubernetes dans AWS, une pour le déploiement sur site avec Chef, une pour les scripts Terraform qui automatisent vos dashboards ou monitors, et une pour les développeurs qui réalisent des déploiements localement.
+Envisagez de configurer plusieurs clés API pour votre organisation. Par exemple, utilisez différentes clés API pour chacune de vos méthodes de déploiement : une pour déployer un Agent sur Kubernetes dans AWS, une pour le déployer sur site avec Chef, une pour les scripts Terraform qui automatisent vos tableaux de bord ou vos moniteurs, et une pour les développeurs déployant localement.
L'utilisation de plusieurs clés d'API vous permet d'effectuer une rotation des clés dans le cadre de vos mesures de sécurité ou de révoquer une clé spécifique si elle est exposée par inadvertance ou si vous cessez d'utiliser le service auquel elle est associée.
-Si la limite de 50 clés d'API est insuffisante pour votre organisation, contactez l'[assistance][16] pour demander d'augmenter ce nombre.
+Si votre organisation a besoin de plus que la limite intégrée de 50 clés API, contactez [le support][19] pour demander une augmentation de votre limite.
-## Désactiver un compte utilisateur
+## Désactivation d'un compte utilisateur {#disabling-a-user-account}
-Si le compte d'un utilisateur est désactivé, les clés d'application créées par cet utilisateur sont révoquées. Les clés d'API créées par le compte désactivé ne sont pas supprimées et restent valides.
+Si le compte d'un utilisateur est désactivé, toutes les clés d'application que l'utilisateur a créées sont révoquées. Toutes les clés API qui ont été créées par le compte désactivé ne sont pas supprimées et restent valides.
-## Transferts de clé
+## Transfert de clés {#transferring-keys}
-Pour des raisons de sécurité, Datadog ne transfère pas les clés d'application d'un utilisateur à un autre. Si vous devez partager une clé d'application, utilisez un [compte de service][17].
+Pour des raisons de sécurité, Datadog ne transfère pas les clés d'application d'un utilisateur à un autre. Si vous devez partager une clé d'application, utilisez un [compte de service][20].
-## Que faire en cas d'exposition d'une clé d'API ou d'application
+## Que faire si une clé API ou une clé d'application a été exposée {#what-to-do-if-an-api-or-application-key-was-exposed}
-Si une clé privée a été compromise ou exposée publiquement, vous devez prendre des mesures pour sécuriser votre compte aussi vite que possible. Le fait de supprimer le fichier contenant la clé d'un site public comme GitHub ne garantit **pas** qu'un tiers n'y a pas déjà accédé.
+Si une clé privée a été compromise ou exposée publiquement, des mesures doivent être prises le plus rapidement possible pour garantir la sécurité de votre compte. Supprimer le fichier contenant la clé d'un site public tel que GitHub **ne** garantit pas qu'il n'a pas déjà été consulté par une autre partie.
Suivez ces étapes pour protéger votre compte :
-**Remarque :** la révocation d'une clé active peut affecter le fonctionnement de vos services. Si la portée de la clé est vaste ou inconnue, nous vous conseillons de suivre les étapes 2 à 5 **avant** de révoquer la clé affectée.
+**Remarque :** Révoquer une clé active peut avoir un impact sur vos services. Si l'étendue d'utilisation est large ou indéterminée, envisagez les étapes 2 à 5 **avant** de révoquer la clé concernée.
1. Révoquez la clé affectée.
2. Supprimez le code contenant la clé privée de tous les fichiers accessibles publiquement :
- - Publiez le fichier corrigé sur votre dépôt public.
+ - Publiez le fichier assaini dans votre dépôt public.
- Supprimez les données sensibles de votre historique de commits.
3. Créez une nouvelle clé.
4. Mettez à jour la clé pour les services affectés.
5. Vérifiez que votre compte n'a fait l'objet d'aucun accès non autorisé :
- Utilisateurs récemment ajoutés
- Nouvelles ressources
- - Modifications apportées aux rôles ou aux autorisations
+ - Changements de rôles ou de permissions
-Si vous avez identifié une activité inhabituelle ou que vous avez besoin d'aide pour sécuriser votre compte, contactez l'[assistance Datadog][16].
+Si une activité inhabituelle est identifiée, ou si vous avez besoin d'aide supplémentaire pour sécuriser votre compte, contactez [le support Datadog][19].
-## Dépannage
+## Dépannage {#troubleshooting}
-Besoin d'aide ? Contactez [l'assistance Datadog][16].
+Besoin d'aide ? Contactez [le support Datadog][19].
[1]: https://app.datadoghq.com/organization-settings/api-keys
-[2]: https://app.datadoghq.com/access/application-keys
-[4]: /fr/account_management/rbac/permissions
-[5]: /fr/api/latest/key-management/
-[6]: /fr/logs/log_collection/javascript/
-[7]: /fr/logs/log_collection/android/
-[8]: /fr/logs/log_collection/ios/
-[9]: /fr/logs/log_collection/reactnative/
-[10]: /fr/logs/log_collection/flutter/
-[11]: /fr/logs/log_collection/roku/
-[12]: /fr/real_user_monitoring/
-[13]: https://app.datadoghq.com/organization-settings/client-tokens
-[14]: /fr/api/latest/key-management/#create-an-application-key-for-current-user
-[15]: /fr/api/latest/service-accounts/
-[16]: /fr/help/
-[17]: /fr/account_management/org_settings/service_accounts/
-[18]: /fr/api/latest/authentication/#validate-api-key
\ No newline at end of file
+[2]: https://app.datadoghq.com/organization-settings/application-keys
+[3]: /fr/account_management/rbac/permissions
+[4]: /fr/api/latest/key-management/
+[5]: /fr/api/latest/app-builder/
+[6]: /fr/api/latest/action-connection/
+[7]: /fr/api/latest/workflow-automation/
+[8]: /fr/logs/log_collection/javascript/
+[9]: /fr/logs/log_collection/android/
+[10]: /fr/logs/log_collection/ios/
+[11]: /fr/logs/log_collection/reactnative/
+[12]: /fr/logs/log_collection/flutter/
+[13]: /fr/logs/log_collection/roku/
+[14]: /fr/real_user_monitoring/
+[15]: https://app.datadoghq.com/organization-settings/client-tokens
+[16]: /fr/api/latest/authentication/#validate-api-key
+[17]: /fr/api/latest/key-management/#create-an-application-key-for-current-user
+[18]: /fr/api/latest/service-accounts/
+[19]: /fr/help/
+[20]: /fr/account_management/org_settings/service_accounts/
+[21]: /fr/api/latest/action-connection/#register-a-new-app-key
+[22]: /fr/account_management/audit_trail/#setup
+[23]: /fr/account_management/rbac/permissions/#compliance
\ No newline at end of file
diff --git a/content/fr/account_management/rbac/permissions.md b/content/fr/account_management/rbac/permissions.md
index c4ef83d3f8a..08cd925b0ac 100644
--- a/content/fr/account_management/rbac/permissions.md
+++ b/content/fr/account_management/rbac/permissions.md
@@ -1,56 +1,92 @@
---
+algolia:
+ category: Documentation
+ rank: 80
+ subcategory: Datadog Role Permissions
aliases:
- /fr/account_management/faq/managing-global-role-permissions
+description: Référence complète des autorisations Datadog, y compris les rôles gérés,
+ les rôles personnalisés, les autorisations sensibles et la liste des autorisations.
disable_toc: true
further_reading:
- link: /account_management/rbac/
tag: Documentation
- text: Découvrir comment créer, mettre à jour et supprimer un rôle
-- link: /api/v2/roles/#enumerer-les-autorisations
+ text: Créer, mettre à jour et supprimer un rôle
+- link: /api/v2/roles/#list-permissions
tag: Documentation
text: Gérer vos autorisations avec l'API Permission
title: Autorisations des rôles Datadog
-algolia:
- rank: 80
- category: Documentation
- subcategory: Autorisations des rôles Datadog
---
+## Autorisations {#permissions}
+
+Les autorisations définissent le type d'accès qu'un utilisateur a à une ressource donnée. En général, les autorisations donnent à un utilisateur le droit de lire, de modifier ou de supprimer un objet. Les autorisations sous-tendent les droits d'accès de tous les rôles, y compris les trois rôles gérés et les rôles personnalisés.
+
+### Autorisations sensibles {#sensitive-permissions}
+
+Certaines autorisations Datadog donnent accès à des fonctionnalités plus privilégiées qu'il est important de connaître, telles que :
+
+- Accès pour modifier les paramètres de l'organisation
+- Accès pour lire des données potentiellement sensibles
+- Accès pour effectuer des opérations privilégiées
+
+Les autorisations sensibles sont signalées dans les interfaces Rôles et Autorisations pour indiquer qu'elles peuvent nécessiter une attention accrue. En tant que meilleure pratique, les administrateurs configurant des rôles doivent prêter une attention particulière à ces autorisations et confirmer lesquelles de ces autorisations sont attribuées à leurs rôles et utilisateurs.
+
+### Autorisations en mode aperçu {#preview-mode-permissions}
+
+Certaines autorisations apparaissent en "mode aperçu" avant de devenir pleinement appliquées. Pendant cette période :
+
+- Les autorisations en aperçu sont marquées dans l'application avec un badge "Aperçu"
+- Elles ne restreignent pas l'accès jusqu'à la fin de la période d'aperçu
+- L'aperçu dure généralement de 2 à 4 semaines avant que l'application des autorisations ne commence.
+- Les administrateurs doivent configurer les rôles de manière appropriée pendant cette période
+
+Le mode aperçu donne aux administrateurs de votre organisation la possibilité d'opter pour certaines nouvelles autorisations, afin qu'ils puissent éviter de perdre l'accès à des ressources qui étaient auparavant non restreintes. Les notes de version associées à chaque mode d'aperçu indiquent quand la permission est créée et quand elle sera appliquée. Bien que ces permissions ne restreignent pas l'accès pendant l'aperçu, Datadog recommande de mettre à jour les configurations de rôle avant qu'elles ne soient appliquées pour éviter toute interruption.
+
+## Rôles {#roles}
+
+### Rôles gérés {#managed-roles}
+
+Par défaut, les utilisateurs existants sont associés à l'un des trois rôles gérés :
+
+- Rôle Administrateur Datadog
+- Rôle Standard Datadog
+- Rôle Datadog en lecture seule
-Une fois votre rôle créé, attribuez-lui ou retirez-lui directement des autorisations en [le modifiant dans Datadog][1] ou via [l'API Permission de Datadog][2]. Vous trouverez ci-dessous la liste des autorisations disponibles.
+Tous les utilisateurs ayant l'un de ces rôles peuvent lire des données, sauf pour les ressources [individuellement restreintes en lecture][1]. Les utilisateurs administrateurs et standards ont des autorisations d'écriture sur les actifs. Les utilisateurs administrateurs ont des autorisations supplémentaires de lecture et d'écriture pour les actifs sensibles liés à la gestion des utilisateurs, à la gestion de l'organisation, à la facturation et à l'utilisation.
-## Présentation
+Les rôles gérés sont créés et maintenus par Datadog. Leurs autorisations peuvent être mises à jour automatiquement par Datadog à mesure que de nouvelles fonctionnalités sont ajoutées ou que les autorisations changent. Les utilisateurs ne peuvent pas modifier directement les rôles gérés, mais ils peuvent les cloner pour créer des [rôles personnalisés](#custom-roles) avec des autorisations spécifiques. Si nécessaire, les utilisateurs peuvent supprimer des rôles gérés de leur compte.
-### Autorisations générales
+### Rôles personnalisés {#custom-roles}
-Les autorisations générales définissent les niveaux d'accès minimum pour votre rôle. Les [autorisations avancées](#autorisations-avancees) permettent ensuite d'accorder des droits supplémentaires.
+Créez un rôle personnalisé pour combiner des permissions en de nouveaux rôles. Un rôle personnalisé vous permet de définir un profil, par exemple, un administrateur de facturation, puis d'attribuer les autorisations appropriées pour ce rôle. Après avoir créé un rôle, attribuez ou retirez des autorisations à ce rôle directement en [mettant à jour le rôle dans Datadog][2], ou via l'[API d’autorisations Datadog][3]. Vous pouvez également ajouter une permission à plusieurs rôles personnalisés à la fois en sélectionnant ces rôles depuis la page des rôles et en cliquant sur {{< ui >}}Add Permission{{< /ui >}}.
-{{< permissions group="Géneral" >}}
+Contrairement aux rôles gérés, les rôles personnalisés ne reçoivent pas de nouvelles autorisations lorsque Datadog publie de nouveaux produits et fonctionnalités, sauf s'ils sont configurés pour recevoir des mises à jour automatiques. Si les mises à jour automatiques sont désactivées, les rôles personnalisés ne reçoivent que de nouvelles autorisations pour maintenir la compatibilité lorsque Datadog publie une nouvelle autorisation qui restreint une fonctionnalité existante.
-**Remarque** : il n'existe pas d'autorisation `read-only`. Pour obtenir un accès en lecture seule, il suffit de ne pas accorder l'autorisation `standard`.
+Pour configurer les mises à jour automatiques pour les rôles personnalisés :
-### Autorisations avancées
+1. Allez sur la page des paramètres de l'organisation et cliquez sur l'onglet {{< ui >}}Roles{{< /ui >}}.
+2. Cliquez sur le rôle que vous souhaitez mettre à jour et cliquez sur {{< ui >}}Edit Role{{< /ui >}}.
+3. Sous {{< ui >}}Automatically Receives Permissions{{< /ui >}}, choisissez une option dans le menu déroulant : Aucune, Rôle Datadog en lecture seule, Rôle Datadog standard ou Rôle Datadog administrateur.
-Par défaut, les utilisateurs existants sont associés à l'un des trois rôles prêts à l'emploi :
+Si le rôle personnalisé est configuré pour recevoir des mises à jour automatiques, votre rôle personnalisé reçoit toutes les nouvelles autorisations dès qu'elles sont publiées pour le modèle de rôle sélectionné. Aucune autorisation déjà publiée n'est ajoutée. Vous pouvez ajouter ou supprimer des autorisations de ce rôle et continuer à recevoir des mises à jour automatiques.
-- Admin Datadog
-- Standard Datadog
-- Read-Only Datadog
+**Remarque** : Lorsque vous ajoutez un nouveau rôle personnalisé à un utilisateur, assurez-vous de supprimer le rôle Datadog géré associé à cet utilisateur pour appliquer strictement les nouvelles autorisations du rôle.
-Tous les utilisateurs peuvent lire l'ensemble des types de données. Les utilisateurs Admin et Standard sont autorisés à écrire des données sur des ressources.
+## Liste des autorisations {#permissions-list}
-**Remarque** : lorsque vous attribuez un nouveau rôle personnalisé à un utilisateur, assurez-vous de supprimer le rôle Datadog par défaut attribué à cet utilisateur afin d'appliquer les nouvelles autorisations de rôle.
+Le tableau suivant répertorie le nom, la description et le rôle par défaut pour toutes les autorisations disponibles dans Datadog. Chaque type d'actif a des autorisations de lecture et d'écriture correspondantes.
-En plus des autorisations générales, vous pouvez définir des autorisations plus granulaires pour des ressources ou des types de données spécifiques. Les autorisations peuvent être globales ou limitées à un sous-ensemble d'éléments. Vous trouverez ci-dessous les détails de ces options et leur impact sur chacune des autorisations disponibles.
+Chaque rôle géré hérite de toutes les autorisations des rôles moins puissants. Par conséquent, le rôle Datadog standard a toutes les autorisations énumérées dans le tableau avec Datadog en lecture seule comme rôle par défaut. De plus, le rôle Datadog administrateur contient toutes les autorisations des rôles Datadog standard et Datadog en lecture seule.
{{% permissions %}}
-{{< permissions group="Logs" >}}
-## Pour aller plus loin
+## Lecture complémentaire {#further-reading}
{{< partial name="whats-next/whats-next.html" >}}
-*Log Rehydration est une marque déposée de Datadog, Inc.
+*Log Rehydration est une marque de commerce de Datadog, Inc.
-[1]: /fr/account_management/users/#edit-a-user-s-roles
-[2]: /fr/api/latest/roles/#list-permissions
\ No newline at end of file
+[1]: /fr/account_management/rbac/granular_access
+[2]: /fr/account_management/users/#edit-a-user-s-roles
+[3]: /fr/api/latest/roles/#list-permissions
\ No newline at end of file
diff --git a/content/fr/agent/_index.md b/content/fr/agent/_index.md
index 682f7ed3596..8603c4e541b 100644
--- a/content/fr/agent/_index.md
+++ b/content/fr/agent/_index.md
@@ -36,8 +36,11 @@ further_reading:
tag: Documentation
text: Pourquoi installer l'Agent sur des instances cloud ?
- link: https://www.datadoghq.com/blog/dont-fear-the-agent/
- tag: Blog
+ tag: GitHub
text: N'ayez pas peur de l'Agent
+- link: https://learn.datadoghq.com/courses/agent-on-host
+ tag: Centre d'apprentissage
+ text: L'Agent sur un hôte
title: Agent
---
+
+## Démarrer, arrêter et redémarrer l'Agent {#start-stop-and-restart-the-agent}
+
+### Démarrer l'Agent {#start-the-agent}
+
+Liste des commandes pour démarrer l'Agent Datadog :
+
+| Plateforme | Commande |
+|------------|--------------------------------------------------------------------|
+| AIX | `startsrc -s datadog-agent` |
+| Linux | Consultez la [documentation de l'Agent][1] pour votre système d'exploitation. |
+| Docker | Utilisez la [commande d'installation][2]. |
+| Kubernetes | `kubectl create -f datadog-agent.yaml` |
+| macOS | `launchctl start com.datadoghq.agent` *ou* via l'application systray |
+| Source | `sudo service datadog-agent start` |
+| Windows | Consultez la [documentation de l'Agent Windows][3]. |
+
+### Arrêter l'Agent {#stop-the-agent}
+
+Liste des commandes pour arrêter l'Agent Datadog :
+
+| Plateforme | Commande |
+|------------|----------------------------------------------------------------------------------|
+| AIX | `stopsrc -s datadog-agent` |
+| Linux | Consultez la [documentation de l'Agent][1] pour votre système d'exploitation. |
+| Docker | `docker exec -it agent stop` |
+| Kubernetes | `kubectl delete pod `—note : le pod est automatiquement replanifié |
+| macOS | `launchctl stop com.datadoghq.agent` *ou* via l'application systray |
+| Source | `sudo service datadog-agent stop` |
+| Windows | Consultez la [documentation de l'Agent Windows][3]. |
+
+### Redémarrer l'Agent {#restart-the-agent}
+
+Liste des commandes pour redémarrer l'Agent Datadog :
+
+| Plateforme | Commande |
+|------------|----------------------------------------------------------------------------------|
+| Linux | Consultez la [documentation de l'Agent][1] pour votre système d'exploitation. |
+| Docker | Utilisez la [commande d'installation][2]. |
+| Kubernetes | `kubectl delete pod `—note : le pod est automatiquement reprogrammé |
+| macOS | Arrêtez puis redémarrez l'Agent avec : `launchctl stop com.datadoghq.agent` `launchctl start com.datadoghq.agent` Ou utilisez l'application systray |
+| Source | *Plateforme non prise en charge* |
+| Windows | Consultez la [documentation de l'Agent Windows][3]. |
+
+
+## État et informations de l'Agent {#agent-status-and-information}
+
+### État du service {#service-status}
+
+Liste des commandes pour afficher le statut de l'Agent Datadog :
+
+| Plateforme | Commande |
+|-----------------|-------------------------------------------------------------------------------|
+| AIX | `lssrc -s datadog-agent` |
+| Linux | Consultez la [documentation de l'Agent][1] pour votre système d'exploitation. |
+| Docker (Debian) | `sudo docker exec -it s6-svstat /var/run/s6/services/agent/` |
+| Kubernetes | `kubectl exec -it -- s6-svstat /var/run/s6/services/agent/` |
+| macOS | `launchctl list com.datadoghq.agent` *ou* via l'application systray |
+| Source | `sudo service datadog-agent status` |
+| Windows | Consultez la [documentation de l'Agent Windows][4]. |
+| [Cluster Agent (Kubernetes)][5] | `datadog-cluster-agent status` |
+
+### Informations sur l'agent {#agent-information}
+
+Liste des commandes pour afficher le statut de votre Agent Datadog et les intégrations activées.
+
+| Plateforme | Commande |
+|------------|------------------------------------------------------|
+| AIX | `datadog-agent status` |
+| Linux | `sudo datadog-agent status` |
+| Docker | `sudo docker exec -it agent status` |
+| Kubernetes | `kubectl exec -it -- agent status` |
+| macOS | `datadog-agent status` or through the [web GUI][6] |
+| Source | `sudo datadog-agent status` |
+| Windows | Consultez la [documentation de l'Agent Windows][4]. |
+| [Cluster Agent (Kubernetes)][5] | `datadog-cluster-agent status` |
+
+Une intégration correctement configurée s'affiche sous **Running Checks** sans avertissements ni erreurs, comme indiqué ci-dessous :
+
+```text
+Running Checks
+==============
+ network (1.6.0)
+ ---------------
+ Total Runs: 5
+ Metric Samples: 26, Total: 130
+ Events: 0, Total: 0
+ Service Checks: 0, Total: 0
+ Average Execution Time : 0ms
+```
+
+## Autres commandes {#other-commands}
+
+L'interface de ligne de commande de l'Agent est basée sur des sous-commandes. Pour voir la liste des sous-commandes disponibles, exécutez :
+
+```shell
+ --help
+```
+
+Pour exécuter une sous-commande, vous devez invoquer le binaire de l'Agent :
+
+```shell
+
+```
+
+Certaines options ont des flags et des options détaillées sous `--help`. Par exemple, utilisez l'aide avec la sous-commande `check` :
+
+```shell
+ check --help
+```
+
+| Sous-commande | Remarques |
+|-------------------|-----------------------------------------------------------------------------|
+| `check` | Exécutez la vérification spécifiée. |
+| `config` | [Gestion de la configuration d'exécution][7]. |
+| `configcheck` | Imprimez toutes les configurations chargées et résolues d'un Agent en cours d'exécution. |
+| `diagnose` | Exécutez un diagnostic de connectivité sur votre système. |
+| `flare` | [Collect a flare and send it to Datadog][8]. |
+| `health` | Imprimez l'état actuel de l'Agent. |
+| `help` | Aide sur n'importe quelle commande. |
+| `hostname` | Imprimez le nom d'hôte utilisé par l'Agent. |
+| `import` | Importez et convertissez les fichiers de configuration des versions précédentes de l'Agent. |
+| `jmx` | Dépannage JMX. |
+| `launch-gui` | Démarrez l'interface graphique de l'Agent Datadog. |
+| `restart-service` | Redémarrez l'Agent dans le gestionnaire de contrôle des services. Windows uniquement. |
+| `start-service` | Démarrez l'Agent dans le gestionnaire de contrôle des services. Windows uniquement. |
+| `stream-logs` | Diffusez les journaux traités par un Agent en cours d'exécution. |
+| `stopservice` | Arrêtez l'Agent dans le gestionnaire de contrôle des services. Windows uniquement. |
+| `version` | Imprimez les informations de version. |
+
+## Lectures complémentaires {#further-reading}
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /fr/agent/
+[2]: /fr/agent/docker/
+[3]: /fr/agent/basic_agent_usage/windows/
+[4]: /fr/agent/basic_agent_usage/windows/#status-and-information
+[5]: /fr/containers/cluster_agent/
+[6]: /fr/agent/basic_agent_usage/#gui
+[7]: /fr/agent/troubleshooting/config/
+[8]: /fr/agent/troubleshooting/send_a_flare/
\ No newline at end of file
diff --git a/content/fr/agent/configuration/network.md b/content/fr/agent/configuration/network.md
index 7c820bec003..3e42503d4d3 100644
--- a/content/fr/agent/configuration/network.md
+++ b/content/fr/agent/configuration/network.md
@@ -30,10 +30,10 @@ title: Trafic réseau
## Aperçu {#overview}
-Le trafic est toujours initié par l'Agent vers Datadog. Aucune session n'est jamais initiée de Datadog vers l'Agent.
+Le trafic est toujours initié par l'Agent vers Datadog. Aucune session n'est initiée par Datadog vers l'Agent.
-Tout le trafic de l'Agent est envoyé via SSL. La destination dépend du service et du site Datadog. Pour voir les destinations basées sur votre [site Datadog][11], cliquez sur le sélecteur `DATADOG SITE` à droite.
+Tout le trafic de l'Agent est envoyé via SSL. La destination dépend du service et du site Datadog. Pour voir les destinations basées sur votre [site Datadog][11], cliquez sur le sélecteur {{< ui >}}DATADOG SITE{{< /ui >}} à droite.
## Installation {#installation}
@@ -62,7 +62,7 @@ Ce comportement peut être désactivé dans la version 7.72.0 et ultérieure en
[Images de Conteneurs][13]
: `contimage-intake.`{{< region-param key="dd_site" code="true" >}}
-[Conteneurs en Direct][3], [Processus en Direct][4], [Surveillance du Réseau Cloud][24], [Surveillance Universelle des Services][25]
+[Conteneurs en Direct][3], [Processus en Direct][4], [Surveillance du Réseau Cloud][24], [Surveillance des Services Universels][25]
: `process.`{{< region-param key="dd_site" code="true" >}}
[Surveillance des Dispositifs Réseau][10]
@@ -71,7 +71,8 @@ Ce comportement peut être désactivé dans la version 7.72.0 et ultérieure en
`ndmflow-intake.`{{< region-param key="dd_site" code="true" >}}
[Chemin Réseau][14]
-: `netpath-intake.`{{< region-param key="dd_site" code="true" >}}
+: `netpath-intake.`{{< region-param key="dd_site" code="true" >}}
+Dans l'Agent v7.75+, le Chemin Réseau contacte des services externes via HTTPS pour résoudre l'adresse IP publique de l'hôte source. C'est optionnel et le Chemin Réseau fonctionne sans cela, mais si votre réseau restreint le trafic sortant et que vous souhaitez la résolution de l'adresse IP publique source, ajoutez les éléments suivants à votre liste d'autorisation : `icanhazip.com`, `ipinfo.io`, `checkip.amazonaws.com`, `api.ipify.org`, `whatismyip.akamai.com`. Voir [Configuration du Chemin Réseau][33] pour plus de détails.
[Orchestrateur][5]
: `orchestrator.`{{< region-param key="dd_site" code="true" >}}
@@ -86,18 +87,18 @@ Ce comportement peut être désactivé dans la version 7.72.0 et ultérieure en
[Vulnérabilités de Sécurité Cloud][29]
: `sbom-intake.`{{< region-param key="dd_site" code="true" >}}
-[Emplacements Privés de Surveillance Synthétique][8]
-: Travailleurs Synthétiques v1.5.0 ou ultérieur : `intake.synthetics.`{{< region-param key="dd_site" code="true" >}} est le seul point de terminaison que vous devez configurer.
-Résultats des tests API pour le Travailleur Synthétique > v0.1.6 : `intake.synthetics.`{{< region-param key="dd_site" code="true" >}}
-Résultats des tests de navigateur pour le Travailleur Synthétique > v0.2.0 : `intake-v2.synthetics.`{{< region-param key="dd_site" code="true" >}}
-Résultats des tests API pour le Travailleur Synthétique < v0.1.5 : `api.`{{< region-param key="dd_site" code="true" >}}
+[Surveillance Synthétique des Emplacements Privés][8]
+: Synthetics Worker v1.5.0 ou version ultérieure : `intake.synthetics.`{{< region-param key="dd_site" code="true" >}} est le seul point de terminaison que vous devez configurer.
+Résultats des tests API pour le Synthetics Worker > v0.1.6 : `intake.synthetics.`{{< region-param key="dd_site" code="true" >}}
+Résultats des tests de navigateur pour le Synthetics Worker > v0.2.0 : `intake-v2.synthetics.`{{< region-param key="dd_site" code="true" >}}
+Résultats des tests API pour le Synthetics Worker < v0.1.5 : `api.`{{< region-param key="dd_site" code="true" >}}
{{% site-region region="us,eu,us3,us5,ap1,ap2" %}}
[Configuration à Distance][101]
: `config.`{{< region-param key="dd_site" code="true" >}}
-[Surveillance de Base de Données][102]
+[Surveillance de base de données][102]
: `dbm-metrics-intake.`{{< region-param key="dd_site" code="true" >}}
`dbquery-intake.`{{< region-param key="dd_site" code="true" >}}
@@ -108,22 +109,22 @@ Résultats des tests API pour le Travailleur Synthétique < v0.1.5 : `api.`{{< r
{{% logs-tcp-disclaimer %}}
-[Logs][30] & [logs HIPAA][31]
+[Journaux][30] et [journaux HIPAA][31]
: (Obsolète) TCP : {{< region-param key=tcp_endpoint code="true" >}}
HTTP : {{< region-param key=agent_http_endpoint code="true" >}}
-Autre : Voir [points de terminaison des journaux][32]
+Autre : Voir [points de terminaison de journaux][32]
-[Journaux HIPAA hérités][31] (Obsolète, TCP non pris en charge)
+[journaux HIPAA hérités][31] (Obsolète, TCP non pris en charge)
: {{< region-param key=hipaa_logs_legacy code="true" >}}
[Métriques][26], [Vérifications de service][27], [Événements][28] et autres métadonnées de l'Agent
: `-app.agent.`{{< region-param key="dd_site" code="true" >}}
Par exemple, l'Agent v7.31.0 rapporte à `7-31-0-app.agent.`{{< region-param key="dd_site" code="true" >}}. Vous devez ajouter `*.agent.`{{< region-param key="dd_site" code="true" >}} à votre liste d'inclusion dans votre(s) pare-feu(s).
-Depuis v6.1.0, l'Agent interroge également l'API de Datadog pour fournir des fonctionnalités non critiques (Par exemple, afficher la validité de la clé API configurée) :
+Depuis v6.1.0, l'Agent interroge également l'API de Datadog pour fournir des fonctionnalités non critiques (Par exemple, afficher la validité de la clé API configurée) :
Agent v7.18.0 ou 6.18.0 et versions ultérieures : `api.`{{< region-param key="dd_site" code="true" >}}
Agent < v7.18.0 ou 6.18.0 : `app.`{{< region-param key="dd_site" code="true" >}}
-[Flare de l'Agent][12]
+[Agent flare][12]
: `-flare.agent.`{{< region-param key="dd_site" code="true" >}}