Lire et résumer vos journaux
Récupérez une fenêtre de journaux de requêtes, puis la même fenêtre sous forme de comptes regroupés, pour une page d'état ou une réponse au support.
get_logs relit les mêmes documents account_log que chaque appel à /cpi écrit pour vous, limités à votre propre
compte : ce qui a été appelé, d'où, et ce qui est revenu. get_logs_counts répond à une question plus étroite sur la
même fenêtre, combien, regroupé, ce qui coûte moins cher que de parcourir vous-même chaque ligne quand une réponse au
support ou un widget d'état n'a besoin que de la forme d'une période, pas de son détail.
Méthodes
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.
Pas à pas
Lire une fenêtre d'entrées
log_type, log_date_from et log_date_to sont les seuls champs déclarés, mais le gestionnaire lit aussi un
log_search non déclaré (texte libre sur les corps et les en-têtes de requête et de réponse) et un log_status
('success' ou 'failed', selon la tranche de statut HTTP). log_type: "account_log" se limite automatiquement à ce
compte : vous ne passez jamais uid vous-même.
2. Obtenir la même fenêtre sous forme de comptes regroupés
get_logs_counts a aussi besoin d'une valeur non déclarée request_type ou response_status pour choisir la vue
groupée qu'elle lit ; n'envoyer ni l'une ni l'autre est un refus, pas un résultat vide (voir Erreurs).
request_type est le champ request_type du journal lui-même, 'POST' pour chaque ligne account_log que
add_account_log écrit aujourd'hui. La clé de regroupement que construit response_status se trouve dans une
définition de vue que ce dépôt ne contient pas : confirmez d'abord avec get_logs les valeurs sous lesquelles vos
propres lignes se regroupent, plutôt que d'en deviner une.
La réponse
get_logs renvoie tel quel un résultat Mango find, docs plus un bookmark pour la page suivante :
get_logs_counts renvoie à la place un résultat brut de vue groupée CouchDB, des rows de { key, value } où value est le compte pour cette clé. Les champs qui composent key sont définis par la vue elle-même,
pas par ce gestionnaire ; traitez-la comme un identifiant de groupe opaque et lisez value pour le nombre.