Clawd BotandClaude Opus 4.6
ca9b510922
- Reset master to upstream/main (16,697 commits) - Overlay 2,271 local-only files (skills, tools, workspace, configs, apps) - Restore IDENTITY.md and USER.md templates - Build verified, gateway running, Discord working Co-Authored-By: Claude Opus 4.6 <[email protected]>
111 lines
4.4 KiB
Markdown
111 lines
4.4 KiB
Markdown
# 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.
|