Files

T

Clawd BotandClaude Opus 4.6 ca9b510922 chore: align with upstream openclaw/openclaw and overlay local additions

- 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]>

2026-03-03 07:40:46 +01:00

4.4 KiB

Raw Permalink Blame History

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

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

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

Eksempel 3: Analyse af modeludnyttelse

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.

4.4 KiB Raw Permalink Blame History