Inspired by awslogs
, gcplogs
is a simple command line tool for querying logging events from Google Cloud Logging.
gcplogs get gce_instance --event-start='1 week ago'
gcplogs get gce_instance --event-start='1 min ago' --watch
More advanced example:
gcplogs get ml_job --event-start '2 mins ago' --filter-pattern 'protoPayload:unicorns'
gcplogs get ml_job --event-start '2 mins ago' --filter-pattern 'protoPayload:unicorns' --project 'rainbows' --credentials '/cool-kids.json'
You can easily install gcplogs
using pip
:
pip install gcplogs
Optional:
gcplogs --install-completion
Option 1: Follow recommended way to authenticate Google Cloud API
Option 2: If you have an activated service account, just create an environment variable:
export GOOGLE_APPLICATION_CREDENTIALS="/path/[FILE_NAME].json"
Option 3: If you have gcloud installed, you can use this method, but you might run into rate-limit errors:
gcloud auth application-default login
You can use --filter-pattern
if you want to only retrieve logs which match one Stackdriver Logs Filter pattern.
gcplogs get audited_resource --filter-pattern="textPayload:10.0.0.0/8" --project google-ai
Full documentation of how to write patterns: https://cloud.google.com/logging/docs/view/logging-query-language