Skip to content

Latest commit

 

History

History
 
 

README.rst

Python Client for Stackdriver Logging

Python idiomatic client for Stackdriver Logging

pypi versions

Quick Start

$ pip install --upgrade google-cloud-logging

For more information on setting up your Python development environment, such as installing pip and virtualenv on your system, please refer to Python Development Environment Setup Guide for Google Cloud Platform.

Note: The creation of cross project sinks (log exports) is not currenlty supported. You may only create sinks within the same project set for the client. In other words, the parameter uniqueWriterIdentity is not yet available.

Authentication

With google-cloud-python we try to make authentication as painless as possible. Check out the Authentication section in our documentation to learn more. You may also find the authentication document shared by all the google-cloud-* libraries to be helpful.

Using the API

Stackdriver Logging API (Logging API docs) allows you to store, search, analyze, monitor, and alert on log data and events from Google Cloud Platform.

from google.cloud import logging
client = logging.Client()
logger = client.logger('log_name')
logger.log_text('A simple entry')  # API call

Example of fetching entries:

for entry in logger.list_entries():
    print(entry.payload)

See the google-cloud-python API logging documentation to learn how to connect to Stackdriver Logging using this Client Library.