Leggere e riassumere i log
Recupera una finestra di log delle richieste, poi la stessa finestra come conteggi raggruppati, per una pagina di stato o una risposta all'assistenza.
get_logs rilegge gli stessi documenti account_log che ogni chiamata a /cpi scrive per te,
limitati al tuo account: cosa è stato chiamato, da dove e cosa è tornato. get_logs_counts risponde
a una domanda più stretta sulla stessa finestra, quanti e raggruppati, ed è più economico che
scorrere tu stesso ogni riga quando una risposta all'assistenza o un widget di stato ha bisogno solo
della forma di un periodo e non del suo dettaglio.
Metodi
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.
Procedura
Leggi una finestra di voci
log_type, log_date_from e log_date_to sono gli unici campi dichiarati, ma il gestore legge
anche log_search (testo libero su corpi e header di richiesta e risposta), non dichiarato, e
log_status ('success' o 'failed', per fascia di stato HTTP). log_type: "account_log" limita
automaticamente a questo account: non devi mai passare uid tu stesso.
2. Ottieni la stessa finestra come conteggi raggruppati
get_logs_counts richiede anche un valore non dichiarato, request_type o response_status, per
scegliere quale vista raggruppata leggere; non inviarne nessuno è un rifiuto, non un risultato vuoto
(vedi Errori). request_type è il campo request_type del log stesso, 'POST' per ogni riga
account_log che add_account_log scrive oggi. La chiave di raggruppamento su cui si basa
response_status si trova in una definizione di vista che questo repository non contiene: conferma
prima con get_logs sotto quali valori vengono raggruppate le tue righe, invece di indovinarne uno.
La risposta
get_logs passa così com'è il risultato di un find Mango, docs più un bookmark per la pagina
successiva:
get_logs_counts passa invece così com'è il risultato grezzo di una vista raggruppata di CouchDB,
rows di { key, value } dove value è il conteggio per quella chiave. I campi che compongono
key li stabilisce la vista stessa, non questo gestore; trattala come un id di gruppo opaco e leggi
value per il numero.