Skip to main content
client.apps.network funktioniert nur mit Web-Apps. Jede Methode nimmt zuerst die App-ID.

Zeitfenster

analytics, errors, logs und performance nehmen ein start und ein end, jeweils ein ISO-8601-String oder ein datetime. Ein naives datetime gilt als lokale Zeit und wird in UTC umgerechnet. Ein Fenster umfasst höchstens 7 Tage, und start wird auf das Erstellungsdatum der App begrenzt. Ein ungültiges Fenster ergibt 400 INVALID_TIME_RANGE.
Ergebnisse werden in 5-Minuten-Intervallen gecacht. Cache-Misses dieser vier Methoden teilen sich ein Limit von 20 Anfragen pro 60 Sekunden pro Konto: Wird es überschritten, ergibt das 429 RATE_LIMITED.

Analytics

network.analytics(app_id, start, end, **filters) gibt Verkehrssummen und Aufschlüsselungen zurück. Für ein Fenster ohne Verkehr gibt die Methode None zurück.
Die Aufschlüsselungen sind countries, devices, os, browsers, protocols, methods, paths, referers, providers, ips, status_codes, bots und content_types. Jeder Eintrag hat type, visits, requests und bytes.

Filter

Filter sind Keyword-Argumente und schränken jede Aufschlüsselung ein. Jeder nimmt den exakten type-Wert seiner Aufschlüsselung:
Ein ungültiger Filter ergibt 400 INVALID_FILTER. Ein Filter mit dem Wert None oder '' wird nicht gesendet.

Fehler

network.errors(app_id, start, end, include_4xx=False) gibt die 5xx-Antworten des Fensters zurück, mit include_4xx=True (reines Keyword-Argument) zusätzlich die 4xx. Für ein leeres Fenster gibt die Methode None zurück.

Request-Logs

network.logs(app_id, start, end) gibt einzelne Anfragen mit Details zu Client, Anfrage und Antwort zurück. Verfügbar in den Plänen Pro und Enterprise (sonst 403 UPGRADE_REQUIRED).

Performance

network.performance(app_id, start, end) gibt Latenzperzentile (p50, p95, p99, in ms) an der Edge und am Ursprung zurück, nach Land, nach Standort und für die langsamsten Pfade. Für ein leeres Fenster gibt die Methode None zurück. Verfügbar in den Plänen Pro und Enterprise.

DNS

network.dns(app_id) gibt die DNS-Einträge zurück, die deine eigene Domain benötigt, zusammen mit ihrem Status. Ohne eigene Domain ergibt das 400 NO_CUSTOM_DOMAIN.

Eigene Domain

network.set_domain(app_id, domain) verbindet eine eigene Domain (ab dem Standard-Plan). Übergib "@", um sie zu entfernen.

Cache leeren

network.purge_cache(app_id) leert den Edge-Cache der App. Das ist auf einen Vorgang alle 60 Sekunden begrenzt (429 KEEP_CALM).

Fehler der Analytics-Methoden