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:
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.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c21ca4784e7297458bfa3e9b5a3aae4605dd98d2e4a56ed13ff97cdab5fd2510 |
|
MD5 | e3e41f10a340eca0485598faf14c9d08 |
|
BLAKE2b-256 | 682810efe1d054148afef512d34ad69a5ecb05ac185f001128af9d8bad46359c |
Hashes for google_cloud_logging-1.15.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f194df9f92cef62e03f559526ab66ae0de8076f6c0f19aa242c5334d161e7363 |
|
MD5 | 42fbe4c4643023c93f2dc82044b51ab9 |
|
BLAKE2b-256 | eb0a11708a74508d9715f1e2bfc43030f4989cf95c69e1bd0b59c092402c0898 |