> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Módulo App Logs

> Registra la actividad del usuario en tu app mediante base44.appLogs.

<Warning>
  Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la [documentación para desarrolladores](/developers).
</Warning>

# Módulo App Logs

Registra la actividad del usuario en tu app mediante `base44.appLogs`.

## Contenido

* [Métodos](#methods)
* [Ejemplos](#examples)
* [Casos de uso](#use-cases)

## Métodos

| Método                   | Firma           | Descripción                                                         |
| ------------------------ | --------------- | ------------------------------------------------------------------- |
| `logUserInApp(pageName)` | `Promise<void>` | Registra la actividad del usuario en una página                     |
| `fetchLogs(params?)`     | `Promise<any>`  | Obtiene los registros de la app con parámetros de filtro opcionales |
| `getStats(params?)`      | `Promise<any>`  | Obtiene estadísticas de uso de la app                               |

## Ejemplos

### Registrar actividad del usuario

```javascript theme={null}
// Registrar cuando el usuario visita una página
await base44.appLogs.logUserInApp("dashboard");

// Registrar visitas a páginas específicas
await base44.appLogs.logUserInApp("settings");
await base44.appLogs.logUserInApp("profile");

// Registrar uso de funciones
await base44.appLogs.logUserInApp("export-button-click");
```

El nombre de la página no tiene que ser una página real - puede ser cualquier cadena que quieras rastrear.

## Casos de uso

### Rastrear vistas de página en React

```javascript theme={null}
// Registrar vistas de página en cambio de ruta
useEffect(() => {
  base44.appLogs.logUserInApp(window.location.pathname);
}, [location.pathname]);
```

### Rastrear uso de funciones

```javascript theme={null}
// Registrar cuando el usuario usa funciones específicas
function handleExport() {
  base44.appLogs.logUserInApp("export-data");
  // ... lógica de exportación
}

function handleSettingsChange() {
  base44.appLogs.logUserInApp("settings-updated");
  // ... guardar configuración
}
```

### Obtener registros

```javascript theme={null}
// Obtener todos los registros
const logs = await base44.appLogs.fetchLogs();

// Obtener registros con filtros
const recentLogs = await base44.appLogs.fetchLogs({
  limit: 50,
  page: "/dashboard"
});
```

### Obtener estadísticas

```javascript theme={null}
// Obtener estadísticas de uso de la app
const stats = await base44.appLogs.getStats();

// Obtener estadísticas con parámetros de rango de fechas
const weekStats = await base44.appLogs.getStats({
  from: "2024-01-01",
  to: "2024-01-07"
});
```

## Notas

* Los registros aparecen en la página Analytics del panel de tu app
* Los registros de app rastrean la actividad a nivel de página y de función
* Usa `analytics.track()` para eventos personalizados con propiedades, `appLogs.logUserInApp()` para rastreo simple de páginas/funciones

## Definiciones de tipos

```typescript theme={null}
/** Módulo App Logs para rastrear y analizar el uso de la app. */
interface AppLogsModule {
  /**
   * Registra la actividad del usuario en la app.
   * @param pageName - Nombre de la página o sección visitada.
   * @returns Promesa que se resuelve cuando se registra el log.
   */
  logUserInApp(pageName: string): Promise<void>;

  /**
   * Obtiene los registros de la app con parámetros de filtro opcionales.
   * @param params - Parámetros de filtro opcionales (por ejemplo, límite, nombre de página, rango de fechas).
   * @returns Promesa que resuelve a los datos de registros.
   */
  fetchLogs(params?: Record<string, any>): Promise<any>;

  /**
   * Obtiene estadísticas de uso de la app.
   * @param params - Parámetros de filtro opcionales (por ejemplo, rango de fechas).
   * @returns Promesa que resuelve a los datos de estadísticas.
   */
  getStats(params?: Record<string, any>): Promise<any>;
}
```

<Note>Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).</Note>