Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translation Pipeline PR #28244

Merged
merged 89 commits into from
Mar 27, 2025
Merged
Changes from 1 commit
Commits
Show all changes
89 commits
Select commit Hold shift + click to select a range
dd52d4f
Translated file updates
guacbot Mar 18, 2025
8500460
Translated file updates
guacbot Mar 19, 2025
d10cfc2
Translated file updates
guacbot Mar 19, 2025
cd65b1c
Translated file updates
guacbot Mar 19, 2025
5874fe6
Translated file updates
guacbot Mar 19, 2025
d2af5dd
Translated file updates
guacbot Mar 19, 2025
707115a
Translated file updates
guacbot Mar 19, 2025
b5e0c84
Merge branch 'master' into guacbot/translation-pipeline
jhgilbert Mar 19, 2025
996ec7a
Translated file updates
guacbot Mar 19, 2025
abde8d0
Test fix
jhgilbert Mar 19, 2025
8490c4f
Merge branch 'master' into guacbot/translation-pipeline
jhgilbert Mar 19, 2025
aaf57c7
Remove stray punctuation
jhgilbert Mar 19, 2025
a6b6c95
Merge remote-tracking branch 'refs/remotes/origin/guacbot/translation…
jhgilbert Mar 19, 2025
a8accae
Remove stray punctuation
jhgilbert Mar 19, 2025
cbe6e39
Fix stray punctuation
jhgilbert Mar 19, 2025
f9c905a
Translated file updates
guacbot Mar 19, 2025
7f84afe
Deleting translations of content/es/real_user_monitoring/platform/con…
guacbot Mar 19, 2025
084c984
Translated file updates
guacbot Mar 19, 2025
09073b3
Translated file updates
guacbot Mar 19, 2025
4baab57
Translated file updates
guacbot Mar 20, 2025
b0592bb
Translated file updates
guacbot Mar 20, 2025
958e413
Translated file updates
guacbot Mar 20, 2025
7622663
Translated file updates
guacbot Mar 20, 2025
b542782
Translated file updates
guacbot Mar 20, 2025
6d905f7
Translated file updates
guacbot Mar 20, 2025
369baad
Translated file updates
guacbot Mar 20, 2025
2e3e0fc
Translated file updates
guacbot Mar 20, 2025
0534ef1
Translated file updates
guacbot Mar 20, 2025
bd003a9
Translated file updates
guacbot Mar 20, 2025
738a291
Translated file updates
guacbot Mar 20, 2025
b3e0c73
Translated file updates
guacbot Mar 21, 2025
b90647d
Translated file updates
guacbot Mar 21, 2025
e8870c5
Translated file updates
guacbot Mar 21, 2025
8d70e29
Translated file updates
guacbot Mar 21, 2025
43ac9d1
Translated file updates
guacbot Mar 21, 2025
a7abfe1
Translated file updates
guacbot Mar 21, 2025
5cd01cd
Translated file updates
guacbot Mar 22, 2025
3a10456
Translated file updates
guacbot Mar 22, 2025
cad5b53
Translated file updates
guacbot Mar 22, 2025
9e264e6
Translated file updates
guacbot Mar 22, 2025
acb8511
Translated file updates
guacbot Mar 22, 2025
ed6907e
Translated file updates
guacbot Mar 22, 2025
6131bf3
Translated file updates
guacbot Mar 22, 2025
06a0ada
Translated file updates
guacbot Mar 23, 2025
b2c885c
Translated file updates
guacbot Mar 23, 2025
c11525e
Translated file updates
guacbot Mar 23, 2025
1321a76
Translated file updates
guacbot Mar 23, 2025
947d3f0
Translated file updates
guacbot Mar 23, 2025
267a2da
Translated file updates
guacbot Mar 23, 2025
dfbc559
Translated file updates
guacbot Mar 24, 2025
5885838
Translated file updates
guacbot Mar 24, 2025
5d70a7c
Translated file updates
guacbot Mar 24, 2025
011564c
Translated file updates
guacbot Mar 24, 2025
bb7082e
Translated file updates
guacbot Mar 24, 2025
dfe33ac
Translated file updates
guacbot Mar 24, 2025
7dc89a9
Translated file updates
guacbot Mar 24, 2025
e15d206
Translated file updates
guacbot Mar 25, 2025
57ae4eb
Translated file updates
guacbot Mar 25, 2025
d4d66de
Translated file updates
guacbot Mar 25, 2025
8a60045
Deleting translations of content/es/software_catalog/self-service/_in…
guacbot Mar 25, 2025
6e55fbd
Deleting translations of content/es/software_catalog/self-service/sof…
guacbot Mar 25, 2025
10fa4d7
Translated file updates
guacbot Mar 25, 2025
d41b8f5
Translated file updates
guacbot Mar 25, 2025
73ddbbc
Translated file updates
guacbot Mar 25, 2025
7b738d6
Translated file updates
guacbot Mar 25, 2025
7b80f55
Translated file updates
guacbot Mar 26, 2025
db91836
Translated file updates
guacbot Mar 26, 2025
ae71615
Translated file updates
guacbot Mar 26, 2025
bc9cf89
Translated file updates
guacbot Mar 26, 2025
eac8360
Translated file updates
guacbot Mar 26, 2025
14002d8
Translated file updates
guacbot Mar 26, 2025
d8c8523
Translated file updates
guacbot Mar 26, 2025
847ba4d
Translated file updates
guacbot Mar 26, 2025
4b085ae
Translated file updates
guacbot Mar 26, 2025
d3f852b
Translated file updates
guacbot Mar 26, 2025
52e2628
Translated file updates
guacbot Mar 26, 2025
f4508ab
Update _index.md
buraizu Mar 26, 2025
0f61cb6
Update _index.md
buraizu Mar 26, 2025
629ef7e
Update _index.md
buraizu Mar 26, 2025
76edd8e
Update profile_settings.md
buraizu Mar 27, 2025
c13069a
Update configure-mobile-device-for-on-call.md
buraizu Mar 27, 2025
2939232
Update profile_settings.md
buraizu Mar 27, 2025
73b5b0c
Translated file updates
guacbot Mar 27, 2025
ae37740
Translated file updates
guacbot Mar 27, 2025
a81adc9
Translated file updates
guacbot Mar 27, 2025
8542004
Translated file updates
guacbot Mar 27, 2025
84f713e
Translated file updates
guacbot Mar 27, 2025
8cd2e03
Translated file updates
guacbot Mar 27, 2025
10baf0c
Fixes
bgdeutsch Mar 27, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Translated file updates
guacbot committed Mar 19, 2025
commit 996ec7a285aaedec1032c728df53219433714e6a
353 changes: 353 additions & 0 deletions content/es/real_user_monitoring/browser/setup/server.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,353 @@
---
beta: true
code_lang: servidor
code_lang_weight: 2
further_reading:
- link: /real_user_monitoring/explorer/
tag: Documentación
text: Más información sobre el Explorador RUM
- link: /logs/log_collection/javascript/
tag: Documentación
text: Información sobre el SDK del navegador para logs de Datadog
title: Instrumentación automática de la monitorización de navegadores (del lado del
servidor)
type: lenguaje de código múltiple
---

<div class="alert alert-info">Para probar la vista previa de la inyección automática de SDK RUM, sigue las instrucciones de configuración que aparecen a continuación.</div>

## Información general

La instrumentación automática RUM Datadog (del lado del servidor) te permite optar por Real User Monitoring (RUM) automáticamente instrumentando aplicaciones web servidas a través de un servidor web o proxy.

La instrumentación automática RUM funciona inyectando un scriptlet JavaScript del SDK RUM en las respuestas HTML que se sirven a través de un servidor web o proxy.

Una vez instrumentadas tus aplicaciones, puedes configurar tu aplicación RUM en Datadog.

## Limitaciones

La funcionalidad disponible tiene las siguientes limitaciones importantes:

- Si se aplica un proxy para el tráfico comprimido, el método de instrumentación automática no puede inyectar el scriptlet JS en el tráfico HTML.
- Este método de instrumentación no admite ninguna [configuración de RUM avanzada][3]. Sin embargo, se admiten `allowedTracingUrls` y `excludedActivityUrls`.
- Si el servidor web actúa como proxy y el servidor ascendente tiene activado el cifrado de extremo a extremo (como TLS) o la compresión de contenidos (como gzip, zstd o Brotli), es posible que el módulo no inyecte el SDK del navegador RUM. Asegúrate de lo siguiente para que la instrumentación tenga éxito:
- La compresión de contenidos está desactivada en el servidor ascendente.
- El servidor web está configurado para originar TLS.
- La configuración para la instrumentación automática (sólo Windows IIS) sólo está disponible por cada sitio Windows IIS.

## Requisitos previos

El método de instalación automática requiere que tengas instalado el [Datadog Agent][2].

## Configurar tu aplicación RUM

<div class="alert alert-warning">Para solicitar asistencia con un servidor web que no figura en esta lista, <a href="https://www.datadoghq.com/private-beta/rum-sdk-auto-injection/">rellena este formulario.</a></div>

{{< tabs >}}
{{% tab "NGINX" %}}

El método de instrumentación automática aprovecha la [capacidad de los módulos dinámicos NGINX][1] para implementar un filtro de cuerpo de respuesta. El filtro inyecta el SDK del navegador RUM en el cuerpo de la respuesta para las respuestas
identificadas como HTML. Para un control más granular de la gestión de los archivos de configuración o los permisos, también puedes instalar NGINX manualmente.

[1]: https://docs.nginx.com/nginx/admin-guide/dynamic-modules/dynamic-modules/


{{% collapse-content title="Instalación automática (recomendado)" level="h5" %}}

Para instrumentar automáticamente tu aplicación RUM:

1. En Datadog, ve a [**Digital Experience > Add an Application Page** (Experiencia digital > Añadir una página de aplicación)][1] y selecciona el tipo de aplicación JavaScript (JS).
2. Selecciona **Instrumentación automática** y **NGINX**.
3. Configura las frecuencias de muestreo de tu sesión y de Session Replay. Consulta la [guía para la configuración del muestreo][2].
4. Copia y ejecuta el comando de instalación para cargar el módulo NGINX Datadog con el inyector de SDK RUM en NGINX.
5. Una vez que el instalador haya instalado correctamente el inyector de SDK, reinicia NGINX para comenzar a recopilar sesiones RUM.
6. (Opcional) Para comprobar que el módulo está inyectando correctamente el SDK del navegador RUM en páginas HTML, consulta los logs de error de NGINX para ver si hay mensajes importantes. El módulo registra pasos importantes durante el proceso de inyección. Asegúrate de que NGINX está configurado con al menos el nivel de log `INFO` con lo siguiente:

```javascript
error_log <file> info;
```

[1]: https://app.datadoghq.com/rum/list
[2]: /es/real_user_monitoring/guide/sampling-browser-plans/

{{% /collapse-content %}}

{{% collapse-content title="Configuración manual" level="h5" %}}

### Descarga el archivo `.tgz` correspondiente

1. Utiliza el archivo `.tgz` correspondiente a tu versión de NGINX. Puedes encontrar todos los archivos `.tgz` relevantes presentados por versión de NGINX en [Referencia](#reference).
2. Extrae el tarball para extraer el archivo `ngx_http_datadog_module.so`. Desplázalo hacia una localización a la que NGINX tenga acceso (citada como `<RUM_MODULE_PATH>` en los pasos siguientes).

### Actualizar la configuración de NGINX
1. El archivo `nginx.conf` se encuentra normalmente en el directorio de configuración de NGINX. Añade la siguiente línea para cargar el módulo:

```javascript
load_module <RUM_MODULE_PATH>;
```

2. A continuación, en la sección **http/server/location**, añade lo siguiente:

```javascript
# APM Tracing is enabled by default. The following line disables APM Tracing.
datadog_disable;
datadog_rum on;
datadog_rum_config "v5" {
"applicationId" "<DATADOG_APPLICATION_ID>";
"clientToken" "<DATADOG_CLIENT_TOKEN>";
"site" "<DATADOG_SITE>";
"service" "my-web-application";
"env" "production";
"version" "1.0.0";
"sessionSampleRate" "100";
"sessionReplaySampleRate" "100";
"trackResources" "true";
"trackLongTasks" "true";
"trackUserInteractions" "true";
}
```

### Reiniciar el servidor

1. Reinicia el servidor NGINX para comenzar a recopilar datos de tu aplicación RUM Datadog. Por defecto, el SDK RUM se inyecta en todos los documentos HTML. Es posible que necesites borrar la memoria caché de tu navegador.
2. (Opcional) Para comprobar que el módulo está inyectando correctamente el SDK del navegador RUM en páginas HTML, consulta los logs de error de NGINX para ver si hay mensajes importantes. El módulo registra pasos importantes durante el proceso de inyección. Asegúrate de que NGINX está configurado con al menos el nivel de log `INFO` con lo siguiente:

```javascript
error_log <file> info;
```

{{% /collapse-content %}}

{{% /tab %}}
{{% tab "Servidor HTTP Apache" %}}

El método de instrumentación automática aprovecha la [capacidad de los módulos httpd Apache][1] para implementar un filtro de cuerpo de respuesta. El filtro inyecta el SDK del navegador RUM en el cuerpo de la respuesta para las respuestas
identificadas como HTML. Para un control más granular de la gestión de los archivos de configuración o los permisos, también puedes instalar NGINX manualmente.

[1]: https://httpd.apache.org/modules/


{{% collapse-content title="Instalación automática (recomendado)" level="h5" %}}

Para instrumentar automáticamente tu aplicación RUM:

1. En Datadog, ve a [**Digital Experience > Add an Application Page** (Experiencia digital > Añadir una página de aplicación)][1] y selecciona el tipo de aplicación JavaScript (JS).
2. Selecciona **Instrumentación automática** y **httpd**.
3. Configura las frecuencias de muestreo de tu sesión y de Session Replay. Consulta la [guía para la configuración del muestreo][2].
4. Copia y ejecuta el comando de instalación para cargar el módulo httpd Datadog con el inyector de SDK RUM en httpd.
5. Una vez que el instalador haya instalado correctamente el inyector de SDK, reinicia httpd para comenzar a recopilar sesiones RUM.
6. (Opcional) Para comprobar que el módulo está inyectando correctamente el SDK del navegador RUM en páginas HTML, consulta los logs de error de httpd para ver si hay mensajes importantes. El módulo registra pasos importantes durante el proceso de inyección. Asegúrate de que el servidor HTTP APache está configurado con al menos el nivel de log `info` con lo siguiente:

[1]: https://app.datadoghq.com/rum/list
[2]: /es/real_user_monitoring/guide/sampling-browser-plans/

{{% /collapse-content %}}

{{% collapse-content title="Configuración manual" level="h5" %}}

### Descargar el archivo del módulo

1. Descarga el [módulo comprimido][1].
2. Extrae el zip para obtener el archivo `mod_datadog.so`. Desplázalo hacia una localización a la que tenga acceso el servidor HTTP Apache (citada como `<RUM_MODULE_PATH>` en los pasos siguientes).

[1]: https://rum-auto-instrumentation.s3.amazonaws.com/httpd/latest/mod_datadog-amd64.zip

### Actualizar la configuración del servidor HTTP Apache
1. Busca el archivo de configuración. Puedes utilizar `apachectl -V` para encontrar la ruta de configuración por defecto. Añade la siguiente línea para cargar el módulo:

```javascript
LoadModule datadog_module <RUM_MODULE_PATH>
```

2. En la sección **raíz o localización** correspondiente, añade lo siguiente:

```javascript
# APM Tracing is enabled by default. The following line disables APM Tracing
DatadogTracing Off
DatadogRum On
<DatadogRumSettings>
DatadogRumOption "applicationId" "<DATADOG_APPLICATION_ID>"
DatadogRumOption "clientToken" "<DATADOG_CLIENT_TOKEN>"
DatadogRumOption "site" "<DATADOG_SITE>"
DatadogRumOption "service" "my-web-application"
DatadogRumOption "env" "production"
DatadogRumOption "version" "1.0.0"
DatadogRumOption "sessionSampleRate" "100"
DatadogRumOption "sessionReplaySampleRate" "100"
DatadogRumOption "trackResources" "true"
DatadogRumOption "trackLongTasks" "true"
DatadogRumOption "trackUserInteractions" "true"
</DatadogRumSettings>
```

### Reiniciar el servidor

1. Reinicia el servidor HTTP Apache para comenzar a recopilar datos de tu aplicación RUM Datadog. Por defecto, el SDK RUM se inyecta en todos los documentos HTML. Es posible que necesites borrar la memoria caché de tu navegador.
2. (Opcional) Para comprobar que el módulo está inyectando correctamente el SDK del navegador RUM en páginas HTML, consulta los logs de error de httpd para ver si hay mensajes importantes. El módulo registra pasos importantes durante el proceso de inyección. Asegúrate de que el servidor HTTP Apache está configurado con al menos el nivel de log `info` con lo siguiente:

{{% /collapse-content %}}

{{% /tab %}}
{{% tab "Windows IIS" %}}

La instrumentación automática aprovecha un módulo de Windows que inyecta el SDK RUM en el cuerpo de la respuesta para las respuestas servidas por la instancia IIS.

1. En Datadog, ve a [**Digital Experience > Add an Application Page** (Experiencia digital > Añadir una página de aplicación)][1] y selecciona el tipo de aplicación JavaScript (JS).
2. Selecciona **Instrumentación automática** y **Windows IIS**.
3. Configura el módulo IIS utilizando el instalador GUI o la línea de comandos como se describe a continuación:

[1]: https://app.datadoghq.com/rum/list/create/

{{% collapse-content title="Uso del instalador GUI (recomendado)" level="h5" %}}

1. Descarga el instalador RUM Datadog.
2. Sigue el instalador como administrador abriendo el archivo `.msi`.
3. Sigue las instrucciones y acepta el acuerdo de licencia.
4. Configura las frecuencias de muestreo de tu sesión y de Session Replay. Consulta la [guía para la configuración del muestreo][1].
5. Copia y ejecuta el comando de configuración mostrado para cada sitio IIS en el que quieres inyectar RUM.

[1]: /es/real_user_monitoring/guide/best-practices-for-rum-sampling/

{{% /collapse-content %}}

{{% collapse-content title="Uso de la línea de comandos" level="h5" %}}

1. Ejecuta la línea de comandos Powershell como administrador.
2. Configura las frecuencias de muestreo de tu sesión y de Session Replay. Consulta la [guía para la configuración del muestreo][1].
3. Copia y ejecuta el comando de configuración mostrado para cada sitio IIS en el que quieres inyectar RUM.

[1]: /es/real_user_monitoring/guide/best-practices-for-rum-sampling/

{{% /collapse-content %}}

{{% /tab %}}
{{< /tabs >}}

## Actualización de la aplicación RUM

Puedes ajustar las frecuencias de muestreo de tu sesión y de Session Replay desde la página Gestión de aplicaciones.

{{< tabs >}}
{{% tab "NGINX" %}}

Para actualizar tu solicitud RUM:

1. Ve a tu aplicación RUM desde la lista de [Gestión de aplicaciones][1].
2. En la página Instrumentar tu aplicación, ajusta el control deslizante o introduce un porcentaje específico en el cuadro de entrada para el muestreo de sesiones o de Session Replay.
3. Copia y pega el fragmento de configuración en tu archivo `NGINX.conf`.

[1]: https://app.datadoghq.com/rum/list

{{% /tab %}}

{{% tab "Apache HTTP Server" (Servidor HTTP Apache) %}}

Para actualizar tu solicitud RUM:

1. Ve a tu aplicación RUM desde la lista de [Gestión de aplicaciones][1].
2. En la página Instrumentar tu aplicación, ajusta el control deslizante o introduce un porcentaje específico en el cuadro de entrada para el muestreo de sesiones o de Session Replay.
3. Copia y pega el fragmento de configuración en tu archivo `/opt/datadog-httpd/datadog.conf`.

[1]: https://app.datadoghq.com/rum/list

{{% /tab %}}

{{% tab "Windows IIS" %}}

Para actualizar tu solicitud RUM:

1. Ve a tu aplicación RUM desde la lista de [Gestión de aplicaciones][1].
2. En la página Instrumentar tu aplicación, ajusta el control deslizante o introduce un porcentaje específico en el cuadro de entrada para el muestreo de sesiones o de Session Replay.
3. Copia y sustituye el código en el archivo de configuración de RUM Datadog para el sitio IIS que hayas instrumentado.

[1]: https://app.datadoghq.com/rum/list

{{% /tab %}}
{{< /tabs >}}

## Solucionar problemas

### NGINX deja de responder

Dado que el módulo se encuentra en versión de vista previa, es posible que NGINX deje de servir solicitudes, especialmente después de la instalación. Si experimentas este problema, ponte en contacto con el [servicio de asistencia de Datadog][4] con la siguiente información, para ayudar con la investigación y resolución del problema:

- Tu archivo de configuración de NGINX
- Cualquier log de error relevante

### No se inyecta RUM

Si observas que RUM no se inyecta en las páginas HTML, considera las siguientes causas posibles:

- **No coincide el tipo de contenido**: RUM sólo se inyecta en páginas HTML. Si la cabecera `Content-Type` no indica correctamente `text/html`, se omite la inyección.
- **Servidor de flujo ascendente con cifrado de extremo a extremo o compresión de contenidos**: Consulta [Limitaciones][41].

## Referencia

### Módulos NGINX

| Versión de NGINX | amd64 | arm 64 |
|---------------|-------|--------|
| 1.22.0 | [ngx_http_datadog-amd64-1.22.0][5] | [ngx_http_datadog-arm64-1.22.0][6] |
| 1.22.1 | [ngx_http_datadog-amd64-1.22.1][7] | [ngx_http_datadog-arm64-1.22.1][8] |
| 1.23.0 | [ngx_http_datadog-amd64-1.23.0][9] | [ngx_http_datadog-arm64-1.23.0][10] |
| 1.23.1 | [ngx_http_datadog-amd64-1.23.1][11] | [ngx_http_datadog-arm64-1.23.1][12] |
| 1.23.2 | [ngx_http_datadog-amd64-1.23.2][13] | [ngx_http_datadog-arm64-1.23.2][14] |
| 1.23.3 | [ngx_http_datadog-amd64-1.23.3][15] | [ngx_http_datadog-arm64-1.23.3][16] |
| 1.23.4 | [ngx_http_datadog-amd64-1.23.4][17] | [ngx_http_datadog-arm64-1.23.4][18] |
| 1.24.0 | [ngx_http_datadog-amd64-1.24.0][19] | [ngx_http_datadog-arm64-1.24.0][20] |
| 1.25.0 | [ngx_http_datadog-amd64-1.25.0][21] | [ngx_http_datadog-arm64-1.25.0][22] |
| 1.25.1 | [ngx_http_datadog-amd64-1.25.1][23] | [ngx_http_datadog-arm64-1.25.1][24] |
| 1.25.2 | [ngx_http_datadog-amd64-1.25.2][25] | [ngx_http_datadog-arm64-1.25.2][26] |
| 1.25.3 | [ngx_http_datadog-amd64-1.25.3][27] | [ngx_http_datadog-arm64-1.25.3][28] |
| 1.25.4 | [ngx_http_datadog-amd64-1.25.4][29] | [ngx_http_datadog-arm64-1.25.4][30] |
| 1.25.5 | [ngx_http_datadog-amd64-1.25.5][31] | [ngx_http_datadog-arm64-1.25.5][32] |
| 1.26.0 | [ngx_http_datadog-amd64-1.26.0][33] | [ngx_http_datadog-arm64-1.26.0][34] |
| 1.26.1 | [ngx_http_datadog-amd64-1.26.1][35] | [ngx_http_datadog-arm64-1.26.1][36] |
| 1.26.2 | [ngx_http_datadog-amd64-1.26.2][37] | [ngx_http_datadog-arm64-1.26.2][38] |
| 1.27.0 | [ngx_http_datadog-amd64-1.27.0][39] | [ngx_http_datadog-arm64-1.27.0][40] |

## Referencias adicionales

{{< partial name="whats-next/whats-next.html" >}}

[1]: /es/real_user_monitoring/browser/setup/
[2]: /es/agent/
[3]: /es/real_user_monitoring/browser/advanced_configuration/
[4]: /es/help
[5]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.22.0.so.tgz
[6]:https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.22.0.so.tgz
[7]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.22.1.so.tgz
[8]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.22.1.so.tgz
[9]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.23.0.so.tgz
[10]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.23.0.so.tgz
[11]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.23.1.so.tgz
[12]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.23.1.so.tgz
[13]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.23.2.so.tgz
[14]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.23.2.so.tgz
[15]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.23.3.so.tgz
[16]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.23.3.so.tgz
[17]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.23.4.so.tgz
[18]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.23.4.so.tgz
[19]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.24.0.so.tgz
[20]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.24.0.so.tgz
[21]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.25.0.so.tgz
[22]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.25.0.so.tgz
[23]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.25.1.so.tgz
[24]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.25.1.so.tgz
[25]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.25.2.so.tgz
[26]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.25.2.so.tgz
[27]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.25.3.so.tgz
[28]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.25.3.so.tgz
[29]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.25.4.so.tgz
[30]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.25.4.so.tgz
[31]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.25.5.so.tgz
[32]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.25.5.so.tgz
[33]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.26.0.so.tgz
[34]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.26.0.so.tgz
[35]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.26.1.so.tgz
[36]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.26.1.so.tgz
[37]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.26.2.so.tgz
[38]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.26.2.so.tgz
[39]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-amd64-1.27.0.so.tgz
[40]: https://ddagent-windows-unstable.s3.amazonaws.com/inject-browser-sdk/nginx/latest/ngx_http_datadog_module-arm64-1.27.0.so.tgz
[41]: /es/real_user_monitoring/browser/setup/server/#limitations
239 changes: 137 additions & 102 deletions content/ko/agent/guide/private-link.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
---
further_reading:
- link: https://www.datadoghq.com/architecture/using-cross-region-aws-privatelink-to-send-telemetry-to-datadog/
tag: 아키텍처 센터
text: 크로스 리전 AWS PrivateLink를 사용하여 Datadog에 원격 측정 데이터 전송
- link: /agent/logs
tag: 설명서
text: Agent로 로그 수집 활성화
@@ -19,174 +22,201 @@ title: AWS PrivateLink를 통해 Datadog에 연결
---

{{% site-region region="us3,us5,eu,gov" %}}
<div class="alert alert-warning">Datadog PrivateLink는 선택한 Datadog 사이트를 지원하지 않습니다.</div>
<div class="alert alert-warning">Datadog PrivateLink는 선택한 Datadog site에서 지원되지 않습니다.</div>
{{% /site-region %}}

{{% site-region region="us,ap1" %}}

이 가이드는 Datadog와 함께 사용하기 위해 [AWS PrivateLink][1]를 설정하는 방법을 안내합니다.

## 개요

전체 프로세스는 로컬 Datadog 에이전트가 데이터를 보낼 수 있는 VPC 내부 엔드포인트를 설정하는 것으로 구성됩니다. 그런 다음 VPC 엔드포인트는 Datadog의 VPC 내 엔드포인트로 피어링됩니다.

{{< img src="agent/guide/private_link/vpc_diagram_schema.png" alt="VPC diagram Schema" >}}

## 설정
이 가이드는 Datadog과 함께 사용할 수 있도록 [AWS PrivateLink][11]를 구성하는 방법을 안내합니다. 전체 프로세스는 로컬 Datadog Agent가 데이터를 전송할 수 있는 VPC의 내부 엔드포인트를 구성하는 것으로 진행됩니다. 그런 다음 VPC 엔드포인트를 Datadog의 VPC 내 엔드포인트와 피어링합니다.

Datadog는 **{{< region-param key="aws_region" >}}**에 AWS PrivateLink 엔드포인트를 노출합니다.

그러나 다른 리전에서 {{< region-param key="aws_region" code="true" >}}에 있는 Datadog 의 PrivateLink 제품으로 트래픽을 라우팅하려면 리전 간 [Amazon VPC 피어링][2]을 사용해야 합니다. 리전 간 VPC 피어링을 사용하면 서로 다른 AWS 리전에 있는 VPC 간에 연결을 설정할 수 있습니다. 이를 통해 서로 다른 지역에 있는 VPC 리소스가 비공개 IP 주소를 사용하여 서로 통신할 수 있습니다. 자세한 내용은 [Amazon VPC 피어링][2]을 참조하세요.

{{< tabs >}}
{{% tab "Connect from same region" %}}
{{< img src="agent/guide/private_link/vpc_diagram_schema.png" alt="VPC 다이어그램 스키마" >}}

1. AWS 콘솔을 **{{< region-param key="aws_region" >}}** 리전에 연결하고 VPC 엔드포인트를 생성합니다.
Datadog은 **{{< region-param key="aws_region" >}}**에서 AWS PrivateLink 엔드포인트를 노출합니다.
- 동일한 리전에서 Datadog 트래픽을 라우팅해야 하는 경우 [동일한 리전에서 연결](#connect-from-the-same-region)의 단계에 따라 엔드포인트를 설정합니다.
- {{< region-param key="aws_region" >}}에서 다른 리전으로부터 Datadog의 PrivateLink 제품으로 트래픽을 라우팅하려면 Datadog는 [크로스 리전 PrivateLink 엔드포인트](?tab=crossregionprivatelinkendpoints#connect-from-other-regions)를 권장합니다. [크로스 리전 PrivateLink][11]를 사용하면 서로 다른 AWS 리전의 VPC 간에 연결을 설정할 수 있습니다. 이를 통해 서로 다른 리전의 VPC 리소스가 프라이빗 IP 주소를 사용하여 서로 통신할 수 있습니다. 또는 [VPC 피어링](?tab=vpcpeering#connect-from-other-regions)을 사용합니다.

{{< img src="agent/guide/private_link/create_vpc_endpoint.png" alt="VPC 엔드포인트 생성" style="width:60%;" >}}
## 동일한 리전에서 연결

2. **이름으로 서비스 찾기**를 선택합니다.
3. AWS PrivateLink를 설정할 서비스 에 따라 _서비스 이름_ 텍스트 상자를 입력합니다:
1. AWS Management Console을 원하는 리전에 연결합니다.
1. VPC 대시보드의 **PrivateLink and Lattice**에서 **Endpoints**를 선택합니다.
1. **Create Endpoint**를 클릭합니다.
{{< img src="agent/guide/private-link-vpc.png" alt="VPC 대시보드의 엔드포인트 페이지" style="width:90%;" >}}
1. **Find service by name**을 선택합니다.
1. AWS PrivateLink를 설정하려는 서비스에 따라 _Service Name_ 텍스트 상자에 입력합니다.

{{< img src="agent/guide/private_link/vpc_service_name.png" alt="VPC 서비스 이름" style="width:70%;" >}}

| Datadog | PrivateLink 서비스 이름 | 비공개 DNS 이름 |
| Datadog | PrivateLink 서비스 이름 | 프라이빗 DNS 이름 |
|---------------------------|----------------------------------------------------------------------------------------|------------------------------------------------------------------------|
| 로그(에이전트 HTTP 인테이크) | {{< region-param key="aws_private_link_logs_agent_service_name" code="true" >}} | {{< region-param key="agent_http_endpoint" code="true">}} |
| 로그(사용자 HTTP 인테이크) | {{< region-param key="aws_private_link_logs_user_service_name" code="true" >}} | {{< region-param key="http_endpoint" code="true">}} |
| API | {{< region-param key="aws_private_link_api_service_name" code="true" >}} | <code>API.{{< region-param key="dd_site" >}}</code> |
| 메트릭 | {{< region-param key="aws_private_link_metrics_service_name" code="true" >}} | <code>메트릭.에이전트.< region-param key="dd_site" >}}</code> |
| 컨테이너 |< region-param key="aws_private_link_containers_service_name" code="true" >}} | <code>orchestrator.{{< region-param key="dd_site" >}}</code> |
| 프로세스 | {{< region-param key="aws_private_link_process_service_name" code="true" >}} | <code>프로세스.{{< region-param key="dd_site" >}}</code> |
| 프로파일링 |< region-param key="aws_private_link_profiling_service_name" code="true" >}} | <code>intake.profile.{{< region-param key="dd_site" >}}</code> |
| 트레이스 | {{< region-param key="aws_private_link_traces_service_name" code="true" >}} | <code>추적하다.에이전트.< region-param key="dd_site" >}}</code> |
| 데이터베이스 모니터링 | {{< region-param key="aws_private_link_dbm_service_name" code="true" >}} | <code>dbm-메트릭</code> -intake <code>.{{< region-param key="dd_site" >}}</code> |
| 원격 설정 | {{< region-param key="aws_private_link_remote_config_service_name" code="true" >}} | <code>config.< region-param key="dd_site" >}}</code> |
| 로그 (Agent HTTP 인테이크) | {{< region-param key="aws_private_link_logs_agent_service_name" code="true" >}} | {{< region-param key="agent_http_endpoint" code="true">}} |
| 로그 (User HTTP 인테이크) | {{< region-param key="aws_private_link_logs_user_service_name" code="true" >}} | {{< region-param key="http_endpoint" code="true">}} |
| API | {{< region-param key="aws_private_link_api_service_name" code="true" >}} | <code>api.{{< region-param key="dd_site" >}}</code> |
| 메트릭 | {{< region-param key="aws_private_link_metrics_service_name" code="true" >}} | <code>metrics.agent.{{< region-param key="dd_site" >}}</code> |
| 컨테이너 | {{< region-param key="aws_private_link_containers_service_name" code="true" >}} | <code>orchestrator.{{< region-param key="dd_site" >}}</code> |
| 프로세스 | {{< region-param key="aws_private_link_process_service_name" code="true" >}} | <code>process.{{< region-param key="dd_site" >}}</code> |
| 프로파일링 | {{< region-param key="aws_private_link_profiling_service_name" code="true" >}} | <code>intake.profile.{{< region-param key="dd_site" >}}</code> |
| 트레이스 | {{< region-param key="aws_private_link_traces_service_name" code="true" >}} | <code>trace.agent.{{< region-param key="dd_site" >}}</code> |
| 데이터베이스 모니터링 | {{< region-param key="aws_private_link_dbm_service_name" code="true" >}} | <code>dbm-metrics-intake.{{< region-param key="dd_site" >}}</code> |
| 원격 구성 | {{< region-param key="aws_private_link_remote_config_service_name" code="true" >}} | <code>config.{{< region-param key="dd_site" >}}</code> |

4. **확인** 클릭합니다. _서비스 이름을 찾을 수 없음_이 반환되지 않으면 [Datadog 지원팀][1]에 문의하세요.
5. Datadog VPC 서비스 엔드포인트로 피어링할 VPC와 서브넷을 선택합니다.
6. **DNS 이름 사용**에서 _이 엔드포인트에 대해 사용_이 선택되어 있는지 확인합니다:
4. **Verify** 클릭합니다. _Service name found_가 표시되지 않으면 [Datadog 지원팀][14]에 문의하세요.
5. Datadog VPC 서비스 엔드포인트와 피어링할 VPC 및 서브넷을 선택합니다.
6. **Enable DNS name**에 대해 _Enable for this endpoint_가 선택되어 있는지 확인합니다.

{{< img src="agent/guide/private_link/enabled_dns_private.png" alt="DNS 비공개 사용" style="width:80%;" >}}
{{< img src="agent/guide/private_link/enabled_dns_private.png" alt="Enable DNS private" style="width:80%;" >}}

7. 원하는 보안 그룹을 선택하여 이 VPC 엔드포인트로 트래픽을 보낼 수 있는 항목을 제어합니다.
7. 원하는 보안 그룹을 선택하여 이 VPC 엔드포인트로 트래픽을 전송할 수 있는 항목을 제어합니다.

**참고**: **보안 그룹은 TCP 포트 `443`**에서 인바운드 트래픽을 허용해야 합니다.
**참고**: **보안 그룹은 TCP 포트 `443`에서 인바운드 트래픽을 허용해야 합니다**.

8. 화면 하단의 **엔드포인트 생성** 클릭합니다. 성공하면 다음과 같은 화면이 표시됩니다:
8. 화면 하단의 **Create endpoint** 클릭합니다. 성공하면 다음 화면이 표시됩니다.

{{< img src="agent/guide/private_link/vpc_endpoint_created.png" alt="VPC 엔드포인트 생성됨" style="width:60%;" >}}

9. VPC 엔드포인트 ID를 클릭하여 점검 상태를 확인합니다.
10. 상태가 _보류 중_에서 _사용 가능_으로 바뀔 때까지 기다립니다. 최대 10분 정도 걸릴 수 있습니다. _사용 가능_으로 표시되면 AWS PrivateLink를 사용할 수 있습니다.
9. VPC 엔드포인트 ID를 클릭하여 상태를 확인하세요.
10. 상태가 _Pending_에서 _Available_로 변경될 때까지 기다립니다. 최대 10분이 걸릴 수 있습니다. _Available_로 표시되면 AWS PrivateLink를 사용할 수 있습니다.

{{< img src="agent/guide/private_link/vpc_status.png" alt="VPC 상태" style="width:60%;" >}}
{{< img src="agent/guide/private_link/vpc_status.png" alt="VPC status" style="width:60%;" >}}

11. Datadog 에이전트 버전이 6.19 또는 7.19 이전인 경우 로그 데이터를 수집하려면 에이전트가 HTTPS를 통해 로그 를 전송하도록 설정되어 있는지 확인하세요. 데이터가 아직 없는 경우 [에이전트 `datadog.yaml` 설정 파일][2]에 다음을 추가합니다:
11. v6.19 또는 v7.19보다 이전 버전의 Datadog Agent를 실행 중이고 로그 데이터를 수집하려면 Agent가 HTTPS를 통해 로그를 보내도록 구성되어 있는지 확인하세요. 데이터가 아직 없으면 [Agent `datadog.yaml` 구성 파일][15]에 다음을 추가하세요.

```yaml
logs_config:
FORCE_USE_HTTP: TRUE
force_use_http: true
```
컨테이너 에이전트를 사용하는 경우 대신 다음 환경 변수를 대신 설정하세요.
컨테이너 Agent를 사용하는 경우 대신 다음 환경 변수를 설정하세요.
```
DD_LOGS_CONFIG_FORCE_USE_HTTP=true
```

설정은 로그를 Datadog로 보내는 경우 및 AWS PrivateLink 및 Datadog 에이전트를 사용하는 경우 필요하며, 람다 확장에는 필요하지 않습니다. 자세한 내용은 [에이전트 <txprotected>로그 수집][3]을 참조하세요.
구성은 AWS PrivateLink 및 Datadog Agent를 사용하여 Datadog에 로그를 보낼 때 필요하며 Lambda Extension에는 필요하지 않습니다. 자세한 내용은 [Agent 로그 수집][16]을 참조하세요.

12. 람다 확장 프로그램에서 환경 변수 `DD_API_KEY_SECRET_ARN` 지정된 ARN을 사용하여 AWS Secrets Manager에서 Datadog API 키를 로드하는 경우 [Secrets Manager용 VPC 엔드포인트 생성][4]을 수행해야 합니다.
12. Lambda Extension이 환경 변수 `DD_API_KEY_SECRET_ARN`으로 지정된 ARN을 사용하여 AWS Secrets Manager에서 Datadog API 키를 로드하는 경우 [Secrets Manager에 대한 VPC 엔드포인트를 생성][17]해야 합니다.

13. [에이전트][5]를 다시 시작하여 AWS PrivateLink를 통해 Datadog에 데이터를 전송합니다.
13. AWS PrivateLink를 통해 Datadog로 데이터를 보내려면 [Agent를 다시 시작][13]하세요.

## 다른 리전에서 연결

{{< tabs >}}
{{% tab "크로스 리전 PrivateLink 엔드포인트" %}}
1. AWS Management Console을 원하는 리전에 연결합니다.
1. VPC 대시보드의 **PrivateLink and Lattice**에서 **Endpoints**를 선택합니다.
1. **Create Endpoint**를 클릭합니다.
{{< img src="agent/guide/private-link-vpc.png" alt="VPC 대시보드의 엔드포인트 페이지" style="width:90%;" >}}
1. VPC 인터페이스 엔드포인트 설정을 구성합니다.
1. (선택 사항) **Name tag**를 입력합니다.
1. **Type**에서 **PrivateLink Ready partner services**를 선택합니다.
1. 크로스 리전 서포트를 통해 인터페이스 엔드포인트를 검색하고 구성합니다.
1. **Service name**에 아래 [표](#privatelink-service-names)에서 유효한 PrivateLink 서비스 이름으로 서비스 이름을 입력합니다.
1. **Service region**에서 **Enable Cross Region endpoint**를 클릭하고 **{{< region-param key="aws_private_link_cross_region" >}}**을 선택합니다.
1. **Verify service**를 선택하고 _Service name verified_ 알림을 기다립니다.
**참고:** 위의 단계를 완료한 후에도 서비스를 확인할 수 없는 경우 [Datadog 지원팀][1]에 문의하세요.
1. **Network Settings**에서 VPC 인터페이스 엔드포인트를 배포할 VPC를 선택합니다.
1. **Enable DNS name**이 선택되어 있는지 확인합니다.
1. **Subnets**에서 인터페이스 엔드포인트에 대해 VPC에서 하나 이상의 서브넷을 선택합니다.
1. **Security Groups**에서 VPC 엔드포인트로 트래픽을 전송할 수 있는 항목을 제어하려면 보안 그룹을 선택합니다.

**참고**: 보안 그룹은 TCP 포트 443에서 인바운드 트래픽을 허용해야 합니다.
1. (선택 사항) **Name tag**를 제공하고 **Create endpoint**를 클릭합니다.
1. 엔드포인트 상태가 **Pending***에서 **Available**로 업데이트될 때까지 몇 분 정도 기다립니다. 최대 10분이 걸릴 수 있습니다. 예상보다 오래 걸리는 경우 [Datadog 지원팀][1]에 문의하세요.

엔드포인트 상태가 **Available**로 업데이트되면 이 엔드포인트를 사용하여 크로스 리전 AWS PrivateLink 엔드포인트를 통해 Datadog에 원격 측정 데이터를 전송할 수 있습니다.

## PrivateLink 서비스 이름

| Datadog | PrivateLink 서비스 이름 | 프라이빗 DNS 이름 |
|---------------------------|----------------------------------------------------------------------------------------|------------------------------------------------------------------------|
| 로그 (Agent HTTP 인테이크) | {{< region-param key="aws_private_link_logs_agent_service_name" code="true" >}} | <code>agent-http-intake.logs.{{< region-param key="dd_site" >}}</code> |
| 로그 (User HTTP 인테이크) | {{< region-param key="aws_private_link_logs_user_service_name" code="true" >}} | <code>http-intake.logs.{{< region-param key="dd_site" >}}</code> |
| API | {{< region-param key="aws_private_link_api_service_name" code="true" >}} | <code>api.{{< region-param key="dd_site" >}}</code> |
| 메트릭 | {{< region-param key="aws_private_link_metrics_service_name" code="true" >}} | <code>metrics.agent.{{< region-param key="dd_site" >}}</code> |
| 컨테이너 | {{< region-param key="aws_private_link_containers_service_name" code="true" >}} | <code>orchestrator.{{< region-param key="dd_site" >}}</code> |
| 프로세스 | {{< region-param key="aws_private_link_process_service_name" code="true" >}} | <code>process.{{< region-param key="dd_site" >}}</code> |
| 프로파일링 | {{< region-param key="aws_private_link_profiling_service_name" code="true" >}} | <code>intake.profile.{{< region-param key="dd_site" >}}</code> |
| 트레이스 | {{< region-param key="aws_private_link_traces_service_name" code="true" >}} | <code>trace.agent.{{< region-param key="dd_site" >}}</code> |
| 데이터베이스 모니터링 | {{< region-param key="aws_private_link_dbm_service_name" code="true" >}} | <code>dbm-metrics-intake.{{< region-param key="dd_site" >}}</code> |
| 원격 구성 | {{< region-param key="aws_private_link_remote_config_service_name" code="true" >}} | <code>config.{{< region-param key="dd_site" >}}</code> |

[1]: /ko/help/
[2]: /ko/agent/configuration/agent-configuration-files/#agent-main-configuration-file
[3]: /ko/agent/logs/?tab=tailexistingfiles#send-logs-over-https
[4]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html
[5]: /ko/agent/configuration/agent-commands/#restart-the-agent

{{% /tab %}}

{{% tab "Connect from another region using VPC Peering" %}}

### Amazon VPC 피어링

1. AWS 콘솔을 **{{< region-param key="aws_region" >}}** 리전에 연결하고 VPC 엔드포인트를 생성합니다.
{{% tab "VPC 피어링" %}}
1. AWS 콘솔을 리전 **{{< region-param key="aws_region" >}}**에 연결하고 VPC 엔드포인트를 생성합니다.

{{< img src="agent/guide/private_link/create_vpc_endpoint.png" alt="VPC 엔드포인트 생성" style="width:80%;" >}}

2. **이름으로 서비스 찾기**를 선택합니다.
3. AWS PrivateLink를 설정하려는 서비스 에 따라 _서비스 이름_ 텍스트 상자를 입력합니다:
2. **Find service by name**을 선택합니다.
3. AWS PrivateLink를 설정하려는 서비스에 따라 _Service Name_ 텍스트 상자에 입력합니다.

{{< img src="agent/guide/private_link/vpc_service_name.png" alt="VPC 서비스 이름" style="width:90%;" >}}

| Datadog | PrivateLink 서비스 이름 |
| Datadog | PrivateLink 서비스 이름 |
|---------------------------|----------------------------------------------------------------------------------------|
| 로그 에이전트 HTTP 인테이크) | {{< region-param key="aws_private_link_logs_agent_service_name" code="true" >}} |
| 로그(사용자 HTTP 인테이크) | {{< region-param key="aws_private_link_logs_user_service_name" code="true" >}} |
| API | {{< region-param key="aws_private_link_api_service_name" code="true" >}} |
| 메트릭 | {{< region-param key="aws_private_link_metrics_service_name" code="true" >}} |
| 컨테이너 | {{< region-param key="aws_private_link_containers_service_name" code="true" >}} |
| 프로세스 | {{< region-param key="aws_private_link_process_service_name" code="true" >}} |
| 프로파일링 | {{< region-param key="aws_private_link_profiling_service_name" code="true" >}} |
| 트레이스 | {{< region-param key="aws_private_link_traces_service_name" code="true" >}} |
| 데이터베이스 모니터링 | {{< region-param key="aws_private_link_dbm_service_name" code="true" >}} |
| 원격 설정 | {{< region-param key="aws_private_link_remote_config_service_name" code="true" >}} |
| 로그 (Agent HTTP 인테이크) | {{< region-param key="aws_private_link_logs_agent_service_name" code="true" >}} |
| 로그 (User HTTP 인테이크) | {{< region-param key="aws_private_link_logs_user_service_name" code="true" >}} |
| API | {{< region-param key="aws_private_link_api_service_name" code="true" >}} |
| 메트릭 | {{< region-param key="aws_private_link_metrics_service_name" code="true" >}} |
| 컨테이너 | {{< region-param key="aws_private_link_containers_service_name" code="true" >}} |
| 프로세스 | {{< region-param key="aws_private_link_process_service_name" code="true" >}} |
| 프로파일링 | {{< region-param key="aws_private_link_profiling_service_name" code="true" >}} |
| 트레이스 | {{< region-param key="aws_private_link_traces_service_name" code="true" >}} |
| 데이터베이스 모니터링 | {{< region-param key="aws_private_link_dbm_service_name" code="true" >}} |
| 원격 구성 | {{< region-param key="aws_private_link_remote_config_service_name" code="true" >}} |

4. **확인**을 클릭합니다. _서비스 이름 찾음_이 반환되지 않으면 [Datadog 지원팀][1]에 문의하세요.
4. **Verify**를 클릭합니다. _Service name found_가 표시되지 않으면 [Datadog 지원팀][1]에 문의하세요.

5. 다음으로 Datadog VPC 서비스 엔드포인트로 피어링할 VPC와 서브넷을 선택합니다. VPC 피어링을 사용하려면 DNS를 수동으로 설정해야 하므로 **DNS 이름 사용**을 선택하지 마세요.
5. Datadog VPC 서비스 엔드포인트와 피어링해야 하는 VPC와 서브넷을 선택합니다. VPC 피어링에는 DNS를 수동으로 구성해야 하기 때문에 **Enable DNS name**을 선택하지 마세요.

6. 원하는 보안 그룹을 선택하여 이 VPC 엔드포인트로 트래픽을 보낼 수 있는 항목을 제어합니다.
6. 원하는 보안 그룹을 선택하여 이 VPC 엔드포인트로 트래픽을 전송할 수 있는 항목을 제어합니다.

**참고**: **보안 그룹은 TCP 포트 `443`**에서 인바운드 트래픽을 허용해야 합니다.
**참고**: **보안 그룹은 TCP 포트 `443`에서 인바운드 트래픽을 허용해야 합니다**.

7. 화면 하단의 **엔드포인트 생성**을 클릭합니다. 성공하면 다음과 같은 화면이 표시됩니다:
7. 화면 하단에서 **Create endpoint**를 클릭합니다. 성공하면 다음 화면이 표시됩니다.

{{< img src="agent/guide/private_link/vpc_endpoint_created.png" alt="VPC 엔드포인트 생성됨" 스타일="width:80%;" >}}
{{< img src="agent/guide/private_link/vpc_endpoint_created.png" alt="VPC 엔드포인트 생성됨" style="width:80%;" >}}

8. VPC 엔드포인트 ID를 클릭하여 점검 상태를 확인합니다.
9. 상태가 _보류 중_에서 _사용 가능_으로 바뀔 때까지 기다립니다. 최대 10분 정도 걸릴 수 있습니다.
10. 엔드포인트를 생성한 후 VPC 피어링을 사용하여 다른 지역에서 PrivateLink 엔드포인트를 사용할 수 있도록 설정하여 PrivateLink를 통해 Datadog로 텔레메트리을 보냅니다. 자세한 내용은 AWS의 [VPC 피어링 연결로 작업하기][2] 페이지를 참조하세요.
8. VPC 엔드포인트 ID를 클릭하여 상태를 확인합니다.
9. 상태가 _Pending_에서 _Available_로 바뀔 때까지 기다립니다. 최대 10분이 걸릴 수 있습니다.
10. 엔드포인트를 만든 후 VPC 피어링을 사용하여 PrivateLink 엔드포인트를 다른 지역에서 사용할 수 있게 하여 PrivateLink를 통해 Datadog에 원격 측정을 보냅니다. 자세한 내용은 AWS의 [VPC 피어링 연결 작업][2] 페이지를 참조하세요.

{{< img src="agent/guide/private_link/vpc_status.png" alt="VPC 상태" style="width:80%;" >}}
{{< img src="agent/guide/private_link/vpc_status.png" alt="VPC status" style="width:80%;" >}}

### Amazon Route53

1. AWS PrivateLink 엔드포인트를 생성한 각 서비스 에 대해 [Route53 비공개 호스트 영역][3]을 생성합니다. {{< region-param key="aws_region" code="true" >}}의 VPC에 프라이빗 호스트 영역을 연결합니다.
1. AWS PrivateLink 엔드포인트를 생성한 각 서비스에 대해 [Route53 프라이빗 호스팅 영역][3]을 생성합니다. {{< region-param key="aws_region" code="true" >}}에서 Attach 프라이빗 호스팅 영역을 VPC에 연결합니다.

{{< img src="agent/guide/private_link/create-a-route53-private-hosted-zone.png" alt="Route53 사설 호스트 영역 생성" style="width:80%;" >}}
{{< img src="agent/guide/private_link/create-a-route53-private-hosted-zone.png" alt="Route53 프라이빗 호스팅 영역 생성" style="width:80%;" >}}

아래 목록을 사용하여 서비스와 DNS 이름을 Datadog의 다른 부분에 매핑합니다:
아래 목록을 사용하여 서비스와 DNS 이름을 Datadog의 다른 부분에 매핑하세요.

| Datadog | PrivateLink 서비스 이름 | 비공개 DNS 이름 |
| Datadog | PrivateLink 서비스 이름 | 프라이빗 이름 |
|---------------------------|----------------------------------------------------------------------------------------|------------------------------------------------------------------------|
| 로그(에이전트 HTTP 인테이크) | {{< region-param key="aws_private_link_logs_agent_service_name" code="true" >}} | <code>http-intake.logs.</code> <code>.로그.{{< region-param key="dd_site" >}}</code> |
| 로그(사용자 HTTP 인테이크) | {{< region-param key="aws_private_link_logs_user_service_name" code="true" >}} | <code>로그.{{< region-param key="dd_site" >}}</code> |
| API | {{< region-param key="aws_private_link_api_service_name" code="true" >}} | <code>API.{{< region-param key="dd_site" >}}</code> |
| 메트릭 | {{< region-param key="aws_private_link_metrics_service_name" code="true" >}} | <code>metrics.agent.< region-param key="dd_site" >}}</code> |
| 컨테이너 |< region-param key="aws_private_link_containers_service_name" code="true" >}} | <code>orchestrator.{{< region-param key="dd_site" >}}</code> |
| 프로세스 | {{< region-param key="aws_private_link_process_service_name" code="true" >}} | <code>process.{{< region-param key="dd_site" >}}</code> |
| 프로파일링 |< region-param key="aws_private_link_profiling_service_name" code="true" >}} | <code>intake.profile.{{< region-param key="dd_site" >}}</code> |
| 트레이스 | {{< region-param key="aws_private_link_traces_service_name" code="true" >}} | <code>trace.agent.< region-param key="dd_site" >}}</code> |
| 데이터베이스 모니터링 | {{< region-param key="aws_private_link_dbm_service_name" code="true" >}} | <code>dbm-metrics-intake</code><code>.{{< region-param key="dd_site" >}}</code> |
| 원격 설정 | {{< region-param key="aws_private_link_remote_config_service_name" code="true" >}} | <code>config.< region-param key="dd_site" >}}</code> |

AWS API , `DescribeVpcEndpointServices`, 또는 다음 명령을 사용하여 이 정보를 찾을 수도 있습니다.
| 로그 (Agent HTTP 인테이크) | {{< region-param key="aws_private_link_logs_agent_service_name" code="true" >}} | <code>agent-http-intake.logs.{{< region-param key="dd_site" >}}</code> |
| 로그 (User HTTP 인테이크) | {{< region-param key="aws_private_link_logs_user_service_name" code="true" >}} | <code>http-intake.logs.{{< region-param key="dd_site" >}}</code> |
| API | {{< region-param key="aws_private_link_api_service_name" code="true" >}} | <code>api.{{< region-param key="dd_site" >}}</code> |
| 메트릭 | {{< region-param key="aws_private_link_metrics_service_name" code="true" >}} | <code>metrics.agent.{{< region-param key="dd_site" >}}</code> |
| 컨테이너 | {{< region-param key="aws_private_link_containers_service_name" code="true" >}} | <code>orchestrator.{{< region-param key="dd_site" >}}</code> |
| 프로세스 | {{< region-param key="aws_private_link_process_service_name" code="true" >}} | <code>process.{{< region-param key="dd_site" >}}</code> |
| 프로파일링 | {{< region-param key="aws_private_link_profiling_service_name" code="true" >}} | <code>intake.profile.{{< region-param key="dd_site" >}}</code> |
| 트레이스 | {{< region-param key="aws_private_link_traces_service_name" code="true" >}} | <code>trace.agent.{{< region-param key="dd_site" >}}</code> |
| 데이터베이스 모니터링 | {{< region-param key="aws_private_link_dbm_service_name" code="true" >}} | <code>dbm-metrics-intake.{{< region-param key="dd_site" >}}</code> |
| 원격 구성 | {{< region-param key="aws_private_link_remote_config_service_name" code="true" >}} | <code>config.{{< region-param key="dd_site" >}}</code> |

AWS API인 `DescribeVpcEndpointServices`를 조사하거나 다음 명령을 사용하여 이 정보를 찾을 수도 있습니다.

```bash
AWS ec2 describe-vpc-endpoint-서비스 --서비스-names <서비스-name>``
aws ec2 describe-vpc-endpoint-services --service-names <service-name>`
```

예를 들어, {{< region-param key="aws_region" code="true" >}}에 대한 Datadog 메트릭 엔드포인트의 경우:
예를 들어, {{< region-param key="aws_region" code="true" >}}에 대한 Datadog 메트릭 엔드포인트의 경우

<div class="site-region-컨테이너">
<div class="site-region-container">
<div class="highlight">
<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><spam class="line">aws ec2 describe-vpc-endpoint-services --service-names {{< region-param key="aws_private_link_metrics_service_name" >}} | jq '.ServiceDetails[0].PrivateDnsName'</span></code></pre>
<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line">aws ec2 describe-vpc-endpoint-services --service-names {{< region-param key="aws_private_link_metrics_service_name" >}} | jq '.ServiceDetails[0].PrivateDnsName'</span></code></pre>
</div>
</div>

@@ -253,15 +283,20 @@ PHZ(프라이빗 호스팅 영역)가 연결된 VPC에는 몇 가지 설정이
[5]: https://docs.amazonaws.cn/en_us/Route53/latest/DeveloperGuide/hosted-zone-private-associate-vpcs-different-accounts.html
[6]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zone-private-considerations.html#hosted-zone-private-considerations-vpc-settings
[7]: /ko/agent/configuration/agent-commands/?tab=agentv6v7#restart-the-agent
[8]: /ko/agent/configuration/agent-configuration-files/?tab=agentv6v7#agent-main-configuration-file
[9]: https://docs.datadoghq.com/ko/agent/logs/?tab=tailexistingfiles#send-logs-over-https
[8]: /ko/agent/configuration/agent-configuration-files/#agent-main-configuration-file
[9]: /ko/agent/logs/?tab=tailexistingfiles#send-logs-over-https
[10]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html
{{% /tab %}}
{{< /tabs >}}

[11]: https://aws.amazon.com/privatelink/
[12]: https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html
[13]: /ko/agent/configuration/agent-commands/#restart-the-agent
[14]: /ko/help/
[15]: /ko/agent/configuration/agent-configuration-files/#agent-main-configuration-file
[16]: /ko/agent/logs/?tab=tailexistingfiles#send-logs-over-https
[17]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html

[1]: https://aws.amazon.com/privatelink/
[2]: https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html
{{% /site-region %}}

## 참고 자료