# OpenClaw Analytics Metrics Dokumentation

Denne dokumentation beskriver de metrikker, der er indført som en del af analytics-forbedringerne for OpenClaw.

## Oversigt

OpenClaw indsamler og eksponerer nu en række metrikker relateret til API-brug, modeludførelse og systemydelse. Disse metrikker kan bruges til at overvåge og optimere systemets ydelse, identificere trends og træffe data-drevne beslutninger.

## API Nøgle Validering Metrics

Disse metrikker relaterer sig til API-nøglevalidering, der sker ved gateway-startup.

- `api_key_validation_total`: Antallet af API-nøglevalideringsforsøg
- `api_key_validation_success`: Antallet af succesfulde API-nøglevalideringer
- `api_key_validation_failure`: Antallet af fejlslagne API-nøglevalideringer

## Model Registry Metrics

Disse metrikker relaterer sig til modelregistry, der sikrer korrekt modelhåndtering.

- `model_registry_total`: Antallet af registrerede modeller
- `model_registry_missing`: Antallet af manglende modeller i registry
- `model_registry_validation_total`: Antallet af modelvalideringsforsøg
- `model_registry_validation_success`: Antallet af succesfulde modelvalideringer
- `model_registry_validation_failure`: Antallet af fejlslagne modelvalideringer

## Session Cleanup Metrics

Disse metrikker relaterer sig til den automatiske session-oprydning, der sker hver 24. time.

- `session_cleanup_total`: Antallet af session-oprydningscyklusser
- `session_cleanup_deleted`: Antallet af slettede sessioner
- `session_cleanup_errors`: Antallet af fejl under session-oprydning

## Dashboard & Aggregering Metrics

Disse metrikker relaterer sig til dashboard-usage.json aggregeringen og dashboard-visning.

- `usage_aggregation_total`: Antallet af aggregeringskørsler
- `usage_aggregation_duration_seconds`: Varighed af aggregeringsprocessen i sekunder
- `usage_aggregation_records_processed`: Antallet af behandlede usage records
- `usage_aggregation_errors`: Antallet af fejl under aggregering

## Cache Metrics

Disse metrikker relaterer sig til cache-optimeringen og cache-håndteringen.

- `cache_hits`: Antallet af successfulde cache-hits
- `cache_misses`: Antallet af cache-misses
- `cache_size_kb`: Størrelsen af cachen i kilobytes
- `cache_cleanup_total`: Antallet af cache-oprydningscyklusser
- `cache_cleanup_deleted`: Antallet af slettede cache-poster

## Performance Metrics

Disse metrikker relaterer sig til systemydelsen og brugen af modeller.

- `performance_avg_duration_ms`: Gennemsnitlig udførelsestid for requests i millisekunder
- `performance_avg_tokens`: Gennemsnitlig antal tokens per request
- `performance_total_requests`: Totalt antal behandlede requests
- `performance_total_tokens`: Totalt antal behandlede tokens

## Error Rate Metrics

Disse metrikker relaterer sig til fejlhåndtering og fejlrate i systemet.

- `error_rate_percentage`: Fejlprocent af alle requests
- `error_types_total`: Antallet af unikke fejltyper
- `error_type_{error_name}_total`: Antallet af forekomster af en bestemt fejltype

## Usage Distribution Metrics

Disse metrikker relaterer sig til fordelingen af brugen af systemet over tid og brugere.

- `usage_distribution_daily_{date}`: Antallet af requests per dag
- `usage_distribution_model_{model_id}`: Antallet af requests per model
- `usage_distribution_user_{user_id}_total`: Totalt antal requests per bruger
- `usage_distribution_user_{user_id}_tokens`: Totalt antal tokens per bruger

## Visualisering Metrics

Disse metrikker relaterer sig til dashboard-visningen og -eksporten.

- `dashboard_visualization_total`: Antallet af dashboard-visninger
- `dashboard_export_total`: Antallet af dashboard-eksporter
- `dashboard_export_format_{format}`: Antallet af eksporter per format (f.eks. json, csv)

## Eksempler på brug

### Eksempel 1: Overvågning af cache-hits vs cache-misses over tid

```bash
grep -E 'cache_hits|cache_misses' /var/log/openclaw/analytics.log | awk '{print $1, $2, $3}' > cache_stats.csv
```

### Eksempel 2: Overvågning af fejlprocent over tid

```bash
grep 'error_rate_percentage' /var/log/openclaw/analytics.log | awk '{print $1, $2}' > error_rates.csv
```

### Eksempel 3: Analyse af modeludnyttelse

```bash
grep 'usage_distribution_model' /var/log/openclaw/analytics.log | awk -F'_' '{print $3, $4}' > model_usage.csv
```

## Integration med eksisterende systemer

Alle metrikker kan eksporteres til JSON eller CSV-format for nem integration med eksisterende overvågningssystemer eller BI-værktøjer som Grafana, Kibana eller Power BI.