Statistiken

Die Metriken verstehen

Abschnitt mit dem Titel „Die Metriken verstehen“

• Understanding the Metrics: Anzahl der einzigartigen Geräte, die in den letzten 30 Tagen auf Ihre App zugegriffen haben
• Speicherplatz: Gesamter Speicherplatz aller Pakete und Ressourcen in Byte
• Bandbreite: Gesamter Datenverkehr für die Herunterladen von Paketen in Byte

Gute Praktiken

1. Regelmäßige Überwachung: Überprüfen Sie Statistiken regelmäßig, um Wachstum und Nutzungsmuster zu verfolgen
2. Ressourcenplanung: Verwenden Sie Speicherplatz- und Bandbreitenmetriken für die Kapazitätsplanung
3. Benutzerbeteiligung: Track MAU, um Nutzertrends zu verstehen
4. Kostenverwaltung: Ressourcenverbrauch überwachen, um Kosten zu optimieren

Endpunkte

GET /statistics/app/:app_id/

Statistiken für eine bestimmte App abrufen. Dieser Endpunkt ist nützlich, um die Leistung einzelner Apps zu überwachen

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"

Beispielantwort

[
  {
    "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 /statistics/org/:org_id/

Organisationsstatistiken 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 /statistics/user/

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"

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 /statistics/app/:app_id/bundle_usage

Abrufen von Verwendungszahlen für ein bestimmtes 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

Gemeinsame Fehlerfälle 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

1. Wachstumsverfolgung: Überwachen Sie das Wachstum der MAU im Laufe der Zeit
2. Ressourcenoptimierung: Verfolgen Sie den Speicherplatz und die Bandbreitenverwendung, um Kosten zu optimieren
3. Kapazitätsplanung: Verwenden Sie Trends, um für zukünftige Ressourcenbedürfnisse zu planen
4. Nutzungsberichte: Generieren Sie periodische Nutzungsberichte für Stakeholder
5. Analyse der Verteilung von Paketen (Version): Erfassen Sie, wie sich Benutzer auf verschiedene App-Pakete (Versionen) verteilen, mit Hilfe von Paketnutzungstatistiken

Tipps zur Analyse

1. Vergleiche von Zeiträumen: Schauen Sie sich Monats- oder Jahresschwankungen an
2. Ratios verfolgen: Überwachen Sie die Bandbreite pro Benutzer oder die Speicherung pro App
3. Benachrichtigungen einrichten: Erstellen Sie Benachrichtigungen für ungewöhnliche Spitzen in der Nutzung
4. Regelmäßige Sicherungen: Exportieren Sie Statistiken regelmäßig für historische Analyse
5. Paket (Version) -Einführung: Verwenden Sie die Verwendung von Bundeln, um die Akzeptanzraten neuer Bundel (Versionen) zu verfolgen.

Weitergehen von Statistiken

Wenn Sie Statistiken zur Planung von Speicher und Dateimanagement verwenden, verbinden Sie sie mit @capgo/capacitor-data-storage-sqlite für die Implementierungsdetails in @capgo/capacitor-data-storage-sqlite Verwenden Sie @capgo/capacitor-data-storage-sqlite für die native Fähigkeit in Verwenden Sie @capgo/capacitor-data-storage-sqlite @capgo/capacitor-file für die Implementierungsdetails in @capgo/capacitor-file Mit @capgo/capacitor-Datei zur nativen Fähigkeit in Mit @capgo/capacitor-Datei, und @capgo/capacitor-Uploader zur Implementierungsdetail in @capgo/capacitor-Uploader.