Stackdriver Logging Python Samples

This directory contains samples for Stackdriver Logging. Stackdriver Logging allows you to store, search, analyze, monitor, and alert on log data and events from Google Cloud Platform and Amazon Web Services.

Setup

Authentication

This sample requires you to have authentication setup. Refer to the Authentication Getting Started Guide for instructions on setting up credentials for applications.

Install Dependencies

1. Clone python-docs-samples and change directory to the sample directory you want to use.

   $ git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

2. Install pip and virtualenv if you do not already have them. You may want to refer to the Python Development Environment Setup Guide for Google Cloud Platform for instructions.

3. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.

   $ virtualenv env
   $ source env/bin/activate

4. Install the dependencies needed to run the samples.

   $ pip install -r requirements.txt

Samples

Quickstart

To run this sample:

$ python quickstart.py

Snippets

To run this sample:

$ python snippets.py

usage: snippets.py [-h] logger_name {list,write,delete} ...

This application demonstrates how to perform basic operations on logs and
log entries with Stackdriver Logging.

For more information, see the README.md under /logging and the
documentation at https://cloud.google.com/logging/docs.

positional arguments:
  logger_name          Logger name
  {list,write,delete}
    list               Lists the most recent entries for a given logger.
    write              Writes log entries to the given logger.
    delete             Deletes a logger and all its entries. Note that a
                       deletion can take several minutes to take effect.

optional arguments:
  -h, --help           show this help message and exit

Export

To run this sample:

$ python export.py

usage: export.py [-h] {list,create,update,delete} ...

positional arguments:
  {list,create,update,delete}
    list                Lists all sinks.
    create              Lists all sinks.
    update              Changes a sink's filter. The filter determines which
                        logs this sink matches and will be exported to the
                        destination. For example a filter of 'severity>=INFO'
                        will send all logs that have a severity of INFO or
                        greater to the destination. See https://cloud.google.c
                        om/logging/docs/view/advanced_filters for more filter
                        information.
    delete              Deletes a sink.

optional arguments:
  -h, --help            show this help message and exit

The client library

This sample uses the Google Cloud Client Library for Python. You can read the documentation for more details on API usage and use GitHub to browse the source and report issues.