Stackdriver Logging API client library
Project description
Stackdriver Logging API: Writes log entries and manages your Stackdriver Logging configuration.
Quick Start
In order to use this library, you first need to go through the following steps:
- Select or create a Cloud Platform project.
- Enable billing for your project.
- Enable the Stackdriver Logging API.
- Setup Authentication.
Installation
Install this library in a venv using pip. venv is a tool to create isolated Python environments. The basic problem it addresses is one of dependencies and versions, and indirectly permissions.
With venv, 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 was removed on January 1, 2020.
Mac/Linux
python -m venv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-cloud-logging
Windows
python -m venv <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() resource = { "type": "global", "labels": { "project_id": "[PROJECT_ID]" } } """ Log entries can be either LogEntry or dict. You can describe the same data in the following format: e = { "log_name": "projects/[PROJECT_ID]/logs/test-logging", "resource": resource, "text_payload": "this is a log statement", } """ e = logging_v2.types.LogEntry( log_name="projects/[PROJECT_ID]/logs/test-logging", # optional resource=resource, # optional text_payload="this is a log statement") entries = [e] 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for google-cloud-logging-1.15.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb0d4af9d684eb8a416f14c39d9fa6314be3adf41db2dd8ee8e30db9e8853d90 |
|
MD5 | c3889700beb020f5956db058d29b8c77 |
|
BLAKE2-256 | 55bc76c0741d8f54a914a8cacc79c9d8a16dac6f4cb2b44263fa698710c7140a |
Hashes for google_cloud_logging-1.15.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 20c7557fd170891eab1a5e428338ad646203ddc519bc2fc57fd59bef14cd3602 |
|
MD5 | 31e478b69a759c26d8a364129ae3fe1c |
|
BLAKE2-256 | c86c4f6ec818c7f4c239c130d4dda86a3747d10647d31eba2b2e0cbf16098542 |