Aprende a integrar los registros de backend de Dynatrace con las repeticiones de sesión de OpenReplay para ampliar tus capacidades de monitoreo y depuración.

Esta integración está disponible para usuarios de Cloud (Serverless, Dedicated) y Self-Host (Community, Enterprise).

Sigue estos pasos para obtener las credenciales necesarias de Dynatrace:

1. Inicia sesión en tu cuenta de Dynatrace.
2. Ve a Account Management
3. Crea un OAuth Client:

• Haz clic en Identity & Access Management
• Selecciona OAuth clients
• Haz clic en Create client para generar las credenciales requeridas.

4. Guarda tus credenciales:

• Después de crear el cliente, guarda lo siguiente:
  • Client ID
  • Client Secret
  • Account URN

5. Obtén tu environment ID:

   // Example
   Dynatrace URL: https://rzr85764.app.dynatrace.com/
   Environment ID: rzr85764

Para vincular los registros de Dynatrace con las sesiones de OpenReplay, hay que propagar un ID de sesión único openReplaySession.id desde tu frontend a tu backend en cada solicitud que quieras rastrear.

Modifica el código de tu frontend para añadir el openReplaySession.id a las cabeceras de tus solicitudes API:

// JavaScript Example for for Single Page Applications (SPA):

// Import OpenReplay
import { tracker } from '@openreplay/tracker';

// Initialize the tracker
tracker.configure({
  projectKey: 'YOUR_PROJECT_KEY',
  ingestPoint: "https://openreplay.mydomain.com/ingest", // when dealing with the self-hosted version of OpenReplay
});

// Start the tracker and wait for it to resolve
tracker.start().then(() => {
  // Get the session ID after the tracker has started
  const sessionId = tracker.getSessionID();

  const headers = {
    'Content-Type': 'application/json',
  };

// Get the session ID
const sessionId = tracker.getSessionID();

const headers = {
  'Content-Type': 'application/json',
};

if (sessionId) {
  headers['openReplaySession.id'] = sessionId;
}

// Make the API request
fetch('/api/endpoint', {
  method: 'GET', // or 'POST', etc.
  headers,
  // ...other options
})
  .then(response => {
    // Handle response
  })
  .catch(error => {
    // Handle error
  });

En tu aplicación de backend, extrae el openReplaySession.id de las solicitudes entrantes e inclúyelo en tus registros usando el formato específico de clave-valor openReplaySession.id=<sessionId>:

//  Example.....
// Middleware to extract the session ID
app.use((req, res, next) => {
  const sessionId = req.headers['openreplaysession.id'];
  req.sessionId = sessionId; // Attach to request object
  next();
});

// When logging events or errors
app.get('/api/endpoint', (req, res) => {
  // Your logic here

  // Log with the session ID in the required format
  console.log(`openReplaySession.id=${req.sessionId} - Endpoint accessed`);

  res.send('Success');
});

// Error handling middleware
app.use((err, req, res, next) => {
  console.error(`openReplaySession.id=${req.sessionId} - Error: ${err.message}`);
  res.status(500).send('Internal Server Error');
});

Al incluir el openReplaySession.id en los registros de tu backend, Dynatrace puede recopilar los registros asociados con sesiones específicas de OpenReplay. Esto te permite ver estos registros durante las repeticiones de sesión en OpenReplay, ofreciendo una visión completa de las interacciones del usuario y los registros del backend.

Crea un atributo de registro personalizado en Dynatrace para extraer el openReplaySession.id de tus registros.

1. Accede a tu cuenta SaaS de Dynatrace.
2. Ve a Settings.
3. Selecciona Log Monitoring > Custom attributes y luego selecciona Add custom attribute.
4. Introduce la clave openReplaySession.id.

Referencia: Consulta los pasos detallados en la documentación de Dynatrace: Log custom attributes.

En tu cuenta de OpenReplay, sigue estos 3 pasos para completar la correlación de las repeticiones de sesión con los registros de backend de Dynatrace.

1. Ve a Preferences > Integrations en OpenReplay.
2. Selecciona la pestaña Backend Logging.
3. Selecciona el proyecto en el que quieres habilitar la integración de Dynatrace: Localiza la tarjeta de integración de Dynatrace > Haz clic en ella.

En la barra lateral de integración de Dynatrace introduce:

1. Environment ID: El ID de entorno de tu Dynatrace para acceso externo.
2. Client ID y Client Secret: Guardados en el primer paso.
3. Dynatrace Account URN: Tu identificador único utilizado dentro de la plataforma de Dynatrace, también guardado en el primer paso.

1. Haz clic en Add para probar la conexión: Un mensaje de éxito confirmará que la integración se ha configurado correctamente.

1. Ve a Sessions en OpenReplay.
2. Abre cualquier repetición de sesión.
3. Haz clic en el botón Traces.
4. Se mostrarán los registros de Dynatrace relacionados con la sesión.
5. Haz clic en cualquier entrada de registro para ver información detallada.

Los registros de tipo LOG con estados WARN, ERROR, INFO y NONE se recuperan mediante la Dynatrace Log Monitoring API v2.

Si tienes algún problema, conéctate a nuestro Slack o visita nuestro Foro y obtén ayuda de nuestra comunidad.