Statistiken

Eine Einrichtungsanweisung mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin kopieren.

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

Die Metriken verstehen

MAU (Monatlich aktive Benutzer): Anzahl der einzigartigen Geräte, die in den letzten 30 Tagen auf Ihre App zugegriffen haben
Speicherplatz: Gesamtgröße aller Pakete und Ressourcen in Byte
Datentransfer: Gesamtdatenübertragung für Paketdownloads in Byte

Gute Praxis

Regelmäßige Überwachung: Überprüfen Sie Statistiken regelmäßig, um Wachstum und Nutzungsmuster zu verfolgen
Ressourcenplanung: Verwenden Sie Speicherplatz- und Datentransfermetriken zur Kapazitätsplanung
Benutzerbeteiligung: Erfassen Sie MAU, um Trends der Benutzerbeteiligung zu verstehen
Kostenmanagement: Überwachen Sie die Ressourcenverwendung, um Kosten zu optimieren

Endpunkte

GET /statistics/app/:app_id/

Statistiken für eine bestimmte App abrufen. 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 /statistiken/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"

Beispielantwort

[
  {
    "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 /statistik/nutzer/

Erhalte aggregierte Statistiken über alle Organisationen, zu denen du Zugriff hast. Perfekt 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"

Beispielantwort

[
  {
    "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/anwendung/:app_id/bundle_nutzung

Bund-Nutzungsstatistiken für eine bestimmte Anwendung abrufen, wobei die Verteilung von Bundles (Versionen) unter Benutzern über einen bestimmten Zeitraum angezeigt wird.

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"
}

Häufige Anwendungsfälle

WachstumstrackingMAU-Wachstum über die Zeit verfolgen
RessourcenoptimierungSpeicherplatz- und Bandbreitenverbrauch verfolgen, um Kosten zu optimieren
LeistungsplanungTrends nutzen, um zukünftige Ressourcenbedarfe zu planen
NutzungsberichtePeriodische Nutzungsberichte für Stakeholder erstellen
Paket (Version) Verteilungsanalyse: Erfassen Sie, wie sich die Benutzer auf verschiedene App-Pakete (Versionen) über die Verteilung von Paketnutzungszahlen verteilen.

Tipps zur Analyse

Vergleichen Sie Zeiträume: Überprüfen Sie die Trends von Monat zu Monat oder Jahr zu Jahr.
Verfolgen Sie Verhältnisse: Überwachen Sie die Bandbreite pro Benutzer oder die Speicherung pro App.
Setzen Sie Warnungen: Erstellen Sie Warnungen für ungewöhnliche Spitzen in der Nutzung.
Regelmäßige Sicherungen: Exportieren Sie Statistiken regelmäßig für eine historische Analyse.
Paket (Version) Einführung: Verwenden Sie die Paketnutzung, um die Einführungsraten neuer Pakete (Versionen) zu verfolgen

Weiter von Statistiken

Wenn Sie Statistiken zur Planung von Speicher und Dateihandling verwenden, verbinden Sie es mit @capgo/capacitor-datei für die Implementierungsdetails in @capgo/capacitor-datei, Verwenden Sie @capgo/capacitor-datei für die native Fähigkeit in Verwenden Sie @capgo/capacitor-datei, @capgo/capacitor-datei für die Implementierungsdetails im @capgo/capacitor-Datei Mit der Verwendung der @capgo/capacitor-Datei für die native Fähigkeit in der Verwendung der @capgo/capacitor-Datei, und @capgo/capacitor-Uploader für die Implementierungsdetails im @capgo/capacitor-Uploader.