Skip to content

Commit

Permalink
chore: add translations
Browse files Browse the repository at this point in the history
  • Loading branch information
svc-docs-eng-opensource-bot committed Feb 1, 2025
1 parent ae0cdc8 commit 7f4ced4
Show file tree
Hide file tree
Showing 64 changed files with 3,010 additions and 1,472 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,151 @@
---
title: Detectar automáticamente los logs de browser
metaDescription: Get a more complete picture of your front-end application
freshnessValidatedDate: '2024-11-18T00:00:00.000Z'
translationType: machine
---

El logging automático recopila mensajes de log emitidos desde el browser `console` para ayudarlo a maximizar la observabilidad de su aplicación frontend.

Los logs del Browser se rastrean de forma predeterminada en el `WARN` nivel para el agente Pro y Pro+SPA, pero no están disponibles para el Lite agente del browser. Le recomendamos que primero confirme que está empleando el agente Pro o Pro+SPA. Consulte [Primeros pasos](#get-started).

## Cómo funciona el logging automático del browser [#how-it-works]

En función de los niveles de logging y las frecuencias de ejemplificación establecido en la configuración, la instrumentación automática de logs browser intentará recopilar mensajes de los siguientes métodos:

<table>
<thead>
<tr>
<th style={{width: "200px"}}>
Método
</th>

<th>
Nivel
</th>
</tr>
</thead>

<tbody>
<tr>
<td>
`console.log`
</td>

<td>
`'INFO'`
</td>
</tr>

<tr>
<td>
`console.error`
</td>

<td>
`'ERROR'`
</td>
</tr>

<tr>
<td>
`console.warn`
</td>

<td>
`'WARN'`
</td>
</tr>

<tr>
<td>
`console.info`
</td>

<td>
`'INFO'`
</td>
</tr>

<tr>
<td>
`console.debug`
</td>

<td>
`'DEBUG'`
</td>
</tr>

<tr>
<td>
`console.trace`
</td>

<td>
`'TRACE'`
</td>
</tr>
</tbody>
</table>

<Callout variant="important">
Los datos que pasan a través de los métodos de consola pueden pasar por serialización y [ofuscación](/docs/browser/new-relic-browser/configuration/obfuscate-browser-agent-data/). Dependiendo del tamaño y la frecuencia, esto puede afectar negativamente el rendimiento de la aplicación, así como los costos de datos. En general, NO se recomienda pasar objetos grandes o grandes cantidades de datos a los métodos de consola.
</Callout>

De forma predeterminada, los datos de logging se almacenan durante 30 días, pero la retención real de los datos depende de su cuenta.

## Empezar [#get-started]

<Steps>
<Step>
### Habilitar la recopilación automática de logs [#enable-configure-settings]

1. Vaya a <DNT>**[one.newrelic.com](https://one.newrelic.com/all-capabilities) &amp;gt; All Capabilities &amp;gt; Browser**</DNT>.
2. Seleccione la aplicación de su browser .
3. En el menú de la izquierda, haga clic en <DNT>**Application settings**</DNT>.
4. En la página de configuración de la aplicación, cerciorar de que el agente del browser <DNT>**Pro**</DNT> o <DNT>**Pro + SPA**</DNT> esté seleccionado. La detección automática de logs no está disponible para el Lite agente del browser.
5. Activar la configuración <DNT>**Browser logs**</DNT> .
</Step>

<Step>
### Configurar tasas de muestreo [#configure-sampling-rates]

Establezca una frecuencia de muestreo (0%-100%) para las siguientes muestras:

* <DNT>**User sessions**</DNT> registra una muestra aleatoria de todas las sesiones de usuario.

Por ejemplo, si establece la frecuencia de ejemplificación de la sesión al 50%, significa que:

* La mitad de todas las sesiones de usuario recopilarán automáticamente el log de eventos.
</Step>

<Step>
### Ver log de eventos [#view-events]

Puede encontrar datos de logging en dos lugares:

* En la página <DNT>**Logs**</DNT> :

1. Vaya a: <DNT>**[one.newrelic.com &gt; All capabilities](https://one.newrelic.com/all-capabilities) &amp;gt; Logs**</DNT>. Para obtener detalles sobre lo que puede hacer en la UI, consulte [Logs UI](/docs/logs/ui-data/use-logs-ui).

También puedes consultar el tipo de datos `Log` . Aquí hay un ejemplo simple de consulta NRQL:

```sql
SELECT * FROM Log
```

También puede utilizar NerdGraph, nuestra API en formato GraphQL para [consultar datos](/docs/apis/nerdgraph/examples/nerdgraph-nrql-tutorial) o [configurar la administración de logs](/docs/apis/nerdgraph/examples/nerdgraph-log-parsing-rules-tutorial).

* En la página <DNT>**Errors inbox**</DNT> :

1. En el menú browser de la izquierda, haga clic en <DNT>**Errors**</DNT>.
2. Haga clic en las páginas <DNT>**Triage**</DNT> y <DNT>**Group errors**</DNT> para ver los logs adjuntos a los errores.
</Step>
</Steps>

## Consumo de datos [#data-consumption]

Los logs siguen el mismo precio de consumo que los demás bytes de su browser . La cantidad de bytes producidos depende del número y la longitud de los mensajes.

La función de logging automático elimina la necesidad de llamar a `newrelic.log` la `newrelic.wrapLogger` browser API o, excepto cuando se agrega un atributo personalizado al evento de registro.
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
title: Información adicional
metaDescription: 'Data consumption, User privacy and security concerns.'
freshnessValidatedDate: '2024-12-19T00:00:00.000Z'
translationType: machine
---

## Consumo de datos [#data-consumption]

Session Replay sigue el mismo precio de consumo que los otros bytes de su browser . La cantidad de bytes producidos depende del recuento, la duración y los niveles de actividad del usuario de las sesiones, así como de la complejidad del DOM de su sitio.

La forma más precisa de proyectar su costo por repetición es habilitar la función durante un periodo de prueba corto y medir su consumo real. Alternativamente, puedes emplear un promedio de 5,3 MB por repetición como aproximación, aunque ten en cuenta que el costo real puede variar significativamente. Una fórmula simple para proyectar sus costos aproximados es: `sessions` x `sampling_rate` x `gb_per_replay` x `cost_per_gb`.

He aquí un ejemplo:

1 millón (sesiones) x 5% (tasa de ejemplificación) x 0,0053 (gb por repetición) x $0,35 (costo por gb) = $92,75 por 50 000 repeticiones

Para controlar su consumo, [ajuste sus tasas de ejemplificación](/docs/browser/browser-monitoring/browser-pro-features/session-replay/configuration/setup-session-replay/#configure-sampling-rates).

## Preocupaciones de seguridad y privacidad del usuario [#data-security]

Priorizamos la privacidad de los datos y creamos Session Replay con configuraciones predeterminadas estables para minimizar la posible exposición de información confidencial de los clientes. Puede [personalizar aún más la configuración de privacidad](/docs/browser/browser-monitoring/browser-pro-features/session-replay/configuration/customize-privacy-settings) para satisfacer sus necesidades específicas.

La reproducción de sesión no captura capturas de pantalla ni videos. En cambio, registra únicamente los cambios esenciales del estado DOM necesarios para reconstruir la interacción del usuario. Esto reduce significativamente la cantidad de datos almacenados.

### Cumplimiento de las leyes de privacidad de datos

New Relic actúa como procesador de datos según GDPR y proveedor de servicios según CCPA. Esto significa que procesamos datos de acuerdo con sus instrucciones. En última instancia, el cumplimiento de estas leyes depende de cómo implemente Session Replay dentro de su aplicación.

De forma predeterminada, todo el texto y las entradas del usuario, incluidos los datos personales, están enmascarados dentro de las grabaciones. Puede desenmascarar selectivamente elementos específicos si es necesario, pero la configuración predeterminada garantiza que ninguna información de identificación personal sea fácilmente visible. Este enfoque proporciona una base estable para la privacidad de los datos y al mismo tiempo ofrece flexibilidad para sus necesidades específicas.

## Session Replay y el rendimiento de tu app [#app-performance]

Session Replay minimiza el impacto en su rendimiento de la aplicación con:

* **Impacto inicial mínimo**: Session Replay se carga de forma asincrónica después de cargar la página completa, lo que garantiza que no interfiera con el rendimiento métrico de la carga temprana de la página.

* **Seguimiento de mutaciones DOM **: una vez cargado, Session Replay monitorea los cambios DOM y los informa como carga comprimida. El tamaño de estas cargas se correlaciona con la complejidad del árbol DOM .

* **Técnicas de optimización del rendimiento**: el tamaño de la carga útil también puede aumentar si el DOM es grande. Sin embargo, Session Replay utiliza una serie de técnicas para reducir el tamaño de la carga, como por ejemplo:

* Compresión GZIP

* Reducción de duplicación

* Recolección de carga estratégica: una carga grande (comprimida) se envía solo cuando se captura el DOM completo, lo que generalmente ocurre cuando se importa por primera vez la característica de reproducción. Posteriormente sólo se envían pequeñas cargas relacionadas con las acciones del usuario. El agente del browser recopilará datos en función de la primera aparición de las siguientes condiciones:

* La carga útil alcanza más de 64 KB comprimido.
* Transcurren 60 segundos.
* La visibilidad de la página cambia (ejemplo, cambio de pestaña, enfoque, navegación).
* La sesión termina.

### Cambios clave:

* **Claridad:** Estructura de oraciones mejorada para una mejor legibilidad.
* **Concisión:** Se eliminaron palabras y frases redundantes.
* **Consistencia:** Se emplea una estructura paralela en la lista para lograr uniformidad.
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
---
title: Característica avanzada
metaDescription: 'Manually record session replays, disable automatic session replay tracking and use nerd graph to configure replay settings.'
freshnessValidatedDate: '2024-12-19T00:00:00.000Z'
translationType: machine
---

## Grabar manualmente la repetición de la sesión [#manual-replays]

Si es necesario, puede `force` mediante programación una Session Replay para iniciar o detener la grabación empleando métodos API . A continuación se muestran algunos casos de uso:

* Permitir que el usuario opte por la grabación de interacciones. Por ejemplo, si aparece una ventana emergente que pregunta &quot;¿Permitir que se grabe esta sesión para analizar el rendimiento?&quot; y un usuario consiente:

1. Llama a `newrelic.recordReplay()` para iniciar la grabación.
2. Una vez completada la sesión o retirado el consentimiento, emplee `newrelic.pauseReplay()` para dejar de capturar datos.

* Grabe sesiones según criterios específicos, como:

* Comience a grabar solo sesiones en URL específicas, como el flujo de pago de un producto.
* Detenga la grabación de páginas confidenciales como `/billing` o `/health-records`.

Consulte la documentación de la API para obtener instrucciones:

* [`newrelic.recordReplay`](/docs/browser/new-relic-browser/browser-apis/recordReplay/)
* [`newrelic.pauseReplay`](/docs/browser/new-relic-browser/browser-apis/pauseReplay/)

## Deshabilitar el seguimiento automático Session Replay [#auto-replays]

Puede evitar que la reproducción de sesión se inicie automáticamente, incluso cuando se muestrea, estableciendo la opción de configuración API `autoStart` en `false`. Esto resulta útil en escenarios en los que es necesario priorizar acciones específicas sobre la ejemplificación automática. Por ejemplo, es posible que no desee que Session Replay se ejecute automáticamente en páginas confidenciales, como las que cumplen con HIPAA. En tales casos, puede emplear la API `.start()` para activar manualmente la característica de reproducción luego de obtener el consentimiento del usuario (y su aplicación llama a `.start()`).

La configuración `autoStart: false` indica al agente que posponga su inicialización hasta que se lo llame explícitamente mediante `.start()`. Esto garantiza que no se creará ninguna repetición de sesión, incluso si el backend toma muestras de su aplicación para grabar.

<Callout variant="important">
Llamar a `.start()` no garantiza que se grabará una repetición de la sesión. Simplemente retrasa la importación del módulo y la evaluación de los resultados de la ejemplificación hasta este punto. Si necesita forzar una grabación, consulte [Grabar manualmente la repetición de la sesión](#manual-replays).
</Callout>

Para comenzar a emplear esta API, consulte [`newrelic.start`](/docs/browser/new-relic-browser/browser-apis/start/).

## Utilice Nerdgraph para configurar los ajustes de reproducción [#nerdgraph-mutation]

Puede configurar los ajustes Session Replay usando nuestra [API NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph/) en lugar de usar la UI. Este método es útil si necesita realizar cambios masivos, como aplicar frecuencias de muestreo a múltiples entidades browser .

Aquí hay un ejemplo de mutación y variables para crear una nueva aplicación browser con la configuración predeterminada:

<table>
<thead>
<tr>
<th>
Mutación
</th>

<th>
Variables
</th>
</tr>
</thead>

<tbody>
<tr>
<td>
```graphql
mutation SessionReplayConfigUpdate($guid: EntityGuid!, $settings: AgentApplicationSettingsUpdateInput!) {
agentApplicationSettingsUpdate(guid: $guid, settings: $settings) {
browserSettings {
sessionReplay {
blockSelector
errorSamplingRate
maskTextSelector
enabled
collectFonts
inlineImages
inlineStylesheet
samplingRate
maskAllInputs
maskInputOptions {
color
date
datetimeLocal
email
month
number
range
search
select
tel
text
textArea
time
url
week
}
}
}
errors {
field
errorClass
description
}
}
}
```
</td>

<td>
```json
{
"sessionReplay": {
"enabled": true,
"collectFonts": true,
"blockSelector": ".private-fields",
"maskTextSelector": "*",
"inlineStylesheet": false,
"maskAllInputs": true,
"maskInputOptions": {
"color": true,
"date": true,
"textArea": true
},
"samplingRate": 9.99,
"errorSamplingRate": 1.11
}
}
```
</td>
</tr>
</tbody>
</table>
Loading

0 comments on commit 7f4ced4

Please sign in to comment.