Protokolle lesen und zusammenfassen
Hole ein Zeitfenster von Anfrageprotokollen, dann dasselbe Fenster als gruppierte Zählungen, für eine Statusseite oder eine Support-Antwort.
get_logs liest dieselben account_log-Dokumente zurück, die jeder Aufruf an /cpi für dich schreibt, begrenzt
auf dein eigenes Konto: was aufgerufen wurde, von wo und was zurückkam. get_logs_counts beantwortet eine
engere Frage über dasselbe Zeitfenster, nämlich wie viele, gruppiert. Das ist günstiger, als selbst durch
jede Zeile zu blättern, wenn eine Support-Antwort oder ein Status-Widget nur die Form eines Zeitraums braucht, nicht
seine Details.
Methoden
Get Logs
Queries logs of a given type within a timestamp range, with optional search, paging, and status filters.
Get Logs Counts
Returns grouped log counts by request type or response status within a timestamp range.
Schritt für Schritt
Ein Zeitfenster von Einträgen lesen
log_type, log_date_from und log_date_to sind die einzigen deklarierten Felder, aber der Handler liest außerdem
ein nicht deklariertes log_search (Freitext über die Anfrage-/Antwort-Bodys und Header) und
log_status ('success' oder 'failed', nach HTTP-Statusbereich). log_type: "account_log" begrenzt automatisch auf
dieses Konto, du übergibst uid nie selbst.
2. Dasselbe Zeitfenster als gruppierte Zählungen holen
get_logs_counts braucht zusätzlich einen nicht deklarierten Wert für request_type oder response_status, um zu wählen, welchen
gruppierten View es liest. Sendest du keinen von beiden, ist das eine Ablehnung, kein leeres Ergebnis (siehe Fehler). request_type
ist das eigene Feld request_type des Protokolls, 'POST' bei jeder account_log-Zeile, die add_account_log
heute schreibt. Der Gruppierungsschlüssel, gegen den response_status aufbaut, steht in einer View-Definition, die dieses
Repo nicht enthält. Bestätige zuerst mit get_logs, unter welchen Werten deine eigenen Zeilen gruppiert sind, statt
einen zu raten.
Die Antwort
get_logs reicht ein Mango-find-Ergebnis unverändert durch, docs plus ein bookmark für die nächste
Seite:
get_logs_counts reicht stattdessen ein rohes gruppiertes CouchDB-View-Ergebnis durch, rows aus { key, value }, wobei value die Anzahl für diesen Schlüssel ist. Welche Felder key bilden, legt der View
selbst fest, nicht dieser Handler. Behandle ihn als undurchsichtige Gruppen-ID und lies value für die Zahl.