Skip to content

Mention query time and optimization when using list_entries in the docs #68

@Mapiarz

Description

@Mapiarz

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-quickly

The 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

Metadata

Metadata

Assignees

Labels

api: loggingIssues related to the googleapis/python-logging API.priority: p2Moderately-important priority. Fix may not be included in next release.type: docsImprovement to the documentation for an API.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions