Mention query time and optimization when using list_entries in the docs #68
Labels
api: logging
Issues related to the googleapis/python-logging API.
priority: p2
Moderately-important priority. Fix may not be included in next release.
type: docs
Improvement to the documentation for an API.
Hi.
The library docs explain how to retrieve and query for logs using
list_entries
methods, simple enough. Nonetheless, I was quite puzzled today as to why my queries, even though very simple, take minutes to get the response from the API. After quite a lot of googling and digging deep into Logging docs, I was able to find an answer: https://cloud.google.com/logging/docs/view/advanced-queries#finding-quicklyThe reason why my queries took so long to execute is because I didn't limit the time period of my queries. This can be very confusing for newcomers and I think the docs could use a paragraph about query time and that most queries should be limited by time period (like they are, for instance, in the Google Cloud Platform web logs browser) or that if not limited by time period they can take a lot of time to execute.
Regards,
Bartosz
The text was updated successfully, but these errors were encountered: