Python Client for Stackdriver Logging

Stackdriver Logging API : Writes log entries and manages your Stackdriver Logging configuration.

• Client Library Documentation

• Product Documentation

Quick Start

In order to use this library, you first need to go through the following steps:

1. Select or create a Cloud Platform project.

2. Enable billing for your project.

3. Enable the Stackdriver Logging API.

4. Setup Authentication.

Installation

Install this library in a virtualenv using pip. virtualenv is a tool to create isolated Python environments. The basic problem it addresses is one of dependencies and versions, and indirectly permissions.

With virtualenv , it’s possible to install this library without needing system install permissions, and without clashing with the installed system dependencies.

Supported Python Versions

Python >= 3.5

Deprecated Python Versions

Python == 2.7. Python 2.7 support will be removed on January 1, 2020.

Mac/Linux

 pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-cloud-logging 

Windows

 pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install google-cloud-logging 

Using the API

 from google.cloud import logging_v2 
client = logging_v2 
.LoggingServiceV2Client()
entries = []
response = client.write_log_entries(entries) 

 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:

 from google.cloud import logging
client = logging. Client 
()
logger = client. logger 
('log_name')
for entry in logger.list_entries():
    print(entry.payload) 

Next Steps

• Read the Client Library Documentation for to see other available methods on the client.

• Read the Product documentation to learn more about the product and see How-to Guides.