Statistiken

Ein Setup-Vorschlag kopieren mit den Installationsanweisungen und der vollständigen Markdown-Anleitung für diesen Plugin.

Die Statistik-Endpunkte liefern detaillierte Analysen zu Ihren Apps und Organisationen. Sie können die monatlichen aktiven Benutzer (MAU), den Speicherbedarf und die Bandbreitenverbrauch über verschiedene Zeitabschnitte verfolgen. Diese Daten sind für die Überwachung der App-Wachstum, Ressourcenverbrauch und Planung der Kapazität unerlässlich.

Verständnis der Metriken

MAU (monatlich aktive Benutzer): Anzahl der einzigartigen Geräte, die Ihre App in den letzten 30 Tagen zugriffen haben
Speicher: Gesamter Speicherplatz aller Pakete und Ressourcen in Byte
Bandbreite: Gesamter Datentransfer für die Herunterladen von Paketen in Byte

Gute Praktiken

Regelmäßige Überwachung: Überprüfen Sie die Statistiken regelmäßig, um Wachstum und Nutzungsmuster zu verfolgen
Ressourcenplanung: Verwenden Sie Speicher- und Bandbreitenmetriken für die Kapazitätsplanung
Benutzerbeteiligung: Verfolgen Sie die MAU, um Trends der Benutzerbeteiligung zu verstehen
KostenmanagementÜberwache Ressourcenverbrauch, um Kosten zu optimieren

Endpunkte

GET /statistik/app/:app_id/

Abrufen von Statistiken für eine bestimmte App. Dieser Endpunkt ist nützlich für die Überwachung der Leistung einzelner Apps.

Abfrageparameter

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Beispielanfrage

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/app/com.demo.app/?from=2024-01-01&to=2024-02-01"

Beispielergebnis

[
  {
    "date": "2024-01-01",
    "mau": 1500,
    "storage": 536870912,  // 512MB in bytes
    "bandwidth": 1073741824 // 1GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 1550,
    "storage": 537919488,  // 513MB in bytes
    "bandwidth": 1074790400 // 1.01GB in bytes
  }
]

GET /statistik/org/:org_id/

Statistiken für eine bestimmte Organisation abrufen. Nützlich für die Überwachung der Organisationsebene.

Abfrageparameter

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
  breakdown: boolean  // default false, optional if true it return the breakdown by app
  noAccumulate: boolean // default false, optional if true it will not accumulate data and just return day by day result
}

Beispielanfrage

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/org/046a36ac-e03c-4590-9257-bd6c9dba9ee8/?from=2024-01-01&to=2024-02-01"

Beispielergebnis

[
  {
    "date": "2024-01-01",
    "mau": 10000,
    "storage": 536870912,   // 512MB in bytes
    "bandwidth": 1073741824  // 1GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 10200,
    "storage": 537919488,   // 513MB in bytes
    "bandwidth": 1074790400  // 1.01GB in bytes
  }
]

GET /statistiken/nutzer/

Erhalte aggregierte Statistiken über alle Organisationen, zu denen du Zugriff hast. Ideal für die Überwachung der Gesamtverwendung.

Abfrageparameter

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Beispielanfrage

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/user/?from=2024-01-01&to=2024-02-01"

Beispielergebnis

[
  {
    "date": "2024-01-01",
    "mau": 25000,
    "storage": 1073741824,  // 1GB in bytes
    "bandwidth": 2147483648  // 2GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 25500,
    "storage": 1074790400,  // 1.01GB in bytes
    "bandwidth": 2148532224  // 2.01GB in bytes
  }
]

GET /statistik/app/:app_id/bundle_usage

Abrufen von Statistiken zur Verwendung von Paketen für eine bestimmte App, die Verteilung von Paketen (Versionen) unter Benutzern über einen bestimmten Zeitraum zeigt.

Abfrageparameter

interface BundleUsageQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Beispielanfrage

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/app/com.demo.app/bundle_usage?from=2024-01-01&to=2024-02-01"

Beispielergebnis

{
  "labels": ["2024-01-01", "2024-01-02", "2024-01-03"],
  "datasets": [
    {
      "label": "1.0.0",
      "data": [60.5, 58.2, 55.3]
    },
    {
      "label": "1.0.1",
      "data": [39.5, 41.8, 44.7]
    }
  ]
}

Fehlerbehandlung

Häufige Fehler und ihre Antworten:

// Invalid body
{
  "status": "Invalid body",
  "error": "Invalid date format or missing parameters"
}

// Permission denied
{
  "status": "You can't access this app",
  "error": "Insufficient permissions to access statistics"
}

// Permission denied for organization
{
  "status": "You can't access this organization",
  "error": "Insufficient permissions to access organization statistics"
}

// No organizations found for user statistics
{
  "status": "No organizations found",
  "error": "No organizations found"
}

// Internal server error
{
  "status": "Cannot get app statistics",
  "error": "Internal server error message"
}

Gemeinsame Verwendungsfälle

Wachstumstracking: Überwache den Zeitverlauf des MAU-Wachstums
Ressourcenoptimierung: Verfolge den Speicherplatz- und Bandbreitenverbrauch, um Kosten zu optimieren
Kapazitätsplanung: Verwenden Sie Trends zur Planung zukünftiger Ressourcenbedarfe
Nutzungsberichte: Generieren Sie periodische Nutzungsberichte für Stakeholder
Analyse der Verteilung von Bundeln (Version): Verstehen Sie, wie Benutzer über verschiedene App-Bundeln (Versionen) verteilt sind, mit Hilfe von Statistiken zur Bundelnutzung

Tipps zur Analyse

Zeitraum vergleichenBetrachte Monats- oder jahreszeitliche Trends
Verfolge Verhältnisse: Übertragen Sie Bandbreite pro Benutzer oder Speicher pro App
Set Alerts: Create alerts for unusual spikes in usage
Regelmäßige Sicherungen: Exportieren Sie Statistiken regelmäßig für historische Analyse
Bündel (Version) - Einführung: Verwenden Sie die Bündel-Nutzung, um die Einführungsraten neuer Bündel (Versionen) zu verfolgen

Weitergehen von Statistiken

Wenn Sie Capgo verwenden Statistics um Speicherplatz und Dateimanagement zu planen, verbinden Sie es mit @capgo/capacitor-Daten-Speicher-SQLite für die Implementierungsdetails in @capgo/capacitor-Daten-Speicher-SQLite, Mit @capgo/capacitor-Daten-Speicher-SQLite für die native Fähigkeit in Mit @capgo/capacitor-Daten-Speicher-SQLite, @capgo/capacitor-Datei für die Implementierungsdetail in @capgo/capacitor-Datei, Mit @capgo/capacitor-Datei für die native Fähigkeit in Mit @capgo/capacitor-Datei, und @capgo/capacitor-Uploader für die Implementierungsdetail in @capgo/capacitor-Uploader.